Descargar el mensaje de Hacienda de factura de compra
GET /api/v1/facturas-compra/{clave}/respuesta
Devuelve el XML de respuesta de Hacienda de la factura de compra: el acuse firmado por el Ministerio donde consta si el comprobante fue aceptado o rechazado, y por qué motivo. Mismo comportamiento que GET /facturas/{clave}/respuesta, aplicado al espacio de claves de tipo 08.
Es un documento distinto del que se obtiene en Descargar XML de factura de compra — aquel corresponde al comprobante propio, firmado por quien lo emite — y es el que sirve como prueba ante una auditoría de que Hacienda lo recibió y qué resolvió.
Autenticación y permisos
| Atributo | Valor |
|---|---|
| Esquema | API key (X-Api-Key) |
| Scope requerido | facturas-compra:read |
Respuestas
200 OK
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Disposition: attachment; filename="50615012600310112345600100001080000000123456789012_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.
404 Not Found
{ "error": "Comprobante no encontrado." }La clave no corresponde a ninguna factura de compra del tenant, o corresponde a un documento que no es de tipo 08.
Notas operativas
- Una factura de compra
rechazadasí tiene respuesta: el XML es justamente donde Hacienda explica el motivo del rechazo. El202no significa rechazo, significa que todavía no contestó. - El acuse llega de forma automática, sin necesidad de solicitarlo. Ver también Descargar el mensaje de Hacienda para el mismo comportamiento del lado de ventas.