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.

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

Requiere las cabeceras de firma token, timestamp y sign, vea Autenticación.

Registra una carta de corrección (evento 110110) 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

Parámetros de ruta

empresaIdstringobligatorio
Identificador de la empresa devuelto en Registrar empresa.
Ejemplo: 1934811222334455
nfeIdstringobligatorio
El id enviado en la emisión.
Ejemplo: NFe-000014553

Cuerpo de la petición

correcaostringobligatorio
Texto de la corrección, 15–1000 caracteres tras el saneado (acentos eliminados, ASCII imprimible conservado; los dos puntos, paréntesis y signos de porcentaje se mantienen). Solo puede corregirse información que no afecte a los importes tributarios (observaciones, texto de la naturaleza de la operación, datos de transporte). Importes, cantidades, precios unitarios, bases y valores de tributos, documentos de las partes y fechas deben pasar por cancelación + reemisión o factura de devolución; la SEFAZ no valida la semántica y el emisor es el responsable.
Ejemplo: Correcao do transportador: item (2) sem alteracao de valor

Respuestas

200

Evento registrado en la SEFAZ.

chaveAcessostring
Clave de acceso de la NF-e corregida.
tipostring
Fijo CartaCorrecao.
codigostring
Fijo 110110.
sequenciainteger
Número de secuencia nSeq de esta carta.
statusstring
Fijo Registrada.
motivostring
Código de estado y descripción de la SEFAZ.
protocolostring
Número del protocolo del evento.
datastring
Momento del registro en la SEFAZ, ISO-8601 UTC.
correcaostring
Texto saneado realmente enviado a la SEFAZ.
linkXmlstring
Enlace de descarga del XML de recibo procEventoNFe, vea Descarga de archivos.
linkDaccestring
Enlace de descarga del DACCE (PDF de la carta de corrección, vea Descarga de archivos); vacío cuando el servicio de renderizado no está disponible, reintente mediante el endpoint de listado.

Errores

Código	HTTP
NFe0001	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 autorizado. Consulte para confirmar el estado.
10004015	400	Ya hay 20 cartas registradas en la factura. No caben más cartas; cancele + reemita o emita factura de devolución.
10004016	400	Rechazada por la SEFAZ (código de estado y motivo adjuntos). Actúe según el motivo de la SEFAZ.
10004017	400	Menos de 15 caracteres tras el saneado. Reescriba en portugués / ASCII.
10004019	400	Fuera de la ventana de 720 horas tras la autorización. Solo queda cancelar + reemitir o emitir factura de devolución.
10001001	400	Falló la validación de campos (una entrada por campo). Corrija según `mensagem`.

Reglas

Solo facturas Autorizada (10004012 en caso contrario).
Dentro de las 720 horas siguientes a la autorización (10004019).
Como máximo 20 cartas por factura (10004015); los números de secuencia los asigna la plataforma y cada carta sustituye a la anterior en el lado de la SEFAZ, conservando todo el historial.
Texto con menos de 15 caracteres tras el saneado: 10004017.
Rechazo de la SEFAZ: 10004016 con el código de estado y el motivo de la SEFAZ.
Todavía no existe el callback invoice.cce.registered; use la respuesta síncrona o Listar cartas de corrección.