Повторна доставка

Створити повторну доставку

post

/shipments/modification/repeat-delivery

Цей метод створює запит на повторну доставку для відправлення, яке наразі зберігається на складі довгострокового зберігання (LTS).

Основні правила:

• Доступний лише для відправлень, які наразі перебувають на довгостроковому зберіганні (LTS).
• Для одного відправлення дозволено не більше 4 завершених послуг повторної доставки.
• Послугу повторної доставки не можна замовити, якщо для відправлення вже існує запит на переадресацію (Redirecting), повернення (Return) або повторну доставку (Repeat Delivery) зі статусом NeedProcessing або InProgress.

Authorizations

AuthorizationstringRequired

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

Body

shipmentIdintegerRequired

Ідентифікатор відправлення на довгостроковому зберіганні.

🔻Це поле є обов'язковим.

payerTypestring · enum · nullableOptional

Визначає, хто відповідає за оплату послуги повторної доставки.

Допустимі значення:

• Sender
• Recipient
• ThirdPerson

Якщо поле не передано, послугу оплачує користувач, який створює замовлення.

Possible values:

payerContractNumberstring · nullableOptional

Обов'язковий параметр для B2B-клієнтів (юридичних осіб з оплатою за договором).

notestringOptional

Будь-який коментар до замовлення.

Responses

200

Запит на повторну доставку успішно створено.

application/json

costnumberOptional

Вартість послуги повторної доставки.

currencystringOptional

Код валюти відповідно до стандарту ISO 4217.

currencySymbolstringOptional

Символ валюти.

scheduledDeliveryDatestring · date-timeOptional

Орієнтовна дата доставки у форматі ISO 8601.

401

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

application/json

422

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

application/json

503

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

application/json

post/shipments/modification/repeat-delivery

POST /v.1.0/shipments/modification/repeat-delivery HTTP/1.1
Host: api-stage.novapost.com/
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 502

{
  "shipmentId": 440459,
  "payerContractNumber": "String",
  "payerType": "Sender",
  "note": "Repeat delivery to a new address",
  "recipient": {
    "name": "John Doe",
    "phone": "37360123456",
    "email": "[e-mail]",
    "companyTin": "38130410",
    "companyName": "String",
    "countryCode": "MD",
    "eoriCode": null,
    "settlementId": null,
    "divisionId": null,
    "address": {},
    "addressParts": {
      "postCode": "1345",
      "building": "3",
      "street": "Mircea cel Batrin",
      "city": "Chișinău",
      "region": "Chișinău",
      "flat": "",
      "note": "Near central park",
      "block": ""
    }
  }
}

{
  "cost": 69,
  "currency": "MDL",
  "currencySymbol": "",
  "scheduledDeliveryDate": "2026-03-31T15:00:00.000000Z"
}

Скасувати повторну доставку

delete

/shipments/modification/repeat-delivery/delete/{shipmentID}

Цей метод скасовує поточний активний запит на повторну доставку, пов'язаний із зазначеним відправленням.

Використовуйте цей метод, якщо необхідно скасувати запит на повторну доставку, який ще не було оброблено. Скасування доступне лише доти, доки замовлення на повторну доставку ще перебуває в обробці.

Основні правила:

• Скасування доступне лише доти, доки замовлення на повторну доставку ще перебуває в обробці.
• Після завершення повторної доставки її неможливо скасувати.

Authorizations

AuthorizationstringRequired

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

Path parameters

shipmentIDintegerRequired

Ідентифікатор відправлення, для якого необхідно скасувати замовлення на повторну доставку.

Example: 440459

Responses

200

Замовлення на повторну доставку успішно скасовано. Повертає часову позначку скасування.

application/json

deletedAtstringRequired

Часова позначка, коли замовлення на повторну доставку було скасовано.

Pattern: ^20[0-9]{2}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}.[0-9]{6}Z$

422

Неможливо обробити сутність. Скасування неможливо виконати.

application/json

delete/shipments/modification/repeat-delivery/delete/{shipmentID}

DELETE /v.1.0/shipments/modification/repeat-delivery/delete/{shipmentID} HTTP/1.1
Host: api-stage.novapost.com/
Authorization: YOUR_API_KEY
Accept: */*

{
  "deletedAt": "2026-06-08T15:15:33.043730Z"
}