Referencia · OpenAPI 3.1.0

API Reference

API REST para crear, rastrear y gestionar pedidos de entrega (last-mile). Un pedido (Order) representa un envío a un cliente final: se crea, se asigna a un despacho/ruta, se recoge, viaja y se entrega con prueba de entrega. Cada cambio de estado emite un webhook.

Descargar OpenAPIBase: https://api.falconext.pe/api/v1/logistics

Documento de plantilla

PLANTILLA ALINEADA AL DOMINIO REAL de falconext-mype (módulo logística: PedidoLogistica, ciclo EstadoPedidoLogistica, prueba de entrega, COD). Es una fachada en inglés sobre los modelos internos en español. Valídala y/o genérala desde el backend (@nestjs/swagger) antes de publicar.

Pedidos

Crea, consulta y gestiona pedidos de entrega.

Rastreo

Estado en tiempo real, ubicación y prueba de entrega.

Webhooks

Endpoints que reciben los eventos del ciclo de vida.

POSTRegistrar un endpoint de webhook/webhook_endpoints

Cada endpoint tiene su propia página (deep-link y SEO). Todo se genera desde /openapi/logistica/2025-07-01.json: cambia el spec y la referencia se regenera.