Начало

Настройки web услуги

25 Април, 2017 - 10:26 — UCS Dreem Team
Версия за печатВерсия за печат

Въведение

В тази статия:

  • Настройки на контрагент
  • Настройки на услуга на куриери Рапидо
  • Настройки на услуга на куриери Спиди
  • Настройки на услуга на куриери Еконт
  •  

 

 

Настройки на контрагент

В списък контрагенти се създава контрагент за съответния куриер (например Спиди) и за тип на контрагента се избира Куриер.

Настройките на web услугата си поставят в колона Забележка на персоната която е избрана като контакт за контрагента.

Настройки на услуга на куриери Рапидо

Конфигурацията на интеграцията се указва в JSON формат и минималната конфигурация изглежда така:

{
    "Type": "Rapido",
    "User": "username",
    "Pass": "password",
}
където <username> и <password> са съответно потребител и парола за достъп до API на куриери Рапидо и обикновено са различни от регистрацията за online модула за създаване на товарителници към куриера. Тази конфигурация се копира в колона Забележка на персона по подразбиране на контрагент Рапидо и е напълно достатъчна за връзка с API на web услугата на Рапидо.
 
Допълнителни опции могат да се задават с настройки на елементи Subservices и Defaults на JSON конфигурацията например така
{
    "Type": "Rapido",
    "User": "username",
    "Pass": "password",
    "Subservices": [ 5, 8 ],
    "Defaults": { "IsOpenBeforePay": 1 }
}
Двете стойности под Subservices указват типа (времето за изпълнение) на градската и междуградската услуга по подразбиране. Отделно вече конкретно за всяка товарителница може да се променя типа на услугата през формата за редакция на куриерски товарителници.
 
Списък с валидни стойности на Subservices за куриери Рапидо
 1 До 60 мин. oт заявката            Експресни градски услуги
 2 До 120 мин. oт заявката           Експресни градски услуги
 3 До 180 мин. oт заявката           Експресни градски услуги
 4 До края на раб. ден               Експресни градски услуги
 5 24 часа                           Експресни градски услуги
18 48 часа икономична                Експресни градски услуги
19 ЕВРОПАЛЕ 600                      Експресни градски услуги
26 ЕВРОПАЛЕ 800                      Експресни градски услуги
27 ИНД. ПАЛЕ                         Експресни градски услуги
 6 Документи - експресна             Куриерски услуги в България 
 7 Документи - икономична            Куриерски услуги в България 
 8 Пакети - експресна                Куриерски услуги в България 
 9 Пакети - икономична               Куриерски услуги в България 
20 ЕВРОПАЛЕ 600 - експресна          Куриерски услуги в България 
21 ЕВРОПАЛЕ 600 - икономична         Куриерски услуги в България 
22 ЕВРОПАЛЕ 800 - експресна          Куриерски услуги в България 
23 ЕВРОПАЛЕ 800 - икономична         Куриерски услуги в България 
24 ИНД. ПАЛЕ - експресна             Куриерски услуги в България 
25 ИНД. ПАЛЕ - икономична            Куриерски услуги в България
В конфигурация Defaults могат да се настройват стойности по подразбиране при създаване на нова товарителница. В случая е указано реквизит Отвори преди плащане да бъде включен за всички нови товарителници към Рапидо по подразбиране.

 

Настройки на услуга на куриери Спиди

Конфигурацията на интеграцията се указва в JSON формат и минималната конфигурация изглежда така:

{
    "Type": "Speedy",
    "User": "username",
    "Pass": "password",
}

Други налични опции за конфигурация

{
    "Type": Text,                       // "Speedy" или "Econt" (Задължително)
    "User": Text,                       // Потребител за услуга на куриер (Задължително)
    "Pass": Text,                       // Парола на потребител (Задължително)
    "EndPoint": Text                    // URL на услуга на куриер
    "Timeout": 1..N                     // В секунди (по подразбиране 30)
    "SubServices": [ 505, 505 ],        // ID по подразбиране за пращане с градска, междуградска и международна услуга (виж по-долу)
    "ReturnServices": [ 505, 505 ],     // ID по подразбиране за връщане с градска, междуградска и международна услуга (виж по-долу)
    "SessionTimeout:" 1..N,             // СПИДИ: В секунди (по подразбиране 300)
    "RetServiceId": ID,                 // СПИДИ: optionsBeforePayment/returnServiceTypeId
    "RetPayerType": 0..2,               // СПИДИ: optionsBeforePayment/returnPayerType
       "CopyForSender": 0/1,               // СПИДИ: additionalCopyForSender
    "InsuranceCurrency": Text,          // ЕКОНТ: Валута за застраховка (по подразбиране BGN)
    "CollectCurrency": Text,            // ЕКОНТ: Валута за НП (по подразбиране BGN)
    "CollectAgreement": Text,           // ЕКОНТ: Номер на договор за НП
    "SmsNotification": 0/1,             // ЕКОНТ: services/sms_notification=ON (по подразбиране НЕ)
    "MaxRetry": 1..N,                   // ЕКОНТ: Брой повторения при грешка (по подразбиране 10)
    "MinDelay": 1..N,                   // ЕКОНТ: Милисекунди (по подразбиране 500)
    "MaxDelay": 1..N,                   // ЕКОНТ: Милисекунди (по подразбиране 2000)
    "Defaults": {
            // Подател
        "MyObjectPhone": Text,          // Телефон
        "SendTime": Time,               // Време на предаване
        "EndOfWorkTime": Time,          // Край на работно време
        "SenderOfficeId": ID,           // Изпращане от, ID на офис на куриер
            // Информация
        "ExpenseOfType": 0..2,          // За сметка на, 0=Подател, 1=Получател, 2=По договор (кредит)
        "PriceListType": 0..2,          // Ценова листа, 0=На платец, 1=На подател, 2=На получател
        "ContentDesc": Text,            // Съдържание
        "PackingDesc": Text,            // Пакетиране
        "PackCount": 1..N,              // Брой колети
        "TotalWeight": Number,          // Бруто тегло (кг)
            // Допълнителни услуги  
        "FixedHour": Time,              // Фиксирано време
        "IsInsured": 0/1,               // Застраховка
        "IsBackReceipt": 0/1,           // Обратна разписка
        "IsBackDocs": 0/1,              // Обратни документи
        "IsWeekendDelivery": 0/1,       // Съботен разнос
        "IsFragile": 0/1,               // Чупливо
        "IsDocuments": 0/1,             // Документи
        "IsOpenBeforePay": 0/1,         // Отвори преди плащане
        "IsTestBeforePay": 0/1,         // Тествай преди плащане
        "IsPostalMoneyTransfer": 0/1,   // Пощенски паричен превод
        "IsReturnVouchers": 0/1,        // Ваучери за връщане
        "SmsNotification": Phone,       // SMS известяване (ако тел. е различен от този на получател)
            // При отказ плащане
        "RetServiceId": ID,             // Услуга за връщане, ID на услуга на куриер
        "RetPayerType": 0..2,           // За сметка на, 0=Подател, 1=Получател, 2=По договор (кредит)
            // Обратна доставка
        "BackServiceId": ID,            // Услуга за обратна пратка, ID на услуга на куриер
        "BackPackCount": 1..N,          // Брой колети
    },
    "MyObjects": {
        "123": {                        // 123=ID на наш обект в услуга на куриер
            "IsOpenBeforePay": 1,
            <<other defaults>>          // Виж опции горе
        }
    }
}

Списък с валидни стойности на Subservices за куриери Спиди
505 СТАНДАРТ 24 ЧАСА          Градски услуги
411 PALLET ONE BG - 6 ЧАСА    Градски услуги
412 PALLET ONE BG - PREMIUM   Градски услуги
413 PALLET ONE BG - ECONOMY   Градски услуги
704 ГУМИ                      Градски услуги
505 СТАНДАРТ 24 ЧАСА          Междуградски услуги
412 PALLET ONE BG - PREMIUM   Междуградски услуги
413 PALLET ONE BG - ECONOMY   Междуградски услуги
704 ГУМИ                      Междуградски услуги
202 SPEEDY CEE ECONOMY        Международни услуги
432 PALLET ONE RO             Международни услуги
707 TYRES BALKANS             Международни услуги
 

Настройки на услуга на куриери Еконт

Конфигурацията на интеграцията се указва в JSON формат и минималната конфигурация изглежда така:

{
    "Type": "Econt",
    "User": "username",
    "Pass": "password",
}

 

Импорт на номенклатури на куриер

Като последна стъпка трябва да се импортират номенклатури с населени места и улици/квартали и да се свържат с номенклатурите на куриерската услуга, за да могат да се избират в съответните списъци на реквизити на документи в Dreem.

Във функционалност Референтни номенклатури отворете списък с държави и изберете България. От меню Средства изберете опция Импорт... и потвърдете току що настроения куриер като източник на данни.