Міжнародні відправлення з Європи до США
Ця сторінка описує процес створення відправлень з Європи для міжнародної доставки до США.
JWT-токен авторизації зі строком дії 1 годину у заголовку
Визначає поточний статус транспортного документа, відстежуючи його проходження через життєвий цикл доставки.
Представляє всі можливі ідентифікатори замовлення, пов’язані з відправленням.
Тут може бути вказана будь-яка додаткова інформація або спеціальні інструкції щодо замовлення.
Визначає тип тарифу, який буде застосовано до відправлення під час створення або оновлення.
Визначає, хто несе відповідальність за оплату послуг доставки.
Обов’язковий для платежів із типом платника ThirdPerson, а також для безготівкових платежів, якщо payerType має значення Sender або Recipient.
Відправлення успішно створено.
Унікальний ідентифікатор, що призначається кожному відправленню, який використовується для внутрішніх операцій, таких як модифікація, пошук у системі та видалення відправлень. Поле id слугує ключовим посиланням для адміністративних і логістичних процесів у системі доставки, забезпечуючи точний доступ і керування записами відправлень.
Номер транспортного документа, який надається клієнтам для відстеження та доступу до друкованих форм. Також використовується для пошуку відправлень у системі, забезпечуючи зручний спосіб моніторингу їхнього статусу. Хоча number використовується зовні для відстеження та документації, у деяких випадках він може застосовуватись і для внутрішньої ідентифікації, подібно до id.
^[A-Z]{4}\d{10}$Орієнтовна дата доставки, розрахована на основі маршруту та рівня сервісу. Може змінюватися залежно від логістичних та зовнішніх факторів. Дата у форматі ISO 8601.
2023-04-14T09:00:00ZПоточний статус відправлення. Під час створення встановлюється значення "ReadyToShip", що означає готовність до відправки.
Загальна вартість послуг доставки, розрахована на основі розміру, ваги, напрямку та обраних сервісів.
31.5Загальна кількість місць (посилок) у відправленні. Використовується для планування логістики та відстеження.
Дата та час створення запису відправлення в системі. Формат ISO 8601.
2023-04-11T10:42:05ZДата та час останнього оновлення відправлення. Використовується для відстеження змін. Формат ISO 8601.
2023-04-11T10:42:05ZДата та час видалення або скасування відправлення. Якщо відправлення не скасовано — значення null.
Неавторизований доступ
Вказаний ресурс не знайдено
Помилка валідації
Час очікування з’єднання вичерпано
POST /v.1.0/shipments HTTP/1.1
Host: api-stage.novapost.com/
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 1018
{
"status": "ReadyToShip",
"clientOrder": "",
"note": "",
"payerType": "Sender",
"invoice": {
"incoterm": "DAP",
"exportReason": "Selling",
"cost": 80,
"currency": "USD",
"items": [
{
"amount": 1,
"measurementCode": "pieces",
"cost": 80,
"actualWeight": 300,
"name": "Convertible roof hydraulic pump",
"nameEng": "Convertible roof hydraulic pump",
"hsCode": "8413602000",
"id": null,
"madeInCountryCode": null,
"serialNumber": null,
"material": null,
"materialEng": null
}
],
"customerNumber": null,
"customerCreatedAt": null,
"type": null,
"payerFeesCustoms": null
},
"services": [],
"parcels": [
{
"cargoCategory": "parcel",
"number": null,
"parcelDescription": "parcel for test",
"insuranceCost": 100,
"rowNumber": 1,
"width": 200,
"length": 350,
"height": 100,
"actualWeight": 300,
"volumetricWeight": 300
}
],
"sender": {
"companyTin": "",
"companyName": "",
"phone": "380007654321",
"email": "sender@test.com",
"name": "Maks Tester",
"countryCode": "PL",
"divisionId": 1,
"ioss": null
},
"recipient": {
"phone": "12125551234",
"email": "recipient@test.com",
"name": "Chuck Norris",
"countryCode": "US",
"divisionId": 2138547
}
}{
"id": 4673662,
"number": "SHPL2643850049",
"scheduledDeliveryDate": "2026-10-05T22:00:00.000000Z",
"status": "ReadyToShip",
"cost": 180,
"parcelsAmount": 1,
"createdAt": "2026-09-21T09:36:05.284005Z",
"updatedAt": "2026-09-21T09:36:05.284005Z",
"deletedAt": null,
"recipientsArea": null,
"recipientsAreaNumber": null,
"deliveryPartners": [
{
"id": 3678025,
"shipmentId": 4673662,
"type": "LastMile",
"name": "UPS",
"number": "1ZXXXXXXXXXXXXXXXX",
"main": true,
"parcelNumber": null,
"createdAt": "2026-09-21T09:36:05.284005Z",
"updatedAt": "2026-09-21T09:36:05.284005Z",
"deletedAt": null,
"flags": [
"Shipment",
"Deletion",
"Marking"
],
"routeId": null,
"divisionId": 1935309,
"countryCode": "PL",
"status": "Created"
},
{
"id": 3678026,
"shipmentId": 4673662,
"type": "LastMile",
"name": "UPS",
"number": "1ZXXXXXXXXXXXXXXXX",
"main": false,
"parcelNumber": "SHPL2643850049",
"createdAt": "2026-09-21T09:36:05.284005Z",
"updatedAt": "2026-09-21T09:36:05.284005Z",
"deletedAt": null,
"flags": [
"Tracking",
"Scanning"
],
"routeId": null,
"divisionId": 1935309,
"countryCode": "PL",
"status": "Created"
}
],
"services": [
{
"id": "20441618",
"shipmentId": "4673662",
"shipmentParcelRowNumber": null,
"serviceId": "5637144609",
"serviceName": "Insurance",
"amount": 100,
"contractNumber": null,
"payerType": "Sender",
"paymentStatus": "FreeOfCharge",
"divisionId": null,
"price": 0,
"discount": 0,
"cost": 0,
"currencyCode": "PLN",
"user": "4ec5890f-d49f-4ce1-ae35-98c41f03910c",
"shipmentLockVersion": 1,
"additionalParameters": {
"countryCode": null,
"divisionId": null,
"addressParts": null,
"cod": null,
"backwardDelivery": null,
"partner": null,
"codPaymentService": null,
"sameDay": null,
"longStorageDays": null,
"recipientPhoneAlternative": null,
"quantity": null,
"actionType": null,
"restrictions": null,
"payerType": null,
"thirdPerson": null,
"multipleReturns": null,
"hybridPayment": null,
"processOption": null,
"consolidationMerchantTin": null,
"date": null,
"from": null,
"to": null,
"string": null,
"fullName": null,
"phone": null
},
"createdAt": "2026-09-21T09:36:05.284005Z",
"updatedAt": "2026-09-21T09:36:05.284005Z"
},
{
"id": "20441619",
"shipmentId": "4673662",
"shipmentParcelRowNumber": null,
"serviceId": "5640076500",
"serviceName": "CustomsBrokerageDEST",
"amount": 100,
"contractNumber": null,
"payerType": "Sender",
"paymentStatus": "FreeOfCharge",
"divisionId": null,
"price": 0,
"discount": 0,
"cost": 0,
"currencyCode": "PLN",
"user": "4ec5890f-d49f-4ce1-ae35-98c41f03910c",
"shipmentLockVersion": 1,
"additionalParameters": {
"countryCode": null,
"divisionId": null,
"addressParts": null,
"cod": null,
"backwardDelivery": null,
"partner": null,
"codPaymentService": null,
"sameDay": null,
"longStorageDays": null,
"recipientPhoneAlternative": null,
"quantity": null,
"actionType": null,
"restrictions": null,
"payerType": null,
"thirdPerson": null,
"multipleReturns": null,
"hybridPayment": null,
"processOption": null,
"consolidationMerchantTin": null,
"date": null,
"from": null,
"to": null,
"string": null,
"fullName": null,
"phone": null
},
"createdAt": "2026-09-21T09:36:05.284005Z",
"updatedAt": "2026-09-21T09:36:05.284005Z"
},
{
"id": "20441620",
"shipmentId": "4673662",
"shipmentParcelRowNumber": "1",
"serviceId": "5637144588",
"serviceName": "InternationalParcelS",
"amount": 1,
"contractNumber": null,
"payerType": "Sender",
"paymentStatus": "NeedPay",
"divisionId": null,
"price": 180,
"discount": 0,
"cost": 180,
"currencyCode": "PLN",
"user": "4ec5890f-d49f-4ce1-ae35-98c41f03910c",
"shipmentLockVersion": 1,
"additionalParameters": {
"countryCode": null,
"divisionId": null,
"addressParts": null,
"cod": null,
"backwardDelivery": null,
"partner": null,
"codPaymentService": null,
"sameDay": null,
"longStorageDays": null,
"recipientPhoneAlternative": null,
"quantity": null,
"actionType": null,
"restrictions": null,
"payerType": null,
"thirdPerson": null,
"multipleReturns": null,
"hybridPayment": null,
"processOption": null,
"consolidationMerchantTin": null,
"date": null,
"from": null,
"to": null,
"string": null,
"fullName": null,
"phone": null
},
"createdAt": "2026-09-21T09:36:05.284005Z",
"updatedAt": "2026-09-21T09:36:05.284005Z"
}
],
"parcels": [
{
"number": "SHPL2643850049",
"rowNumber": 1,
"untied": false,
"pricingType": "parcel",
"cargoCategory": null,
"cargoCategoryId": 2,
"parcelDescription": "parcel for test",
"insuranceCost": 100,
"length": 350,
"width": 200,
"height": 100,
"actualWeight": 300,
"volumetricWeight": 1750,
"recipient": null,
"clientParcel": null
}
]
}Останнє оновлення