Create Shipment

POST https://api.salla.dev/admin/v2/shipments

This endpoint allows you to create a shipment related to your store directly from this endpoint.

Request Body

{"courier_id"=>"<integer>", "shipment_type"=>"return", "payment_method"=>"cod", "packages"=>[{"name"=>"<string>", "sku"=>"<string>", "price"=>{"amount"=>"<number>", "currency"=>"<string>"}, "quantity"=>"<integer>", "weight"=>{"value"=>"<integer>", "units"=>"g"}}, {"name"=>"<string>", "sku"=>"<string>", "price"=>{"amount"=>"<number>", "currency"=>"<string>"}, "quantity"=>"<integer>", "weight"=>{"value"=>"<integer>", "units"=>"lb"}}], "order_id"=>"<integer>", "overwrite_exists_pending"=>"<boolean>", "policy_options"=>{"boxes"=>"<integer>"}, "ship_to"=>{"name"=>"<string>", "email"=>"<string>", "phone"=>"<string>", "country_id"=>"<string>", "city_id"=>"<string>", "address_line"=>"<string>", "street_number"=>"<string>", "block"=>"<string>", "postal_code"=>"<string>", "geo_coordinates"=>{"lat"=>"<number>", "lng"=>"<string>"}}, "ship_from"=>{"type"=>"<string>", "name"=>"<string>", "email"=>"<string>", "phone"=>"<string>", "country"=>"<string>", "city"=>"<string>", "address_line"=>"<string>", "street_number"=>{"nullable"=>true, "description"=>"Shipment Ship From Street Number", "example"=>"120B"}, "block"=>{"nullable"=>true, "description"=>"Shipment Ship From Block", "example"=>"Block AB"}, "postal_code"=>{"nullable"=>true, "description"=>"Shipment Ship From Postal Code", "example"=>"1000"}, "latitude"=>"<number>", "longitude"=>"<number>", "branch_id"=>"<integer>"}}

HEADERS

RESPONSES

status: OK

{"status":"\u003cstring\u003e","success":"\u003cstring\u003e","data":{"id":"\u003cinteger\u003e","order_id":"\u003cinteger\u003e","order_reference_id":"\u003cnumber\u003e","created_at":{"date":"\u003cstring\u003e","timezone_type":"\u003cinteger\u003e","timezone":"\u003cstring\u003e"},"type":"shipment","courier_id":"\u003cinteger\u003e","courier_name":"\u003cstring\u003e","courier_logo":"\u003cstring\u003e","shipping_number":"\u003cstring\u003e","tracking_number":"\u003cstring\u003e","pickup_id":{"nullable":true,"description":"Shipment Pickup ID","example":"10954392"},"trackable":"\u003cboolean\u003e","tracking_link":"\u003cstring\u003e","label":{"format":"\u003cstring\u003e","url":"\u003cstring\u003e"},"payment_method":"pre_paid","source":"\u003cstring\u003e","status":"created","total":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"cash_on_delivery":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"is_international":"\u003cboolean\u003e","total_weight":{"value":"\u003cnumber\u003e","units":"\u003cstring\u003e"},"packages":[{"item_id":"\u003cinteger\u003e","external_id":"\u003cinteger\u003e","name":"\u003cstring\u003e","sku":"\u003cstring\u003e","price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"quantity":"\u003cinteger\u003e","weight":{"value":"\u003cinteger\u003e","units":"g"}},{"item_id":"\u003cinteger\u003e","external_id":"\u003cinteger\u003e","name":"\u003cstring\u003e","sku":"\u003cstring\u003e","price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"quantity":"\u003cinteger\u003e","weight":{"value":"\u003cinteger\u003e","units":"oz"}}],"ship_from":{"type":"\u003cstring\u003e","name":"\u003cstring\u003e","email":"\u003cstring\u003e","phone":"\u003cstring\u003e","country":"\u003cstring\u003e","city":"\u003cstring\u003e","address_line":"\u003cstring\u003e","street_number":{"nullable":true,"description":"Shipment Ship From Street Number","example":"120B"},"block":{"nullable":true,"description":"Shipment Ship From Block","example":"Block AB"},"postal_code":{"nullable":true,"description":"Shipment Ship From Postal Code","example":"1000"},"latitude":"\u003cnumber\u003e","longitude":"\u003cnumber\u003e","branch_id":"\u003cinteger\u003e"},"ship_to":{"type":"\u003cstring\u003e","name":"\u003cstring\u003e","email":"\u003cstring\u003e","phone":"\u003cstring\u003e","country":"\u003cstring\u003e","city":"\u003cstring\u003e","address_line":"\u003cstring\u003e","street_number":"\u003cstring\u003e","block":"\u003cstring\u003e","postal_code":"\u003cstring\u003e","latitude":"\u003cnumber\u003e","longitude":"\u003cnumber\u003e"},"meta":{"app_id":"\u003cinteger\u003e","policy_options":{"shipment_content_type":["food_stuff","document"],"packaging_type":["box","basket"],"boxes":"\u003cinteger\u003e"}}}}