API Facturador
Documentación de la API de cada empresa (tenant). Emite comprobantes electrónicos, gestiona clientes, productos, inventario y guías.
No confundir con la API Administrador: aquella corre en el host central y usa el token del reseller. Esta API corre en el subdominio de la empresa.
Servidor
La base URL es el FQDN del tenant:
| Entorno | URL |
|---|---|
| Empresa | https://{subdominio}.{tu-dominio} |
Ejemplo: si el facturador abre en https://miempresa.pro.uio.la, las rutas son https://miempresa.pro.uio.la/api/documents, etc.
Autenticación
HTTP Bearer con el api_token del usuario del tenant.
Authorization: Bearer <api_token>
El token se copia en el facturador: Configuración → Usuarios (campo de solo lectura api_token). No uses el token de POST /api/login del panel administrador.
Guardia
Los endpoints de esta sección requieren auth:api sobre el hostname del tenant. Un token válido de otra empresa o del system devolverá 401.
Comprobantes
La mayoría de CPE (factura, boleta, notas) se emiten con POST /api/documents. Cambia codigo_tipo_documento y el payload: cada página de Facturas, Boletas y Notas es un escenario de ese mismo endpoint.
Respuesta habitual
Tras emitir un CPE el API suele devolver external_id y enlaces de descarga XML / PDF / CDR.
Clientes generados
Cada sección de esta API está vinculada al método equivalente del cliente. El código vive en sdks/ y se regenera con bash scripts/generate-api-sdks.sh.