Вие сте тук: Начало Документи за изпращане Потвърждение за създаване на товарителница

Потвърждение за създаване на товарителница

Въведение

Можете да считате заявката за пратка за приета в момента, в който получите отговор от системата ни с информация за генерираната товарителница, както и нейния номер и конфигурация.

Търговецът може директно да получи достъп до самите товарителници и да ги отпечата в избран от вас формат, за да спести време при идването на куриера.

 

Какво получава търговецът с интеграцията

В отговора на заявката за товарителница се получава следната информация:

  • Резултат от заявката: успешна или не
  • Номер на документ за изпращане (товарителница)
  • Конфигурация на пратката (тип пратка, допълнителни услуги към нея)
  • Обща цена и разбивка на стойността на всяка допълнителна услуга по пратката
  • Препратка към PDF файл за печат на товарителницата

 

Как да използвате тази функционалност

 

1. Достави с Еконт

След като клиентът е генерирал успешно поръчка в магазина, системата няма да генерира автоматично товарителница, за да може да потвърдите самата поръчка, ако се налага.

Списъкът с поръчки можете да видите в меню Поръчки за всеки магазин, където ще показваме таблица с информация за поръчката и пратката. В колона Товарителница на таблицата можете да видите по коя пратката вече сте генерирали товарителница и, съответно, заявка за куриер (ако такава е настроена) и за коя пратка предстои да го направите. Ако в реда на поръчката и колона Товарителница виждате номер, то това е номерът на вече генерираната от вас товарителница (вижте как може да откажете товарителницата).

Ако по пратката не е генерирана товарителница, натиснете бутона изпрати в същата колона. Ще получите отговор, че товарителницата ви е подготвена успешно, както и номера ѝ. Можете да видите файла за печат на документа в избрания от вас формат като маркирате препратката с номера на товарителницата.

 

2. Интеграция с XML

След като клиентът е генерирал успешно поръчка в магазина, можете да настроите системата да действа по един от следните 2 начина:

  • Да генерира автоматично товарителница при всяка поръчка, като вие преценявате как и къде показвате самите товарителници, информацията за пратките и дали да автоматизирате заявката за куриер според определени от вас критерии (виж Автоматизиране на заявка за куриер)
  • Да генерира товарителници за няколко поръчки, избрани и потвърдени от вас, т.е. да генерирате товарителници само с избрани и потвърдени от клиентите поръчки наведнъж, с една заявка за няколко товарителници

 

Който и вариант да изберете, след генерирането на товарителница ще получите отговор с информация за една или повече товарителници.
В отговора ще получите следната информация за успешно генерираната пратка или грешка при неуспешно генериране:

  • loading_id – ID на товарителницата
  • loading_num – Номер на товарителницата
  • delivery_date – Дата на доставяне на пратката
  • loading_price – Цена на пратката по услуги и обща (total) цена. За да се провери само цената на пратката без да се прави подготовка, е нужно да се подаде. В секцията се подава и паричната единица на стойността (за международни пратки)
  • loading_discount – Отстъпка по пратката (ако има такава): amount – стойност; description – основание
  • letter_price – цена на Пощенската пратка при запитване за тарифиране на Пощенски пратки
  • error – Съобщение за грешка
  • error_code – Код на грешката
  • blank_yes – URL до скрипта, генериращ PDF файл за товарителниците върху бланка

 

Търговецът може да генерира, запази и отпечата PDF файла на товарителницата, за да предадет директно окомплектовани пратки на куриерите ни при идването им и да спести време.

Важно: Ако търговецът избере да използва услугата Обявена стойност и иска да носим отговорност за пратките ви, опаковките не следва да са запечатани преди куриерът да ги е прегледал и да е проверил съдържанието им. В противен случай покритието на нашата отговорност ще намалее.

Примерен отговор в XML формат:

<response>
<result>
<e>
<loading_id>2008090000064</loading_id>
<loading_num>1000000000160</loading_num>
<delivery_date>2009-10-22</delivery_date >
<loading_price>
<C>7.8</C>
<DC>2.4</DC>
<DISC_E-ECONT>-0.15</DISC_E-ECONT>
<SHARE->-5.1</SHARE->
<SHARE>5.1</SHARE>
<sender_total>4.95</sender_total>
<receiver_total>5.1</receiver_total>
<other_total>0</other_total>
<total>10.05</total>
<currency>лв</currency>
</loading_price>
<loading_discount>
<amount>-1.28</amount>
<description>…</description>
</loading_discount>
<pdf_url></pdf_url>
<prev_parcel_num></prev_parcel_num>
<next_parcels>
<e>
<num></num>
<reason></reason>
<pdf_url></pdf_url>
</e>
</next_parcels>
<error></error>
</e>
<e>
<letter_price>5.2</letter_price>
<error />
<error_code />
</e>
</result>
<pdf>
<blank_yes>
<![CDATA[
]]>
</blank_yes>
</pdf>
</response>

 

 

3. Интеграция със SOAP/JSON

След като клиентът е генерирал успешно поръчка в магазина, можете да настроите системата да действа по най-общо 2 начина:

  • Да генерира автоматично товарителница при всяка поръчка (метод createLabel), като вие и търговецът преценявате как и къде да показвате самите товарителници, информацияте за пратките и дали да автоматизирате заявката за куриер според определени от вас критерии (виж Автоматизиране на заявка за куриер)
  • Да генерира товарителници за няколко поръчки, избрани (метод createLabels) и потвърдени от него (т.е. да генерира товарителници само с избрани и потвърдени от клиентите поръчки наведнъж, с една заявка за няколко товарителници)

 

Който и вариант да изберете, след генерирането на товарителница ще получите отговор с информация за една или повече товарителници.

В отговора ще получите следната информация за успешно генерираната пратка или грешка при неуспешно генериране:

Вариант Описание
shipmentNumber Номер на товарителница
storageOfficeName Склад за съхранение
storagePersonName Име на контакт в склад за съхранение
createdTime Дата и час на създаване
sendTime Кога ще бъде изпратена пратката
deliveryTime Кога трябва да бъде доставена пратката
shipmentType Какъв е типа пратка
packCount Брой части на пратката
weight Тегло на пратката
shipmentDescription Описание на пратката
senderDeliveryType Тип на изпращане (от офис, от адрес)
senderClient Подателя (юридическо лице)
senderAgent Упълномощено от подателя лице за контакт
senderOfficeCode Код на офиса на подателя
senderAddress Адрес на подателя
receiverDeliveryType Тип на получаване (до офис, до адрес)
receiverClient Получател (юридическо лице)
receiverAgent Упълномощено лице на получателя
receiverOfficeCode Код на офиса на получателя
receiverAddress Адрес на получателя
cdCollectedAmount Сума за събиране по Наложен платеж
cdCollectedCurrency Валута на Наложения платеж
cdCollectedTime Време на събиране на сумата по Наложен платеж
cdPaidAmount Платена сума по Наложен платеж
cdPaidCurrency Валута, в която е платена сумата по Наложен платеж
cdPaidTime Дата и час на плащане на Наложения платеж
totalPrice Обща цена на пратката
currency Валута
discountPercent Процент отстъпка (ако е налична такава)
discountAmount Сума на отстъпката
discountDescription Описание на отстъпката
senderDueAmount Сума за плащане от подателя
receiverDueAmount Сума за плащане от получателя
otherDueAmount Други дължими суми
deliveryAttemptCount Брой опити за доставка
previousShipmentNumber Номер на предишна пратка (ако е наличен)
services Допълнителни услуги
nextShipments Последващи пратки (ако са изисквани в Указанията за връщане на пратка)
trackingEvents Събитие по проследяване на пратката
pdfURL PDF адрес с товарителницата
expectedDeliveryDate Очаквана дата на доставка

Примерен JSON отговор на заявка:

{
"results": [
{
"label": {
"shipmentNumber": null,
"storageOfficeName": null,
"storagePersonName": null,
"createdTime": 1524123599000,
"sendTime": null,
"deliveryTime": null,
"shipmentType": "post_pack",
"packCount": 1,
"weight": 2,
"shipmentDescription": "маратонки",
"senderDeliveryType": null,
"senderClient": null,
"senderAgent": null,
"senderOfficeCode": null,
"senderAddress": null,
"receiverDeliveryType": null,
"receiverClient": null,
"receiverAgent": null,
"receiverOfficeCode": null,
"receiverAddress": null,
"cdCollectedAmount": 0,
"cdCollectedCurrency": "",
"cdCollectedTime": null,
"cdPaidAmount": 0,
"cdPaidCurrency": "",
"cdPaidTime": null,
"totalPrice": 4.4,
"currency": "BGN",
"discountPercent": 0,
"discountAmount": -0,
"discountDescription": "",
"senderDueAmount": 4.4,
"receiverDueAmount": 0,
"otherDueAmount": 0,
"deliveryAttemptCount": 0,
"previousShipmentNumber": "",
"services": [
{
"type": "C",
"description": "пощенски колет над 1 кг",
"count": 1,
"paymentSide": "SENDER",
"price": 4.4,
"currency": "BGN"
}
],
"nextShipments": [],
"trackingEvents": [],
"pdfURL": "",
"expectedDeliveryDate": 1524171600000
},
"error": null
},
{
"label": {
"shipmentNumber": null,
"storageOfficeName": null,
"storagePersonName": null,
"createdTime": 1524123599000,
"sendTime": null,
"deliveryTime": null,
"shipmentType": "pack",
"packCount": 1,
"weight": 5,
"shipmentDescription": "дънки",
"senderDeliveryType": null,
"senderClient": null,
"senderAgent": null,
"senderOfficeCode": null,
"senderAddress": null,
"receiverDeliveryType": null,
"receiverClient": null,
"receiverAgent": null,
"receiverOfficeCode": null,
"receiverAddress": null,
"cdCollectedAmount": 0,
"cdCollectedCurrency": "",
"cdCollectedTime": null,
"cdPaidAmount": 0,
"cdPaidCurrency": "",
"cdPaidTime": null,
"totalPrice": 11.4,
"currency": "BGN",
"discountPercent": 0,
"discountAmount": -0,
"discountDescription": "",
"senderDueAmount": 11.4,
"receiverDueAmount": 0,
"otherDueAmount": 0,
"deliveryAttemptCount": 0,
"previousShipmentNumber": "",
"services": [
{
"type": "C",
"description": "Куриерска услуга - врата \/ врата до 5 кг",
"count": 1,
"paymentSide": "SENDER",
"price": 11.4,
"currency": "BGN"
}
],
"nextShipments": [],
"trackingEvents": [],
"pdfURL": "",
"expectedDeliveryDate": 1524171600000
},
"error": null
}
]
}

 

Търговецът може да генерира, запази и отпечата PDF файла на товарителницата, за да предаде директно окомплектовани пратки на куриерите ни при идването им и да спести време.

Важно: Ако търговецът избере да използва услугата Обявена стойност и иска да носим отговорност за пратките ви, опаковките на пратките не следва да са запечатани преди куриерът да ги е прегледал и да е проверил съдържанието им. В противен случай покритието на нашата отговорност ще се ограничи само до състоянието на опаковката.

 

4. Интеграция с модул за платформа за електронна търговия

В готовите модули за интеграция този процес не е видим – вие виждате резултата от него (генерираните товарителници и информацията за тях в четим вид).

Следващи стъпки

При проблем с товарителница, можете да я изтриете и да изпратите заявка за нова такава по пратката.