PUT v1/Orders/{orderId}/Parcels

Update an existing Parcel.

Request Information

Requires Authorization!

URI Parameters

Name	Description	Type	Additional information
orderId	The id of the Order.	integer	Required.

Body Parameters

The Parcel.

ParcelChanges

Name	Description	Type	Additional information
ShipmentId		integer	None.
ReturnId		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		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	Required
TrackingCode	Gets or sets the tracking code.	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
ParcelStatus	The Parcel Status.	ParcelStatusEnum	None.
IsReturn	Indicates whether the Parcel is a return shipment.	boolean	Required

Request Formats

application/json, text/json

Sample:

{
  "ShipmentId": 1,
  "ReturnId": 1,
  "SynchronizeParameters": true,
  "SynchronizeShippingLabels": true,
  "LastCarrierUpdate": "2021-12-02T20:19:34.5447333+01:00",
  "FirstDeliveryAttempt": "2021-12-02T20:19:34.5447333+01:00",
  "GoodsDescription": "sample string 5",
  "DeliveredDate": "2021-12-02T20:19:34.5447333+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": "2021-12-02T20:19:34.5447333+01:00",
      "LastCarrierUpdate": "2021-12-02T20:19:34.5447333+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": "2021-12-02T20:19:34.5447333+01:00",
      "LastCarrierUpdate": "2021-12-02T20:19:34.5447333+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",
  "CreateTimestamp": "2021-12-02T20:19:34.5447333+01:00",
  "ShopId": 9,
  "OrderId": 1,
  "CarrierAccountId": 10,
  "ParcelStatus": 1,
  "IsReturn": true
}

application/xml, text/xml

Sample:

<ParcelChanges xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Id>6</Id>
  <TrackingCode>sample string 7</TrackingCode>
  <CreateTimestamp>2021-12-02T20:19:34.5447333+01:00</CreateTimestamp>
  <ShopId>9</ShopId>
  <OrderId>1</OrderId>
  <CarrierAccountId>10</CarrierAccountId>
  <ParcelStatus>NotPlanned</ParcelStatus>
  <IsReturn>true</IsReturn>
  <LastCarrierUpdate>2021-12-02T20:19:34.5447333+01:00</LastCarrierUpdate>
  <FirstDeliveryAttempt>2021-12-02T20:19:34.5447333+01:00</FirstDeliveryAttempt>
  <GoodsDescription>sample string 5</GoodsDescription>
  <DeliveredDate>2021-12-02T20:19:34.5447333+01:00</DeliveredDate>
  <Params>
    <Parameters>
      <Key>sample string 1</Key>
      <Value>sample string 2</Value>
    </Parameters>
    <Parameters>
      <Key>sample string 1</Key>
      <Value>sample string 2</Value>
    </Parameters>
  </Params>
  <ShippingLabels>
    <ShippingLabels>
      <Id>1</Id>
      <TrackingCode>sample string 2</TrackingCode>
      <DeliveryStatus>NotPlanned</DeliveryStatus>
      <Weight>3</Weight>
      <Length>4</Length>
      <Width>5</Width>
      <Height>6</Height>
      <DeliveredDate>2021-12-02T20:19:34.5447333+01:00</DeliveredDate>
      <LastCarrierUpdate>2021-12-02T20:19:34.5447333+01:00</LastCarrierUpdate>
      <LastCarrierStatus>sample string 7</LastCarrierStatus>
    </ShippingLabels>
    <ShippingLabels>
      <Id>1</Id>
      <TrackingCode>sample string 2</TrackingCode>
      <DeliveryStatus>NotPlanned</DeliveryStatus>
      <Weight>3</Weight>
      <Length>4</Length>
      <Width>5</Width>
      <Height>6</Height>
      <DeliveredDate>2021-12-02T20:19:34.5447333+01:00</DeliveredDate>
      <LastCarrierUpdate>2021-12-02T20:19:34.5447333+01:00</LastCarrierUpdate>
      <LastCarrierStatus>sample string 7</LastCarrierStatus>
    </ShippingLabels>
  </ShippingLabels>
  <ShipFrom>
    <Id>1</Id>
    <CompanyName>sample string 2</CompanyName>
    <Address>sample string 3</Address>
    <Address2>sample string 4</Address2>
    <StreetAddress>sample string 5</StreetAddress>
    <StreetAddressNumber>sample string 6</StreetAddressNumber>
    <StreetAddressExtension>sample string 7</StreetAddressExtension>
    <PostalCode>sample string 8</PostalCode>
    <City>sample string 9</City>
    <CountryId>1</CountryId>
    <CountryCode>sample string 10</CountryCode>
    <EMail>sample string 11</EMail>
    <Phone>sample string 12</Phone>
    <Phone2>sample string 13</Phone2>
    <StateProvince>sample string 14</StateProvince>
    <StateProvinceCode>sample string 15</StateProvinceCode>
  </ShipFrom>
  <ShipTo>
    <Id>1</Id>
    <CompanyName>sample string 2</CompanyName>
    <Address>sample string 3</Address>
    <Address2>sample string 4</Address2>
    <StreetAddress>sample string 5</StreetAddress>
    <StreetAddressNumber>sample string 6</StreetAddressNumber>
    <StreetAddressExtension>sample string 7</StreetAddressExtension>
    <PostalCode>sample string 8</PostalCode>
    <City>sample string 9</City>
    <CountryId>1</CountryId>
    <CountryCode>sample string 10</CountryCode>
    <EMail>sample string 11</EMail>
    <Phone>sample string 12</Phone>
    <Phone2>sample string 13</Phone2>
    <StateProvince>sample string 14</StateProvince>
    <StateProvinceCode>sample string 15</StateProvinceCode>
  </ShipTo>
  <ShipmentId>1</ShipmentId>
  <ReturnId>1</ReturnId>
  <SynchronizeParameters>true</SynchronizeParameters>
  <SynchronizeShippingLabels>true</SynchronizeShippingLabels>
</ParcelChanges>

Response Information

Response Codes

OK (200)

Resource Description

The HttpResponseMessage object.

HttpResponseMessage

Name	Type	Additional information
Version	Version	None.
Content	HttpContent	None.
StatusCode	HttpStatusCode	None.
ReasonPhrase	string	None.
Headers	Collection of Object	None.
RequestMessage	HttpRequestMessage	None.
IsSuccessStatusCode	boolean	None.