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 perfilRecursoEjemplo
ClientesClientesDisponibleGET /partners/v1/customers Ver operación en la Referencia →
ProveedoresProveedoresDisponibleGET /partners/v1/providers Ver operación en la Referencia →
ServiciosServiciosDisponibleGET /partners/v1/services Ver operación en la Referencia →
InventariosProductosDisponibleGET /partners/v1/products Ver operación en la Referencia →
FacturaciónVentas: crear, consultar y anular · vendedores, zonas y condiciones de pago de ventaDisponiblePOST /partners/v1/invoices Ver operación en la Referencia →
ComprasCompras: crear y consultar · condiciones de pago de compraDisponiblePOST /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:

  1. El token no corresponde a una llave de API de Partners.
  2. 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).

Copyright © 2026