Finalizar contingencia
/api/v1/contingencias/:contingenciaId/finalizarFinaliza la contingencia identificada por contingenciaId. Requiere X-API-Key con permiso facturas.crear y no recibe cuerpo.
X-API-KeyVer operaciones de Contingencias Contrato de la operación
Finaliza la contingencia identificada por contingenciaId. Requiere X-API-Key con permiso facturas.crear y no recibe cuerpo.
El evento debe pertenecer a la empresa y al ambiente de la clave y encontrarse en estado activo. Durante el cierre puede pasar a finalizando. La respuesta incluye codigoEventoSiat cuando el cierre queda registrado.
Consulta el estado de la contingencia y de sus facturas para verificar el resultado del cierre y el envío de los documentos pendientes.
Ejemplo
Solicitud de ejemplo
export FALMUS_API_URL='https://api.falmus.com/api/v1'
export FALMUS_API_KEY='flm_test_REEMPLAZA_CON_TU_CLAVE'
export CONTINGENCIA_ID='REEMPLAZA_CON_CONTINGENCIA_ID'
curl --request POST \
--url "$FALMUS_API_URL/contingencias/${CONTINGENCIA_ID}/finalizar" \
--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 finalizada 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": "finalizado",
"fechaHoraInicio": "2026-09-02T10:00:00Z",
"fechaHoraFin": "2026-09-02T12: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.