Метод «save», працює в моделі «InternetDocument», цей метод дозволяє створювати/формувати експрес-накладну (інтернет-документ).
Оформлення запитів з різними типами вантажів
1) Формування запиту з типом вантажу «шини-диски» "CargoType"="TiresWheels",
"CargoDetails": [ {
"CargoDescription": "20f7b626-9add-11e3-b441-0050568002cf",
"Amount": "4" } ],
2) Формування запиту з типом вантажу «пелети або вантаж» із зазначенням параметрів кожного місця "CargoType"="Pallet",
"OptionsSeat": [ {
"volumetricVolume": "10",
"volumetricWidth": "10",
"volumetricLength": "10",
"volumetricHeight": "10",
"weight": "10" },
{ "volumetricVolume": "10",
"volumetricWidth": "10",
"volumetricLength": "10",
"volumetricHeight": "10",
"weight": "10" } ],
3) Формування запиту з типом вантажу «документи» "CargoType"="Documents"
Якщо вибрано тип доставки "CargoType": "Documents", доступні такі параметри ваги: 0,1 або 0,5 або 1. У всіх інших випадках повернеться помилка.
Після створення інтернет документа в програмному середовищі API, ЕН з'являється у списку ЕН в особистому кабінеті. Відкривши документ, ми бачимо обраний тип послуги та зазначений тип вантажу «документи», також вказані його параметри та кількість.
Параметр | Тип | Опис |
---|---|---|
PayerType* | string[36] | Тип платника (Sender, Recipient, ThirdPerson) |
PaymentMethod* | string[36] | Форма розрахунку Cash/NonCash |
DateTime* | string[36] | Дата відправки у форматі дд.мм.рррр |
CargoType* | string[36] | Тип вантажу |
Weight* | string[36] | Фактична вага, в кг min - 0,1 |
ServiceType* | string[36] | Технологія доставки DoorsDoors, DoorsWarehouse, WarehouseWarehouse, WarehouseDoors |
SeatsAmount* | string[36] | Кількість місць відправлення, ціле число |
Description* | string[36] | Текстове поле, вводиться для додаткогвого опису відправлення |
Cost* | string[36] | Оціночна вартість, ціле число (якщо не зазначити вартість то АРІ автоматично проставить мінімальну оціночну вартість =300.01) |
CitySender* | string[36] | Ідентифікатор міста відправника |
Sender* | string[36] | Ідентифікатор відправника |
SenderAddress* | string[36] | Ідентифікатор адреси відправника. REF адреси брати з відповіді методу Список адрес контрагента |
ContactSender* | string[36] | Ідентифікатор контактної особи відправника. REF брати з відповіді методу Список контактних осіб контрагента |
SendersPhone* | string[36] | Телефон відправника у форматі: +380660000000, 380660000000, 0660000001 |
CityRecipient* | string[36] | Ідентифікатор міста отримувача |
Recipient* | string[36] | Ідентифікатор отримувача |
RecipientAddress* | string[36] | Ідетнифікатор адреси отримувача/Ідентифікатор поштомату |
ContactRecipient* | string[36] | Ідентифікатор контактної особи |
RecipientsPhone* | string[36] | Телефон отримувача у форматі: +380660000000, 380660000000, 0660000001 |
OptionsSeat* | array | Параметр вантажу для кожного місця відправлення |
{
"apiKey": "[ВАШ КЛЮЧ]",
"modelName": "InternetDocument",
"calledMethod": "save",
"methodProperties": {"PayerType" : "ThirdPerson","PaymentMethod" : "NonCash","DateTime" : "дд.мм.рррр","CargoType" : "Pallet","Weight" : "280","ServiceType" : "DoorsDoors","SeatsAmount" : "2","Description" : "Додатковий опис відправлення","Cost" : "15000","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":"10","volumetricWidth":"30","volumetricLength":"30","volumetricHeight":"30","weight":"20"},{"volumetricVolume":"10","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": []
}