Update Parcel Dispatch
curl --request POST \
--url https://{merchant_site_domain}/UpdateParcelDispatch \
--header 'Content-Type: application/json' \
--data '
{
"UrlParameters": null,
"DispatchedParcel": {
"ParcelTracking": {
"ParcelTrackingNumber": "0545123533352",
"ParcelTrackingUrl": "https%3a%2f%2ftracking.dpd.de%2fstatus%2fen_NL%2fparcel%2f0545123533352",
"ParcelCode": "24543282-P1"
},
"HubCode": null,
"Code": "24543282-P1",
"StatusName": null,
"Products": [
{
"Sku": "00006901119001",
"CartItemId": "e3480db5-f139-4f11-8111-fdb95353a110",
"Quantity": 1
}
]
},
"OrderId": "GE23457211382NL",
"MerchantOrderId": "12456",
"StatusCode": null,
"MerchantGUID": "1d5111e18-31224-448d-ae3d-d11b1111991c",
"WebStoreCode": "9o1eeefRR",
"WebStoreInstanceCode": "GlobalEDefaultStoreInstance"
}
'import requests
url = "https://{merchant_site_domain}/UpdateParcelDispatch"
payload = {
"UrlParameters": None,
"DispatchedParcel": {
"ParcelTracking": {
"ParcelTrackingNumber": "0545123533352",
"ParcelTrackingUrl": "https%3a%2f%2ftracking.dpd.de%2fstatus%2fen_NL%2fparcel%2f0545123533352",
"ParcelCode": "24543282-P1"
},
"HubCode": None,
"Code": "24543282-P1",
"StatusName": None,
"Products": [
{
"Sku": "00006901119001",
"CartItemId": "e3480db5-f139-4f11-8111-fdb95353a110",
"Quantity": 1
}
]
},
"OrderId": "GE23457211382NL",
"MerchantOrderId": "12456",
"StatusCode": None,
"MerchantGUID": "1d5111e18-31224-448d-ae3d-d11b1111991c",
"WebStoreCode": "9o1eeefRR",
"WebStoreInstanceCode": "GlobalEDefaultStoreInstance"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
UrlParameters: null,
DispatchedParcel: {
ParcelTracking: {
ParcelTrackingNumber: '0545123533352',
ParcelTrackingUrl: 'https%3a%2f%2ftracking.dpd.de%2fstatus%2fen_NL%2fparcel%2f0545123533352',
ParcelCode: '24543282-P1'
},
HubCode: null,
Code: '24543282-P1',
StatusName: null,
Products: [
{
Sku: '00006901119001',
CartItemId: 'e3480db5-f139-4f11-8111-fdb95353a110',
Quantity: 1
}
]
},
OrderId: 'GE23457211382NL',
MerchantOrderId: '12456',
StatusCode: null,
MerchantGUID: '1d5111e18-31224-448d-ae3d-d11b1111991c',
WebStoreCode: '9o1eeefRR',
WebStoreInstanceCode: 'GlobalEDefaultStoreInstance'
})
};
fetch('https://{merchant_site_domain}/UpdateParcelDispatch', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{merchant_site_domain}/UpdateParcelDispatch",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'UrlParameters' => null,
'DispatchedParcel' => [
'ParcelTracking' => [
'ParcelTrackingNumber' => '0545123533352',
'ParcelTrackingUrl' => 'https%3a%2f%2ftracking.dpd.de%2fstatus%2fen_NL%2fparcel%2f0545123533352',
'ParcelCode' => '24543282-P1'
],
'HubCode' => null,
'Code' => '24543282-P1',
'StatusName' => null,
'Products' => [
[
'Sku' => '00006901119001',
'CartItemId' => 'e3480db5-f139-4f11-8111-fdb95353a110',
'Quantity' => 1
]
]
],
'OrderId' => 'GE23457211382NL',
'MerchantOrderId' => '12456',
'StatusCode' => null,
'MerchantGUID' => '1d5111e18-31224-448d-ae3d-d11b1111991c',
'WebStoreCode' => '9o1eeefRR',
'WebStoreInstanceCode' => 'GlobalEDefaultStoreInstance'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://{merchant_site_domain}/UpdateParcelDispatch"
payload := strings.NewReader("{\n \"UrlParameters\": null,\n \"DispatchedParcel\": {\n \"ParcelTracking\": {\n \"ParcelTrackingNumber\": \"0545123533352\",\n \"ParcelTrackingUrl\": \"https%3a%2f%2ftracking.dpd.de%2fstatus%2fen_NL%2fparcel%2f0545123533352\",\n \"ParcelCode\": \"24543282-P1\"\n },\n \"HubCode\": null,\n \"Code\": \"24543282-P1\",\n \"StatusName\": null,\n \"Products\": [\n {\n \"Sku\": \"00006901119001\",\n \"CartItemId\": \"e3480db5-f139-4f11-8111-fdb95353a110\",\n \"Quantity\": 1\n }\n ]\n },\n \"OrderId\": \"GE23457211382NL\",\n \"MerchantOrderId\": \"12456\",\n \"StatusCode\": null,\n \"MerchantGUID\": \"1d5111e18-31224-448d-ae3d-d11b1111991c\",\n \"WebStoreCode\": \"9o1eeefRR\",\n \"WebStoreInstanceCode\": \"GlobalEDefaultStoreInstance\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://{merchant_site_domain}/UpdateParcelDispatch")
.header("Content-Type", "application/json")
.body("{\n \"UrlParameters\": null,\n \"DispatchedParcel\": {\n \"ParcelTracking\": {\n \"ParcelTrackingNumber\": \"0545123533352\",\n \"ParcelTrackingUrl\": \"https%3a%2f%2ftracking.dpd.de%2fstatus%2fen_NL%2fparcel%2f0545123533352\",\n \"ParcelCode\": \"24543282-P1\"\n },\n \"HubCode\": null,\n \"Code\": \"24543282-P1\",\n \"StatusName\": null,\n \"Products\": [\n {\n \"Sku\": \"00006901119001\",\n \"CartItemId\": \"e3480db5-f139-4f11-8111-fdb95353a110\",\n \"Quantity\": 1\n }\n ]\n },\n \"OrderId\": \"GE23457211382NL\",\n \"MerchantOrderId\": \"12456\",\n \"StatusCode\": null,\n \"MerchantGUID\": \"1d5111e18-31224-448d-ae3d-d11b1111991c\",\n \"WebStoreCode\": \"9o1eeefRR\",\n \"WebStoreInstanceCode\": \"GlobalEDefaultStoreInstance\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{merchant_site_domain}/UpdateParcelDispatch")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"UrlParameters\": null,\n \"DispatchedParcel\": {\n \"ParcelTracking\": {\n \"ParcelTrackingNumber\": \"0545123533352\",\n \"ParcelTrackingUrl\": \"https%3a%2f%2ftracking.dpd.de%2fstatus%2fen_NL%2fparcel%2f0545123533352\",\n \"ParcelCode\": \"24543282-P1\"\n },\n \"HubCode\": null,\n \"Code\": \"24543282-P1\",\n \"StatusName\": null,\n \"Products\": [\n {\n \"Sku\": \"00006901119001\",\n \"CartItemId\": \"e3480db5-f139-4f11-8111-fdb95353a110\",\n \"Quantity\": 1\n }\n ]\n },\n \"OrderId\": \"GE23457211382NL\",\n \"MerchantOrderId\": \"12456\",\n \"StatusCode\": null,\n \"MerchantGUID\": \"1d5111e18-31224-448d-ae3d-d11b1111991c\",\n \"WebStoreCode\": \"9o1eeefRR\",\n \"WebStoreInstanceCode\": \"GlobalEDefaultStoreInstance\"\n}"
response = http.request(request)
puts response.read_body{
"Success": true,
"Message": "Fulfillment status was updated",
"Description": null
}Update Parcel Dispatch
The Update Parcel Dispatch API pushes to the merchant Global-e updated Parcel Dispatch Information.
POST
/
UpdateParcelDispatch
Update Parcel Dispatch
curl --request POST \
--url https://{merchant_site_domain}/UpdateParcelDispatch \
--header 'Content-Type: application/json' \
--data '
{
"UrlParameters": null,
"DispatchedParcel": {
"ParcelTracking": {
"ParcelTrackingNumber": "0545123533352",
"ParcelTrackingUrl": "https%3a%2f%2ftracking.dpd.de%2fstatus%2fen_NL%2fparcel%2f0545123533352",
"ParcelCode": "24543282-P1"
},
"HubCode": null,
"Code": "24543282-P1",
"StatusName": null,
"Products": [
{
"Sku": "00006901119001",
"CartItemId": "e3480db5-f139-4f11-8111-fdb95353a110",
"Quantity": 1
}
]
},
"OrderId": "GE23457211382NL",
"MerchantOrderId": "12456",
"StatusCode": null,
"MerchantGUID": "1d5111e18-31224-448d-ae3d-d11b1111991c",
"WebStoreCode": "9o1eeefRR",
"WebStoreInstanceCode": "GlobalEDefaultStoreInstance"
}
'import requests
url = "https://{merchant_site_domain}/UpdateParcelDispatch"
payload = {
"UrlParameters": None,
"DispatchedParcel": {
"ParcelTracking": {
"ParcelTrackingNumber": "0545123533352",
"ParcelTrackingUrl": "https%3a%2f%2ftracking.dpd.de%2fstatus%2fen_NL%2fparcel%2f0545123533352",
"ParcelCode": "24543282-P1"
},
"HubCode": None,
"Code": "24543282-P1",
"StatusName": None,
"Products": [
{
"Sku": "00006901119001",
"CartItemId": "e3480db5-f139-4f11-8111-fdb95353a110",
"Quantity": 1
}
]
},
"OrderId": "GE23457211382NL",
"MerchantOrderId": "12456",
"StatusCode": None,
"MerchantGUID": "1d5111e18-31224-448d-ae3d-d11b1111991c",
"WebStoreCode": "9o1eeefRR",
"WebStoreInstanceCode": "GlobalEDefaultStoreInstance"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
UrlParameters: null,
DispatchedParcel: {
ParcelTracking: {
ParcelTrackingNumber: '0545123533352',
ParcelTrackingUrl: 'https%3a%2f%2ftracking.dpd.de%2fstatus%2fen_NL%2fparcel%2f0545123533352',
ParcelCode: '24543282-P1'
},
HubCode: null,
Code: '24543282-P1',
StatusName: null,
Products: [
{
Sku: '00006901119001',
CartItemId: 'e3480db5-f139-4f11-8111-fdb95353a110',
Quantity: 1
}
]
},
OrderId: 'GE23457211382NL',
MerchantOrderId: '12456',
StatusCode: null,
MerchantGUID: '1d5111e18-31224-448d-ae3d-d11b1111991c',
WebStoreCode: '9o1eeefRR',
WebStoreInstanceCode: 'GlobalEDefaultStoreInstance'
})
};
fetch('https://{merchant_site_domain}/UpdateParcelDispatch', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{merchant_site_domain}/UpdateParcelDispatch",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'UrlParameters' => null,
'DispatchedParcel' => [
'ParcelTracking' => [
'ParcelTrackingNumber' => '0545123533352',
'ParcelTrackingUrl' => 'https%3a%2f%2ftracking.dpd.de%2fstatus%2fen_NL%2fparcel%2f0545123533352',
'ParcelCode' => '24543282-P1'
],
'HubCode' => null,
'Code' => '24543282-P1',
'StatusName' => null,
'Products' => [
[
'Sku' => '00006901119001',
'CartItemId' => 'e3480db5-f139-4f11-8111-fdb95353a110',
'Quantity' => 1
]
]
],
'OrderId' => 'GE23457211382NL',
'MerchantOrderId' => '12456',
'StatusCode' => null,
'MerchantGUID' => '1d5111e18-31224-448d-ae3d-d11b1111991c',
'WebStoreCode' => '9o1eeefRR',
'WebStoreInstanceCode' => 'GlobalEDefaultStoreInstance'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://{merchant_site_domain}/UpdateParcelDispatch"
payload := strings.NewReader("{\n \"UrlParameters\": null,\n \"DispatchedParcel\": {\n \"ParcelTracking\": {\n \"ParcelTrackingNumber\": \"0545123533352\",\n \"ParcelTrackingUrl\": \"https%3a%2f%2ftracking.dpd.de%2fstatus%2fen_NL%2fparcel%2f0545123533352\",\n \"ParcelCode\": \"24543282-P1\"\n },\n \"HubCode\": null,\n \"Code\": \"24543282-P1\",\n \"StatusName\": null,\n \"Products\": [\n {\n \"Sku\": \"00006901119001\",\n \"CartItemId\": \"e3480db5-f139-4f11-8111-fdb95353a110\",\n \"Quantity\": 1\n }\n ]\n },\n \"OrderId\": \"GE23457211382NL\",\n \"MerchantOrderId\": \"12456\",\n \"StatusCode\": null,\n \"MerchantGUID\": \"1d5111e18-31224-448d-ae3d-d11b1111991c\",\n \"WebStoreCode\": \"9o1eeefRR\",\n \"WebStoreInstanceCode\": \"GlobalEDefaultStoreInstance\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://{merchant_site_domain}/UpdateParcelDispatch")
.header("Content-Type", "application/json")
.body("{\n \"UrlParameters\": null,\n \"DispatchedParcel\": {\n \"ParcelTracking\": {\n \"ParcelTrackingNumber\": \"0545123533352\",\n \"ParcelTrackingUrl\": \"https%3a%2f%2ftracking.dpd.de%2fstatus%2fen_NL%2fparcel%2f0545123533352\",\n \"ParcelCode\": \"24543282-P1\"\n },\n \"HubCode\": null,\n \"Code\": \"24543282-P1\",\n \"StatusName\": null,\n \"Products\": [\n {\n \"Sku\": \"00006901119001\",\n \"CartItemId\": \"e3480db5-f139-4f11-8111-fdb95353a110\",\n \"Quantity\": 1\n }\n ]\n },\n \"OrderId\": \"GE23457211382NL\",\n \"MerchantOrderId\": \"12456\",\n \"StatusCode\": null,\n \"MerchantGUID\": \"1d5111e18-31224-448d-ae3d-d11b1111991c\",\n \"WebStoreCode\": \"9o1eeefRR\",\n \"WebStoreInstanceCode\": \"GlobalEDefaultStoreInstance\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{merchant_site_domain}/UpdateParcelDispatch")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"UrlParameters\": null,\n \"DispatchedParcel\": {\n \"ParcelTracking\": {\n \"ParcelTrackingNumber\": \"0545123533352\",\n \"ParcelTrackingUrl\": \"https%3a%2f%2ftracking.dpd.de%2fstatus%2fen_NL%2fparcel%2f0545123533352\",\n \"ParcelCode\": \"24543282-P1\"\n },\n \"HubCode\": null,\n \"Code\": \"24543282-P1\",\n \"StatusName\": null,\n \"Products\": [\n {\n \"Sku\": \"00006901119001\",\n \"CartItemId\": \"e3480db5-f139-4f11-8111-fdb95353a110\",\n \"Quantity\": 1\n }\n ]\n },\n \"OrderId\": \"GE23457211382NL\",\n \"MerchantOrderId\": \"12456\",\n \"StatusCode\": null,\n \"MerchantGUID\": \"1d5111e18-31224-448d-ae3d-d11b1111991c\",\n \"WebStoreCode\": \"9o1eeefRR\",\n \"WebStoreInstanceCode\": \"GlobalEDefaultStoreInstance\"\n}"
response = http.request(request)
puts response.read_body{
"Success": true,
"Message": "Fulfillment status was updated",
"Description": null
}Part of the Dispatch Notifications (Global-e to Merchant) integration guide — see it for when and how to use this endpoint.
Body
application/json
Dispatched parcel information.
Show child attributes
Show child attributes
Global‑e order unique identifier.
Unique identifier of the Merchant on Global-e.
Order unique identifier on the Merchant's site returned from a previous call to the SendOrderToMerchant method for this order.
Code denoting the order status on the Merchant's site (to be mapped on the Global‑e side).
Code used on the merchant's site to identify the web store, as specified in the WebStoreCode argument for cart method for the cart converted to this order on Global‑e.
Refers to Merchant Store Instance.
Response
200 - application/json
Success or failure response.