> For the complete documentation index, see [llms.txt](https://api-portal.novapost.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-portal.novapost.com/methods/ua/overview/shipments/print-documents.md).
# Друк документів
## Друк транспортних документів
> Цей API-метод дозволяє отримати маркування транспортного документа за його номером.\
> Сформоване маркування можна роздрукувати та прикріпити до вантажу перед відправленням.\
> \
> Доступні два формати маркування:\
> \- \`PDF\`: використовується за замовчуванням, якщо параметр \`format\` не передано.\
> \- \`ZPL\`: доступний лише для відправлень, у яких першу та останню милю обслуговує Nova Post (EU-EU та EU-UA).\
> \
> 🔹Для формату ZPL доступні два варіанти роздільної здатності: 203 та 300 dpi. Якщо роздільну здатність не вказано, за замовченням використовується значення 203 dpi.
```json
{"openapi":"3.0.0","info":{"title":"API Nova Post","version":"1.0.0"},"tags":[{"name":"Shipments"}],"servers":[{"description":"sandbox","url":"https://api-stage.novapost.com/v.1.0/"},{"description":"production","url":"https://api.novapost.com/v.1.0/"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"apiKey","in":"header","name":"Authorization","description":"JWT-токен авторизації зі строком дії 1 годину у заголовку"}},"responses":{"Unauthorized":{"description":"Неавторизований доступ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Вказаний ресурс не знайдено","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Validation":{"description":"Помилка валідації","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Time-out":{"description":"Час очікування з’єднання вичерпано","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Error":{"type":"object","properties":{"errors":{"type":"object","properties":{"":{"type":"string"}}}}}}},"paths":{"/shipments/print":{"get":{"tags":["Shipments"],"description":"Цей API-метод дозволяє отримати маркування транспортного документа за його номером.\nСформоване маркування можна роздрукувати та прикріпити до вантажу перед відправленням.\n\nДоступні два формати маркування:\n- `PDF`: використовується за замовчуванням, якщо параметр `format` не передано.\n- `ZPL`: доступний лише для відправлень, у яких першу та останню милю обслуговує Nova Post (EU-EU та EU-UA).\n\n🔹Для формату ZPL доступні два варіанти роздільної здатності: 203 та 300 dpi. Якщо роздільну здатність не вказано, за замовченням використовується значення 203 dpi.\n","parameters":[{"in":"query","name":"numbers[]","description":"Номери відправлень. Може приймати як один номер, так і масив номерів. Якщо використовується `type=marking`, у межах одного запиту дозволяється передавати лише один номер.","schema":{"type":"string"}},{"in":"query","name":"type","description":"Тип документа для друку.\n\n- `marking`: для маркування відправлення (`100x100`, `100x150` або інші формати залежно від відправлення)\n- `international`: формує митну декларацію/інвойс для міжнародних відправлень. Наразі це значення також використовується для отримання друкованої форми локальних (внутрішніх) відправлень у деяких країнах, де працює Nova Post — наприклад, для внутрішніх відправлень по Молдові. Окремого значення `type` для локального друку поки не існує, тому для таких відправлень потрібно передавати саме `international`, навіть якщо відправлення не є міжнародним. Див. примітку нижче.\n- `invoice`: для комерційного інвойсу\n\n**Примітка: Друк локальних (внутрішніх) відправлень — наприклад, по Молдові**\n\nДля друку форми локального/внутрішнього відправлення передавайте `type=international`. Це очікувана поведінка, а не помилка: окремого значення `type` для друку локальних відправлень Nova Post наразі не надає, тому `type=international` використовується як для митної декларації/інвойсу міжнародних відправлень, так і для друкованої форми локальних відправлень.\n","schema":{"type":"array","enum":["marking","international","invoice"]}},{"in":"query","name":"printSizeType","description":"Вибір розміру документа.\n\nДля `type=marking` цей параметр визначає тип запиту на друк маркування, але не гарантує кінцевий фізичний формат PDF-файлу, який повертає сервіс.\n\nКінцевий формат етикетки визначається автоматично відповідно до створеного відправлення.\n\nЯкщо параметр не передано:\n- для `type=marking` використовується внутрішня логіка друку маркування;\n- для `type=international` та `type=invoice` за замовчуванням використовується `size_A4`.\n\nЗворотна сумісність зі значеннями `100_100` та `size_100_100` збережена.\n","schema":{"type":"array"}},{"in":"query","name":"deliveryType","description":"Тип логістичного процесу для друку документа маркування. Застосовується лише для `type=marking`.\n- `Pickup`: перша миля\n- `Shipment`: остання миля\n","required":false,"schema":{"type":"string","enum":["Pickup","Shipment"]}},{"in":"query","name":"format","required":false,"description":"Формат файлу маркування.\n- `pdf`: повертає маркування у форматі PDF.\n- `zpl`: повертає внутрішнє маркування Nova Post у форматі ZPL для термопринтерів. Доступний лише для відправлень, у яких першу та останню милю обслуговує Nova Post (EU-EU та EU-UA).\n\nЯкщо параметр не передано, за замовчуванням використовується `pdf` для забезпечення зворотної сумісності.\n","schema":{"type":"string","enum":["pdf","zpl"],"default":"pdf"}},{"in":"query","name":"dpi","required":false,"description":"Роздільна здатність друку. Застосовується лише для `format=zpl`.\n- `203`: 203 dpi.\n- `300`: 300 dpi.\n\nЯкщо `dpi` не передано для `format=zpl`, за замовчуванням використовується 203 dpi.\n\nЯкщо `dpi` передано для `format=pdf`, параметр ігнорується.\n","schema":{"type":"integer","enum":[203,300],"default":203}}],"responses":{"200":{"description":"Файл маркування у запитаному форматі.","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}},"application/zpl":{"schema":{"type":"string"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/Validation"},"503":{"$ref":"#/components/responses/Time-out"}},"summary":"Друк транспортних документів"}}}}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://api-portal.novapost.com/methods/ua/overview/shipments/print-documents.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.