Consultar conciliación

Name: Facturalo API
Availability: InStock

Consulta el estado de una conciliación SIRE iniciada previamente con POST /conciliar. Hacer polling cada 10-15 segundos hasta COMPLETADO o ERROR.

GEThttps://api.facturalo.pe/api/v3/sire/conciliaciones/{conciliacionId}

Este endpoint sirve tanto para conciliaciones de ventas como de compras — el campo libro indica cuál es.

Estados

Estado	Descripción
PENDIENTE	Job encolado, aún no inició
EN_PROCESO	Descargando TXT y comparando
COMPLETADO	Resultado disponible en resultado
ERROR	Falló — ver errorMensaje. Se puede reintentar con POST /conciliar

Mientras procesa

200 OKjson

{
  "success": true,
  "message": "Estado de conciliación obtenido correctamente.",
  "data": {
    "conciliacionId": "550e8400-e29b-41d4-a716-446655440000",
    "periodo": "202605",
    "libro": "ventas",
    "estado": "EN_PROCESO",
    "createdAt": "2026-06-17T06:59:48.000000Z",
    "updatedAt": "2026-06-17T06:59:49.000000Z"
  }
}

Completado

200 OKjson

{
  "success": true,
  "message": "Estado de conciliación obtenido correctamente.",
  "data": {
    "conciliacionId": "aca34a6a-4073-4b29-8611-40662e532f77",
    "periodo": "202605",
    "libro": "ventas",
    "estado": "COMPLETADO",
    "createdAt": "2026-06-17T06:59:48.000000Z",
    "updatedAt": "2026-06-17T06:59:51.000000Z",
    "resultado": {
      "resumen": {
        "coinciden": 975,
        "totalSire": 1003,
        "soloEnSire": 5,
        "montoTotalSire": 305714.84,
        "totalFacturalo": 980,
        "diferenciaMonto": 514.84,
        "soloEnFacturalo": 3,
        "diferenciasMonto": 1,
        "diferenciasEstado": 2,
        "montoTotalFacturalo": 305200
      },
      "diferencias": [
        {
          "serie": "FE01",
          "montoSire": 590,
          "codTipoCDP": "01",
          "estadoSire": "ACTIVO",
          "correlativo": "4986",
          "tipoDiferencia": "ESTADO_DIFERENTE",
          "estadoFacturalo": "ANULADO",
          "montoFacturalo": 590
        },
        {
          "serie": "FE01",
          "montoSire": 1180,
          "codTipoCDP": "01",
          "estadoSire": "ACTIVO",
          "correlativo": "5001",
          "tipoDiferencia": "MONTO_DIFERENTE",
          "estadoFacturalo": "ACTIVO",
          "montoFacturalo": 1170
        },
        {
          "serie": "BL01",
          "montoSire": 48,
          "codTipoCDP": "03",
          "estadoSire": "ACTIVO",
          "correlativo": "243",
          "tipoDiferencia": "SOLO_EN_SIRE"
        }
      ]
    }
  }
}

Error

200 OKjson

{
  "success": true,
  "message": "Estado de conciliación obtenido correctamente.",
  "data": {
    "conciliacionId": "550e8400-e29b-41d4-a716-446655440000",
    "periodo": "202605",
    "libro": "ventas",
    "estado": "ERROR",
    "createdAt": "2026-06-17T06:59:48.000000Z",
    "updatedAt": "2026-06-17T07:09:52.000000Z",
    "errorMensaje": "El ticket SIRE 20260300000145 no terminó en 10 minutos."
  }
}

Tipos de diferencia

tipoDiferencia	Descripción
ESTADO_DIFERENTE	Existe en ambos pero con estado distinto (ej: ANULADO en Facturalo, ACTIVO en SIRE)
MONTO_DIFERENTE	Existe en ambos pero la diferencia de monto supera S/ 0.10
SOLO_EN_SIRE	SUNAT tiene el comprobante pero no está en Facturalo
SOLO_EN_FACTURALO	Facturalo tiene el comprobante pero SUNAT no lo incluye en la propuesta