Buscar contingencias

POST/api/v1/contingencias/buscar

Lista contingencias de todas las sucursales de la empresa en el ambiente de la X-API-Key. Requiere facturas.consultar.

Header requerido X-API-KeyVer operaciones de Contingencias

Contrato de la operación

Lista contingencias de todas las sucursales de la empresa en el ambiente de la X-API-Key. Requiere facturas.consultar.

page inicia en 0; size admite hasta 100. sortBy acepta fechaHoraInicio o estado; sortDir acepta asc o desc. El filtro disponible es estado. Los estados incluyen activo, finalizando, evento_incierto, finalizado, enviando, aceptado, observado, rechazado y requiere_revision. observado/rechazado indican que un paquete necesita corrección o revisión. evento_incierto y requiere_revision no se reintentan automáticamente; consulta el detalle de la contingencia para ver el resultado por paquete. Responde 200, 400, 401, 403 o 404.

Ejemplo

Solicitud de ejemplo

Clave ficticia; no se ejecuta desde esta página

JSON · cuerpo de solicitud

{
  "page": 0,
  "size": 20,
  "sortBy": "fechaHoraInicio",
  "sortDir": "desc",
  "filters": {}
}

Respuesta

Ejemplo de respuesta

200 OKapplication/json

JSON

{
  "message": "contingencias obtenidas correctamente",
  "data": {
    "content": [
      {
        "id": "00000000-0000-4000-8000-000000000001",
        "puntoVentaId": "00000000-0000-4000-8000-000000000001",
        "codigoMotivoEvento": 2,
        "descripcion": "SIAT no responde desde las 10:00",
        "estado": "activo",
        "fechaHoraInicio": "2026-09-02T10:00:00Z",
        "creadoEn": "2026-09-02T10:00:00Z",
        "actualizadoEn": "2026-09-02T10:00:00Z"
      }
    ],
    "page": 0,
    "size": 20,
    "totalElements": 1,
    "totalPages": 1
  }
}

Datos ficticios; los identificadores y valores cambian en cada respuesta.

Volver a Contingencias