POST v1/Orders/{orderId}/Parcels

Adds the specified Parcel.

Request Information

URI Parameters

Name	Description	Type	Additional information
orderId	The order identifier.	integer	Required.

Body Parameters

The Parcel.

ParcelChanges

Name	Description	Type	Additional information
ShipmentId	Sets the (Order)Shipment identifier. By setting this value, the Parcel will be added to the OrderShipment.	integer	None.
ReturnId	Sets the (Order)Return identifier. By setting this value, the Parcel will be added to the OrderReturn.	integer	None.
SynchronizeParameters	Gets or sets a value indicating whether the parameters are synchronized.	boolean	None.
SynchronizeShippingLabels	Gets or sets a value indicating whether the packages are synchronized.	boolean	None.
LastCarrierUpdate	The timestamp of the last status check with the Carrier.	date	None.
FirstDeliveryAttempt	The timestamp of the first delivery attempt. Note, not all Carrier support this field.	date	None.
GoodsDescription		string	Max length: 50
DeliveredDate	The timestamp the complete Parcel was delivered. This timestamp is based on the DeliveryDate of all containing labels/packages.	date	None.
Params	Gets or sets the shipment parameters.	Collection of CarrierParameter	None.
ShippingLabels	Gets or sets the shipment packages.	Collection of ShippingLabel	None.
ShipFrom	Gets the sender contact info	ContactInfoAddress	None.
ShipTo	Gets the addressee contact info	ContactInfoAddress	None.
Id	Gets or sets the identifier.	integer	Must be 0 (for insert operations)
TrackingCode	Gets or sets the tracking code.	string	Max length: 2147483647
TrackingUrl	Optionally specify the full tracking url. When not specified the Carrier implementation will have to compose the url from the TrackinCode.	string	Max length: 2147483647
CreateTimestamp	Gets or sets the create timestamp.	date	Required
ShopId	Gets or sets the Shop identifier.	integer	Required
OrderId	Gets or sets the Order identifier.	integer	None.
CarrierAccountId	Gets or sets the Carrier account.	integer	Required
OrderShipmentId	Identifier of related shipment	integer	None.
ParcelStatus	The Parcel Status.	ParcelStatusEnum	None.
IsReturn	Indicates whether the Parcel is a return shipment.	boolean	Required
ErrorMessage	When set, the last status update experienced an technical error	string	Max length: 2147483647

Request Formats

application/json, text/json

Sample:

{
  "ShipmentId": 1,
  "ReturnId": 1,
  "SynchronizeParameters": true,
  "SynchronizeShippingLabels": true,
  "LastCarrierUpdate": "2026-01-11T16:14:59.700716+01:00",
  "FirstDeliveryAttempt": "2026-01-11T16:14:59.700716+01:00",
  "GoodsDescription": "sample string 5",
  "DeliveredDate": "2026-01-11T16:14:59.700716+01:00",
  "Params": [
    {
      "Key": "sample string 1",
      "Value": "sample string 2"
    },
    {
      "Key": "sample string 1",
      "Value": "sample string 2"
    }
  ],
  "ShippingLabels": [
    {
      "Id": 1,
      "TrackingCode": "sample string 2",
      "DeliveryStatus": 1,
      "Weight": 3.0,
      "Length": 4.0,
      "Width": 5.0,
      "Height": 6.0,
      "DeliveredDate": "2026-01-11T16:14:59.700716+01:00",
      "LastCarrierUpdate": "2026-01-11T16:14:59.700716+01:00",
      "LastCarrierStatus": "sample string 7"
    },
    {
      "Id": 1,
      "TrackingCode": "sample string 2",
      "DeliveryStatus": 1,
      "Weight": 3.0,
      "Length": 4.0,
      "Width": 5.0,
      "Height": 6.0,
      "DeliveredDate": "2026-01-11T16:14:59.700716+01:00",
      "LastCarrierUpdate": "2026-01-11T16:14:59.700716+01:00",
      "LastCarrierStatus": "sample string 7"
    }
  ],
  "ShipFrom": {
    "Id": 1,
    "CompanyName": "sample string 2",
    "Address": "sample string 3",
    "Address2": "sample string 4",
    "StreetAddress": "sample string 5",
    "StreetAddressNumber": "sample string 6",
    "StreetAddressExtension": "sample string 7",
    "PostalCode": "sample string 8",
    "City": "sample string 9",
    "CountryId": 1,
    "CountryCode": "sample string 10",
    "CountryName": null,
    "EMail": "sample string 11",
    "Phone": "sample string 12",
    "Phone2": "sample string 13",
    "StateProvince": "sample string 14",
    "StateProvinceCode": "sample string 15"
  },
  "ShipTo": {
    "Id": 1,
    "CompanyName": "sample string 2",
    "Address": "sample string 3",
    "Address2": "sample string 4",
    "StreetAddress": "sample string 5",
    "StreetAddressNumber": "sample string 6",
    "StreetAddressExtension": "sample string 7",
    "PostalCode": "sample string 8",
    "City": "sample string 9",
    "CountryId": 1,
    "CountryCode": "sample string 10",
    "CountryName": null,
    "EMail": "sample string 11",
    "Phone": "sample string 12",
    "Phone2": "sample string 13",
    "StateProvince": "sample string 14",
    "StateProvinceCode": "sample string 15"
  },
  "Id": 6,
  "TrackingCode": "sample string 7",
  "TrackingUrl": "sample string 8",
  "CreateTimestamp": "2026-01-11T16:14:59.700716+01:00",
  "ShopId": 10,
  "OrderId": 1,
  "CarrierAccountId": 11,
  "OrderShipmentId": null,
  "ParcelStatus": 1,
  "IsReturn": true,
  "ErrorMessage": "sample string 13"
}

Response Information

Resource Description

The HttpResponseMessage object.

Parcel

Name	Description	Type	Additional information
LastCarrierUpdate	The timestamp of the last status check with the Carrier.	date	None.
FirstDeliveryAttempt	The timestamp of the first delivery attempt. Note, not all Carrier support this field.	date	None.
ShipperTrackingUrl	Gets or sets the shipper tracking URL.	Collection of string	None.
GoodsDescription		string	Max length: 50
DeliveredDate	The timestamp the complete Parcel was delivered. This timestamp is based on the DeliveryDate of all containing labels/packages.	date	None.
Params	Gets or sets the shipment parameters.	Collection of CarrierParameter	None.
ShippingLabels	Gets or sets the shipment packages.	Collection of ShippingLabel	None.
ShippingLabelFileId	Gets or sets the Id to the file (pdf) containing the generated shippinglabel.	integer	None.
ShipFrom	Gets the sender contact info	ContactInfoAddress	None.
ShipTo	Gets the addressee contact info	ContactInfoAddress	None.
Id	Gets or sets the identifier.	integer	Must be 0 (for insert operations)
TrackingCode	Gets or sets the tracking code.	string	Max length: 2147483647
TrackingUrl	Optionally specify the full tracking url. When not specified the Carrier implementation will have to compose the url from the TrackinCode.	string	Max length: 2147483647
CreateTimestamp	Gets or sets the create timestamp.	date	Required
ChangedTimestamp	Gets the changed timestamp.	date	Required
CarrierName	The name of the Carrier used.	string	None.
ShopId	Gets or sets the Shop identifier.	integer	Required
OrderId	Gets or sets the Order identifier.	integer	None.
CarrierAccountId	Gets or sets the Carrier account.	integer	Required
OrderShipmentId	Identifier of related shipment	integer	None.
ParcelStatus	The Parcel Status.	ParcelStatusEnum	None.
IsReturn	Indicates whether the Parcel is a return shipment.	boolean	Required
ErrorMessage	When set, the last status update experienced an technical error	string	Max length: 2147483647

Response Formats

application/json, text/json

Sample:

{
  "LastCarrierUpdate": "2026-01-11T16:14:59.700716+01:00",
  "FirstDeliveryAttempt": "2026-01-11T16:14:59.700716+01:00",
  "ShipperTrackingUrl": [
    "sample string 1",
    "sample string 2"
  ],
  "GoodsDescription": "sample string 1",
  "DeliveredDate": "2026-01-11T16:14:59.700716+01:00",
  "Params": [
    {
      "Key": "sample string 1",
      "Value": "sample string 2"
    },
    {
      "Key": "sample string 1",
      "Value": "sample string 2"
    }
  ],
  "ShippingLabels": [
    {
      "Id": 1,
      "TrackingCode": "sample string 2",
      "DeliveryStatus": 1,
      "Weight": 3.0,
      "Length": 4.0,
      "Width": 5.0,
      "Height": 6.0,
      "DeliveredDate": "2026-01-11T16:14:59.700716+01:00",
      "LastCarrierUpdate": "2026-01-11T16:14:59.700716+01:00",
      "LastCarrierStatus": "sample string 7"
    },
    {
      "Id": 1,
      "TrackingCode": "sample string 2",
      "DeliveryStatus": 1,
      "Weight": 3.0,
      "Length": 4.0,
      "Width": 5.0,
      "Height": 6.0,
      "DeliveredDate": "2026-01-11T16:14:59.700716+01:00",
      "LastCarrierUpdate": "2026-01-11T16:14:59.700716+01:00",
      "LastCarrierStatus": "sample string 7"
    }
  ],
  "ShippingLabelFileId": 1,
  "ShipFrom": {
    "Id": 1,
    "CompanyName": "sample string 2",
    "Address": "sample string 3",
    "Address2": "sample string 4",
    "StreetAddress": "sample string 5",
    "StreetAddressNumber": "sample string 6",
    "StreetAddressExtension": "sample string 7",
    "PostalCode": "sample string 8",
    "City": "sample string 9",
    "CountryId": 1,
    "CountryCode": "sample string 10",
    "CountryName": null,
    "EMail": "sample string 11",
    "Phone": "sample string 12",
    "Phone2": "sample string 13",
    "StateProvince": "sample string 14",
    "StateProvinceCode": "sample string 15"
  },
  "ShipTo": {
    "Id": 1,
    "CompanyName": "sample string 2",
    "Address": "sample string 3",
    "Address2": "sample string 4",
    "StreetAddress": "sample string 5",
    "StreetAddressNumber": "sample string 6",
    "StreetAddressExtension": "sample string 7",
    "PostalCode": "sample string 8",
    "City": "sample string 9",
    "CountryId": 1,
    "CountryCode": "sample string 10",
    "CountryName": null,
    "EMail": "sample string 11",
    "Phone": "sample string 12",
    "Phone2": "sample string 13",
    "StateProvince": "sample string 14",
    "StateProvinceCode": "sample string 15"
  },
  "Id": 2,
  "TrackingCode": "sample string 3",
  "TrackingUrl": "sample string 4",
  "CreateTimestamp": "2026-01-11T16:14:59.700716+01:00",
  "ChangedTimestamp": "2026-01-11T16:14:59.700716+01:00",
  "CarrierName": "sample string 7",
  "ShopId": 8,
  "OrderId": 1,
  "CarrierAccountId": 9,
  "OrderShipmentId": null,
  "ParcelStatus": 1,
  "IsReturn": true,
  "ErrorMessage": "sample string 11"
}