Skip to main content
El token delegado es el JWT que el portal del SIN genera para que el sistema de CUCU facture a nombre de tu empresa. Vence una vez al año y es distinto en piloto (sandbox) y en producción.

Cargar o rotar el token

PUT /api/v3/admin/company/{companyId}/siat-token
cURL
Qué pasa, en orden. Hasta el último paso no se guarda nada:
  1. Si es el mismo token que ya está cargado, responde 200 con changed: false y no guarda nada. Si algún punto de venta quedó sin CUIS (un pedido anterior falló), se lo vuelve a pedir y aparece en pointsOfSale. Si el guardado tenía espacios alrededor o una empresa hermana tiene otro, se corrige y responde changed: true.
  2. Se leen los datos del token (los espacios y saltos de línea alrededor se ignoran; adentro, no): que no esté vencido ni por vencer, que sea de un sistema de CUCU, que esté delegado a CUCU y que el NIT sea el de tu empresa.
  3. Se prueba contra el SIN del mismo ambiente (piloto en sandbox, producción en producción) con una consulta real de CUIS, sin guardar nada.
  4. Se guarda el token cifrado, también en las empresas del mismo tenant con el mismo NIT y el mismo sistema (comparten la credencial), y se pide el CUIS de cada punto de venta de todas ellas que no tenga uno vigente.
Con tu API Key podés rotar el token del mismo sistema. Si el token es de otro sistema que el de tu empresa, el cambio lo hace CUCU (pedilo a soporte). Respuesta:
Un punto de venta rechazado no deshace la carga: el token ya pasó la prueba contra el SIN. El message dice qué contestó el SIN para ese punto de venta. Rotar el token se puede aunque haya eventos de contingencia abiertos o sin registrar: suele ser justo lo que los provocó. El cierre del evento, su registro y el envío del paquete toman el token nuevo en su próximo intento. El token nunca vuelve en una respuesta.

Errores

En todos los errores, el token anterior sigue cargado.

Cambio de sistema (CUCU)

Cuando el token es de otro sistema, la administración de CUCU lo carga con el mismo endpoint. El SIN lo prueba igual, y la respuesta es 409 TOKEN_SIAT_CAMBIO_DE_SISTEMA con tokenRef (el SHA-256 del token) y el codigoSistema nuevo en error.details. El cambio se hace con: PUT /api/v3/admin/company/{companyId}/siat-token/system-change
Pide confirmación humana. Al ejecutar valida y prueba el token de nuevo, guarda el token y el sistema en la empresa y en las empresas del mismo tenant con el mismo NIT y el mismo sistema anterior, y pide el CUIS de todos sus puntos de venta. Antes de guardar deja inactivos el CUIS y el CUFD del sistema anterior, así ninguna factura sale con códigos del sistema viejo. Con cada CUIS nuevo, el CUFD del punto de venta se pide enseguida, sin esperar a la primera factura. Con trabajo fiscal en curso (facturas que el SIN todavía no cerró, anulaciones en curso, eventos de contingencia abiertos o sin registrar, lotes masivos abiertos, paquetes enviándose) responde 409 TOKEN_SIAT_TRABAJO_PENDIENTE. Antes de la aprobación sólo se consulta al SIN; el CUIS se pide después. La referencia vive lo que una confirmación más unos minutos; si la ejecución falla (por ejemplo el SIN no responde) se puede volver a aprobar mientras viva, y se gasta cuando el cambio se guarda. Herramientas MCP gemelas: actualizarTokenSiat y cambiarSistemaTokenSiat.