Para emprendedores

Divoox Flex: la API para conectar tu sistema

Si tu empresa ya tiene un sistema propio, puede crear y consultar envíos y paquetes directamente con una clave de integración, sin pasar por el panel.

Cómo funciona

En «API» creas una clave de integración. Se muestra una sola vez: cópiala y guárdala en tu sistema. Cada clave tiene permisos acotados (crear envíos, consultarlos, registrar pasos, importar, gestionar centros y lotes) y nunca puede manejar tu equipo ni dinero. Puedes revocarla cuando quieras.

La clave viaja en una cabecera de cada llamada. Las llamadas que crean algo exigen además una clave de idempotencia con un valor único por operación: si repites la misma llamada, recibes la misma respuesta sin duplicar nada. La referencia técnica completa, con las direcciones y los ejemplos, se la entregamos a tu integrador desde el panel.

Operaciones disponibles: crear un envío o varios en una sola llamada (hasta veinticinco), listar y consultar envíos y paquetes, registrar un paso de custodia, obtener los datos de la etiqueta, resolver un código escaneado, importar una hoja en dos pasos (previsualizar y confirmar) y gestionar lotes y rutas en borrador.

Hay un límite de sesenta llamadas por minuto por clave. Los errores vienen en palabras claras, en el idioma que pidas con la cabecera «x-idioma» (en o es).

El destinatario puede consultar el estado de su paquete con su código de seguimiento; esa consulta solo muestra el estado y las fechas, nunca datos personales.

Pasos

1. En el panel de tu empresa entra a «API», crea una clave con los permisos que necesites y cópiala.
2. Envía tus llamadas con tu clave y, en las que crean cosas, con una clave de idempotencia única por operación.
3. Crea envíos con el nombre de quien recibe, la dirección y la cantidad de paquetes; guarda los códigos que vuelven.
4. Consulta el estado de cada paquete cuando lo necesites y registra sus pasos desde tu sistema.

Divoox también puede avisar a tu sistema de cada cambio: lo configuras en «Integraciones» (guía «avisos, orden sugerido, capacidad e indicadores»).