Empezar
Onboarding del punto de venta
Empresa → sucursal → punto de venta → certificado P12 → setup(). Una sola llamada lo deja listo.
- 1
Registra la empresa
Se hace una vez con tu backend (bootstrap). Recibes la X-API-Key del tenant. - 2
Crea sucursal y punto de venta
Desde el dashboard o con el SDK de gestión. Guarda el pointOfSaleId. - 3
Sube el P12
El SDK cifra y valida la cadena completa (legacy y moderno AES-256). - 4
setupPointOfSale
CUIS → sincronización de catálogos → CUFD → readiness. Idempotente.
index.ts
1// Alta completa del PDV en una llamada (idempotente):2// CUIS → catálogos → CUFD → readiness3const setup = await supay.onboarding.setupPointOfSale({ pointOfSaleId: POS_ID });4 5if (!setup.ready) {6 throw new Error("PDV no listo: revisa certificado o catálogos");7}8 9// Operaciones granulares si prefieres paso a paso:10await supay.cuis.request({ pointOfSaleId: POS_ID });11await supay.catalogs.sync({ pointOfSaleId: POS_ID });12await supay.cufd.request({ pointOfSaleId: POS_ID });Qué hace setup por dentro
Solicita CUIS si falta, sincroniza catálogos versionados por tenant (productos SIN, actividades, leyendas, paramétricas), solicita CUFD y devuelve `ready` con el detalle por chequeo. Si algo falla, el resultado indica qué paso corregir sin exponer SOAP.
Renovación automática
El CUFD se renueva ~4h antes de vencer y el CUIS a diario. Antes de emitir, el SDK valida vigencia y renueva si hace falta.