Autenticación

Cómo autenticarte en Facturalo API. Tokens de usuario (user_sk_), empresa demo (sk_test_) y producción (sk_live_). Sin Bearer, sin OAuth. El entorno se detecta del prefijo del token.

Todos los endpoints requieren un token de API en el header Authorization. No se usa el esquema Bearer — envía el token directamente.

¿Qué tipos de token usa Facturalo API?

user_sk_... — Cuenta — Gestión de empresas y establecimientos. Obtenido al registrarte en la plataforma.
sk_test_... — Empresa · Demo — Emite comprobantes en el entorno de pruebas SUNAT. Generado al crear una empresa.
sk_live_... — Empresa · Producción — Emite comprobantes en producción SUNAT. Generado al crear una empresa.

¿Cómo se envía el token de empresa?

Headers requeridoshttp

Authorization: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

¿Cuándo usar el token de usuario?

Header para endpoints de cuentahttp

Authorization: user_sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

¿Cómo hacer la primera llamada a la API?

cURL con token de empresabash

-primary-dark)">curl https://api.facturalo.pe/api/v3/documentos/enviar \
  -H "Authorization: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

Seguridad: nunca expongas los tokens en frontend o código público. Usa variables de entorno. Si un token fue comprometido, regenéralo en POST /empresas/ {uuid} /token/regenerar.