API para envio de CCe – Carta de Correção Eletrônica

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 Integração NFe - DocumentaçãoUtilize o seguinte serviço:

<code>POST /nfe2/emitir_cce?token=TOKEN&amp;ref=REFERENCIA</code>

Onde 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:

<code>GET /nfe2/consultar_cce?token=TOKEN&amp;ref=REFERENCIA</code>

Onde 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.