> 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/metodi-1/methods/manifests.md).
# Manifests
## Create Manifest with shipments
> This method allows combining previously created shipments into a single Manifest document in the EuroGate system for customs processing and transportation.\
> \
> The \`mainNumbers\` parameter must contain shipment numbers of previously created shipments.
```json
{"openapi":"3.0.0","info":{"title":"API Nova Post","version":"1.0.0"},"tags":[],"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":"Authorization JWT-token with a lifetime of 1 hour in header"}}},"paths":{"/declaration-groups":{"post":{"tags":["Customs Integration"],"summary":"Create Manifest with shipments","description":"This method allows combining previously created shipments into a single Manifest document in the EuroGate system for customs processing and transportation.\n\nThe `mainNumbers` parameter must contain shipment numbers of previously created shipments.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["deliveryPartner","type","recipientCompanyTin","recipientCountryCode","shipmentType","mainNumbers"],"properties":{"name":{"type":"string","maxLength":255,"description":"Special Manifest name used for personalization purposes.\n\nIf the parameter is absent, it does not need to be transferred.\n"},"partnerNumber":{"type":"string","maxLength":50,"description":"Unique partner Manifest number generated in the partner system.\n\nIf the parameter is absent, it does not need to be transferred.\n"},"deliveryPartner":{"type":"string","nullable":true,"description":"Delivery partner identifier.\n\nSince delivery is initially performed through the Lviv CSS and customs clearance process, the parameter must be transferred with the value `null`.\n"},"type":{"type":"string","enum":["Manifest"],"description":"Document type.\n\nThe parameter must be transferred with the value `Manifest`.\n"},"senderCompanyTin":{"type":"string","maxLength":20,"nullable":true,"description":"Sender company TIN code.\n\nThe value must be agreed upon with the integration manager.\n"},"senderCompanyName":{"type":"string","maxLength":255,"nullable":true,"description":"Name of the sender organization.\n\nFill in this field if `senderCompanyTin == null` or the value is missing from the directory.\n"},"senderAddress":{"type":"string","maxLength":255,"nullable":true,"description":"Loading address.\n\nFill in this field if `senderDivisionTin == null` or the value is missing from the directory.\n"},"senderCountryCode":{"type":"string","nullable":true,"pattern":"^[A-Z]{2}$","description":"Sender country code according to the ISO Alpha-2 standard.\n\nFill in this field if `senderDivisionId == null` or the value is missing from the directory.\n"},"recipientCompanyTin":{"type":"string","maxLength":20,"description":"TIN code of the consignee legal entity according to the Manifest.\n"},"recipientCountryCode":{"type":"string","pattern":"^[A-Z]{2}$","description":"Recipient country code according to the ISO Alpha-2 standard.\n"},"shipmentType":{"type":"string","nullable":true,"description":"Shipment type.\n\nAvailable values:\n- `B2CDeliveryLess150`\n- `B2CDeliveryMoreOrEqual150`\n- `B2BAndC2BDelivery`\n"},"grossWeight":{"type":"integer","description":"Gross weight of the Manifest in grams.\n\nThe gross weight cannot be less than the net weight.\n"},"mainNumbers":{"type":"array","description":"Array of previously created shipment numbers.\n","items":{"type":"string"}}}}}}},"responses":{"200":{"description":"Manifest successfully created.","content":{"application/json":{"schema":{"type":"object","properties":{"documents":{"type":"array","description":"List of Manifest documents and linked shipments.","items":{"type":"object","properties":{"id":{"type":"integer","description":"Internal document identifier."},"declarationGroupNumber":{"type":"string","description":"Unique Manifest number in the EuroGate system."},"declarationNumber":{"type":"string","description":"Declaration number."},"mainNumber":{"type":"string","description":"Shipment number linked to the Manifest."},"declarationStatus":{"type":"string","description":"Declaration status."},"createdAt":{"type":"string","format":"date-time","description":"Document creation date and time."},"updatedAt":{"type":"string","format":"date-time","description":"Last document update date and time."},"deletedAt":{"type":"string","nullable":true,"description":"Document deletion date and time."}}}},"number":{"type":"string","description":"Unique Manifest number in the EuroGate system.\n"},"partnerNumber":{"type":"string","description":"Partner Manifest number."},"deliveryPartner":{"type":"string","description":"Delivery partner."},"status":{"type":"string","description":"Manifest status."},"statusDateTime":{"type":"string","format":"date-time","description":"Date and time of the last status update."},"name":{"type":"string","description":"Manifest name."},"type":{"type":"string","description":"Document type."},"user":{"type":"string","description":"User identifier who created the Manifest."},"divisionId":{"type":"integer","description":"Division identifier."},"countryCode":{"type":"string","description":"Country code."},"recipientCompanyTin":{"type":"string","description":"Recipient company TIN."},"recipientCompanyName":{"type":"string","nullable":true,"description":"Recipient company name."},"recipientCountryCode":{"type":"string","description":"Recipient country code."},"senderCompanyTin":{"type":"string","description":"Sender company TIN."},"senderCompanyName":{"type":"string","nullable":true,"description":"Sender company name."},"senderAddress":{"type":"string","nullable":true,"description":"Sender address."},"senderCountryCode":{"type":"string","description":"Sender country code."},"shipmentType":{"type":"string","description":"Shipment type."},"grossWeight":{"type":"integer","description":"Gross weight in grams."},"parcelsAmount":{"type":"integer","description":"Number of parcels."},"actualWeight":{"type":"integer","description":"Actual weight in grams."},"shipmentAmount":{"type":"integer","description":"Number of shipments."},"totalCost":{"type":"number","description":"Total shipment cost."},"currencyCode":{"type":"string","description":"Currency code."},"createdAt":{"type":"string","format":"date-time","description":"Manifest creation date and time."},"updatedAt":{"type":"string","format":"date-time","description":"Manifest update date and time."},"deletedAt":{"type":"string","nullable":true,"description":"Manifest deletion date and time."}}}}}}}}}}}
```
## Add Manifest gross weight
> This method allows adding or updating the gross weight of the Manifest in the EuroGate system.\
> \
> The gross weight is specified in grams and cannot be less than the net weight of the Manifest.
```json
{"openapi":"3.0.0","info":{"title":"API Nova Post","version":"1.0.0"},"tags":[],"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":"Authorization JWT-token with a lifetime of 1 hour in header"}}},"paths":{"/declaration-groups/gross-weights/{number}":{"put":{"tags":["Customs Integration"],"summary":"Add Manifest gross weight","description":"This method allows adding or updating the gross weight of the Manifest in the EuroGate system.\n\nThe gross weight is specified in grams and cannot be less than the net weight of the Manifest.\n","parameters":[{"name":"number","in":"path","required":true,"schema":{"type":"string","maxLength":50},"description":"Manifest identifier.\n\nIt can be transmitted as:\n- the partner number (`partnerNumber` value), or\n- the unique Manifest number in the EuroGate system (`number` value).\n"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["grossWeight"],"properties":{"grossWeight":{"type":"integer","description":"Gross weight of the Manifest in grams.\n\nThe gross weight cannot be less than the net weight.\n"}}}}}},"responses":{"200":{"description":"Gross weight successfully updated.","content":{"application/json":{"schema":{"type":"object","description":"Full Manifest object returned from the EuroGate system after successful update."}}}}}}}}}
```
## Add additional shipments to Manifest
> This method allows adding previously created shipments to an existing Manifest in the EuroGate system.\
> \
> The request must contain an array of previously created shipment numbers that need to be added to the Manifest.
```json
{"openapi":"3.0.0","info":{"title":"API Nova Post","version":"1.0.0"},"tags":[],"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":"Authorization JWT-token with a lifetime of 1 hour in header"}}},"paths":{"/declaration-groups/documents/{number}":{"post":{"tags":["Customs Integration"],"summary":"Add additional shipments to Manifest","description":"This method allows adding previously created shipments to an existing Manifest in the EuroGate system.\n\nThe request must contain an array of previously created shipment numbers that need to be added to the Manifest.\n","parameters":[{"name":"number","in":"path","required":true,"schema":{"type":"string","maxLength":50},"description":"Manifest identifier.\n\nIt can be transmitted as:\n- the partner number (`partnerNumber` value), or\n- the unique Manifest number in the EuroGate system (`number` value).\n"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["mainNumbers"],"properties":{"mainNumbers":{"type":"array","description":"Array of previously created shipment numbers that need to be added to the Manifest.\n","items":{"type":"string"}}}}}}},"responses":{"200":{"description":"Shipments successfully added to the Manifest.","content":{"application/json":{"schema":{"type":"object","description":"Full Manifest object returned from the EuroGate system after successful update."}}}}}}}}}
```
## Delete shipments from Manifest
> This method allows deleting previously created shipments from an existing Manifest in the EuroGate system.\
> \
> The request must contain an array of previously created shipment numbers that need to be deleted from the Manifest.
```json
{"openapi":"3.0.0","info":{"title":"API Nova Post","version":"1.0.0"},"tags":[],"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":"Authorization JWT-token with a lifetime of 1 hour in header"}}},"paths":{"/declaration-groups/documents/{number}":{"delete":{"tags":["Customs Integration"],"summary":"Delete shipments from Manifest","description":"This method allows deleting previously created shipments from an existing Manifest in the EuroGate system.\n\nThe request must contain an array of previously created shipment numbers that need to be deleted from the Manifest.\n","parameters":[{"name":"number","in":"path","required":true,"schema":{"type":"string","maxLength":50},"description":"Manifest identifier.\n\nIt can be transmitted as:\n- the partner number (`partnerNumber` value), or\n- the unique Manifest number in the EuroGate system (`number` value).\n"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["mainNumbers"],"properties":{"mainNumbers":{"type":"array","description":"Array of previously created shipment numbers that need to be deleted from the Manifest.\n","items":{"type":"string"}}}}}}},"responses":{"200":{"description":"Shipments successfully deleted from the Manifest.","content":{"application/json":{"schema":{"type":"object","description":"Full Manifest object returned from the EuroGate system after successful update."}}}}}}}}}
```
## Delete Manifest
> This method allows deleting a Manifest from the EuroGate system.
```json
{"openapi":"3.0.0","info":{"title":"API Nova Post","version":"1.0.0"},"tags":[],"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":"Authorization JWT-token with a lifetime of 1 hour in header"}}},"paths":{"/declaration-groups/{number}":{"delete":{"tags":["Customs Integration"],"summary":"Delete Manifest","description":"This method allows deleting a Manifest from the EuroGate system.\n","parameters":[{"name":"number","in":"path","required":true,"schema":{"type":"string","maxLength":50},"description":"Manifest identifier.\n\nIt can be transmitted as:\n- the partner number (`partnerNumber` value), or\n- the unique Manifest number in the EuroGate system (`number` value).\n"}],"responses":{"200":{"description":"Manifest successfully deleted.","content":{"application/json":{"schema":{"type":"object","properties":{"deletedAt":{"type":"string","format":"date-time","description":"Date and time when the Manifest was deleted.\n"}}}}}}}}}}}
```
## Print Manifest sticker
> This method allows receiving a printed version of the Manifest sticker from the EuroGate system.\
> \
> In response to a successful request, a Manifest sticker in \`.pdf\` format encoded in Base64 is returned.
```json
{"openapi":"3.0.0","info":{"title":"API Nova Post","version":"1.0.0"},"tags":[],"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":"Authorization JWT-token with a lifetime of 1 hour in header"}}},"paths":{"/declaration-groups/prints":{"get":{"tags":["Customs Integration"],"summary":"Print Manifest sticker","description":"This method allows receiving a printed version of the Manifest sticker from the EuroGate system.\n\nIn response to a successful request, a Manifest sticker in `.pdf` format encoded in Base64 is returned.\n","parameters":[{"name":"numbers[]","in":"query","required":true,"schema":{"type":"array","items":{"type":"string","maxLength":50}},"description":"Array of Manifest identifiers.\n\nEach value can be transmitted as:\n- the partner number (`partnerNumber` value), or\n- the unique Manifest number in the EuroGate system (`number` value).\n"}],"responses":{"200":{"description":"Manifest sticker successfully generated.","content":{"application/json":{"schema":{"type":"object","properties":{"file":{"type":"string","description":"Manifest sticker file in `.pdf` format encoded in Base64.\n"}}}}}}}}}}}
```
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://api-portal.novapost.com/metodi-1/methods/manifests.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.