Saltar al contenido
Falconextdev
POST/orders

Crear un pedido

Registra un nuevo pedido de entrega y devuelve su identificador y código de rastreo.

Cuerpo de la solicitud

external_order_idstring

Tu identificador externo (nº de orden en tu sistema).

sourceenum

Origen por el que se creó el pedido (fachada de OrigenPedidoLogistica).

manualexcelapiwebhookecommercefalconext_erpfalconext

customerobjectrequerido
namestringrequerido

Nombre del cliente final.

document_typestring

Tipo de documento (DNI, RUC, CE…).

document_numberstring
emailstring
phonestring
whatsappstring
delivery_addressobjectrequerido
labelstring

Etiqueta de la dirección.

addressstringrequerido

Dirección en texto.

districtstring
citystring
departmentstring
latnumber
lngnumber
referencestring

Referencia para ubicar el lugar.

access_notesstring

Notas de acceso.

itemsobject[]
skustring
descriptionstringrequerido
quantityinteger
weight_kgnumber
declared_valuenumber
requested_datestring

Fecha solicitada de entrega.

time_windowobject

Ventana horaria de entrega (HH:mm).

startstring
endstring
priorityinteger

1: baja, 2: normal, 3: alta.

is_urgentboolean
requires_signatureboolean
requires_photoboolean
cash_on_deliverynumber

Monto a cobrar contra entrega (COD). 0 si no aplica.

customer_notesstring
metadataobject

Pares clave-valor propios.

Respuestas

  • 201Pedido creado
  • 401API key ausente o inválida
  • 422Parámetros inválidos
POST /orders
curl -X POST 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",
    "source": "manual",
    "customer": {
      "name": "María Fernández",
      "document_type": "DNI",
      "document_number": "70123456",
      "email": "maria@example.com",
      "phone": "+51987654321",
      "whatsapp": "+51987654321"
    },
    "delivery_address": {
      "label": "Casa",
      "address": "Calle Los Pinos 120, Miraflores",
      "district": "Miraflores",
      "city": "Lima",
      "department": "Lima",
      "lat": -12.1211,
      "lng": -77.0296,
      "reference": "Frente al parque",
      "access_notes": "Dejar en conserjería"
    },
    "items": [
      {
        "sku": "TSHIRT-M-BLK",
        "description": "Polo talla M negro",
        "quantity": 2,
        "weight_kg": 0.3,
        "declared_value": 59.9
      }
    ],
    "requested_date": "2025-07-02T00:00:00Z",
    "time_window": {
      "start": "09:00",
      "end": "13:00"
    },
    "priority": 2,
    "is_urgent": false,
    "requires_signature": true,
    "requires_photo": false,
    "cash_on_delivery": 120,
    "customer_notes": "Llamar al llegar.",
    "metadata": {}
  }'
Respuesta · 201
JSON
{
  "id": "ord_3xK8p2Qm",
  "object": "order",
  "tracking_code": "FX-7Q2M8K",
  "external_order_id": "ORD-10482",
  "source": "manual",
  "status": "pending",
  "customer": {
    "name": "María Fernández",
    "document_type": "DNI",
    "document_number": "70123456",
    "email": "maria@example.com",
    "phone": "+51987654321",
    "whatsapp": "+51987654321"
  },
  "delivery_address": {
    "label": "Casa",
    "address": "Calle Los Pinos 120, Miraflores",
    "district": "Miraflores",
    "city": "Lima",
    "department": "Lima",
    "lat": -12.1211,
    "lng": -77.0296,
    "reference": "Frente al parque",
    "access_notes": "Dejar en conserjería"
  },
  "items": [
    {
      "sku": "TSHIRT-M-BLK",
      "description": "Polo talla M negro",
      "quantity": 2,
      "weight_kg": 0.3,
      "declared_value": 59.9
    }
  ],
  "weight_kg": 0.6,
  "packages": 1,
  "cash_on_delivery": 120,
  "shipping_cost": 12.5,
  "created_at": "2025-07-01T14:03:11Z",
  "updated_at": "2025-07-01T14:03:11Z"
}
Pruébalo
Falconext Logística2025-07-01

Se guarda solo en tu navegador (localStorage). Nunca se incluye en el código copiable.

POSThttps://api.falconext.pe/api/v1/logistics/orders
curl -X POST https://api.falconext.pe/api/v1/logistics/orders \
  -H "Authorization: Bearer $FALCONEXT_API_KEY"
Respuesta

Envía una solicitud para ver la respuesta