Skip to navigation
Operaciones SIAT

CUIS y CUFD

Códigos que habilitan a tu punto de venta ante el SIAT. Sin CUIS no hay CUFD; sin CUFD vigente no se emite. Se renuevan automáticamente (job cada hora), pero estas rutas sirven para forzarlos y verificar vigencia.

En esta página aprenderás: setup idempotente, forzar CUIS/CUFD y leer vigencia · Prerrequisitos: POS creado (Onboarding) · Tiempo: ~5 min · ¿Términos nuevos? Glosario.

CódigoQué esVigencia típica
CUISHabilita el punto de ventaLarga (renovación automática)
CUFDHabilita emitir cada díaDiaria (renovación automática ~4h antes de vencer)

La vía recomendada es el setup idempotente (CUIS + CUFD + readiness de una vez). Estas rutas granulares son para forzar o diagnosticar.

// Setup idempotente: CUIS + CUFD + readiness (recomendado)
const setup = await supay.siat.setup({ point_of_sale_id: pos.id });
// setup.readiness.ready === true
// Granular: forzar CUIS y luego CUFD (requiere CUIS previo)
const cuis = await supay.siat.requestCuis({ pointOfSaleId: pos.id });
// cuis.cuis, cuis.fecha_vigencia
const cufd = await supay.siat.requestCufd({ pointOfSaleId: pos.id });
// cufd.data.cufd, cufd.data.fecha_vigencia, cufd.data.codigo_control

Errores típicos

SituaciónRespuesta
CUFD sin CUIS previo409 CONFLICT
SIAT caído503 SIAT_UNAVAILABLE — reintentar, no duplicar

Siguiente: Sincronización de catálogos.