TF Fiscal
Documentation

NF-e

Register correction letter

Registers a correction letter (CC-e) on an authorized invoice; the protocol is returned synchronously.

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

Requires the token, timestamp and sign signature headers, see Authentication.

Registers a correction letter (event 110110) on an authorized invoice. The call is synchronous: HTTP 200 is returned only after SEFAZ registers the event, and the response body is the result; no callback involved. Authentication errors (10009xxx) are listed under Authentication.

Parameters

Path parameters

  • empresaIdstringrequired

    Company identifier returned by Register company.

    Example: 1934811222334455
  • nfeIdstringrequired

    The id sent at issuance.

    Example: NFe-000014553

Request body

  • correcaostringrequired

    Correction text, 15–1000 characters after sanitising (accents stripped, printable ASCII kept; colons, parentheses and percent signs survive). Only information that does not affect tax amounts may be corrected (remarks, nature-of-operation wording, transport data). Amounts, quantities, unit prices, tax bases, tax amounts, party documents and dates must go through cancellation + reissue or a return invoice; SEFAZ does not validate semantics and the issuer is liable.

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

Responses

200

Event registered with SEFAZ.

  • chaveAcessostring

    Access key of the corrected NF-e.

  • tipostring

    Fixed CartaCorrecao.

  • codigostring

    Fixed 110110.

  • sequenciainteger

    Sequence number nSeq of this letter.

  • statusstring

    Fixed Registrada.

  • motivostring

    SEFAZ status code and description.

  • protocolostring

    Event protocol number.

  • datastring

    SEFAZ registration time, ISO-8601 UTC.

  • correcaostring

    Sanitised text actually sent to SEFAZ.

  • linkXmlstring

    Download link of the procEventoNFe receipt XML, see File download.

  • linkDaccestring

    Download link of the DACCE (correction-letter PDF, see File download); empty when the rendering service is unavailable, retry through the list endpoint.

Errors

CodeHTTP
NFe0001404

The nfeId does not exist. Check the id sent at issuance and the empresaId.

10003000404

empresaId does not exist or does not belong to this application.

10004012400

Invoice not in authorized status. Query to confirm the status.

10004015400

20 letters already registered on the invoice. No further letters; cancel + reissue or return invoice.

10004016400

Refused by SEFAZ (status code and reason attached). Act on the SEFAZ reason.

10004017400

Fewer than 15 characters after sanitising. Rewrite in Portuguese / ASCII.

10004019400

Outside the 720-hour window after authorization. Cancel + reissue or return invoice only.

10001001400

Request field validation failed (one entry per field). Fix per mensagem.

Rules

  • Only Autorizada invoices (10004012 otherwise).
  • Within 720 hours of authorization (10004019).
  • At most 20 letters per invoice (10004015); sequence numbers are assigned by the platform and each letter supersedes the previous one on the SEFAZ side while history is fully kept.
  • Text shorter than 15 characters after sanitising: 10004017.
  • SEFAZ refusal: 10004016 with the SEFAZ status code and reason.
  • There is still no invoice.cce.registered callback; rely on the synchronous response or List correction letters.
PreviousCancel NF-eNextList correction letters