Primeros pasos
Crea tu primer pedido de entrega con la API de Falconext Logística en minutos.
Bienvenido a Falconext Logística. En esta guía crearás tu primer pedido por API y recibirás su primer evento de webhook. Toma unos cinco minutos.
Lo que necesitas
Una cuenta de Falconext y una API key de pruebas. Si aún no la tienes, revisa cómo generar API keys.
Instala un SDK (opcional)
Puedes usar la API con cualquier cliente HTTP, pero los SDKs oficiales te ahorran trabajo.
npm install @falconext/logisticaCrea tu primer pedido
Autentícate con tu API key
Todas las solicitudes usan tu API key como Bearer token. Guárdala en una variable de entorno; nunca la incrustes en el código cliente.
export FALCONEXT_API_KEY="sk_test_••••••••"Envía la solicitud de creación
Indica el cliente y la dirección de entrega. Falconext devuelve un id y un tracking_code.
import { FalconextLogistica } from "@falconext/logistica";
const fx = new FalconextLogistica({ apiKey: process.env.FALCONEXT_API_KEY });
const order = await fx.orders.create({
externalOrderId: "ORD-10482",
customer: { name: "María Fernández", phone: "+51987654321" },
deliveryAddress: { address: "Calle Los Pinos 120, Miraflores", city: "Lima" },
items: [{ description: "Polo talla M", quantity: 2 }],
cashOnDelivery: 120.0,
});
console.log(order.trackingCode);Recibe eventos del pedido
Registra un endpoint de webhook y escucha el ciclo de
vida completo: order.created, order.assigned, order.picked_up, order.in_transit
y order.delivered.
La respuesta
Una creación exitosa devuelve 201 Created con el recurso del pedido:
{
"id": "ord_3xK8p2Qm",
"object": "order",
"external_order_id": "ORD-10482",
"tracking_code": "FX-7Q2M8K",
"status": "pending",
"created_at": "2025-07-01T14:03:11Z"
}Pruébalo sin escribir código
Abre el Sandbox, pega tu API key y envía este mismo request desde el navegador.
Siguientes pasos
Autenticación
Cómo funcionan las API keys y los entornos.
API Reference
Todos los endpoints, generados desde OpenAPI.
Webhooks
Recibe cada cambio de estado en tiempo real.