Integrar por REST

Integra cualquier sistema con Falconext usando la API REST.

Si tu sistema puede hacer peticiones HTTP, puede integrarse con Falconext. Esta es la ruta universal, sin depender de un SDK.

El patrón mínimo

Autentícate

Envía tu API key como Bearer token en cada request. Ver Autenticación.

Crea el pedido cuando se genere la orden

En tu sistema, dispara una llamada a POST /orders al confirmar una orden.

Terminal

curl https://api.falconext.pe/api/v1/logistics/orders \
  -H "Authorization: Bearer $FALCONEXT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "external_order_id": "ORD-10482",
        "customer": { "name": "María Fernández", "phone": "+51987654321" },
        "delivery_address": { "address": "Calle Los Pinos 120, Miraflores", "city": "Lima" } }'

Guarda el id y el tracking_code

Asócialos a tu orden para poder consultarlos después y mostrar el rastreo a tu cliente.

Escucha los webhooks

Suscríbete a los eventos para actualizar el estado de la orden sin hacer polling. Ver Integrar con Webhooks.

Idempotencia

Si reintentas una creación por un timeout, envía el mismo external_order_id para evitar pedidos duplicados. Falconext lo usa como identificador externo de tu orden.

Manejo de errores

Programa contra type y code del error, y aplica reintentos con backoff ante 429 y 5xx.