Para integrar as operações de emissão e consulta de uma CCe (Carta de Correção eletrônica) de uma NFe à sua aplicação você pode utilizar nossa API web.
Aqui assumimos que você emitiu a NFe usando nossa API de envio de NFe.
Emissão de CCe Utilize o seguinte serviço:
POST /nfe2/emitir_cce?token=TOKEN&ref=REFERENCIAOnde TOKEN e REFERENCIA são o token de acesso e a referência utilizada para criar a NFe. Este serviço aceita os seguintes parâmetros adicionais:
- correcao – Contem a correção a ser aplicada à NFe (mínimo de 15 e máximo de 1000 caracteres). É o único campo obrigatório.
- data_evento – Data no formato ISO (exemplo ’2012-03-30T14:35:00-03:00′) com a data da correção. Caso este campo não seja informado será usado a data atual
- numero_sequencial_evento – Uma NFe pode conter 20 cartas de correções (sendo que a última substitui todas as outras) sendo que cada uma possui um número sequencial. Este campo força a utilização do respectivo número. Caso este campo não seja informado, o sistema irá calcular automaticamente a próxima sequência
O serviço é assíncrono assim como a emissão de NFe, ou seja, a solicitação será enfileirada e sua aplicação deverá posteriormente consultar o status da CCe. Consulta de CCe Utilize o seguinte serviço:
GET /nfe2/consultar_cce?token=TOKEN&ref=REFERENCIAOnde TOKEN e REFERENCIA são o token de acesso e a referência utilizada para criar a NFe. Este serviço aceita os seguintes parâmetros adicionais:
- numero_sequencial_evento – Este campo consulta apenas a CCe indicada pelo seu número sequencial. Caso este campo não seja informado, o sistema irá informar a situação da última CCe desta NFe
O sistema irá devolver a situação da CCe em formato YAML, abaixo um exemplo de uma CCe emitida em duplicidade:
--- status: erro_autorizacao chave_nfe: NFe41131006059934000185550010000027751019556666 status_sefaz: "573" numero_sequencial_evento: 1 mensagem_sefaz: Duplicidade de Evento. ID1101104113100605993400018555001000002775101955776666
Abaixo um exemplo de uma CCe autorizada corretamente:
--- status: autorizado chave_nfe: NFe41131006059934000185550010000027751019556666 numero_sequencial_evento: 1 caminho_xml: /arquivos/99999999000199/201310/XMLs/41131006059934000185550010000027751019556666-cce-01.xml caminho_pdf: /notas_fiscais/NFe41131006059934000185550010000027751019556666/cartas_correcao/1.pdf
Quer integrar seu sistema para emissão de NF-e? Clique aqui, acesse nossa documentação e saiba tudo o que você para fazer a integração do seu sistema com a nossa API.
