NF-e
Registrar carta de correção
Registra uma carta de correção (CC-e) em uma nota autorizada; o protocolo é devolvido de forma síncrona.
/openapi/v2/empresas/{empresaId}/nf-e/{nfeId}/carta-correcaotoken, timestamp e sign, veja Autenticação.Registra uma carta de correção em uma nota autorizada. A chamada é síncrona: HTTP 200 só é retornado depois que a SEFAZ registra o evento, e o corpo da resposta é o resultado; nenhum callback está envolvido. Erros de autenticação (10009xxx) estão em Autenticação.
Parâmetros de caminho
empresaId* | string | Identificador da empresa |
nfeId* | string | Identificador da nota |
* Campo obrigatório
Corpo da requisição
correcao* | string | Texto da correção |
* Campo obrigatório
chaveAcesso | string | Chave de acesso da nota corrigida |
tipo | string | Tipo do evento |
codigo | string | Código do evento na SEFAZ |
sequencia | int | Sequência da carta |
status | string | Status do registro |
motivo | string | Resposta da SEFAZ |
protocolo | string | Protocolo do evento |
data | string | Data do registro |
correcao | string | Texto da correção |
linkXml | string | Link do XML do recibo |
linkDacce | string | Link do DACCE |
A carta de correção só altera texto. Tudo o que muda valor de tributo fica fora: nesses casos cancele e reemita dentro de 24 horas, ou emita uma nota de devolução.
Pode corrigir
Observações da nota, o texto da natureza da operação e os dados de transporte: transportadora, veículo, volumes, endereço de entrega.
{ "correcao": "Correcao do transportador: item (2) sem alteracao de valor" }
correcao* | string | Texto da correção |
* Campo obrigatório
Não pode corrigir
Valores, quantidades, preços unitários, bases e valores de tributo, documentos das partes e datas. A SEFAZ recusa (10004016); use cancelamento com reemissão ou nota de devolução.
- A sequência é atribuída pela plataforma; cada carta substitui a anterior na SEFAZ, e a nota aceita no máximo 20 (
10004015). - Janela: até 720 horas depois da autorização (
10004019). - Não há callback para cartas de correção; use a resposta síncrona ou Listar cartas de correção.
tipoTipo do evento
| Valores | Significado |
|---|---|
| CartaCorrecao | Carta de correção: corrige textos de uma nota autorizada sem mudar valores de tributo |
statusStatus do registro
| Valores | Significado |
|---|---|
| Registrada | Registrada na SEFAZ; o único status devolvido, porque a recusa vira erro 10004016 |
| Código | HTTP | |
|---|---|---|
| 10004000 | 404 | O nfeId não existe. Verifique o id enviado na emissão e o empresaId. |
| 10004001 | 404 | O nfeId não existe. Verifique o id enviado na emissão e o empresaId. |
| 10003000 | 404 | empresaId não existe ou não pertence a esta aplicação. |
| 10004012 | 400 | A nota não está em status Autorizada. Consulte para confirmar o status. |
| 10004015 | 400 | 20 cartas já registradas na nota. Não cabem mais; cancele e reemita, ou emita nota de devolução. |
| 10004016 | 400 | Recusada pela SEFAZ; a mensagem traz o código de status e o motivo. Atue conforme o motivo. |
| 10004017 | 400 | Menos de 15 caracteres após a sanitização. Reescreva em português sem acentos. |
| 10004019 | 400 | Fora da janela de 720 horas após a autorização. Cancele e reemita, ou emita nota de devolução. |
| 10001001 | 400 | Falha de validação de campos, uma entrada por campo. Corrija conforme mensagem. |