Saltar al contenido
Facturador

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 en differences.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.