Solicitud del CUIS en ambiente piloto: parámetros del mensaje y de la respuesta
El CUIS (Código Único de Inicio de Sistema) es el código que habilita al sistema de facturación para emitir documentos ante el SIAT. Se solicita al servicio FacturacionCodigos mediante el método cuis. En el ambiente piloto se usa el mismo servicio, con codigoAmbiente igual a 2 (SIAT Info – Solicitud CUIS; WSDL del servicio FacturacionCodigos en piloto). Según los códigos de autorización del SIAT, el CUIS tiene vigencia de 365 días.
Campos de la solicitud
| Campo | Qué representa | Observación |
|---|---|---|
| codigoAmbiente | Ambiente en el que se opera | 2 corresponde al ambiente piloto (pruebas). |
| codigoModalidad | Modalidad de facturación para la que se pide el código | Debe coincidir con la modalidad asignada al contribuyente. Verifique el valor en la consulta de modalidad del SIAT. |
| codigoSucursal | Número de sucursal | Debe corresponder a la sucursal registrada. |
| codigoPuntoVenta | Punto de venta | Campo opcional en el esquema; con el valor que corresponda a la sucursal o punto de venta registrado. |
| codigoSistema | Identificador del sistema de facturación | Lo asigna el proceso de autorización del sistema. |
| nit | NIT del contribuyente | Debe ser el NIT asociado al sistema en ese ambiente. |
Qué devuelve el servicio
Una respuesta exitosa (cuisResponse) incluye:
- codigo: el CUIS asignado, que se guarda para los siguientes envíos.
- fechaVigencia: fecha y hora de vencimiento, en formato ISO con zona horaria (por ejemplo,
AAAA-MM-DDTHH:MM:SS.mmm-04:00). - transaccion:
trueindica que la operación fue aceptada.
Qué revisar
- Confirme que
codigoAmbientesea 2 cuando la prueba se hace en piloto, y 1 en producción (así lo indica la documentación del ambiente). - Si la respuesta trae un código de error como el 980 (ya existe un CUIS vigente para la sucursal o punto de venta), consulte el artículo específico sobre ese error antes de volver a solicitar.
- Guarde el CUIS y su fecha de vigencia. Cuando venza, debe solicitarse uno nuevo; los CUFD se piden después, según el CUIS vigente.
- No publique el NIT, el
codigoSistemani los códigos recibidos en capturas o foros. Use datos de prueba al compartir ejemplos.
Nota: los valores numéricos de codigoModalidad, codigoPuntoVenta y codigoSucursal del ejemplo corresponden a un caso de prueba y no deben copiarse sin verificarlos con la modalidad y la sucursal propias.
1 captura(s) del caso no se publican porque contienen datos personales.
Fuentes y normativa
- Códigos de Autorización (SIN)
- Solicitud CUIS (servicio web) (SIN)
- WSDL Servicio FacturacionCodigos v2 (piloto/pruebas) (SIN)
Ante cualquier diferencia, prevalece la normativa vigente publicada por el Servicio de Impuestos Nacionales (SIN).