Onboarding del emisor

Antes de emitir tu primer comprobante necesitas dejar tu emisor (negocio) configurado: datos legales, firma electrónica y al menos un establecimiento. Este es el flujo paso a paso.

Paso 1 — Obtén tu API Key

Desde el panel, crea tu API Key en /app/api-keys y guárdala en tu gestor de secretos. Si todavía no la tienes, sigue Cómo empezar.

Paso 2 — Crea el negocio

curl -X POST https://www.factura-tor.com/api/businesses \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": 1,
    "environmentId": 1,
    "ruc": "0105678901001",
    "businessName": "Mi Empresa S.A.",
    "tradename": "Mi Empresa"
  }'

Guarda el id devuelto: es tu businessId para todas las llamadas siguientes.

Paso 3 — Sube la firma electrónica

Sube el archivo .p12 emitido por una entidad certificadora autorizada en Ecuador (BCE, Security Data, etc.). Opcionalmente, sube también el logo.

curl -X POST https://www.factura-tor.com/api/businesses/1/files \
  -H "X-API-Key: $API_KEY" \
  -F "sign=@/ruta/a/firma.p12" \
  -F "logo=@/ruta/a/logo.png"

Paso 4 — Verifica la firma

curl -X POST https://www.factura-tor.com/api/businesses/1/signature:verify \
  -H "X-API-Key: $API_KEY"

Si la firma es válida y está vigente, recibirás un 200.

Paso 5 — Crea al menos un establecimiento

curl -X POST https://www.factura-tor.com/api/establishments \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "businessId": 1,
    "code": "001",
    "address": "Av. 10 de Agosto N34-123, Quito",
    "open": true,
    "main": true
  }'

Paso 6 — Revisa el secuencial

Las secuencias se crean automáticamente al registrar el negocio. Consulta el estado actual y, solo si está desalineado con respecto al SRI, ajústalo:

curl -X GET "https://www.factura-tor.com/api/sequences?businessId=1" \
  -H "X-API-Key: $API_KEY"

Paso 7 — Carga catálogos en tu UI (opcional)

Para mostrar selectores de tipo de identificación, formas de pago e impuestos, consulta los catálogos y cachéalos localmente.