Интеграции с куриери

Как да свържете Speedy с easySales: пълно ръководство за настройка

От екипа на easySales · Актуализирано 25 септември 2026 · 1 мин. четене

Как да свържете Speedy с easySales: пълно ръководство за настройка

Свържете Speedy с easySales: API данни за достъп и Получи подробности, договорът и обектът за приемане, трите кода на услугите, допълнителни услуги и застраховка, товарителници за чужбина и съобщенията за грешки на Speedy.

Какво Ви дава свързването със Speedy

Когато Speedy е свързан, easySales създава товарителници на Speedy за Вашите поръчки — поединично или масово —, отпечатва ги, проследява всяка пратка и анулира товарителница, която вече не Ви е нужна, без да отваряте приложението на Speedy. Speedy приема пратките в България, така че интеграцията е за пратките, които изпращате от адрес в България — в страната или в чужбина.

Две неща решават дали изобщо ще бъде създадена товарителница: обектът, който избирате в Договор след Получи подробности, и трите кода на услугите. По-голямата част от това ръководство е посветена на тях.

Преди да започнете

✓

Договор със Speedy с API достъп

API достъп се заявява от Speedy на telesales@speedy.bg и Ви дава API потребител и парола, отделни от обичайния Ви вход в Speedy.

✓

Вашите кодове на услугите

Цифровите идентификатори на Speedy за услугите във Вашия договор — един за същото населено място, един между населени места и един международен. Ще ги намерите в акаунта си в Speedy или можете да ги поискате от Speedy.

✓

Телефонен номер на Вашия обект в Speedy

Всеки обект, от който изпращате, трябва да има такъв в Speedy, иначе няма да се появи в списъка Договор.

Стъпка 1 — Отворете картата на Speedy

Отворете Интеграции → Куриери, потърсете speedy и натиснете Свържи на картата на Speedy — или Редактирай, ако вече сте я свързали.

Страницата Куриери в easySales, филтрирана по speedy, с една свързана карта на Speedy.
Интеграции → Куриери, филтрирано по `speedy`.

Стъпка 2 — Данни за достъп и бутонът Получи подробности

Горната част на формуляра за връзка със Speedy в easySales с Псевдоним Speedy склад София, Портребителско ID, Парола и бутоните Клонирай, Изтрий и Получи подробности.
Само тези полета се показват, докато Получи подробности не успее.

Портребителско ID и Парола са API данните за достъп, които Speedy Ви издава — не данните, с които влизате в сайта на Speedy. Псевдоним е името, което виждате в easySales, когато избирате между връзките.

Стъпка 3 — Формат на товарителницата, платец и трите кода на услугите

Формулярът на Speedy след Получи подробности с Формат на товарителница A6, Платец на куриерските услуги Sender, Вид В брой, Национален код на услугата 505, Код на местната услуга 505 и International Service Code 202.
Трите кода на услугите са собствени идентификатори на Speedy от Вашия договор.
Поле Какво прави
Формат на товарителница Оформлението, в което Speedy създава етикета: A4 (цяла страница), A6 (единичен етикет за термопринтер) или A4_4xA6 (четири етикета на един лист A4).
Платец на куриерските услуги На кого Speedy фактурира пратката — Sender (подателя), Recipient (получателя) или Third Party (трето лице).
Вид Как Speedy Ви предава парите, събрани при доставка: В брой или Пощенски превод.
Национален код на услугата Идентификаторът на услугата на Speedy за пратка между различни населени места — подсказката дава 505 като пример.
Код на местната услуга Идентификаторът на услугата на Speedy за доставка в същото населено място.
International Service Code Идентификаторът на услугата на Speedy за пратка, която напуска България — подсказката дава 202 като пример.
Полетата на товарителницата и какво прави всяко

Стъпка 4 — Договор, допълнителни услуги и застраховка

Формулярът на Speedy с избран Договор в София, полето Допълнителни услуги, отметната Застрахована пратка и Чупливо.
Обектът по договора е мястото, откъдето Speedy взема пратките.

Договор е списъкът, който Speedy е върнал за Вашия акаунт. Всеки запис е един от Вашите обекти в Speedy, а изборът му определя откъде Speedy взема пратките и телефона на подателя върху товарителницата — затова втора точка на приемане е втора връзка, а не настройка.

Настройка Какво прави
Допълнителни услуги Три опции, показани с румънските си имена: Livrare sambata (доставка в събота), Deschidere la livrare (клиентът може да отвори пратката, преди да плати; отказана пратка се връща за Ваша сметка) и Paletizat (пратката пътува като палет). Каквото изберете, се добавя към всяка товарителница, създадена на тази връзка.
Застрахована пратка Обявява пред Speedy стойността на продуктите с включен ДДС. Когато е включена, се появява втора опция — Чупливо —, която обявява съдържанието и като чупливо.
Наложен платеж Не е поле в този формуляр. easySales сам добавя сумата за събиране, когато поръчката се плаща при доставка.
Допълнителни услуги и застраховка

Стъпка 5 — Шаблон за бележки

Шаблон за бележки на връзка със Speedy в easySales, с бутоните за променливи от поръчката и продуктите над поле, съдържащо Поръчка ${order.id}.
Това, което създава шаблонът, се отпечатва върху товарителницата.

Това, което шаблонът създава, пътува с пратката и се отпечатва върху товарителницата, затова го ограничете до онова, което шофьор или склад трябва да прочете. Бутоните над полето вмъкват стойности от поръчката и от продуктите в нея. Speedy приема до 97 знака; по-дългият текст се отрязва.

Стъпка 6 — Настройки за печат и разширени възможности

Двата раздела са свити и нито един не е задължителен.

Разгънатите настройки за печат и разширени възможности на връзка със Speedy: размер на хартията, вид мащабиране, Резервен имейл и Генериране на пакети въз основа на броя на опаковките на продукта.
Двата раздела са свити по подразбиране.
Настройка Какво прави
Покажи настройките за печат Размер на хартията и мащабиране, използвани само когато печатате през връзката Printer на easySales и само за този куриер. Не е същото като Формат на товарителница: Speedy решава как изглежда етикетът, а тези настройки — как ляга на хартията.
Резервен имейл Изпраща се като имейл на получателя, когато поръчката няма такъв.
Генериране на пакети въз основа на броя на опаковките на продукта Брои пакетите в товарителницата по броя опаковки, зададен на всеки продукт, вместо винаги да изпраща един.
Настройки за печат и разширени възможности

Натиснете Запази. Картата на Speedy вече показва Свързано.

Повече от една точка на приемане

Отворете менюто ⋮ на картата на Speedy и изберете Свържете друг куриерски профил, или отворете съществуваща връзка и натиснете Клонирай, за да копирате всичките ѝ настройки. Всяка връзка има свой договор, свои кодове на услугите и свои допълнителни услуги, а Вие избирате между тях по Псевдоним, когато създавате товарителница. Изтрий, на същото място, премахва връзка, която вече не използвате.

Създаване на товарителници

Отворете Поръчки, изберете поръчките и използвайте Създай товарителница, или отворете отделна поръчка и създайте товарителницата ѝ там. Някои неща стават автоматично:

  • Наложеният платеж се добавя автоматично, когато поръчката се плаща при доставка, за стойността на поръчката. Вид определя как Speedy Ви го изплаща.
  • Офиси и автомати на Speedy. Когато клиентът е избрал офис или автомат на Speedy, товарителницата отива там вместо на домашния адрес, без промяна във връзката.
  • Тегло. Поръчка без тегло се изпраща с 0,25 кг.
  • Дестинации. Товарителници на Speedy могат да се създават за България, Румъния, Гърция, Полша, Унгария, Чехия, Словакия, Австрия, Германия, Италия и Франция. За всяка друга държава поръчката показва Izbraniyat kurier ne podderzha dostavki do tazi strana.

Изпращане в чужбина: размери на пакета

Задайте на поръчката опаковъчна кутия — определете кутиите си в Опаковъчни кутии, след това изберете поръчката в Поръчки и използвайте Изберете опаковъчни кутии — и създайте товарителницата от страницата на поръчката. Всяка кутия в поръчката става пакет, а дължината, ширината, височината и теглото ѝ отиват към Speedy заедно с товарителницата. Пак от страницата на поръчката създавате товарителница с няколко пакета или пликове.

Когато Speedy откаже товарителница

Speedy отговаря на български и съобщението му се показва в поръчката така, както пристига. Ето тези, които си струва да разпознавате.

Съобщение Какво означава
Пакети: Изискват се описани размери на пакета Обичайно при международните услуги — задайте на поръчката опаковъчна кутия и създайте товарителницата от страницата на поръчката.
Услуга: Услугата не е позволена Изпратеният код не е от тези, които договорът Ви позволява за тази дестинация. Проверете трите кода на услугите със Speedy.
Получател Адрес: Попълнете номер на улица/блок … В адреса за доставка липсва номер на улица или блок. Допълнете адреса в поръчката и създайте товарителницата отново.
Получател Телефон 1: Невалидна стойност Телефонът на получателя липсва или не е такъв, който Speedy приема.
Получател Лице за контакт: … Поръчката е за фирма и лицето за контакт трябва да е име на човек, различно от името на фирмата. Коригирайте името в адреса за доставка.
Обявена стойност: … е по-голяма от максималната … При включена Застрахована пратка обявената стойност е по-висока от допустимата за услугата. Лимитът е на Speedy, за всяка услуга поотделно.
Пакети: Броят пакети е извън допустимия интервал … Броят пакети е извън допустимото за услугата.
Получател Адрес 2: Максималната позволена дължина е 35 Вторият ред на адреса е по-дълъг от 35 знака. Съкратете го в поръчката.
Какво означават отказите на Speedy

Често задавани въпроси

API данните за достъп, които Speedy издава за Вашия договор, а не потребителското име и паролата, с които влизате в сайта на Speedy. API достъп заявявате от Speedy на telesales@speedy.bg.

Първо натиснете Получи подробности. Бутонът влиза в Speedy и прочита обектите по Вашия договор, а останалата част от формуляра — включително Запази — се появява едва след като това успее. Ако върне грешка, данните за достъп са грешни или API достъпът все още не е активиран.

easySales показва само обектите, които имат телефонен номер в Speedy, защото Speedy отпечатва телефона на подателя върху всяка товарителница. Помолете Speedy да добави телефонен номер към този обект и след това натиснете отново Получи подробности.

Това са собствените цифрови идентификатори на услугите на Speedy от Вашия договор: Код на местната услуга за доставка в същото населено място, Национален код на услугата между населени места и International Service Code за пратки, които напускат България. За адрес в България, Румъния или Полша easySales пита Speedy кои услуги достигат до него и изпраща първата потвърдена, в този ред.

Speedy Ви казва, че изпратената услуга не е от тези, които договорът Ви позволява за тази дестинация. Попитайте Speedy кои идентификатори на услуги включва договорът Ви и коригирайте кодовете във връзката.

Международните услуги на Speedy изискват размерите на пакета. Задайте на поръчката опаковъчна кутия (Поръчки → Изберете опаковъчни кутии) и създайте товарителницата от страницата на поръчката — дължината, ширината и височината на кутията се изпращат заедно с товарителницата.

Не. Когато поръчката се плаща при доставка, easySales сам добавя сумата за събиране. Вид във връзката определя само как Speedy Ви я изплаща — в брой или с пощенски превод.

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

Отворете менюто ⋮ на картата на Speedy и изберете Свържете друг куриерски профил, или отворете съществуваща връзка и натиснете Клонирай. Адресът за приемане следва обекта, избран в Договор, така че втора точка на приемане означава втора връзка.

Формат на товарителница се изпраща към Speedy и определя оформлението на етикета, който Speedy създава — цяла страница A4, единичен етикет A6 или четири етикета A6 на един лист A4. Размерът на хартията в настройките за печат важи само когато печатате през връзката Printer на easySales и подменя настройката по подразбиране на принтера само за този куриер.

Беше ли полезно това ръководство?