TF Fiscal
Documentação

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.

POST/openapi/v2/empresas/{empresaId}/nf-e/{nfeId}/carta-correcao

Requer os cabeçalhos de assinatura token, timestamp e sign, veja Autenticação.

Registra uma carta de correção (evento 110110) 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

Parâmetros de caminho

  • empresaIdstringobrigatório

    Identificador da empresa devolvido em Registrar empresa.

    Exemplo: 1934811222334455
  • nfeIdstringobrigatório

    O id enviado na emissão.

    Exemplo: NFe-000014553

Corpo da requisição

  • correcaostringobrigatório

    Texto da correção, 15–1000 caracteres após sanitização (acentos removidos, ASCII imprimível mantido; dois-pontos, parênteses e sinais de percentagem sobrevivem). Somente informações que não afetam valores tributários podem ser corrigidas (observações, texto da natureza da operação, dados de transporte). Valores, quantidades, preços unitários, bases e valores de tributos, documentos das partes e datas devem passar por cancelamento + reemissão ou nota de devolução; a SEFAZ não valida a semântica e o emissor é o responsável.

    Exemplo: Correcao do transportador: item (2) sem alteracao de valor

Respostas

200

Evento registrado na SEFAZ.

  • chaveAcessostring

    Chave de acesso da NF-e corrigida.

  • tipostring

    Fixo CartaCorrecao.

  • codigostring

    Fixo 110110.

  • sequenciainteger

    Número de sequência nSeq desta carta.

  • statusstring

    Fixo Registrada.

  • motivostring

    Código de status e descrição da SEFAZ.

  • protocolostring

    Número do protocolo do evento.

  • datastring

    Momento do registro na SEFAZ, ISO-8601 UTC.

  • correcaostring

    Texto sanitizado efetivamente enviado à SEFAZ.

  • linkXmlstring

    Link de download do XML de recibo procEventoNFe, veja Download de arquivos.

  • linkDaccestring

    Link de download do DACCE (PDF da carta de correção, veja Download de arquivos); vazio quando o serviço de renderização está indisponível, tente de novo pelo endpoint de listagem.

Erros

CódigoHTTP
NFe0001404

O nfeId não existe. Verifique o id enviado na emissão e o empresaId.

10003000404

empresaId não existe ou não pertence a esta aplicação.

10004012400

A nota não está em status autorizado. Consulte para confirmar o status.

10004015400

20 cartas já registradas na nota. Não há mais cartas; cancele + reemita ou emita nota de devolução.

10004016400

Recusada pela SEFAZ (código de status e motivo anexados). Atue conforme o motivo da SEFAZ.

10004017400

Menos de 15 caracteres após a sanitização. Reescreva em português / ASCII.

10004019400

Fora da janela de 720 horas após a autorização. Só resta cancelar + reemitir ou emitir nota de devolução.

10001001400

Falha de validação de campos (uma entrada por campo). Corrija conforme mensagem.

Regras

  • Somente notas Autorizada (10004012 caso contrário).
  • Dentro de 720 horas da autorização (10004019).
  • No máximo 20 cartas por nota (10004015); os números de sequência são atribuídos pela plataforma e cada carta substitui a anterior no lado da SEFAZ, com o histórico integralmente preservado.
  • Texto com menos de 15 caracteres após a sanitização: 10004017.
  • Recusa da SEFAZ: 10004016 com o código de status e o motivo da SEFAZ.
  • Ainda não há callback invoice.cce.registered; use a resposta síncrona ou Listar cartas de correção.
AnteriorCancelar NF-ePróximoListar cartas de correção