NF-e
Registrar carta de corrección
Registra una carta de corrección (CC-e) en una factura autorizada; el protocolo se devuelve de forma síncrona.
/openapi/v2/empresas/{empresaId}/nf-e/{nfeId}/carta-correcaotoken, timestamp y sign, vea Autenticación.Registra una carta de corrección en una factura autorizada. La llamada es síncrona: HTTP 200 se devuelve solo después de que la SEFAZ registra el evento, y el cuerpo de la respuesta es el resultado; no interviene ningún callback. Los errores de autenticación (10009xxx) están en Autenticación.
Parámetros de ruta
empresaId* | string | Identificador de la empresa |
nfeId* | string | Identificador de la factura |
* Campo obligatorio
Cuerpo de la petición
correcao* | string | Texto de la corrección |
* Campo obligatorio
chaveAcesso | string | Clave de acceso de la factura corregida |
tipo | string | Tipo del evento |
codigo | string | Código del evento en la SEFAZ |
sequencia | int | Secuencia de la carta |
status | string | Estado del registro |
motivo | string | Respuesta de la SEFAZ |
protocolo | string | Protocolo del evento |
data | string | Fecha del registro |
correcao | string | Texto de la corrección |
linkXml | string | Enlace del XML del recibo |
linkDacce | string | Enlace del DACCE |
La carta de corrección solo cambia texto. Todo lo que cambie un importe de tributo queda fuera: en esos casos cancele y reemita dentro de 24 horas, o emita una factura de devolución.
Puede corregirse
Observaciones de la factura, el texto de la naturaleza de la operación y los datos de transporte: transportista, vehículo, volúmenes, dirección de entrega.
{ "correcao": "Correcao do transportador: item (2) sem alteracao de valor" }
correcao* | string | Texto de la corrección |
* Campo obligatorio
No puede corregirse
Importes, cantidades, precios unitarios, bases e importes de tributo, documentos de las partes y fechas. La SEFAZ rechaza (10004016); use cancelación con reemisión o factura de devolución.
- La secuencia la asigna la plataforma; cada carta sustituye a la anterior en la SEFAZ, y la factura admite como máximo 20 (
10004015). - Ventana: hasta 720 horas después de la autorización (
10004019). - No hay callback para cartas de corrección; use la respuesta síncrona o Listar cartas de corrección.
tipoTipo del evento
| Valores | Significado |
|---|---|
| CartaCorrecao | Carta de corrección: corrige textos de una factura autorizada sin cambiar importes de tributo |
statusEstado del registro
| Valores | Significado |
|---|---|
| Registrada | Registrada en la SEFAZ; el único estado devuelto, porque el rechazo se convierte en error 10004016 |
| Código | HTTP | |
|---|---|---|
| 10004000 | 404 | El nfeId no existe. Verifique el id enviado en la emisión y el empresaId. |
| 10004001 | 404 | El nfeId no existe. Verifique el id enviado en la emisión y el empresaId. |
| 10003000 | 404 | empresaId no existe o no pertenece a esta aplicación. |
| 10004012 | 400 | La factura no está en estado Autorizada. Consulte para confirmar el estado. |
| 10004015 | 400 | Ya hay 20 cartas registradas en la factura. No caben más; cancele y reemita, o emita factura de devolución. |
| 10004016 | 400 | Rechazada por la SEFAZ; el mensaje trae el código de estado y el motivo. Actúe según el motivo. |
| 10004017 | 400 | Menos de 15 caracteres tras el saneado. Reescriba en portugués sin acentos. |
| 10004019 | 400 | Fuera de la ventana de 720 horas tras la autorización. Cancele y reemita, o emita factura de devolución. |
| 10001001 | 400 | Falló la validación de campos, una entrada por campo. Corrija según mensagem. |