API Экспресс-накладная
Работа с экспресс-накладными
- Рассчитать стоимость услуг
- Прогноз даты доставки груза
- Создать экспресс-накладную
- Создать экспресс-накладную на адрес
- Создать экспресс-накладную на отделение
- Создать экспресс-накладную на почтомат "Нова пошта"
- Создать экспресс-накладную с обратной доставкой
- Редактировать экспресс-накладную
- Трекинг
- Получить список ЭН
- Удалить экспресс-накладную
- Формирование запроса для получения полного отчета по накладным
- Формирование запросов на создание ЭН с дополнительными услугами
- Формирование запросов на создание ЭН с различными видами груза
Формирование запросов на создание ЭН с дополнительными услугами
Метод «save», работает в модели «InternetDocument», этот метод позволяет создавать/формировать экспресс-накладную (интернет-документа) с дополнительными услугами.
URL для входа https://api.novaposhta.ua/v2.0/{format}/ [json or xml]
Формат, обязательно, должен указываться нижним регистром (маленькими буквами), например https://api.novaposhta.ua/v2.0/json/
Доступность: Требует использования API-ключа.
URL-адрес запроса
Параметры запроса
Форматы JSON, XML
Заголовки запросов
Текст запроса
Примеры дополнительных услуг
- Формирование запроса на создание «ЭН» с услугой «Забрать доверенность»
"IsTakeAttorney": "1", - забор доверенности "1" - ДА "0" – НЕТ
После создания интернет документа в программной среде API, ЕН появляется в списке ЕН в личном кабинете. Открыв документ видим указанную дополнительную услугу «Забор доверенности» - Формирование запроса на создание «ЭН» с услугой «Субботняя доставка»
"SaturdayDelivery ": "1", - суботня доставка "1" - ДА "0" – НЕТ
После создания интернет документа в программной среде API, ЕН появляется в списке ЕН в личном кабинете. Открыв документ видим указанную дополнительную услугу «Субботняя доставка» - Формирование запроса на создание «ЭН» с услугой «Контроль оплаты»
"AfterpaymentOnGoodsCost": "1005",
После создания интернет документа в программной среде API, ЕН появляется в списке ЕН в личном кабинете. Открыв документ видим указанную дополнительную услугу «Контроль оплаты» - Формирование запроса на создание «ЭН» с услугой «Локал Експрес»
"LocalExpress": "1",
Детальней о временных интервала можно ознакомиться по ссылке.
"TimeInterval": "CityDeliveryTimeInterval2", - доступные интервалы 2, 3, 4. Если это значение пустое, API проставит пометку "Впродовж дня"
После создания интернет документа в программной среде API, ЕН появляется в списке ЕН в личном кабинете. Открыв документ видим указанную дополнительную услугу «Локал Експрес». Услуга доступна только в пределах доставки в одном городе. - Формирование запроса на создание «ЭН» с услугой «Желаемая дата доставки»
"PreferredDeliveryDate": "07.03.2015",
После создания интернет документа в программной среде API, ЕН появляется в списке ЕН в личном кабинете. Открыв документ видим указанную дополнительную услугу «Желаемая дата доставки» - Формирование запроса на создание «ЭН» с услугой «Доставка во временные интервалы»
"PreferredDeliveryDate": "25.03.2015",
"TimeInterval": "CityDeliveryTimeInterval1/2/3/4",
Услуга «Доставка во временные интервалы» возможна только при заказе услуги «Желаемая дата доставки» Как загрузить список видов временных интервалов можно увидеть в «Виды временных интервалов»
После создания интернет документа в программной среде API, ЕН появляется в списке ЕН в личном кабинете. Открыв документ видим указанную дополнительную услугу «Желаемая дата доставки» - Формирование запроса на создание «ЭН» с услугой «Указать номера упаковки»
"PackingNumber": "4545", - "4545" номера упаковки
После создания интернет документа в программной среде API, ЕН появляется в списке ЕН в личном кабинете. Открыв документ видим указанную дополнительную услугу «Указать номера упаковки» - Формирование запроса на создание «ЭН» с услугой «Указать внутренний номер заказа клиента»
"InfoRegClientBarcodes": "121212", - "121212" внутренний номер
После создания интернет документа в программной среде API, ЕН появляется в списке ЕН в личном кабинете. Открыв документ видим указанную дополнительную услугу «Указать внутренний номер заказа клиента» - Формирование запроса на создание «ЭН» с описанием «Сопровождающие документы»
"AccompanyingDocuments" : "Договор";
После создания интернет документа в программной среде API, ЕН появляется в списке ЕН в личном кабинете. Открыв документ видим указанную дополнительную услугу «Сопровождающие документы» - Формирование запроса на создание «ЭН» с описанием «Дополнительная информация об отправке»
"AdditionalInformation" : "Смартфон";
После создания интернет документа в программной среде API, ЕН появляется в списке ЕН в личном кабинете. Открыв документ видим указанную дополнительную услугу «Дополнительная информация об отправке» - Формирование запроса на создание «ЭН» с услугой «Подъем на
этаж »
"NumberOfFloorsLifting": "3", 3 - номер этажа
"Elevator": "1", 1 - лифт есть, 0 - лифта нет.
После создания интернет документа в программной среде API, ЕН появляется в списке ЕН в личном кабинете. - Формирование запроса на создание «ЭН» с дополнительной услугой
«Доставка лично в руки»
"DeliveryByHand": "1", - "1" - ДА "0" – НЕТ
"DeliveryByHandRecipients": [ - перечень получателей которым можно отдавать отправления
"Могилевська Юлія Костянтинівна",
"Колесник Костянтин Олександрович"
],
При заказе услуги можно загружать до 15 человек включительно. При этом первое лицо всегда - получатель (подтягивается с «Данные получателя»), остальные 14 (Четырнадцать) - произвольные получатели. - Формирование запроса на создание «ЭН» с услугой «Контроль поштучної передачі» (експедирування)
"ForwardingCount":"126" 126 - количество штук
После создания интернет документа в программной среде API, ЕН появляется в списке ЕН в личном кабинете.
- Формирование запроса на создание «ЭН» с услугой «Red Box»
"RedBoxBarcode":"0105QD26L"
После создания интернет документа в программной среде API, ЕН появляется в списке ЕН в личном кабинете.
0105QD26L - код учитывает только верхний регист
Приведенный пример из запроса - Формирование запроса на создание «ЭН» с услугой «забрать доверенность»
- Формирование запроса на создание «ЭН» с услугой «Авиадоставка»
"AviaDelivery":"1", - авиадоставка "1" - ДА "0" – НЕТ
После создания интернет документа в программной среде API, ЕН появляется в списке ЕН в личном кабинете. Открыв документ видим указанную дополнительную услугу «Авиадоставка». Авиадоставка сохраняется в ЕН только при соблюдении времени отправки с отделения. - Формирование запроса на создание «ЭН» с услугой «Отправление без коробки»
Услуга доступна к заказу в случае создание документа с характеристиками: одна з сторон отправления (или одного места) от 40 до 120 см и весом отправления (или одного места) от 2 до 30 кг.
Заказ услуги возможен:
Без передачи габаритов мест с использованием параметра:"SpecialCargo":"1", - «Отправление без коробки» "1" - ДА "0" – НЕТ
.
С передачей габаритов мест с использованием параметра:"specialCargo":"1", - «Отправление без коробки» "1" - ДА "0" – НЕТ
.
"OptionsSeat": [ - Параметр груза для каждого места отправления
{
"weight": 5,
"volumetricHeight":50,
"volumetricWidth":10,
"volumetricLength":10,
"cost": "1",
"description": "1",
"specialCargo":"1"
}
]
После создания интернет документа в программной среде API, ЕН появляется в списке ЕН в личном кабинете.
{
"apiKey": "[ВАШ КЛЮЧ]",
"modelName": "InternetDocument",
"calledMethod": "save",
"methodProperties": {
"IsTakeAttorney": "1",
"PayerType": "Sender",
"PaymentMethod": "Cash",
"DateTime": "18.02.2015",
"CargoType": "Cargo",
"VolumeGeneral": "0.1",
"Weight": "10",
"ServiceType": "WarehouseDoors",
"SeatsAmount": "1",
"Description": "абажур",
"Cost": "500",
"CitySender": "8d5a980d-391c-11dd-90d9-001a92567626",
"Sender": "6e9acced-d072-11e3-95eb-0050568046cd",
"SenderAddress": "01ae2635-e1c2-11e3-8c4a-0050568002cf",
"ContactSender": "d0b9f592-b600-11e4-a77a-005056887b8d",
"SendersPhone": "380678734567",
"CityRecipient": "db5c8892-391c-11dd-90d9-001a92567626",
"Recipient": "d00f2319-b743-11e4-a77a-005056887b8d",
"RecipientAddress": "511fcfbd-e1c2-11e3-8c4a-0050568002cf",
"ContactRecipient": "bc7b61ea-b6eb-11e4-a77a-005056887b8d",
"RecipientsPhone": "380631112223"
}
}
<?xml version="1.0" encoding="UTF-8"?>
<root>
<apiKey>[ВАШ КЛЮЧ]</apiKey>
<modelName>InternetDocument</modelName>
<calledMethod>save</calledMethod>
<methodProperties>
<IsTakeAttorney>1</IsTakeAttorney>
<PayerType>Sender</PayerType>
<PaymentMethod>Cash</PaymentMethod>
<DateTime>02.04.2015</DateTime>
<CargoType>Cargo</CargoType>
<VolumeGeneral>0.1</VolumeGeneral>
<Weight>10</Weight>
<ServiceType>WarehouseDoors</ServiceType>
<SeatsAmount>1</SeatsAmount>
<Description>абажур</Description>
<Cost>500</Cost>
<CitySender>8d5a980d-391c-11dd-90d9-001a92567626</CitySender>
<Sender>5953fb16-08d8-11e4-8958-0025909b4e33</Sender>
<SenderAddress>01ae2635-e1c2-11e3-8c4a-0050568002cf</SenderAddress>
<ContactSender>344a7107-ccac-11e4-bdb5-005056801329</ContactSender>
<SendersPhone>380678734567</SendersPhone>
<CityRecipient>8d5a980d-391c-11dd-90d9-001a92567626</CityRecipient>
<Recipient>56300fb9-cbd3-11e4-bdb5-005056801329</Recipient>
<RecipientAddress>511fcfbd-e1c2-11e3-8c4a-0050568002cf</RecipientAddress>
<ContactRecipient>563ad2d8-cbd3-11e4-bdb5-005056801329</ContactRecipient>
<RecipientsPhone>380631112223</RecipientsPhone>
</methodProperties>
</root>
Ответ 200
Всегда возвращает код 200 даже при логических ошибках.
Тело ответа на запрос
Параметр | Тип данных | Описание |
Ref | string[36] | Идентификатор экспресс-накладной |
CostOnSite | int[36] | Стоимость |
EstimatedDeliveryDate | string[36] | Прогноз даты доставки/td> |
IntDocNumber | int[36] | Номер экспресс-накладной |
TypeDocument | string[36] | Тип экспресс-накладной |
{
"success": true,
"data": [
{
"Ref": "55babc0d-c279-11e4-bdb5-005056801329",
"CostOnSite": 55,
"EstimatedDeliveryDate": "19.02.2015",
"IntDocNumber": "20600000002368",
"TypeDocument": "InternetDocument"
}
],
"errors": [],
"warnings": [],
"info": []
}
<?xml version="1.0" encoding="UTF-8"?>
<root>
<success>true</success>
<data>
<item>
<Ref>112f9765-d913-11e4-bdb5-005056801329</Ref>
<CostOnSite>22</CostOnSite>
<EstimatedDeliveryDate>03.04.2015</EstimatedDeliveryDate>
<IntDocNumber>20400030201056</IntDocNumber>
<TypeDocument>InternetDocument</TypeDocument>
</item>
</data>
<errors></errors>
<warnings></warnings>
<info></info>
</root>