Друк документів

Друк транспортних документів

get

/shipments/print

Цей API-метод дозволяє отримати маркування транспортного документа у форматі PDF за номером документа. Маркування документа є документом для друку, який клієнти можуть прикріпити або наклеїти на свій вантаж під час його відправлення. Вказавши номер документа в запиті, ви можете згенерувати PDF-файл, що містить маркування документа, для зручного друку.

Authorizations

AuthorizationstringRequired

JWT-токен авторизації зі строком дії 1 годину у заголовку

Query parameters

numbers[]stringOptional

Номери відправлень. Може приймати як один номер, так і масив номерів. Якщо використовується type=marking, у межах одного запиту дозволяється передавати лише один номер.

Example: SHPL1234567890

typearray · enumOptional

Тип документа для друку.

• marking: для маркування відправлення 100×100 (внутрішнього або міжнародного)
• international: для митної декларації/інвойсу
• invoice: для комерційного інвойсу

Possible values:

printSizeTypearrayOptional

Вибір розміру документа.

Для type=marking цей параметр визначає тип запиту на друк маркування, але не гарантує кінцевий фізичний формат PDF-файлу, який повертає сервіс.

Кінцевий формат етикетки визначається автоматично відповідно до створеного відправлення.

Якщо параметр не передано:

• для type=marking використовується внутрішня логіка друку маркування;
• для type=international та type=invoice за замовчуванням використовується size_A4.

Зворотна сумісність зі значеннями 100_100 та size_100_100 збережена.

deliveryTypestring · enumOptional

Тип логістичного процесу для друку документа маркування. Застосовується лише для type=marking.

• Pickup: перша миля
• Shipment: остання миля

Possible values:

Responses

200

PDF-файл.

application/pdf

string · binaryOptional

401

Неавторизований доступ

application/json

404

Вказаний ресурс не знайдено

application/json

422

Помилка валідації

application/json

503

Час очікування з’єднання вичерпано

application/json

get/shipments/print

GET /v.1.0/shipments/print HTTP/1.1
Host: api-stage.novapost.com/
Authorization: YOUR_API_KEY
Accept: */*

binary