Cargar o rotar el token
PUT /api/v3/admin/company/{companyId}/siat-token
cURL
- Si es el mismo token que ya está cargado, responde
200conchanged: falsey no guarda nada. Si algún punto de venta quedó sin CUIS (un pedido anterior falló), se lo vuelve a pedir y aparece enpointsOfSale. Si el guardado tenía espacios alrededor o una empresa hermana tiene otro, se corrige y respondechanged: true. - 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.
- 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.
- 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.
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 es409 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
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.