Como testar Integração HTTP Oobj?

Problema

Como testar Integração HTTP Oobj?

Solução/Procedimento

É possível realizar testes de emissão com a integração HTTP Local do DF-e Client utilizando softwares de testes de API. 

Nós da Oobj particularmente utilizamos o Postman para realizar tais testes, que é um API Client que facilita aos desenvolvedores criar e testar APIs. Isso é feito, permitindo aos usuários criar e salvar solicitações HTTP, bem como ler suas respostas em diversos formatos.

Agora que sabemos o que é o Postman vamos aos procedimentos.

Antes de começar!

Veja nosso artigo sobre a  Integração HTTP Local do DF-e Client

Instalação

O link oficial para download do Postman é:

• https://www.getpostman.com/downloads

O procedimento de instalação é bem simples, basta acessar o site , baixar a versão compatível com a versão do seu sistema operacional (64 ou 32bits) e ao executar o instalador, será solicitado a criação de uma conta para ter acesso ao aplicativo.

Após criar a conta o programa irá carregar sua workspace.

Teste de Emissão 

Abaixo o exemplo de como é realizado o teste de emissão via Postman:

• Selecionar a requisição via POST 
• Adicionar a ação do endpoint. Exemplo: http://localhost:3090/?acao=emissao
• Selecionar a aba "Body" e marcar a opção "raw"
• Inserir o conteúdo do arquivo em formato JSON, clicar em "Send" e obter o resultado, se tudo ocorrer bem, será status 200 - OK

Teste de Acompanhamento de Retorno

Exemplo do acompanhamento do retorno da emissão:

• Selecionar a requisição via GET
• Adicionar a ação do endpoint. Exemplo: http://localhost:3090/?acao=acompanhamento&nomeacompanhamento=respSimplhttp-000000001001190819.txt
• Clicar em "Send" e obter o resultado, que se tudo ocorrer bem, será status 200 - OK

Teste de Reimpressão

Exemplo da reimpressão de documento:

• Selecionar a requisição via POST
• Adicionar a ação do endpoint. Exemplo: http://localhost:3090/?acao=reimprimir
• Selecionar a aba "Body" e marcar a opção "raw"
• Inserir o conteúdo do arquivo em formato JSON contendo a chave de acesso do documento autorizado, clicar em "Send" e obter o resultado. Vale ressaltar que reimpressão só é válida para documentos autorizados que não estejam cancelados.

Conteúdo do arquivo JSON utilizado para o teste de reimpressão:

Teste de Cancelamento

Exemplo da emissão do evento de cancelamento e acompanhamento do retorno do evento:

1- Emissão do Evento de Cancelamento:

• Selecionar a requisição via POST
• Adicionar a ação do endpoint. Exemplo: http://localhost:3090/?acao=cancelarnota
• Selecionar a aba "Body" e marcar a opção "raw"
• Inserir o conteúdo do arquivo em formato JSON contendo a chave de acesso do documento autorizado, protocolo e justificativa
• Clicar em "Send" e obter o resultado, que se tudo ocorrer bem, será status 200 - OK

Segue o conteúdo do arquivo JSON utilizado para o evento de cancelamento:

2- Acompanhando o retorno da emissão do evento:

• Selecionar a requisição via GET
• Adicionar a ação do endpoint. Exemplo: http://localhost:3090/?acao=acompanhamento&nomeacompanhamento=respLoteEvento-8177.txt
• Clicar em "Send" e obter o resultado, que se tudo ocorrer bem, será status 200 - OK

Referência

• https://www.oobj.com.br/bc/article/integra%C3%A7%C3%A3o-http-local-704.html
• https://www.getpostman.com/