Empezar

Onboarding del punto de venta

Empresa → sucursal → punto de venta → certificado P12 → setup(). Una sola llamada lo deja listo.

  1. 1

    Registra la empresa

    Se hace una vez con tu backend (bootstrap). Recibes la X-API-Key del tenant.
  2. 2

    Crea sucursal y punto de venta

    Desde el dashboard o con el SDK de gestión. Guarda el pointOfSaleId.
  3. 3

    Sube el P12

    El SDK cifra y valida la cadena completa (legacy y moderno AES-256).
  4. 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 → readiness
3const 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.