Consultar XML
Servicio para obtener el XML de un comprobante electrónico previamente emitido. La respuesta es un objeto JSON cuyo campo xmlFirma contiene el valor en base64.
https://jarvis.tefacturo.pe/consulta-api/invoice2u/integracion/consultarXml/{ruc}Reemplaza {ruc} con el RUC del emisor. Una solicitud exitosa devuelve un objeto JSON con el identificador del comprobante, el XML en base64 dentro de xmlFirma y el campo hashCode.
Headers
| Header | Valor | Descripción |
|---|---|---|
| Authorization | Bearer {token} | Token de autenticación obtenido del endpoint de login |
| Content-Type | application/json | Tipo de contenido del cuerpo de la solicitud |
Cuerpo de la Solicitud
Envía los datos de identificación del comprobante. El siguiente ejemplo corresponde a la solicitud documentada en la sección 6.5 del manual de integración.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| emisor | number | Sí | RUC del emisor (sin comillas) |
| numero | number | Sí | Número correlativo del comprobante |
| serie | string | Sí | Serie del comprobante |
| tipoComprobante | string | Sí | Código del tipo de comprobante: 01 factura, 03 boleta, 07 nota de crédito u 08 nota de débito |
Respuesta Exitosa (200)
El cuerpo de la respuesta es un objeto JSON. Lee la propiedad xmlFirma para obtener el XML del comprobante solicitado codificado en base64.
Nota: El valor de xmlFirma está abreviado en el ejemplo. La respuesta real de la API contiene el valor base64 completo.
| Campo | Tipo | Descripción |
|---|---|---|
| serieNumero | string | Serie y número del comprobante. |
| xmlFirma | string | XML del comprobante codificado en base64. |
| hashCode | string | null | Hash devuelto por el servicio; puede ser null. |
Manejo de Errores
Según el manual de integración, el servicio puede devolver 401, 403, 404 o 500. La mayoría de los errores de consulta ocurren cuando faltan campos obligatorios o sus valores no corresponden al comprobante solicitado.
| Código | Estado | Descripción |
|---|---|---|
| 401 | Unauthorized | La solicitud no cuenta con una autenticación válida. |
| 403 | Forbidden | Las credenciales autenticadas no tienen acceso al recurso solicitado. |
| 404 | Not Found | No se encontró el comprobante con los datos proporcionados. |
| 500 | Internal Server Error | Error interno del servidor. Intente nuevamente. |