Autenticación

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
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.