Brexit – wymagania w odprawie exportowej i importowej po 01-01-2021

W dniu 01-01-2021 wszystkie przesyłki wysyłane do UK będą podlegać odprawie exportowej oraz importowej w UK. W związku z powyższym wprowadzamy nowe wymagania co do danych podawanych podczas generowania etykiet. Powstanie konieczność podania nowych dodatkowych wartości oraz dodanie minium jednego produktu.

W celu zrealizowania odprawy wymagane jest podanie numer EORI oraz numer VAT UK. W celu uproszczenia zmian, wartości te należy jednorazowo podać w profilu użytkownika w systemie Global24.

Nowe zmiany zostaną wprowadzone w dniu 29-12-2020 (tak aby towar odprawiany po 01-01-2021 na granicy posiadał już wszystkie niezbędne dane).

Nowe wymagane wartości

Obowiązkowy minimum jeden produkt

Przykładowy request

{
    "userName": "username",
    "password": "password",
    "CreateShipmentsRequest002": {
        "shipmentType": "Delivery",
        "carrierName": "GB-ROYALMAIL",
        "shipperAddress": {
            "additionalDescription": "description"
        },
        "receiverAddress": {
            "nameOrCompany": "Birmingham Hippodrome",
            "additionalDescription": "description",
            "address1": "Hurst Street",
            "address2": "Southside",
            "city": "Birmingham",
            "zipCode": "B5 4TB",
            "region": "",
            "country": "GB",
            "email": "test@email.com",
            "phone": "123456765",
            "taxId": "",
            "pickupId": null
        },
        "invoiceNumber": "TT100/12/01/001",
        "orderValue": 100.50,
        "currency": "EUR",
        "payerAddress": null,
        "items": [
            {
                "referenceID": "GoLabel0000",
                "referenceID2": "",
                "type": "RP",
                "weight": "2.50",
                "products": [
                    {
                        "name": "turbocharger v1.3",
                        "number": "458152587412584",
                        "quantity": "1",
                        "price": 80.50,
                        "tariffCode": "85044030",
                        "originCountry": "DE",
                        "imageUrl": null
                    }
                ]
            }
        ],
        "serviceLevel": {
            "service": "T48"
        },
        "shipmentDescription1": "description",
        "shipmentDescription2": ""
    }
}
									

1.1 CreateShipment

Metoda pozwala na generowanie przesyłek. Przesyłki będą tworzone tylko wtedy, gdy wszystkie dane przesyłki przejdą proces weryfikacji. Jeśli wystąpi błąd i nie można utworzyć przesyłek odpowiedni komunikat o błędzie zostanie odesłany do XML.

Adres na który wysyłamy żądanie:

• produkcyjny: https://gorest.goglobal24.com/create-shipment
• testowy: http://test-gorest.goglobal24.com/create-shipment

I. Struktura żądania

Struktura autoryzacji jest wymagana we wszystkich żądaniach. Istnieją dwa sposoby przejścia przez autoryzację w GoLabel REST API. Pierwszym jest podanie hasła oraz nazwy użytkownika, natomiast drugim jest hash użytkownika. Dane te są dostarczane przez administratorów GoLabel.

"hash": "{TwójHash}",
"userName": "{TwojaNazwaUżytkownika}",
"password": "{TwojeHasło}",

Właściwa część żądania, w niej zawarte są najważniejsze informacje.

Przykład:

"shipmentType":"Delivery",

Przykład:

"carrierName":"GB-ROYALMAIL",

Pola adresowe są wykorzystywane w danych w zapytaniu zawierających informacje o nadawcy, płatniku oraz odbiorcy. Wszystkie dane adresowe nadawcy na wysyłkach typu „Delivery” oraz w adresie odbiorcy typu „Return” z wyjątkiem additionalDescription zostaną uzupełnione danymi adresowymi punktów zagranicznych Global24.

Przykład:

	"shipperAddress": null,
	"receiverAddress":{
			"nameOrCompany":"Birmingham Hippodrome",
			"additionalDescription":"",
			"address1":"Hurst Street",
			"address2":"Southside",
			"city":"Birmingham",
			"zipCode":"B5 4TB",
			"region":"",
			"country":"GB",
			"email":"test@email.com",
			"phone":"123456765",
			"taxId":"",
			"pickupId":null
		},
	"payerAddress":null,

Tablica zawierająca elementy ze specyfikacją pozycji (paczki).

Tablica zawierająca elementy ze specyfikacją produktów.

Przykład:

			"items":[
				{
					"referenceID":"GoLabel0001",
					"referenceID2":"",
					"type":"RP",
					"weight":"2.50"
				},
				{
					"referenceID":"GoLabel0002",
					"referenceID2":"",
					"type":"RP",
					"weight":"2.50",
					"products":[
			                	{
			                		"name": "turbocharger v1.3",
			                		"number": "458152587412584",
			                		"quantity": "1",
			                		"price": "1125.45",
			                		"tariffCode": "85044030",
			                		"originCountry": "DE",
			                		"imageUrl": "url_to_photo.com"
			                	},
			                	{
			                		"name": "socks",
			                		"number": "398155774553544",
			                		"quantity": "3"
			                	}
	                		]
				}
			],

Określa typ usługi wysyłki. Możliwe typy dla danych kurierów są przedstawione w ich szczegółowych opisach.

Przykład:

"service":"T48",

COD musi zawierać dane takie jak kwota oraz rodzaj waluty. Możliwe waluty dla danych kurierów są przedstawione w ich szczegółowych opisach.

Przykład:

	"cod":{
		"amount": 100,
		"currency": "EUR"
	}

Insurance musi zawierać dane takie jak kwota oraz rodzaj waluty. Możliwe waluty dla danych kurierów są przedstawione w ich szczegółowych opisach.

Przykład:

	"insurance":{
		"description": "",
		"amount": 100,
		"currency": "EUR"
	}

Istnieje możliwość opisu paczki, przy danych kurierach opis będzie wyświetlany na etykiecie.

Przykład:

	"shipmentDescription1":"Car parts",
	"shipmentDescription2":""

II. Przykładowe żądanie

{
	"userName":"username",
	"password":"password",
	"CreateShipmentsRequest002":{
		"shipmentType":"Delivery",
		"carrierName":"DE-DHL",
		"shipperAddress":{
			  "additionalDescription":"description"
		},
		"receiverAddress":{
			  "nameOrCompany":"Kathleen",
			  "additionalDescription":"",
			  "address1":"Packstation 131",
			  "address2":"903729505",
			  "city":"Weil am Rhein",
			  "zipCode":"79576",
			  "region":"",
			  "country":"DE",
			  "email":"test@email.com",
			  "phone":"123456765",
			  "taxId":"",
			  "pickupId": null
		},
		"payerAddress":null,
		"items":[
			{
				"referenceID":"GoLabel00001",
				"referenceID2":"",
				"type":"NP",
				"weight":"1"
			},
            {
				"referenceID":"GoLabel00002",
				"referenceID2":"",
				"type":"NP",
				"weight":"2.5"
			}
		],
		"serviceLevel":{
			"service":"DST",
			"cod":null,
			"insurance":null
		},
		"shipmentDescription1":"description",
		"shipmentDescription2":""
	}
}

III. Struktura odpowiedzi

Status wysłanego żądania. Możliwe wartości:

• “OK” - żądanie przyjęte pomyślnie
• “Error” - żądanie nie zostało przyjęte, żądanie wymaga modyfikacji

Komunikat o błędzie lub dodatkowe informacje związane z wysyłką

Przykład:

	"message": {
        "uid": 14,
        "code": "E1108",
        "content": "The specified combination of the full zipCode and city could not be validated"
    }

Tablica zawierające informacje zwrotne dla poszczególnej paczki. W przypadku gdy jedna paczka nie posiada żadnych błędów, natomiast druga tak, nie zostaje utworzona żadna z nich.

Przykład:

	"responses": [
        {
            "referenceID": "GoLabel00001",
            "created": "2019-02-12",
            "message": {
                "uid": 46,
                "code": "G0032",
                "content": "ReferenceID already used."
            },
            "status": "Error",
            "id": 22674
        },
        {
            "referenceID": "GoLabel00002",
            "created": "2019-02-12",
            "status": "OK",
            "barcode": "123123123123",
            "tracking_number": "123123123",
            "id": 22675,
            "message": null
        }
    ],

IV. Przykład odpowiedzi

{
    "responses": [
        {
            "referenceID": "GoLabel00004",
            "created": "2019-02-12",
            "message": {
                "uid": 46,
                "code": "G0032",
                "content": "ReferenceID already used."
            },
            "status": "Error",
            "id": 22674
        },
        {
            "referenceID": "GoLabel00005",
            "created": "2019-02-12",
            "status": "OK",
            "barcode": "WW123123123123",
            "tracking_number": "WW123123123",
            "id": 22675,
            "message": null
        }
    ],
    "status": "Error",
    "message": {
        "uid": 46,
        "code": "G0032",
        "content": "ReferenceID already used."
    }
}

									

1.2 GetLabel

Metoda umożliwia pobieranie pojedynczych lub zbiorczych etykiet wysyłkowych z systemu. Wykonanie tego żądania wymagane jest by paczka pojawiła się w systemie danego kuriera. Etykiety mogą być generowane w różnych formatach oraz rozmiarach.

Adres na który wysyłamy żądanie:

• produkcyjny: https://gorest.goglobal24.com/get-label
• testowy: http://test-gorest.goglobal24.com/get-label

I. Struktura żądania

Struktura autoryzacji jest wymagana we wszystkich żądaniach. Istnieją dwa sposoby przejścia przez autoryzację w GoLabel REST API. Pierwszym jest podanie hasła oraz nazwy użytkownika, natomiast drugim jest hash użytkownika. Dane te są dostarczane przez administratorów GoLabel.

"hash": "{TwójHash}",
"userName": "{TwojaNazwaUżytkownika}",
"password": "{TwojeHasło}",

Właściwa część żądania, w niej zawarte są najważniejsze informacje.

II. Przykładowe żądanie

{
"userName": "username",
"password": "password",
"GetLabelRequest":
	{
	"referenceID": "GoLabel00001",
	"collectiveLabel": 1,
	"labelFormat": "PDF",
	"labelSize": "A4"
	}
}

III. Struktura odpowiedzi

Status wysłanego żądania. Możliwe wartości:

• “OK” - żądanie przyjęte pomyślnie
• ‘Error” - żądanie nie zostało przyjęte, żądanie wymaga modyfikacji

Komunikat o błędzie.

Przykład:

	"message": {
        "uid": 48,
        "code": "G0029",
        "content": "Incorrect labelFormat."
    }

Tablica zawierające informacje zwrotne dla poszczególnej paczki.

IV. Przykład odpowiedzi

{
    "responses": [
        {
            "referenceID": "GoLabel00001",
            "labelData": "aHR0cHM6Ly9sYWJlbC5nb2dsb2JhbDI0LmNvbS9mMWFiZDY3MDM1OGUwMzZjMzEyOTZlNjZiM2I2NmMzODJhYzAwODEyLzQxZDA4Nzc4YzNmYjgyNTkxNjgxODdlMTBmZWI4MDEzNDhmMWY0MGVtZ2jduywe",
            "status": "OK",
            "labelFormat": "PDF",
            "trackingNo": "TT008242375GB"
        },
        {
            "referenceID": "GoLabel00002",
            "labelData": "aHR0cHM6Ly9sYWJlbC5nb2dsb2JhbDI0LmNvbS9mMWFiZDY3MDM1OGUwMzZjMzEyOTZlNjZiM2I2NmMzODJidmrsODEyLzQxZDA4Nzc4YzNmYjgyNTkxNjgxODdlMTBmZWI4MDEzNDhmMWY0MGVtZ2jduywe",
            "status": "OK",
            "labelFormat": "PDF",
            "trackingNo": "TT008242389GB"
        }
    ]
}

									

1.3 Wiadomości błędów

2.1 Royal Mail

I. Dostępne serwisy

II. Dostępne typy

Pozostawione puste pole spowoduje wpisanie wartości domyślnych. Dla serwisów U24 i U48 będzie to wartość RL, dla pozostałych RP.

III. Waga

Pozostawione puste pole spowoduje wpisanie wartości 1.00.

IV. Ubezpieczenie

Serwis niedostępny dla tego kuriera.

V. Usługa płatności za pobraniem (COD)

Serwis niedostępny dla tego kuriera.

VI. Dodatkowe informacje

Serwisy U24 i U48 nie posiadają w RoyalMail własnego numeru śledzenia, dlatego też w systemie GoLabel został dodany własny numer - przykładowo 0044154;0038643.

VII. Przykłady żądań

{
    "userName": "username",
    "password": "password",
    "CreateShipmentsRequest002": {
        "shipmentType": "Delivery",
        "carrierName": "GB-ROYALMAIL",
        "shipperAddress": {
            "additionalDescription": "description"
        },
        "receiverAddress": {
            "nameOrCompany": "Birmingham Hippodrome",
            "additionalDescription": "description",
            "address1": "Hurst Street",
            "address2": "Southside",
            "city": "Birmingham",
            "zipCode": "B5 4TB",
            "region": "",
            "country": "GB",
            "email": "test@email.com",
            "phone": "123456765",
            "taxId": "",
            "pickupId": null
        },
        "invoiceNumber": "TT100/12/01/001",
        "orderValue": 100.50,
        "currency": "EUR",
        "payerAddress": null,
        "items": [
            {
                "referenceID": "GoLabel00010",
                "referenceID2": "",
                "type": "RP",
                "weight": "2.50",
                "products": [
                    {
                        "name": "turbocharger v1.3",
                        "number": "458152587412584",
                        "quantity": "1",
                        "price": 80.50,
                        "tariffCode": "85044030",
                        "originCountry": "DE",
                        "imageUrl": null
                    }
                ]
            }
        ],
        "serviceLevel": {
            "service": "T48"
        },
        "shipmentDescription1": "description",
        "shipmentDescription2": ""
    }
}

												

{
	"userName": "userName",
	"password": "password",
	"CreateShipmentsRequest002":{
		"shipmentType":"Return",
		"carrierName":"GB-ROYALMAIL",
		"shipperAddress": {
			"nameOrCompany":"Birmingham Hippodrome",
			"additionalDescription":"",
			"address1":"Hurst Street",
			"address2":"Southside",
			"city":"Birmingham",
			"zipCode":"B5 4TB",
			"region":"",
			"country":"GB",
			"email":"test@email.com",
			"phone":"123456765",
			"taxId":"",
			"pickupId":null
		},
		"receiverAddress":{
			"additionalDescription":"description"
		},
		"invoiceNumber": "TT100/12/01/001",
		"orderValue": 100.50,
		"currency": "EUR",
		"payerAddress":null,
		"items":[
			{
				"referenceID":"GoLabel000011",
				"referenceID2":"",
				"type":"RP",
				"weight":"2.50",
                "products": [
                    {
                        "name": "turbocharger v1.3",
                        "number": "458152587412584",
                        "quantity": "1",
                        "price": 80.50,
                        "tariffCode": "85044030",
                        "originCountry": "DE",
                        "imageUrl": null
                    }
                ]
			}
			],

		"serviceLevel":{
			"service":"R48"
		},
		"shipmentDescription1":"description",
		"shipmentDescription2":""
	}
}


												

{
"userName": "username",
"password": "password",
"GetLabelRequest":
	{
	"referenceID": "GoLabel00010",
	"collectiveLabel": 0,
	"labelFormat": "PDF",
	"labelSize": "A4"
	}
}


												

2.2 Colissimo

I. Dostępne serwisy

II. Dostępne typy

Pozostawione puste pole spowoduje wpisanie wartości CS.

III. Waga

Pozostawione puste pole spowoduje wpisanie wartości 1.00.

IV. Ubezpieczenie

Jedyną walutą obsługiwaną przez Colissimo jest EUR, a maksymalna wartość to 1500.

V. Usługa płatności za pobraniem (COD)

Jedyną walutą obsługiwaną przez Colissimo jest EUR, a maksymalna wartość to 1500.

VI. Dodatkowe informacje

VII. Przykłady żądań

{
	"userName":"username",
	"password":"password",
	"CreateShipmentsRequest002":{
		"shipmentType":"Delivery",
		"carrierName":"FR-COLISSIMO",
		"shipperAddress":{
			"additionalDescription":"description"
		},
		"receiverAddress":{
			"nameOrCompany":"Lucas About",
			"additionalDescription":"",
			"address1":"17 Rue Baron le Roy",
			"address2":"",
			"city":"Paris",
			"zipCode":"75012",
			"region":"",
			"country":"FR",
			"email":"test@email.com",
			"phone":"123456765",
			"taxId":"",
			"pickupId": null
		},
		"payerAddress":null,
		"items":[
			{
				"referenceID":"GoLabel000013",
				"referenceID2":"",
				"type":"CS",
				"weight":"1.00"
			}
		],
		"serviceLevel":{
			"service":"STC",
			"cod":null,
			"insurance":null
		},
		"shipmentDescription1":"description",
		"shipmentDescription2":""
	}
}

												

{
"userName": "username",
"password": "password",
"GetLabelRequest":
	{
	"referenceID": "GoLabel000013",
	"collectiveLabel": 0,
	"labelFormat": "PDF",
	"labelSize": "A4"
	}
}


												

2.3 DPD

I. Dostępne serwisy

II. Dostępne typy

Pozostawione puste pole spowoduje wpisanie wartości KP.

III. Waga

Pozostawione puste pole spowoduje wpisanie wartości 1.00.

IV. Ubezpieczenie

Serwis dostępny dla tego kuriera.

V. Usługa płatności za pobraniem (COD)

Serwis dostępny dla tego kuriera.

VI. Dodatkowe informacje

DPD przy zwrotach tworzy dwie etykiety, dlatego też przy metodzie getLabel zwracane są dwa zakodowane linki.

VII. Przykłady żądań

{
	"userName":"username",
	"password":"password",
	"CreateShipmentsRequest002":{
		"shipmentType":"Delivery",
		"carrierName":"DE-DPD",
		"shipperAddress":{
			"additionalDescription":"description"
		},
		"receiverAddress":{
			"nameOrCompany":"John Smith",
			"additionalDescription":"description",
			"address1":"Oldenburger Ring 3",
			"address2":"","city":"Markersdorf",
			"zipCode":"02829",
			"region":"",
			"country":"DE",
			"email":"john@smith.com",
			"phone":"",
			"taxId":"",
			"pickupId":null
		},
		"payerAddress":null,
		"items":[
			{
				"referenceID":"GoLabel000011",
				"referenceID2":"",
				"type":"NP",
				"weight":"1.00"
			}
		],
		"serviceLevel":{
			"service":"STT",
			"cod":null,
			"insurance":null
		},
		"shipmentDescription1":"description",
		"shipmentDescription2":""
	}
}

												

{
	"userName": "userName",
	"password": "password",
	"CreateShipmentsRequest002":{
		"shipmentType":"Return",
		"carrierName":"DE-DPD",
		"shipperAddress": {
			"nameOrCompany":"John Smith",
			"additionalDescription":"description",
			"address1":"Oldenburger Ring 3",
			"address2":"",
			"city":"Markersdorf",
			"zipCode":"02829",
			"region":"",
			"country":"DE",
			"email":"john@smith.com",
			"phone":"",
			"taxId":""
		},
		"receiverAddress":{
			"additionalDescription":"description"
		},
		"payerAddress":null,
		"items":[
			{
				"referenceID":"GoLabel00012",
				"referenceID2":"",
				"type":"NP",
				"weight":"1.00"
			}
			],

		"serviceLevel":{
			"service":"STT"
		},
		"shipmentDescription1":"description",
		"shipmentDescription2":""
	}
}

												

{
"userName": "username",
"password": "password",
"GetLabelRequest":
	{
	"referenceID": "GoLabel000011",
	"collectiveLabel": 0,
	"labelFormat": "PDF",
	"labelSize": "A4"
	}
}



												

2.4 DHL

I. Dostępne serwisy

Serwisy DHL w systemie GoLabel odróżniane są za pomocą wpisanych danych w polu address1. Przykładowo gdy chcemy wybrać Packstation wpisujemy tę frazę wraz z numerem paczkomatu.

Przykład:

“address1”: “Packstation 131”,

II. Dostępne typy

Pozostawione puste pole spowoduje wpisanie wartości NP.

III. Waga

Pozostawione puste pole spowoduje wpisanie wartości 1.00.

IV. Ubezpieczenie

Serwis niedostępny dla tego kuriera.

V. Usługa płatności za pobraniem (COD)

Jedyną walutą obsługiwaną przez DHL jest EUR. Możliwe wszystkie konta bankowe z obszaru SEPA.

Przykład:

	"cod":{
		"amount": 100,
		"currency": "EUR",
		"bankAccountOwner": "Test Company",
		"bankName": "Deutsche Bank",
		"bankAccountNumber": "DE12345678901234567890",
		"bic": "DEUTDEHHXXX"
	}

W przypadku nie podania danych konta bankowego, zostaną one uzupełnione danymi konta bankowego dla COD DHL z profilu Global24 użytkownika.

VI. Dodatkowe informacje

Istnieje możliwość tworzenia paczek międzynadorowych dla DHL

Dopuszczalna ilość znaków w pozycji additionalDescription w adresie nadawcy (w przypadku shipmentType: Delivery) oraz adres odbiorcy (w przypadku shipmentType: Return) wynosi 5 znaków.

W przypadku wyboru Packstation należy w polu address1 podać "Packstation" oraz numer paczkomatu, np. "Packstation 131", natomiast w polu address2 obowiązkowo musi znaleźć się numer pocztowy (Postnummer).

VII. Przykłady żądań

{
	"userName":"username",
	"password":"password",
	"CreateShipmentsRequest002":{
		"shipmentType":"Delivery",
		"carrierName":"DE-DHL",
		"shipperAddress":{
			  "additionalDescription":"description"
		},
		"receiverAddress":{
			  "nameOrCompany":"Kathleen",
			  "additionalDescription":"",
			  "address1":"Packstation 131",
			  "address2":"903729505",
			  "city":"Weil am Rhein",
			  "zipCode":"79576",
			  "region":"",
			  "country":"DE",
			  "email":"test@email.com",
			  "phone":"123456765",
			  "taxId":"",
			  "pickupId": null
		},
		"payerAddress":null,
		"items":[
			{
				"referenceID":"GoLabel000014",
				"referenceID2":"",
				"type":"NP",
				"weight":"1.00"
			}
		],
		"serviceLevel":{
			"service":"DST",
			"cod":null,
			"insurance":null
		},
		"shipmentDescription1":"description",
		"shipmentDescription2":""
	}
}


												

{
"userName": "username",
"password": "password",
"GetLabelRequest":
	{
	"referenceID": "GoLabel000014",
	"collectiveLabel": 0,
	"labelFormat": "PDF",
	"labelSize": "A4"
	}
}


												

2.5 Fedex

I. Dostępne serwisy

II. Dostępne typy

Pozostawione puste pole spowoduje wpisanie wartości "PC".

III. Waga

Pozostawione puste pole spowoduje wpisanie wartości 1.00.

IV. Ubezpieczenie

Ubezpieczenie jest wymagane w przypadku korzystania z usługi płatności za pobaniem. Pole Opis (Insurance description) jest wymagane. Kwota ubezpieczneia musi być podna w walucie PLN oraz nie może być niższa niż kwota pobrania.

V. Usługa płatności za pobraniem (COD)

Jedyną walutą obsługiwaną przez Fedex jest PLN.

VI. Dodatkowe informacje

W przypadku użycia usługi płatności za pobraniem(COD) pole referneceID2 jest wymagane (należy podać w nim numer konta bankowego). Etykiety dla tego kuriera dostępne są tylko w formacie PDF i wielkości A4.

VII. Przykłady żądań

{
	"userName":"username",
	"password":"password",
	"CreateShipmentsRequest002":{
		"shipmentType":"Delivery",
		"carrierName":"PL-FEDEX",
		"receiverAddress":{
                        "nameOrCompany":"Jan Nowak",
                        "address1":"Stara 4",
                        "address2":"",
                        "city":"Karwiany",
                        "zipCode":"52-200",
                        "region":"",
                        "country":"PL",
                        "email":"test@email.com",
                        "phone":"123456765",
                        "taxId":"",
                        "pickupId": null
		},
		"payerAddress":null,
		"items":[
			{
				"referenceID":"GoLabel000014",
				"referenceID2":"",
				"type":"PC",
				"weight":"1.00"
			}
		],
		"serviceLevel":{
			"service":"FST",
			"cod":null,
			"insurance":null
		},
		"shipmentDescription1":"description",
		"shipmentDescription2":""
	}
}


												

{
"userName": "username",
"password": "password",
"GetLabelRequest":
	{
	"referenceID": "GoLabel000014",
	"collectiveLabel": 0,
	"labelFormat": "PDF",
	"labelSize": "A4"
	}
}


												

2.6 Parcel Post

I. Dostępne serwisy

II. Dostępne typy

Pozostawione puste pole spowoduje wpisanie wartości NP.

III. Waga

Pozostawione puste pole spowoduje wpisanie wartości 1.00.

IV. Ubezpieczenie

Serwis niedostępny dla tego kuriera.

V. Usługa płatności za pobraniem (COD)

Serwis niedostępny dla tego kuriera.

VI. Dodatkowe informacje

Przesyłka pocztowa

VII. Przykłady żądań

{
	"userName":"username",
	"password":"password",
	"CreateShipmentsRequest002":{
		"shipmentType":"Delivery",
		"carrierName":"Parcel Post",
		"shipperAddress":{
			"additionalDescription":"description"
		},
		"receiverAddress":{
			"nameOrCompany":"John Smith",
			"additionalDescription":"description",
			"address1":"Oldenburger Ring 3",
			"address2":"","city":"Markersdorf",
			"zipCode":"02829",
			"region":"",
			"country":"DE",
			"email":"john@smith.com",
			"phone":"",
			"taxId":"",
			"pickupId":null
		},
		"payerAddress":null,
		"items":[
			{
				"referenceID":"GoLabel000011",
				"referenceID2":"",
				"type":"NP",
				"weight":"1.00"
			}
		],
		"serviceLevel":{
			"service":"PP",
			"cod":null,
			"insurance":null
		},
		"shipmentDescription1":"description",
		"shipmentDescription2":""
	}
}

										

{
"userName": "username",
"password": "password",
"GetLabelRequest":
	{
	"referenceID": "GoLabel000011",
	"collectiveLabel": 0,
	"labelFormat": "PDF",
	"labelSize": "A4"
	}
}

										

2.7 Post AT

I. Dostępne serwisy

II. Dostępne typy

Pozostawione puste pole spowoduje wpisanie wartości AP.

III. Waga

IV. Ubezpieczenie

Serwis niedostępny dla tego kuriera.

V. Usługa płatności za pobraniem (COD)

Serwis niedostępny dla tego kuriera.

VI. Dodatkowe informacje

VII. Przykłady żądań

{
	"userName":"username",
	"password":"password",
	"CreateShipmentsRequest002":{
		"shipmentType":"Delivery",
		"carrierName":"POST-AT",
		"receiverAddress":{
			  "nameOrCompany":"Alexis Trintignant",
			  "additionalDescription":"",
			  "address1":"Teststrasse",
			  "address2":"",
			  "city":"Wien",
			  "zipCode":"1030",
			  "region":"",
			  "country":"AT",
			  "email":"test@email.com",
			  "phone":"+33123456765",
			  "taxId":"",
			  "pickupId": null
		},
		"payerAddress":null,
		"items":[
			{
				"referenceID":"GoLabel000014",
				"referenceID2":"",
				"type":"AP",
				"weight":"1"
			}
		],
		"serviceLevel":{
			"service":"APS",
			"cod":null,
			"insurance":null
		},
		"shipmentDescription1":"description",
		"shipmentDescription2":""
	}
}

												

{
	"userName": "userName",
	"password": "password",
	"CreateShipmentsRequest002":{
		"shipmentType":"Return",
		"carrierName":"POST-AT",
		"shipperAddress": {
			  "nameOrCompany":"Alexis Trintignant",
			  "additionalDescription":"",
			  "address1":"Teststrasse",
			  "address2":"",
			  "city":"Wien",
			  "zipCode":"1030",
			  "region":"",
			  "country":"AT",
			  "email":"test@email.com",
			  "phone":"+33123456765",
			  "taxId":"",
			  "pickupId": null
		},
		"receiverAddress":{
			"additionalDescription":"description"
		},
		"payerAddress":null,
		"items":[
			{
				"referenceID":"GoLabel00015",
				"referenceID2":"",
				"type":"AP",
				"weight":"31.5"
			}
		],

		"serviceLevel":{
			"service":"APS"
		},
		"shipmentDescription1":"description",
		"shipmentDescription2":""
	}
}

												

{
"userName": "username",
"password": "password",
"GetLabelRequest":
	{
	"referenceID": "GoLabel000014",
	"collectiveLabel": 0,
	"labelFormat": "PDF",
	"labelSize": "A4"
	}
}

2.8 GLS-IT

I. Dostępne serwisy

II. Dostępne typy

Pozostawione puste pole spowoduje wpisanie wartości "ST".

III. Waga

IV. Ubezpieczenie

Serwis niedostępny dla tego kuriera.

V. Usługa płatności za pobraniem (COD)

Serwis niedostępny dla tego kuriera.

VI. Dodatkowe informacje

VII. Przykłady żądań

{
	"userName":"username",
	"password":"password",
	"CreateShipmentsRequest002":{
		"shipmentType":"Delivery",
		"carrierName":"GLS-IT",
		"receiverAddress":{
                    "nameOrCompany": "Test Company",
                    "address1": "Piazza del Colosseo, 1",
                    "address2": "",
                    "city": "Roma",
                    "zipCode": "00184",
                    "region": "",
                    "country": "IT",
                    "email": "email@email.com",
                    "phone": "123456765",
                    "taxId": "",
                    "pickupId": null
		},
		"payerAddress":null,
		"items":[
			{
				"referenceID":"GoLabel000014",
				"referenceID2":"",
				"type":"ST",
				"weight":"1"
			}
		],
		"serviceLevel":{
			"service":"GLI",
			"cod":null,
			"insurance":null
		},
		"shipmentDescription1":"description",
		"shipmentDescription2":""
	}
}


												

{
"userName": "username",
"password": "password",
"GetLabelRequest":
	{
	"referenceID": "GoLabel000014",
	"collectiveLabel": 0,
	"labelFormat": "PDF",
	"labelSize": "A4"
	}
}


												

2.9 Correos

I. Dostępne serwisy

II. Dostępne typy

Pozostawione puste pole spowoduje wpisanie wartości ST.

III. Waga

Pozostawione puste pole spowoduje wpisanie wartości 1.00.

IV. Ubezpieczenie

Serwis niedostępny dla tego kuriera.

V. Usługa płatności za pobraniem (COD)

Serwis niedostępny dla tego kuriera.

VI. Dodatkowe informacje

VII. Przykłady żądań

{
	"userName":"username",
	"password":"password",
	"CreateShipmentsRequest002":{
		"shipmentType":"Delivery",
		"carrierName":"ES-CORREOS",
		"shipperAddress":{
			"additionalDescription":"description"
		},
		"receiverAddress":{
			"nameOrCompany":"John Smith",
			"additionalDescription":"description",
			"address1":"Calle Albacete 27",
			"address2":"PORTE 0012",
			"city":"Yuncosd",
			"zipCode":"45210",
			"region":"",
			"country":"ES",
			"email":"info@global24.com",
			"phone":"+48603040604",
			"taxId":"",
			"pickupId": null
		},
		"payerAddress":null,
		"items":[
			{
				"referenceID":"GoLabel000011",
				"referenceID2":"",
				"type":"ST",
				"weight":"1.00"
			}
		],
		"serviceLevel":{
			"service":"CST",
			"cod":null,
			"insurance":null
		},
		"shipmentDescription1":"description",
		"shipmentDescription2":""
	}
}

												

{
	"userName": "userName",
	"password": "password",
	"CreateShipmentsRequest002":{
		"shipmentType":"Return",
		"carrierName":"ES-CORREOS",
		"shipperAddress": {
			"nameOrCompany":"John Smith",
			"additionalDescription":"description",
			"address1":"Calle Albacete 27",
			"address2":"PORTE 0012",
			"city":"Yuncosd",
			"zipCode":"45210",
			"region":"",
			"country":"ES",
			"email":"info@global24.com",
			"phone":"+48603040604",
			"taxId":"",
			"pickupId": null
		},
		"receiverAddress":{
			"additionalDescription":"description"
		},
		"payerAddress":null,
		"items":[
			{
				"referenceID":"GoLabel00012",
				"referenceID2":"",
				"type":"ST",
				"weight":"1.00"
			}
		],

		"serviceLevel":{
			"service":"CRT"
		},
		"shipmentDescription1":"description",
		"shipmentDescription2":""
	}
}

												

{
"userName": "username",
"password": "password",
"GetLabelRequest":
	{
	"referenceID": "GoLabel000011",
	"collectiveLabel": 0,
	"labelFormat": "PDF",
	"labelSize": "A4"
	}
}



												

2.10 Hermes

I. Dostępne serwisy

II. Dostępne typy

Pozostawione puste pole spowoduje wpisanie wartości ST.

III. Waga

Pozostawione puste pole spowoduje wpisanie wartości 1.00.

IV. Ubezpieczenie

Serwis niedostępny dla tego kuriera.

V. Usługa płatności za pobraniem (COD)

Serwis niedostępny dla tego kuriera.

VI. Dodatkowe informacje

VII. Przykłady żądań

{
    "userName":"username",
    "password":"password",
    "CreateShipmentsRequest002": {
        "shipmentType": "Delivery",
        "carrierName": "GB-HERMES",
        "shipperAddress": {
        },
        "receiverAddress": {
            "nameOrCompany": "Test Company",
            "additionalDescription": "",
            "address1": "103 Gatliff Rd",
            "address2": "",
            "city": "London",
            "zipCode": "SW1W 8BA",
            "region": "",
            "country": "GB",
            "email": "email@email.com",
            "phone": "123456765",
            "taxId": "",
            "pickupId": null
        },
        "invoiceNumber": "TT100/12/01/001",
        "orderValue": 500.50,
        "currency": "EUR",
        "payerAddress": null,
			"items":[
				{
					"referenceID":"GoLabel000011",
					"referenceID2":"",
					"type":"ST",
					"weight":"1",
					"products":[
			                	{
			                		"name": "Giant turtle toy",
			                		"number": "458152587412584",
			                		"quantity": "2",
			                		"price": "20.45",
			                		"tariffCode": "95049080",
			                		"originCountry": "DE",
			                		"imageUrl": "url_to_photo.com"
			                	},
			                	{
			                		"name": "exchaust",
			                		"number": "398155774553544",
			                		"quantity": "3",
			                		"price": "15.32",
			                		"tariffCode": "87141090",
			                		"originCountry": "DE",
			                		"imageUrl": "url_to_photo.com"
			                	}
	                		]
				}
			],
        "serviceLevel": {
            "service": "HST"
        },
        "shipmentDescription1": "",
        "shipmentDescription2": ""
    }
}

												

{
"userName": "username",
"password": "password",
"GetLabelRequest":
	{
	"referenceID": "GoLabel000011",
	"collectiveLabel": 0,
	"labelFormat": "PDF",
	"labelSize": "A4"
	}
}



												

2.11 Post NL

I. Dostępne serwisy

II. Dostępne typy

Pozostawione puste pole spowoduje wpisanie wartości ST.

III. Waga

Pozostawione puste pole spowoduje wpisanie wartości 1.00.

IV. Ubezpieczenie

Serwis niedostępny dla tego kuriera.

V. Usługa płatności za pobraniem (COD)

Serwis niedostępny dla tego kuriera.

VI. Dodatkowe informacje

VII. Przykłady żądań

{
	"userName":"username",
	"password":"password",
	"CreateShipmentsRequest002":{
		"shipmentType":"Delivery",
		"carrierName":"POST-NL",
		"shipperAddress":{
			"additionalDescription":"description"
		},
		"receiverAddress":{
			"nameOrCompany":"John Smith",
			"additionalDescription":"description",
			"address1":"Prinses Beatrixlaan 23",
			"address2":"Floor 10",
			"city":"Den Haag",
			"zipCode":"2595AK",
			"region":"",
			"country":"NL",
			"email":"info@global24.com",
			"phone":"+48603040604",
			"taxId":"",
			"pickupId": null
		},
		"payerAddress":null,
		"items":[
			{
				"referenceID":"GoLabel000011",
				"referenceID2":"",
				"type":"ST",
				"weight":"1.00"
			}
		],
		"serviceLevel":{
			"service":"PPHD",
			"cod":null,
			"insurance":null
		},
		"shipmentDescription1":"description",
		"shipmentDescription2":""
	}
}

												

{
	"userName": "userName",
	"password": "password",
	"CreateShipmentsRequest002":{
		"shipmentType":"Return",
		"carrierName":"POST-NL",
		"shipperAddress": {
			"nameOrCompany":"John Smith",
			"additionalDescription":"description",
			"address1":"Prinses Beatrixlaan 23",
			"address2":"Floor 10",
			"city":"Den Haag",
			"zipCode":"2595AK",
			"region":"",
			"country":"NL",
			"email":"info@global24.com",
			"phone":"+48603040604",
			"taxId":"",
			"pickupId": null
		},
		"receiverAddress":{
			"additionalDescription":"description"
		},
		"payerAddress":null,
		"items":[
			{
				"referenceID":"GoLabel00012",
				"referenceID2":"",
				"type":"ST",
				"weight":"1.00"
			}
		],

		"serviceLevel":{
			"service":"PPHD"
		},
		"shipmentDescription1":"description",
		"shipmentDescription2":""
	}
}

												

{
"userName": "username",
"password": "password",
"GetLabelRequest":
	{
	"referenceID": "GoLabel000011",
	"collectiveLabel": 0,
	"labelFormat": "PDF",
	"labelSize": "A4"
	}
}



												

2.12 Nova Poshta

I. Dostępne serwisy

II. Dostępne typy

Pozostawione puste pole spowoduje wpisanie wartości NR.

III. Waga

Pozostawione puste pole spowoduje wpisanie wartości 1.00.

IV. Ubezpieczenie

Serwis niedostępny dla tego kuriera.

V. Usługa płatności za pobraniem (COD)

Jedyną walutą obsługiwaną przez Nova Poshta jest UAH.

VI. Dodatkowe informacje

Adres

Aktualnie możliwe jest wprowadzanie danych adresowych jedynie w języku ukraińskim (cyrylicą).

Odprawa exportowa

Przesyłki do Ukrainy objęte są odprawą exportową. Obowiązkowo należy wprowadzić numer faktury, wartość zamówienia oraz walutę (odpowiadającą walucie ceny przedmiotów), a także wprowadzić znajdujące się w paczce przedmioty, z uzupełnionymi polami: nazwa produktu, numer SKU, ilość, cena, kod taryfy celnej oraz kraj pochodzenia.

Zwroty

Nie ma możliwości samodzielnego generowania zwrotów. Odbiorca paczki może skorzystać z bezpłatnej opcji "Easy Return" w aplikacji Nova Poshta lub nadać paczkę bezpośrednio w oddziale Nova Poshta.

VII. Przykłady żądań

{
   "userName":"username",
   "password":"password",
   "CreateShipmentsRequest002":{
      "shipmentType":"Delivery",
      "carrierName":"UA-NOVA-POSHTA",
      "receiverAddress":{
                "nameOrCompany":"Випробувальна компанія",
                "additionalDescription":"перший поверх",
                "address1":"Героїв України 1",
                "address2":"",
                "city":"Бровари",
                "zipCode":"07400",
                "region":"Волинська область",
                "country":"UA",
                "email":"test@email.com",
                "phone":"+380660000000",
                "taxId":"",
                "pickupId":null
      },
      "invoiceNumber":"TT100/12/01/001",
      "orderValue":500.50,
      "currency":"UAH",
      "payerAddress":null,
      "items":[
         {
            "referenceID":"NovaPoshta000001",
            "referenceID2":"",
            "type":"NR",
            "weight":"3.00",
            "products":[
               {
                  "name":"Giant turtle toy",
                  "number":"458152587412584",
                  "quantity":"2",
                  "price":"20.45",
                  "tariffCode":"95049080",
                  "originCountry":"DE"
               },
               {
                  "name":"exchaust",
                  "number":"398155774553544",
                  "quantity":"3",
                  "price":"15.32",
                  "tariffCode":"87141090",
                  "originCountry":"DE",
                  "imageUrl":"url_to_photo.com"
               }
            ]
         }
      ],
      "serviceLevel":{
         "service":"NPS",
         "cod":null,
         "insurance":null
      },
      "shipmentDescription1":"description",
      "shipmentDescription2":""
   }
}

{
   "userName":"username",
   "password":"password",
   "GetLabelRequest":{
      "referenceID":"NovaPoshta000001",
      "collectiveLabel":0,
      "labelFormat":"PDF",
      "labelSize":"A4"
   }
}

Tracking (metoda GET) - Pojedyńczo - TYMCZASOWO NIEDOSTĘPNE

Metoda pozwala na zwracanie statusu paczki w formacie JSON. Uwaga: nie wszystkie zwracane pola u kurierów zwierają dane.

Adres na który wysyłamy żądanie:

• produkcyjny: http://api.goglobal24.com/tracking
• testowy: http://test-goreturns-api.goglobal24.com/tracking

I. Struktura żądania

II. Struktura odpowiedzi

III. Przykłady

http://api.goglobal24.com/tracking?code=00340434314501512185

{
    "success": true,
    "trackingCourierUrl": "https://www.royalmail.com/track-your-item#/tracking-results/KT338882630GB",
    "trackingCode": "KT338882630GB",
    "trackingData": [
        {
            "zipCode": null,
            "city": "Olkusz",
            "country": "PL",
            "createdDate": "17/11/19 18:20",
            "status": "created",
            "statusFull": null,
            "note": null,
            "courier": "Global24"
        },
        {
            "zipCode": null,
            "city": "Nowa Wieś Wrocławska",
            "country": "PL",
            "createdDate": "11/12/19 10:23",
            "status": "received",
            "statusFull": null,
            "note": null,
            "courier": "Global24"
        },
        {
            "zipCode": null,
            "city": "Medway Mail Centre",
            "country": "GB",
            "createdDate": "13/12/19 10:12",
            "status": "carrier",
            "statusFull": "Item Received",
            "note": null,
            "courier": "GB-ROYALMAIL"
        },
        {
            "zipCode": null,
            "city": "Home Counties North MC",
            "country": "GB",
            "createdDate": "14/12/19 00:12",
            "status": "carrier",
            "statusFull": "Item Received",
            "note": null,
            "courier": "GB-ROYALMAIL"
        },
        {
            "zipCode": null,
            "city": "Hatfield AL DO",
            "country": "GB",
            "createdDate": "14/12/19 04:12",
            "status": "carrier",
            "statusFull": "Due to be delivered today",
            "note": null,
            "courier": "GB-ROYALMAIL"
        },
        {
            "zipCode": null,
            "city": "Hatfield AL DO",
            "country": "GB",
            "createdDate": "14/12/19 10:12",
            "status": "delivered",
            "statusFull": "Delivered by",
            "note": null,
            "courier": "GB-ROYALMAIL"
        }
    ]
}

{
    "success": false,
    "message": "No result found for your code"
}

Tracking (metoda GET) - Grupowo

Metoda pozwala na zwracanie ostatnich statusów w formacie JSON dla maksymalnie 100 kodów śledzenia. Uwaga: nie wszystkie zwracane pola u kurierów zwierają dane. Zwracane są tylko znalezione paczki.

Adres na który wysyłamy żądanie:

• produkcyjny: http://api.goglobal24.com/tracking/group
• testowy: http://test-goreturns-api.goglobal24.com/tracking/group

I. Struktura żądania

II. Struktura odpowiedzi

III. Przykłady

http://api.goglobal24.com/tracking/group?codes=6A16061440938,00340434314501512185,00340434314502556980

{
    "success": true,
    "data": [
        {
            "trackingCourierUrl": "https://www.dhl.de/en/privatkunden/pakete-empfangen/verfolgen.html?piececode=00340434314501512185&cid=dhlde",
            "trackingCode": "00340434314501512185",
            "trackingData": {
                "zipCode": null,
                "city": "Sölden",
                "country": "DE",
                "createdDate": "06/05/20 12:05",
                "status": "delivered",
                "statusFull": "The shipment has been successfully delivered",
                "note": null,
                "courier": "DE-DHL"
            }
        },
        {
            "trackingCourierUrl": "https://www.dhl.de/en/privatkunden/pakete-empfangen/verfolgen.html?piececode=00340434314502556980&cid=dhlde",
            "trackingCode": "00340434314502556980",
            "trackingData": {
                "zipCode": null,
                "city": "Lublin",
                "country": "PL",
                "createdDate": "27/05/20 09:17",
                "status": "created",
                "statusFull": null,
                "note": null,
                "courier": "Global24"
            }
        },
        {
            "trackingCourierUrl": "https://www.laposte.fr/outils/track-a-parcel?code=6A16061440938",
            "trackingCode": "6A16061440938",
            "trackingData": {
                "zipCode": null,
                "city": "Lublin",
                "country": "PL",
                "createdDate": "27/05/20 09:17",
                "status": "created",
                "statusFull": null,
                "note": null,
                "courier": "Global24"
            }
        }
    ]
}

{
    "success": false,
    "message": "Error message"
}

Inventory (metoda GET)

Metoda pozwala na zwracanie stanów magazynowych aktywnych produktów użytownika.

Adres na który wysyłamy żądanie:

• produkcyjny: http://api.goglobal24.com/warehouse/status
• testowy: http://test-goreturns-api.goglobal24.com/warehouse/status

I. Struktura żądania

Typ autoryzacji: Basic Auth

Dane dostępowe (login oraz hasło) są danymi używanymi do zalogowania się na Global24:

• https://portal.goglobal24.com

II. Struktura odpowiedzi

III. Przykłady

[
    {
        "name": "Iphone",
        "description": "Iphone X  - 256GB",
        "itemid": "123456",
        "code": "123456",
        "currentStock": 0
    },
    {
        "name": "Samsung TV",
        "description": "TV 60 4k",
        "itemid": "123456",
        "code": "123456",
        "currentStock": 31
    },
    {
        "name": "Samsung charger",
        "description": "Samsung Wireless Charger Stand",
        "itemid": "123456",
        "code": "123456",
        "currentStock": 39
    }
]