Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cucu.bo/llms.txt

Use this file to discover all available pages before exploring further.

​
Que es la contingencia?

El modo contingencia permite seguir emitiendo facturas cuando el SIAT no responde. Las facturas se almacenan localmente y se envian al SIAT cuando el servicio se restablece.
La contingencia es un mecanismo regulado por el SIN. Solo debe activarse cuando hay una interrupcion real del servicio SIAT.

​
Cuando activar contingencia

MotivoCodigoDescripcion
Corte de internet1Sin conexion a internet
Falla SIAT2El SIAT no responde
Virus informatico3Sistema comprometido
Otro4Causa no especificada

​
Flujo de contingencia

​
1. Detectar caida del SIAT

# Verificar conexion
curl -X GET https://sandbox.cucu.bo/api/v1/events/check-connection \
  -H "X-API-Key: tu_api_key"
Si retorna false, el SIAT no esta disponible.

​
2. Iniciar evento de contingencia

curl -X POST https://sandbox.cucu.bo/api/v1/events/start \
  -H "Content-Type: application/json" \
  -H "X-API-Key: tu_api_key" \
  -d '{
    "posId": "uuid-del-pos",
    "branchId": "uuid-de-sucursal",
    "codigoMotivo": 2,
    "descripcion": "SIAT no responde"
  }'

​
3. Emitir facturas normalmente

Durante la contingencia, las facturas se emiten con emissionType: "CONTINGENCY". El proceso es identico al normal: 
curl -X POST https://sandbox.cucu.bo/api/v1/invoices \
  -H "Content-Type: application/json" \
  -H "X-API-Key: tu_api_key" \
  -d '{ ... mismos datos de siempre ... }'

​
4. Finalizar contingencia

Cuando el SIAT se restablece: 
curl -X POST https://sandbox.cucu.bo/api/v1/events/end \
  -H "Content-Type: application/json" \
  -H "X-API-Key: tu_api_key" \
  -d '{
    "posId": "uuid-del-pos",
    "branchId": "uuid-de-sucursal",
    "eventoId": "uuid-del-evento"
  }'
Las facturas emitidas en contingencia se envian automaticamente al SIAT para validacion.

​
Consideraciones

  • Las facturas en contingencia tienen validez fiscal una vez enviadas al SIAT
  • El SIN permite hasta 48 horas de contingencia
  • Debes registrar el evento con motivo valido
  • Al finalizar, todas las facturas pendientes se procesan automaticamente