Descargar el mensaje de Hacienda

GET /api/v1/facturas/{clave}/respuesta

Devuelve el XML de respuesta de Hacienda: el acuse firmado por el Ministerio donde consta si el comprobante fue aceptado o rechazado, y por qué motivo.

Es un documento distinto del que se obtiene en Descargar XML — aquel corresponde al comprobante propio del emisor, firmado por él — y es el que sirve como prueba ante una auditoría de que Hacienda lo recibió y qué resolvió.

Autenticación y permisos

Funciona para los cuatro tipos: FE, TE, NC y ND.

Respuestas

200 OK

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Disposition: attachment; filename="50615012600310112345600100001010000000123456789012_Respuesta.xml"

202 Accepted — todavía no hay respuesta

{ "mensaje": "El comprobante existe pero Hacienda todavía no ha respondido." }

El acuse de Hacienda llega de forma asíncrona, minutos después de emitir. Este estado significa “aún no hay respuesta; debe reintentarse”, no “no existe” — por esa razón no es un 404. Si se devolviera 404 en ambos casos, no habría forma de distinguir un comprobante recién emitido de una clave equivocada.

404 Not Found

{ "error": "Comprobante no encontrado." }

La clave no corresponde a ningún comprobante del tenant.

Notas operativas

• Un comprobante rechazado sí tiene respuesta: el XML es justamente donde Hacienda explica el motivo del rechazo. El 202 no significa rechazo, significa que todavía no contestó.
• El acuse llega de forma automática, sin necesidad de solicitarlo: si se configuraron webhooks, el evento notifica cuando el comprobante quedó resuelto, y ese es el momento de descargar este XML.

La misma descarga para factura de compra

GET /api/v1/facturas-compra/{clave}/respuesta

Con scope facturas-compra:read, y con el mismo comportamiento: 200 con el XML, 202 mientras Hacienda no conteste, 404 si la clave no existe.

Desde v1.5 la factura de compra también tiene su XML firmado, que antes faltaba — solo estaba el PDF:

GET /api/v1/facturas-compra/{clave}/xml