Delnext API
Documentation

Returns a list of available pickup/PUDO points near a given postal code. Requires a valid hash_key and the corresponding account must have Pickup Points permission enabled.

curl -X POST https://api.delnext.com/api/v2/pickup-points \
  -d "hash_key=YOUR_API_KEY" \
  -d "zip_code=1000-001" \
  -d "country_code=PT"

{
  "success": 1,
  "message": "Completed",
  "pickup_points": [
    {
      "id":      "PP001",
      "name":    "CTT Agência Central Lisboa",
      "address": "Rua do Comércio 1, 1100-150 Lisboa",
      "lat":     38.7074,
      "lng":     -9.1368
    }
  ]
}

{
  "success": 0,
  "message": "Authentication Required"
}

Creates a new shipping order in the Delnext platform and returns a tracking code, shipping label PDF (base64), and order ID. Requires a valid hash_key.

curl -X POST https://api.delnext.com/api/v2/create-order \
  -d "hash_key=YOUR_API_KEY" \
  -d "sender_first_name=João" \
  -d "sender_company=Empresa Lda" \
  -d "sender_street_address=Rua das Flores, 10" \
  -d "sender_post_code=1000-001" \
  -d "sender_city=Lisboa" \
  -d "sender_country=PT" \
  -d "sender_telephone=211451900" \
  -d "sender_email=sender@empresa.pt" \
  -d "receiver_first_name=Maria" \
  -d "receiver_street_address=Av. da Liberdade, 50" \
  -d "receiver_post_code=4000-065" \
  -d "receiver_city=Porto" \
  -d "receiver_country=PT" \
  -d "receiver_telephone=912345678" \
  -d "parcel_weight=2.5" \
  -d "parcel_length=30" \
  -d "parcel_width=20" \
  -d "parcel_height=15" \
  -d "parcel_reference=ORDER-001" \
  -d "parcel_contents=Electronics" \
  -d "parcel_service_type=1"

{
  "success":       1,
  "tracking_code": "DNX789012",
  "orders_id":     98765,
  "pdf":           "JVBERi0xLjQKJcOk..."  // base64-encoded shipping label PDF
}

{
  "success": 0,
  "message": "Insufficient credits"
}

Retrieves the shipping label PDF (base64) for an existing order, identified by the parcel reference number passed during order creation. Useful when the PDF was not stored at creation time, or when the Create Order response returned a "Label creation is in process" message.

curl -X POST https://api.delnext.com/api/v2/reference-label \
  -d "hash_key=YOUR_API_KEY" \
  -d "reference_number=ORDER-001"

{
  "success":   1,
  "orders_id": 98765,
  "pdf":       "JVBERi0xLjQKJcOk..."  // base64-encoded shipping label PDF
}

{
  "success":   0,
  "orders_id": 98765,
  "message":   "Label creation is in process. Please try again in 1 minute."
}

{
  "success": 0,
  "message": "No order found for the given reference number"
}

Returns the shipping label PDF (base64-encoded) for a given order. You can look up by Delnext order_id or by your own reference (the parcel_reference used when creating the order). If the label was generated locally and is missing from storage, it will be automatically regenerated.

curl -X POST https://api.delnext.com/api/v2/label \
  -d "hash_key=YOUR_API_KEY" \
  -d "order_id=98765"

curl -X POST https://api.delnext.com/api/v2/label \
  -d "hash_key=YOUR_API_KEY" \
  -d "reference=ORDER-001"

{
  "success":   1,
  "orders_id": 98765,
  "pdf":       "JVBERi0xLjQKJcOk..."  // base64-encoded shipping label PDF
}

{
  "success": 0,
  "message": "Order not found."
}

Returns the list of parcels associated with an order, including tracking numbers and prices. You can look up by Delnext order_id or by your own reference. When looking up by reference, all matching orders are returned.

curl -X POST https://api.delnext.com/api/v2/order-details \
  -d "hash_key=YOUR_API_KEY" \
  -d "order_id=98765"

curl -X POST https://api.delnext.com/api/v2/order-details \
  -d "hash_key=YOUR_API_KEY" \
  -d "reference=ORDER-001"

{
  "success": 1,
  "parcels": [
    {
      "Id":             12301,
      "Reference":     "ORDER-001",
      "OrderId":        98765,
      "TrackingNumber": "DNX789012",
      "Parcel_Price":   5.50
    }
  ]
}

{
  "success": 0,
  "message": "Order not found."
}

Cancels an order and all its parcels, setting their status to Voided (5). Only orders in status 1 (Pending) or 13 (Processing) can be cancelled. Orders already sent, delivered, or in any other final state will be rejected.

curl -X POST https://api.delnext.com/api/v2/cancel-order \
  -d "hash_key=YOUR_API_KEY" \
  -d "order_number=98765"

{
  "success": 1,
  "message": "Your order number #98765 has been cancelled successfully"
}

{
  "success": 0,
  "message": "Order number #98765 can not be cancelled. Please contact support team."
}