Consultar Estados
Servicio para consultar los estados de un comprobante electrónico. Retorna tres estados independientes: el estado ante SUNAT, el estado de declaración del comprobante y el estado de entrega al receptor por correo.
https://jarvis.tefacturo.pe/consulta-api/invoice2u/integracion/consultarEstado/{ruc}Consulta el estado completo de un comprobante electrónico. Retorna información sobre la aceptación por SUNAT, el estado de declaración y el estado de entrega por correo electrónico.
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íe los datos de identificación del comprobante cuyo estado desea consultar:
Respuesta Exitosa (200)
La respuesta incluye tres estados independientes (estadoSunat, estadoComprobante, estadoEntrega), cada uno devuelto como un objeto con codigo y valor. Además incluye serieNumero (serie-número del comprobante) y respuestaDeclaracion, un string JSON con el detalle textual de la declaración (codigo y mensaje).
En las tablas siguientes, el código 1 corresponde al estado confirmado. Un guion (—) indica que el código de ese estado está por confirmar.
Estado SUNAT (estadoSunat)
Indica la respuesta oficial de SUNAT respecto al comprobante electrónico:
| Código | Valor | Descripción |
|---|---|---|
| 1 | Aceptado | SUNAT aceptó el comprobante sin observaciones. Es válido fiscalmente. |
| — | Aceptado con observaciones | SUNAT aceptó el comprobante, pero con observaciones. Es válido, pero debe corregirlas en futuras emisiones. |
| — | Rechazado | SUNAT rechazó el comprobante. No es válido fiscalmente y debe ser corregido y reenviado. |
| — | Pendiente | El comprobante aún no ha sido procesado por SUNAT. Puede estar en cola de envío. |
Estado Comprobante - Declaración (estadoComprobante)
Indica el estado de declaración del comprobante en el sistema:
| Código | Valor | Descripción |
|---|---|---|
| 1 | Declarado | El comprobante fue declarado exitosamente ante SUNAT. |
| — | Por declarar | El comprobante está pendiente de ser declarado ante SUNAT. |
| — | En proceso | El comprobante está en proceso de declaración. |
| — | Error de declaración | Ocurrió un error durante la declaración. Consulte el detalle para más información. |
Estado Entrega - Correo (estadoEntrega)
Indica si el comprobante fue enviado por correo electrónico al receptor:
| Código | Valor | Descripción |
|---|---|---|
| 1 | Entregado | El comprobante fue enviado exitosamente al correo del receptor. |
| — | Pendiente de envío | El envío por correo está pendiente. |
| — | Error de envío | No se pudo enviar el correo al receptor. Verifique la dirección de correo. |
| — | No aplica | No se configuró correo de entrega para este comprobante. |
Manejo de Errores
| Código | Estado | Descripción |
|---|---|---|
| 400 | Bad Request | Datos de consulta incorrectos o incompletos. |
| 401 | Unauthorized | Token de autenticación inválido o expirado. |
| 404 | Not Found | No se encontró el comprobante con los datos proporcionados. |
| 500 | Internal Server Error | Error interno del servidor. Intente nuevamente. |