Conceptos
Permisos por módulo del perfil
Qué módulo del perfil de tu llave exige cada recurso, y qué responde la API cuando falta.
Tu llave tiene un perfil, y el perfil da acceso a módulos de Openbox Cloud. Cada operación
exige el módulo de su recurso: sin él responde 403 y no hace nada. El perfil lo configura el
equipo de Openbox Cloud cuando prepara tu empresa (Ambientes).
| Módulo del perfil | Recurso | Ejemplo |
|---|---|---|
| Clientes | Clientes | DisponibleGET /partners/v1/customers Ver operación en la Referencia → |
| Proveedores | Proveedores | DisponibleGET /partners/v1/providers Ver operación en la Referencia → |
| Servicios | Servicios | DisponibleGET /partners/v1/services Ver operación en la Referencia → |
| Inventarios | Productos | DisponibleGET /partners/v1/products Ver operación en la Referencia → |
| Facturación | Ventas: crear, consultar y anular · vendedores, zonas y condiciones de pago de venta | DisponiblePOST /partners/v1/invoices Ver operación en la Referencia → |
| Compras | Compras: crear y consultar · condiciones de pago de compra | DisponiblePOST /partners/v1/purchases Ver operación en la Referencia → |
La respuesta 403 de cada operación, en la Referencia, nombra el módulo que exige.
Qué responde sin permiso
{
"statusCode": 403,
"message": "No tienes acceso al modulo de Facturación."
}
El 403 tiene dos causas:
- El token no corresponde a una llave de API de Partners.
- El perfil de la llave no tiene el módulo del recurso, o la llave no tiene perfil o empresa asignados.
No se resuelve reintentando: pide al equipo de Openbox Cloud que agregue el módulo al perfil de tu llave (Errores).