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 é:
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
{"config":{"emitCpfCnpj":"07385111000102","url_oobj_service":"http://localhost:3090","integracao":"yrest","serie":"01","idPDV":"001"},"conteudo":"IDE%7C07385111000102%7C35970%7C503%7C4%7C%0ADEST%7C01098983000537%7C%7C%7CE-Sales%20Solucoes%20Oobj%7C%7C%7C%7C9%7C%0AENDERDEST%7CAV.%20FRANCA%7C1162%7C%7CNAVEGANTES%7C4314902%7CPORTO%20ALEGRE%7CRS%7C44096486%7C1058%7CBRASIL%7C7536230233%0APROD%7C1100%7C%7CREFEICAO%20BUFFET%7C21069090%7C%7C%7C5101%7CKG%7C362%7C0.04%7C%7C%7C0%7C%7C40%7C%7C%7C0.00%7C0.00%7C%7C%7C%7C%7C%7C%7C%7C%7C%7C%7C%7C%7C99%7C0.00%7C0.00%7C0%7C0%7C0.00%7C99%7C0.00%7C0.00%7C0%7C0%7C0.00%7C%7C%7C%7C1.73%0APROD%7C1100%7C%7CREFEICAO%20BUFFET%7C21069090%7C%7C%7C5101%7CKG%7C454%7C0.04%7C%7C%7C0%7C%7C40%7C%7C%7C0.00%7C0.00%7C%7C%7C%7C%7C%7C%7C%7C%7C%7C%7C%7C%7C99%7C0.00%7C0.00%7C0%7C0%7C0.00%7C99%7C0.00%7C0.00%7C0%7C0%7C0.00%7C%7C%7C%7C2.17%0APROD%7C1100%7C%7CREFEICAO%20BUFFET%7C21069090%7C%7C%7C5101%7CKG%7C158%7C0.04%7C%7C%7C0%7C%7C40%7C%7C%7C0.00%7C0.00%7C%7C%7C%7C%7C%7C%7C%7C%7C%7C%7C%7C%7C99%7C0.00%7C0.00%7C0%7C0%7C0.00%7C99%7C0.00%7C0.00%7C0%7C0%7C0.00%7C%7C%7C%7C0.76%0APAG%7C03%7C38.96%7C1%7C99999999999999%7C02%7C180003%7C%0AOBS%7ClistaEmail%7Cteste-sustentacao%40oobj.com.br%7CC"}
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:
{"config":{"emitCpfCnpj":"07385111000102","url_oobj_service":"http://localhost:3090","integracao":"oobj","serie":"01","idPDV":"001"},"chaveAcesso":"43190807385111000102650010000359701556757311"}
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:
{"config":{"emitCpfCnpj":"07385111000102","url_oobj_service":"http://localhost:3090","integracao":"yrest","serie":"01","idPDV":"001"},"chaveAcesso":"43190807385111000102650010000359731444352109","protocolo":"143190003837454","justificativa":"teste de cancelamento Postman","cpfCnpjDestinatario":"01098983000537"}
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