NF-e
Register correction letter
Registers a correction letter (CC-e) on an authorized invoice; the protocol is returned synchronously.
/openapi/v2/empresas/{empresaId}/nf-e/{nfeId}/carta-correcaotoken, timestamp and sign signature headers, see Authentication.Registers a correction letter 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.
Path parameters
empresaId* | string | Company identifier |
nfeId* | string | Invoice identifier |
* Required field
Request body
correcao* | string | Correction text |
* Required field
chaveAcesso | string | Access key of the corrected invoice |
tipo | string | Event type |
codigo | string | SEFAZ event code |
sequencia | int | Letter sequence |
status | string | Registration status |
motivo | string | SEFAZ reply |
protocolo | string | Event protocol |
data | string | Registration time |
correcao | string | Correction text |
linkXml | string | Receipt XML link |
linkDacce | string | DACCE link |
A correction letter only changes wording. Anything that changes a tax amount is out of scope: in those cases cancel and reissue within 24 hours, or issue a return invoice.
Can be corrected
Invoice remarks, the nature-of-operation wording and transport data: carrier, vehicle, volumes, delivery address.
{ "correcao": "Correcao do transportador: item (2) sem alteracao de valor" }
correcao* | string | Correction text |
* Required field
Cannot be corrected
Amounts, quantities, unit prices, tax bases and tax amounts, party documents and dates. SEFAZ refuses (10004016); use cancel plus reissue or a return invoice.
- The sequence is assigned by the platform; each letter supersedes the previous one at SEFAZ, and an invoice takes at most 20 (
10004015). - Window: up to 720 hours after authorization (
10004019). - There is no callback for correction letters; rely on the synchronous response or List correction letters.
tipoEvent type
| Values | Meaning |
|---|---|
| CartaCorrecao | Correction letter: fixes wording on an authorized invoice without changing tax amounts |
statusRegistration status
| Values | Meaning |
|---|---|
| Registrada | Registered with SEFAZ; the only status returned, because a refusal becomes error 10004016 |
| Code | HTTP | |
|---|---|---|
| 10004000 | 404 | The nfeId does not exist. Check the id sent at issuance and the empresaId. |
| 10004001 | 404 | The nfeId does not exist. Check the id sent at issuance and the empresaId. |
| 10003000 | 404 | empresaId does not exist or does not belong to this application. |
| 10004012 | 400 | Invoice not in Autorizada status. Query to confirm the status. |
| 10004015 | 400 | 20 letters already registered on the invoice. No further letters; cancel and reissue, or issue a return invoice. |
| 10004016 | 400 | Refused by SEFAZ; the message carries the status code and reason. Act on the reason. |
| 10004017 | 400 | Fewer than 15 characters after sanitising. Rewrite in Portuguese without accents. |
| 10004019 | 400 | Outside the 720-hour window after authorization. Cancel and reissue, or issue a return invoice. |
| 10001001 | 400 | Request field validation failed, one entry per field. Fix per mensagem. |