A Importação e Conciliação de DF-es através da API Rest será permitido para o usuário que já possuir o x-auth-token. No artigo Autenticação na API Rest damos mais detalhes sobre o x-auth-token. Existem alguns Endpoints para o serviço de Importação e Conciliação de Documentos Fiscais e para cada um, há uma URL específica.
Importação de Documentos Fiscais (PUT)
A importação de DFes permite armazenar um documento no Monitor Oobj que foi emitido por outra solução. Esse documento fiscal pode ser o XML Proc de uma NFe, uma NFCe, um CTe ou um MDFe.
A URL é construída da seguinte forma:
http:// ou https:// + /endereço da API Rest + /api/empresas/{empresa}/docs/{ambiente}/{codModelo}
Os valores sublinhados devem ser substituídos pelos valores correspondentes abaixo:
http://rest.oobj-dfe.com.br/api/empresas/07385111000102/docs/hom/55
Importação de Eventos de Documentos Fiscais (PUT)
Assim como é possível importar um DF-e, é possível armazenar Eventos Fiscais relacionados a esses DF-es. Assim, caso um documento esteja cancelado, possua carta de correção e outros tipos como manifesto, é possível manter atualizado o status do documento.
A URL é construída da seguinte forma:
http:// ou https:// + /endereço da API Rest + /api/empresas/{empresa}/docs/{ambiente}/{codModelo}/{ano}/{serie}/{numero}/eventos
Os valores sublinhados devem ser substituídos pelos valores correspondentes abaixo:
http://rest.oobj-dfe.com.br/api/empresas/07385111000102/docs/hom/55/2021/1/100/eventos
Envio de Informações de Vendas do ERP / PDV para Conciliação / Conferência (POST)
A Conciliação de Documentos Fiscais permite o envio de algumas informações do seu ERP / PDV para a nossa API. Esses dados enviados são guardados e são confrontados com os documentos fiscais que já estão na Oobj. Dessa forma é possível obter possíveis diferenças de Chave de Acesso, Valor da Venda e Data de Emissão, por exemplo.
Porém, para que essa integração funcione, é preciso, ao Emitir um DFe, informar no Grupo obsCont (Observações do Contribuinte) o Número do Pedido (que represente a venda no seu PDV). Veja um exemplo de preenchimento:
<obsCont xCampo="numeroPedido">
<xTexto>36017</xTexto>
</obsCont>
O Número de Pedido deve ser informado na NF-e e também será enviado através desse Endpoint para a API.
Através desse serviço, além do Número de Pedido, deverá ser enviado a Data de Emissão, Chave de Acesso, Valor Total do DFe (NFe, NFCe e SAT CFe) e se a Venda foi Cancelada.
Essas informações deverão estar salvas em um arquivo CSV. O arquivo de conciliação a ser enviado deve estar com codificação UTF-8 e deve conter as seguintes colunas separadas por ponto-vírgula (;)
Exemplo: conciliacao.csv
4447;2017-04-26 18:59:59;41170408186139000507650130000360961876097593;25.00;f
4445;2017-04-26 13:59:00;41170408186139000507650120000484781665531420;50.89;t
8429;2017-04-26 10:00:05;;2.00;f
A URL é construída da seguinte forma:
http:// ou https:// + /endereço da API Rest + /api/empresas/{empresa}/docs/{ambiente}/{codModelo}/conciliacao
Os valores sublinhados devem ser substituídos pelos valores correspondentes abaixo:
http://rest.oobj-dfe.com.br/api/empresas/07385111000102/docs/hom/55/conciliacao
Obter comparação entre Vendas do ERP / PDV e DFes Emitidos (GET)
Após realizar o envio do arquivo CSV para Conciliação o usuário poderá obter o resultado da análise / confronto, realizado entre as vendas feitas no PDV / ERP e os Documentos Fiscais que foram emitidos. Dessa forma, poderá ser identificado possíveis diferenças entre os dados do PDV e do Monitor Oobj.
A URL é construída da seguinte forma:
http:// ou https:// + /endereço da API Rest + /api/empresas/{empresa}/docs/{ambiente}/{codModelo}/conciliacao/{data}
Os valores sublinhados devem ser substituídos pelos valores correspondentes abaixo:
http://rest.oobj-dfe.com.br/api/empresas/07385111000102/docs/hom/55/conciliacao/2018-03-26
Para realizar testes com a API Rest, e ter mais detalhes sobre a Importação e Conciliação de DF-es, acesse a documentação completa através dos links:
Nº do Artigo: 747
Postado: 16/03/2018 10:19:13
Última atualização: 20/09/2021 12:14:34
Postado: Mateus Neves [mateus.neves@oobj.com.br]
URL: https://backupbc.novooobj.xyz/article/importação-e-conciliação-de-dfes-na-api-rest-747.html