Saltar al contenido
Falconextdev
POST/orders/{id}/cancel

Cancelar un pedido

Cancela un pedido que aún no ha sido entregado. Emite el evento order.cancelled.

Parámetros de ruta

idstringrequerido

Cuerpo de la solicitud

reasonstring

Motivo de la cancelación.

Respuestas

  • 200Pedido cancelado
  • 404Recurso no encontrado
  • 409El pedido ya no puede cancelarse (p. ej. ya fue entregado).
POST /orders/{id}/cancel
curl -X POST https://api.falconext.pe/api/v1/logistics/orders/:id/cancel \
  -H "Authorization: Bearer $FALCONEXT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "string"
  }'
Respuesta · 200
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/%7Bid%7D/cancel

Parámetros

id*
curl -X POST https://api.falconext.pe/api/v1/logistics/orders/%7Bid%7D/cancel \
  -H "Authorization: Bearer $FALCONEXT_API_KEY"
Respuesta

Envía una solicitud para ver la respuesta