Obtener contingencia
/api/v1/contingencias/:contingenciaIdObtiene una contingencia por UUID, limitada a la empresa y ambiente de X-API-Key. Requiere facturas.consultar. Incluye el estado de cada paquete, el código de recepción y los mensajes de validación persistidos por SIAT. Las facturas pasan a pendientevalidacion al registrar el código de recepción y sólo 908 las marca como aceptadas. En la etapa de recepción sólo se inicia la validación automática cuando SIAT devuelve 901, transaccion=true y un código de recepción; las respuestas contradictorias quedan en requiererevision. Si se pierde la respuesta o el proceso cae durante el envío, las facturas también pasan a pendientevalidacion para impedir una retransmisión automática. Los mensajes son del paquete: no se atribuyen a una factura porque la versión actual de go-siat no conserva el número de archivo ni de detalle. eventoincierto y requiererevision requieren conciliación; no vuelvas a transmitir automáticamente esos paquetes. observado y rechazado son estados terminales que requieren corregir/revisar la información antes de una acción manual. Responde 200, 401, 403 o 404.
X-API-KeyVer operaciones de Contingencias Contrato de la operación
Obtiene una contingencia por UUID, limitada a la empresa y ambiente de X-API-Key. Requiere facturas.consultar. Incluye el estado de cada paquete, el código de recepción y los mensajes de validación persistidos por SIAT. Las facturas pasan a pendiente_validacion al registrar el código de recepción y sólo 908 las marca como aceptadas. En la etapa de recepción sólo se inicia la validación automática cuando SIAT devuelve 901, transaccion=true y un código de recepción; las respuestas contradictorias quedan en requiere_revision. Si se pierde la respuesta o el proceso cae durante el envío, las facturas también pasan a pendiente_validacion para impedir una retransmisión automática. Los mensajes son del paquete: no se atribuyen a una factura porque la versión actual de go-siat no conserva el número de archivo ni de detalle. evento_incierto y requiere_revision requieren conciliación; no vuelvas a transmitir automáticamente esos paquetes. observado y rechazado son estados terminales que requieren corregir/revisar la información antes de una acción manual. Responde 200, 401, 403 o 404.
json
{"message":"contingencia obtenida correctamente","data":{"id":"00000000-0000-4000-8000-000000000001","puntoVentaId":"00000000-0000-4000-8000-000000000001","codigoMotivoEvento":2,"descripcion":"SIAT no responde desde las 10:00","estado":"observado","fechaHoraInicio":"2026-09-02T10:00:00Z","fechaHoraFin":"2026-09-02T11:00:00Z","creadoEn":"2026-09-02T10:00:00Z","actualizadoEn":"2026-09-02T11:00:00Z","paquetes":[{"numeroPaquete":0,"estado":"o...Ejemplo
Solicitud de ejemplo
export FALMUS_API_URL='https://staging-api.falmus.com/api/v1'
export FALMUS_API_KEY='flm_test_REEMPLAZA_CON_TU_CLAVE'
export CONTINGENCIA_ID='REEMPLAZA_CON_CONTINGENCIA_ID'
curl --request GET \
--url "$FALMUS_API_URL/contingencias/${CONTINGENCIA_ID}" \
--header "X-API-Key: $FALMUS_API_KEY"Este ejemplo no incluye un cuerpo. Revisa el contrato para conocer los parámetros de ruta y consulta.
Respuesta
Ejemplo de respuesta
application/json{
"message": "contingencia obtenida correctamente",
"data": {
"id": "00000000-0000-4000-8000-000000000001",
"puntoVentaId": "00000000-0000-4000-8000-000000000002",
"codigoMotivoEvento": 1,
"descripcion": "Interrupción temporal del servicio de internet",
"codigoEventoSiat": 987,
"estado": "aceptado",
"fechaHoraInicio": "2026-09-02T10:00:00Z",
"creadoEn": "2026-09-02T10:00:00Z",
"actualizadoEn": "2026-09-02T12:00:00Z",
"paquetes": [
{
"numeroPaquete": 1,
"estado": "aceptado",
"codigoEstado": 908,
"codigoRecepcion": "00000000-0000-4000-8000-000000000010",
"mensajesValidacion": [],
"actualizadoEn": "2026-09-02T12:00:00Z"
}
]
}
}Datos ficticios; los identificadores y valores cambian en cada respuesta.