Iniciar contingencia

POST/api/v1/contingencias

Registra una contingencia local para una sucursal y punto de venta. Requiere X-API-Key con facturas.crear.

Header requerido X-API-KeyVer operaciones de Contingencias

Contrato de la operación

Registra una contingencia local para una sucursal y punto de venta. Requiere X-API-Key con facturas.crear.

puntoVentaId es el UUID de un punto activo de la empresa. El servidor resuelve su sucursal; no se envía branchId. codigoMotivoEvento debe ser entero positivo; para corte de internet usa 1. descripcion admite de 3 a 500 caracteres.

El servidor obtiene desde la integración activa el CUIS, CUFD de evento, NIT, ambiente, códigos de sistema/sucursal/punto de venta y la fecha UTC de inicio. Por seguridad y consistencia, esos datos no forman parte del contrato público. Sólo puede existir una contingencia activa por empresa, ambiente y punto de venta. Responde 201, 400, 401, 403, 409, 422 o 503.

Ejemplo

Solicitud de ejemplo

Clave ficticia; no se ejecuta desde esta página

JSON · cuerpo de solicitud

{
  "puntoVentaId": "{{puntoVentaId}}",
  "codigoMotivoEvento": 1,
  "descripcion": "CORTE DEL SERVICIO DE INTERNET"
}

Respuesta

Ejemplo de respuesta

201 Createdapplication/json

JSON

{
  "message": "contingencia iniciada correctamente",
  "data": {
    "id": "00000000-0000-4000-8000-000000000001",
    "puntoVentaId": "00000000-0000-4000-8000-000000000001",
    "codigoMotivoEvento": 1,
    "descripcion": "CORTE DEL SERVICIO DE INTERNET",
    "estado": "activo",
    "fechaHoraInicio": "2026-09-02T10:00:00Z",
    "creadoEn": "2026-09-02T10:00:00Z",
    "actualizadoEn": "2026-09-02T10:00:00Z"
  }
}

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

Volver a Contingencias