Salla Docs
Update Shipment Details
PUT/shipments/{shipment_id}This endpoint allows you to update specific shipment details by passing the shipment_id as a path parameter.
Request
A URL that provides a link to the tracking information for the shipment.
A unique identifier for the shipment that distinguishes it from other shipments.
A unique identifier for the tracking information associated with the shipment.
The current status of the shipment.
The note field provides additional shipment information relevant factors, as it is used to clarify the shipment status and provide context.
A PDF label that contains information about the shipment, such as the sender's and recipient's address, tracking number, and other relevant details. The URL should point to a PDF file and ends with .pdf
The actual cost of the shipment that the Merchant will be charged for, which is calculated per the shipping company's actual costs. Ensure to include VAT in the cost.
{
"order_id": 76587644,
"tracking_link": "https://api.shipengine.com/v1/labels/498498496/track",
"shipment_number": "846984645",
"tracking_number": "54563653",
"status": "delivered",
"pdf_label": "https://api.shipengine.com/v1/downloads/10/F91fByOB-0aJJadf7JLeww/label-63563751.pdf",
"cost": 40
}Request samples
[api.label.responses]
Response status code, a numeric or alphanumeric identifier used to convey the outcome or status of a request, operation, or transaction in various systems and applications, typically indicating whether the action was successful, encountered an error, or resulted in a specific condition.
Response flag, boolean indicator used to signal a particular condition or state in the response of a system or application, often representing the presence or absence of certain conditions or outcomes.
A unique identifier for the shipment. Shipment list can be found here.
A unique identifier for the order associated with the shipment. List of orders can be found here
This field refers to a reference ID that can be used to look up additional information about the order
Date and time of shipment creations.
Shipment Type
Shipment Courier ID. Find a complete list of Shipment companies here
Shipment Courier Name
Shipment Courier Logo
Shipment Shipping Number
Shipment Tracking Number
Shipment Pickup ID
Whether or not the shipment is trackable
Shipment Tracking Link
Shipment label details.
Shipment Payment Method
Shipment Source.
Shipment Status
Shipment total.
Shipment cash on delivery details.
Whether the shipment is shipped internationally
Shipment total weight.
Shipment packages details.
Shipment source details.
Shipment destination details.
"Metadata" is data that describes other data, providing details on its creation, format, and context.
{
"status": 200,
"success": true,
"data": {
"id": 362985662,
"order_id": 560695738,
"order_reference_id": 48927,
"created_at": {
"date": "2023-01-12 14:19:08.000000",
"timezone_type": 3,
"timezone": "Asia/Riyadh"
},
"type": "shipment",
"courier": {
"id": 814202285,
"name": "DHL",
"logo": "https://company.com/logo.png"
},
"shipping_number": "0",
"tracking_number": "0",
"pickup_id": null,
"trackable": true,
"tracking_link": "https://www.company/tracking/tracking-express.html?submit=1&tracking-id=12345",
"label": [],
"payment_method": "cod",
"source": "api",
"status": {
"id": 566146469,
"name": "بإنتظار المراجعة",
"slug": "under_review"
},
"total": {
"amount": 7000,
"currency": "SAR"
},
"cash_on_delivery": {
"amount": 15,
"currency": "SAR"
},
"meta": {
"app_id": null,
"policy_options": {
"boxes": 2
}
},
"ship_from": {
"type": "branch",
"branch_id": 1723506348,
"name": "Riyadh",
"email": null,
"phone": "0555555555",
"country": "السعودية",
"city": "الرياض",
"address_line": "7687 طريق الملك فهد الفرعي، الملك فهد، الرياض 12262 3010، السعودية",
"street_number": "7687 طريق الملك فهد الفرعي",
"block": "الملك فهد",
"postal_code": "12262",
"geo_coordinates": {
"lat": "24.7431373",
"lng": "46.6570741"
}
},
"ship_to": {
"type": "address",
"name": "Username",
"email": "[email protected]",
"phone": "050-948-0868",
"country": "السعودية",
"city": "الرياض",
"address_line": "شارع عبدالله سنابل السلام مكة السعوديه",
"street_number": "2345",
"block": "السلام",
"postal_code": "95128",
"geo_coordinates": {
"lat": "21.382590509685",
"lng": "39.773191030685"
}
},
"packages": [
{
"item_id": 2077288690,
"external_id": null,
"name": "Apple Watch",
"sku": "6ytrrhrhr",
"price": {
"amount": "1000.00",
"currency": "SAR"
},
"quantity": 2,
"weight": {
"value": "0.10",
"unit": "kg"
}
},
{
"item_id": 2077288690,
"external_id": null,
"name": "Apple Iphone 14 Pro Max",
"sku": "6ytrrhrhr3332",
"price": {
"amount": "5000.00",
"currency": "SAR"
},
"quantity": 1,
"weight": {
"value": "0.50",
"unit": "kg"
}
}
]
}
}