Створити експрес-накладну на поштомат "Нова Пошта"
Метод «save», працює в моделі «InternetDocument», цей метод дозволяє створювати/формувати експрес-накладну (інтернет-документ).
При створенні ЕН на відділення типу поштамат обов'язково вказуються параметри розмірів.
Обмеження:
- Поштомат може бути лише відділенням одержувача;
- Відправляти на поштамат можна тільки типи вантажу Посилка (Parcel) та Документи (Documents);
- Максимальне значення оцінної вартості для відправки на поштомат (параметр Cost) – 10000 грн.;
- Максимально допустимі габарити вантажу: Ширина 40 см; Довжина 60 см; Висота 30 см;
- Максимально допустима вага вантажу 20 кг;
- При створенні відправлення на поштомат можна вказувати лише одне місце на одне відправлення.
Після створення інтернет документа в програмному середовищі API, ЕН з'являється у списку ЕН в особистому кабінеті.
Текст запиту
Параметр | Тип | Опис |
---|---|---|
SenderWarehouseIndex | string[36] | Цифрова адреса відділення відправника |
RecipientWarehouseIndex | string[36] | Цифрова адреса поштомату отримувача |
PayerType* | string[36] | Тип платника (Sender, Recipient, ThirdPerson) |
PaymentMethod* | string[36] | Форма розрахунку Cash/NonCash |
DateTime* | string[36] | Дата відправки у форматі дд.мм.рррр |
CargoType* | string[36] | Тип вантажу тільки Посилка (Parcel) або Документи (Documents) |
Weight* | string[36] | Фактична вага, в кг min - 0,1 |
ServiceType* | string[36] | Технологія доставки DoorsWarehouse, WarehouseWarehouse |
SeatsAmount* | string[36] | Кількість місць відправлення, ціле число |
Description* | string[36] | Текстове поле, вводиться для додаткогвого опису відправлення |
Cost* | string[36] | Оціночна вартість, ціле число (якщо не зазначити вартість то АРІ автоматично проставить мінімальну оціночну вартість =300.00) |
CitySender* | string[36] | Ідентифікатор (REF) міста відправника |
Sender* | string[36] | Ідентифікатор (REF) відправника |
SenderAddress* | string[36] | Ідентифікатор (REF) адреси відправника. REF адреси брати з відповіді методу Список адрес контрагента |
ContactSender* | string[36] | Ідентифікатор (REF) контактної особи відправника. REF брати з відповіді методу Список контактних осіб контрагента |
SendersPhone* | string[36] | Телефон відправника у форматі: +380660000000, 380660000000, 0660000001 |
CityRecipient* | string[36] | Ідентифікатор(REF) міста отримувача |
Recipient* | string[36] | Ідентифікатор (REF) отримувача |
RecipientAddress* | string[36] | Ідентифікатор (REF) поштомату |
ContactRecipient* | string[36] | Ідентифікатор (REF) контактної особи |
RecipientsPhone* | string[36] | Телефон отримувача у форматі: +380660000000, 380660000000, 0660000001 |
OptionsSeat* | array | Параметр вантажу для кожного місця відправлення:
|
* Позначення обов’язкового параметру
{
"apiKey": "[ВАШ КЛЮЧ]",
"modelName": "InternetDocument",
"calledMethod": "save",
"methodProperties": {"SenderWarehouseIndex" : "101/102","RecipientWarehouseIndex" : "11/3002","PayerType" : "ThirdPerson","PaymentMethod" : "NonCash","DateTime" : "дд.мм.рррр","CargoType" : "Cargo","Weight" : "0.5","ServiceType" : "DoorsWarehouse","SeatsAmount" : "2","Description" : "Додатковий опис відправлення","Cost" : "6000","CitySender" : "00000000-0000-0000-0000-000000000000","Sender" : "00000000-0000-0000-0000-000000000000","SenderAddress" : "00000000-0000-0000-0000-000000000000","ContactSender" : "00000000-0000-0000-0000-000000000000","SendersPhone" : "380660000000","CityRecipient" : "00000000-0000-0000-0000-000000000000","Recipient" : "00000000-0000-0000-0000-000000000000","RecipientAddress" : "00000000-0000-0000-0000-000000000000","ContactRecipient" : "00000000-0000-0000-0000-000000000000","RecipientsPhone" : "380660000000","OptionsSeat" : [{"volumetricVolume":"1","volumetricWidth":"30","volumetricLength":"30","volumetricHeight":"30","weight":"20"}] }
}
Відповідь 200
Завжди повертає код 200 навіть при логічних помилках.
Тіло відповіді на запит
Параметр | Тип | Опис |
Ref | string[36] | Ідентификатор експрес-накладной |
CostOnSite | string[36] | Вартість доставки |
EstimatedDeliveryDate | string[36] | Прогнозована дата доставки |
IntDocNumber | string[36] | Номер експрес-накладной |
TypeDocument | string[36] | Тип експрес-накладной |
{
"success": true,
"data": [{"Ref" : "00000000-0000-0000-0000-000000000000","CostOnSite" : "45","EstimatedDeliveryDate" : "дд.мм.рррр","IntDocNumber" : "20600000002545","TypeDocument" : "InternetDocument" }],
"errors": [],
"warnings": [],
"info": [],
"messageCodes": [],
"errorCodes": [],
"warningCodes": [],
"infoCodes": []
}