Comparar propuesta con el sistema
GET /api/sire/{sire_type}/tickets/{sire_ticket}/comparison
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Descarga la propuesta del ticket terminado y la cruza con el sistema: comprobantes (ventas) o compras. {sire_type}: sale (Registro de Ventas, RVIE) o purchase (Registro de Compras, RCE).
Cruce por serie y número, priorizando el mismo tipo de comprobante; en compras además por RUC del proveedor (dos proveedores pueden repetir serie y número).
data.rows[]: una fila por comprobante de la propuesta con status:
match: existe y el total coincide.total_mismatch: existe con otro total (detalle endifferences.total).not_in_system: está en SUNAT y no en el sistema.
differences.date_of_issue avisa si la fecha difiere (no cambia el estado). data.only_in_system[]: comprobantes del periodo en el sistema que la propuesta no trae (ventas: facturas, boletas y notas 01/03/07/08 que no estén rechazadas ni anuladas; compras: todas salvo anuladas). data.summary: conteos y totales.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
period |
string | Sí | Periodo AAAAMM del ticket. |
page |
integer | No | Página de la consulta del ticket (por defecto 1). |
Quién puede usarlo: administradores y usuarios con el nivel de acceso Resumen de cuentas (account_summary), el mismo que exige el panel en SIRE.
Formato de respuesta: estándar {success, data, message?} con códigos HTTP reales.
Límite: 10 peticiones por minuto.
Errores: 409 SUNAT aún no termina (trae status_code y status); 404 ticket sin registros. Errores comunes: 422 faltan las credenciales SUNAT de la empresa o SUNAT las rechazó; 502 SUNAT respondió con error (su cuerpo va en sunat_error y su código en sunat_code); 504 no hubo conexión con SUNAT; 403 sin permiso.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
sire_type |
ruta | sí | sale |
|
sire_ticket |
ruta | sí | 20260300000077 |
|
period |
query | sí | 202610 |
Periodo tributario AAAAMM (obligatorio) |
Respuestas
200 — Comparación
{
"success": true,
"data": {
"type": "sale",
"period": "202610",
"ticket": "20260300000077",
"rows": [
{
"status": "match",
"sunat": {
"car": "20123456789010F00100000123",
"date_of_issue": "05/10/2026",
"date_of_issue_iso": "2026-10-05",
"document_type_id": "01",
"series": "F001",
"number": 123,
"party_identity_document_type_id": "6",
"party_number": "20100000001",
"party_name": "CLIENTE S.A.C.",
"total": 118.0,
"total_raw": "118.00"
},
"system": {
"id": 5521,
"external_id": "0b6a1e7c-3f1d-4c4e-9a52-7b1f0d9c2e11",
"document_type_id": "01",
"series": "F001",
"number": 123,
"date_of_issue": "2026-10-05",
"party_number": "20100000001",
"party_name": "CLIENTE S.A.C.",
"currency_type_id": "PEN",
"state_type_id": "05",
"total": 118.0
},
"differences": []
},
{
"status": "not_in_system",
"sunat": {
"car": "20123456789010F00100000124",
"date_of_issue": "06/10/2026",
"date_of_issue_iso": "2026-10-06",
"document_type_id": "01",
"series": "F001",
"number": 124,
"party_identity_document_type_id": "6",
"party_number": "20100000002",
"party_name": "OTRO CLIENTE S.A.C.",
"total": 50.0,
"total_raw": "50.00"
},
"system": null,
"differences": []
}
],
"only_in_system": [],
"summary": {
"sunat_count": 2,
"match": 1,
"total_mismatch": 0,
"not_in_system": 1,
"only_in_system": 0,
"sunat_total": 168.0,
"system_total": 118.0
}
}
}
409 — Aún en proceso
{
"success": false,
"message": "SUNAT aún no termina de generar la propuesta.",
"status_code": "02",
"status": "En proceso"
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.