Съдържание
API потребителско име и парола #
За да свържете Speedy със Shopify, е необходимо да имате API потребителско име и парола.
Важно: Username и Password за Speedy API е различно от потребителското име и паролата за вход в MySpeedy профила.
За получаване на тестови достъп (потребителско име и парола) изпратете имейл до api.registration@speedy.bg със следната информация:
- Име и фамилия
- Име на фирмата
- Телефон за контакт
- Teams име (ако е налично)
Повече информацмия на сатйа на Speedy: https://www.speedy.bg/bg/system-integration
Настройката на интеграцията #
Настройката на интеграцията се извършва в админ панела на Shopify. Отворете основната страница на Изпрати БГ и изберете „Свържете куриер„.
Стъпки за интеграция със Speedy в Shopify чрез Izprati #
Тази таблица включва описание на всяко поле за настройка на интеграцията със Speedy. Следвайте следващите стъпки, за да свържете своя Shopify магазин с куриера Speedy чрез приложението Izprati.
| Поле (англ.) | Превод (бълг.) | Описание | Необходими действия | Бележки |
|---|---|---|---|---|
| Стъпка 1 | – | – | – | – |
Carrier settings | Настройки на куриер | Основни настройки за връзка с куриерската интеграция. | – | Име на секция |
| Integration | Интеграция | Избор на куриер (Еконт, Спиди, BoxNow, Sameday). | [1] Изберете куриер Speedy. [2] Натиснете бутона „Create connection“. | Не създавайте повече от една връзка на куриер. |
| Connection | Връзка | Връзка между Shopify магазина и конкретния куриер. | [1] Carrier → Speedy (вече е попълнено) [2] Connection name* → напр. Speedy Main (Име, по което ще разпознавате връзката, заедно с името на куриера) [3] Username → въведете вашето Speedy API потребителско име (Получено от Спиди мениджър; различно е от потребителското име и паролата за вход в MySpeedy профила) [4] Password → въведете вашата Speedy API парола (получена от Спиди мениджър) [5] Натиснете бутона Create | ⚠️ Важно: Username и Password за Speedy API е различно от потребителското име и паролата за вход в MySpeedy профила. Потребителското име и паролата се предоставят от вашия Speedy мениджър. Поискайте от вашия Speedy мениджър потребителско име и парола за Speedy API. Контактите на вашия мениджър можете да намерите в профила си в MySpeedy, горния десен ъгъл.  |
| Стъпка 2 | – | – | – | – |
| Authentication | Удостоверяване | Данни за достъп до API на куриера. | – | Име на секция |
| Username | Потребителско име | Потребителско име за API достъп, получено от куриера. | Username → въведете вашето Speedy API потребителско име (Получено от Спиди мениджър; различно е от потребителското име и паролата за вход в MySpeedy профила) | Попълнете, ако сте го пропуснали на Стъпка 1. |
| Password | Парола | Парола за API достъп, получена от куриера. | Password → въведете вашата Speedy API парола (получена от Спиди мениджър) | Попълнете, ако сте го пропуснали на Стъпка 1. |
| Company Agreement ID | Номер на фирмено споразумение | Номер на споразумението в системата на куриера. | Пропуснете това поле на тази стъпка и го попълнете на Стъпка 4. | Къде да намерите  |
| Стъпка 3 | – | – | – | – |
| General Options | Общи опции | Основни настройки за услугата и начина на плащане. | – | Име на секция |
| Default Service Rate | Стандартна тарифа за услуга | Тарифа, която се използва, ако няма зададена друга. | Може да изберете, но не е задължително. | – |
| COD Processing Type | Тип обработка на наложен платеж | Начин на обработка на наложен платеж (в брой или Пощенски паричен превод). | [1] Изберете една от опциите: – Cash = Cash on Delivery (COD)→ В брой – Наложен платеж – Postal Money Transfer → Пощенски паричен превод ( съгласно Наредба Н-18) | Важно: Cash може да бъде избран само ако действате като юридическо лице, а не като физическо лице. |
| Fiscal receipt enabled | Фискален бон активиран | Активира издаване на фискален бон за услугата. | При избор на Cash е необходимо да бъде активирано и Fiscal receipt enabled | Пример: |
| Card Payment Forbidden | Забранено плащане с карта | Забранява плащане с карта за наложен платеж. | Ако желаете събиране на плащане само в брой (без възможност за плащане с карта) при наложен платеж. | – |
| Currency Code | Код на валута | ISO 4217 код за валута (BGN, EUR и т.н.). | Не. | Задава се автоматично във фоновата система и не е видимо за вас. Полето изглежда празно. |
| Include Shipping Price | Включи цена за доставка | Включва цената за доставка в сумата за наложен платеж. | Hе е задължително. | – |
| Cash on Delivery Custom Name | Персонализирано име за наложен платеж | Име, което ще се показва за наложения платеж. | Hе е задължително. | – |
| Language | Език | Език, който ще се използва за API комуникация. Език на товарителницата. | Hе е задължително. | Можете да изберете български: Bulgarian. |
| Стъпка 4 | – | – | – | – |
| Payer Details | Детайли за платец | Настройки кой поема разходите по доставката. | – | Име на секция |
| Company Agreement ID | Номер на фирмено споразумение | Номер на споразумението в системата на куриера. | Задължително за юридически лица. | Къде да намерите |
| Courier Service Payer | Платец на куриерската услуга | Определя кой плаща куриерската услуга – клиентът или фирмата. | Изберете опция. | Ако сте попълнили Carrier Agreement ID и действате като юридическо лице, изберете Company. Ако сте физическо лице, изберете Sender. Ако искате купувачът да заплати обратната пратка, изберете Recipient. |
| Declared Value Enabled | Декларирана стойност активирана | Добавя декларирана стойност към пратката (за застраховка). | Попълнете, само ако е приложимо. | Позволява добавяне на декларирана стойност към пратките. Ако е активирано, декларираната стойност ще бъде добавена към пратката. Това е стойността на пратката, която се декларира пред куриерската услуга и се използва за целите на застраховането. |
| Declared Value Payer | Платец на декларираната стойност | Определя кой плаща за декларираната стойност. | Изберете опция. | Ако сте попълнили Carrier Agreement ID и действате като юридическо лице, изберете Company. Ако сте физическо лице, изберете Sender. Ако искате купувачът да заплати обратната пратка, изберете Recipient. |
| Return Shipment Payer | Платец на обратна пратка | Определя кой плаща връщането на пратката. | Изберете опция. | Ако сте попълнили Carrier Agreement ID и действате като юридическо лице, изберете Company. Ако сте физическо лице, изберете Sender. Ако искате купувачът да заплати обратната пратка, изберете Recipient. |
| Стъпка 5 | – | – | – | – |
| Delivery Options | Опции за доставка | Допълнителни условия и маркировки за пратката. | – | Име на секция |
| Open Before Payment | Отвори преди плащане | Позволява на клиента да отвори пратката преди плащане. Преглед и тест. | Попълнете, само ако е приложимо. | По подразбиране изберете Disabled – без преглед и тест. |
| Parcel Fragile | Чуплив пакет | Маркира пратката като чуплива. | Попълнете, само ако е приложимо. | Hе е задължително. |
| Parcel Palletized | Пакет на палет | Маркира пратката като палетизирана. | Попълнете, само ако е приложимо. | Hе е задължително. |
| Parcel Documents | Пратка с документи | Маркира пратката като съдържаща документи. | Попълнете, само ако е приложимо. | Hе е задължително. |
| Saturday Delivery | Доставка в събота | Позволява доставка на пратката в събота. | Попълнете, само ако е приложимо. | Hе е задължително. |
| Return Shipment Service ID | ИД на услуга за връщане | Услуга, която се използва при връщане на пратка. | Изберете Standard Return Service. | – |
| Return Shipment Payer | Кой заплаща обратната пратка | Платец на обратна пратка | Изберете опция. | Ако сте попълнили Carrier Agreement ID и действате като юридическо лице, изберете Company. Ако сте физическо лице, изберете Sender. Ако искате купувачът да заплати обратната пратка, изберете Recipient. |
| Стъпка 6 | – | – | – | – |
| Labels Options | Опции за етикети | Настройки за съдържанието на товарителницата. | – | Име на секция |
| Documents Type | Тип документи | Вид документ (например BOL – товарителница). | Изберете опция BOL | BOL = товарителница. |
| Default Package Content | Съдържание на пратката по подразбиране | Текст, който се отпечатва като съдържание, ако не е зададено друго. | Попълнете, само ако е приложимо. | Hе е задължително. |
| Default Drop Off Office | Офис за предаване по подразбиране | Офис за предаване на пратки по подразбиране. | Попълнете, само ако е приложимо. | Hе е задължително. |
Номер на споразумението в системата на куриера. #
Име и парола за Speedy API #
Поискайте от вашия Speedy мениджър потребителско име и парола за Speedy API. Контактите на вашия мениджър можете да намерите в профила си в MySpeedy, горния десен ъгъл.
