Integraciones

Desde Sistema / Integraciones se consultan los tipos disponibles y se activa el acceso para la organización. El listado muestra el estado de activación; el engranaje abre su configuración. Los nombres pueden variar según el idioma del panel.

Elegir la API

API	Para quién	Quién genera el token
Platform API (API)	Sistemas de la organización o integradores contratados	Administrador autorizado desde Integraciones
Customer API	Clientes con acceso habilitado	El cliente desde su portal

Consultar el listado requiere permiso de consulta de Integraciones. Activar/desactivar una integración y crear o revocar tokens Platform requiere además permiso de actualización. Si solo tenés permiso de consulta, pedí a un administrador que realice esas operaciones.

Configurar Platform API

1. Activá API en el listado y abrí el engranaje.
2. Elegí Nuevo token / New token y asignale un nombre identificable para ese sistema.
3. Seleccioná al menos un permiso (scope). Otorgá únicamente las operaciones necesarias.
4. Indicá una fecha de vencimiento si corresponde y confirmá la creación.
5. Copiá el token mostrado y entregalo al responsable de la integración por un canal seguro. El valor completo no se puede recuperar después desde el listado.

La configuración permite consultar permisos, vencimiento y último uso, y revocar uno o varios tokens. Revocar un token interrumpe el acceso del sistema que lo utiliza. Para reemplazarlo, creá uno nuevo, actualizá el sistema consumidor y revocá el anterior cuando termine la transición.

Desactivar API bloquea el acceso de sus tokens. No lo uses como reemplazo de revocar una credencial específica si otros sistemas deben seguir funcionando.

Habilitar Customer API

1. Activá Customer API en Integraciones.
2. Abrí la ficha del cliente en Partners. Debe tener el rol Cliente / Customer.
3. En Acceso API, habilitá el acceso individual y guardá los cambios. Esta edición requiere los permisos correspondientes sobre Partners.
4. Indicá al cliente que ingrese a su portal, abra Mi perfil / Acceso API y genere su token.

El cliente copia el token cuando se muestra. Generar uno nuevo reemplaza el anterior; también puede revocarlo desde esa misma sección. El administrador habilita el acceso, no genera el token en nombre del cliente. El engranaje de Customer API muestra una consulta de clientes habilitados y si tienen token, sin acciones para emitirlo.

Deshabilitar el acceso individual bloquea a ese cliente. Desactivar Customer API bloquea a todos los clientes de la organización. Estos bloqueos no equivalen a borrar sus tokens: para invalidar una credencial definitivamente se debe revocar.

Customer API permite consultar receipts y master shipments propios, crear receipts y consultar los catálogos documentados. No ofrece todas las operaciones disponibles en Platform API.

Resolver problemas de acceso

• 401: comprobar token, vencimiento o revocación y el dominio de la organización.
• 403: comprobar la audiencia del token, la habilitación de acceso y los permisos requeridos.
• 404: comprobar el ID y, para documentos Customer, que pertenezca al cliente autenticado.
• 429: esperar los segundos indicados en Retry-After antes de reintentar.

Para configurar el sistema consumidor, consultá Platform API o Customer API. Los ejemplos internos de desarrollo no reemplazan estas guías para usuarios.