ERP и Спиди: как работи интеграцията и как да започнете

Най-важното накратко

• Интеграцията със Спиди премахва повторното въвеждане на данни. Когато ERP системата, в която управлявате поръчките, наличностите и счетоводството си, е свързана със Спиди, тя поема четири задачи: товарителници, етикети, проследяване на пратките и отчитане на изплатените наложени платежи.
• Старият SOAP интерфейс на Спиди вече не работи. Поддръжката му беше прекратена на 30 септември 2024 г., а през 2025 г. той беше изцяло изведен от употреба. Затова интеграциите вече използват REST API.
• Има три начина за свързване. Вградена ERP интеграция, междинна платформа или собствена разработка. При всеки вариант отговорността за поддръжката е различна.
• По-малко клиенти избират наложен платеж, но плащането в брой все още преобладава. Под една трета от българите избират наложен платеж. В същото време 78% от тези, които плащат директно на куриера, все още предпочитат пари в брой.
• Сверявайте получените суми всеки работен ден. Спиди изплаща сумите от наложен платеж в първия работен ден след доставката. Ежедневната проверка ограничава евентуалните разминавания до поръчките от един ден.
• Prim.io обработва големи обеми поръчки. През системата преминават над 3,1 млн. поръчки месечно, а внедряването при повечето брандове отнема около шест седмици.

Ако изпращате със Спиди, вероятно познавате тази рутина. През нощта пристигат поръчки, сутринта някой ги въвежда една по една в портала на куриера, разпечатва етикетите и после копира номерата за проследяване обратно в онлайн магазина.

Ден по-късно получавате банков превод от Спиди с обща сума за десетки пратки. Някой от екипа трябва да установи кои поръчки са платени с него.

ERP системата с интеграция със Спиди спестява на екипа ви и двете задачи.

Ние разработваме Prim.io - ERP система за брандове и търговци с вградена интеграция със Спиди. В това ръководство разглеждаме какво прави интеграцията, кой начин на свързване е подходящ за вас и как получавате сумите от наложените платежи.

Съдържание

• Какво представлява интеграцията между ERP и Спиди
• Какво може да прави ERP системата чрез API на Спиди
• Три начина да свържете ERP системата със Спиди
• От поръчката до доставката стъпка по стъпка
• Защо наложеният платеж е най-сложната част
• Как да настроите интеграцията със Спиди
• Предимства на вградената интеграция при разрастване на бизнеса
• Как работи интеграцията със Спиди в Prim.io
• Основни изводи
• Често задавани въпроси
• Заключение

Какво представлява интеграцията между ERP и Спиди

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

След това в системата постъпват и данните за изплатените суми. Така парите, събрани от куриера, се отнасят към правилната продажба.

Нека първо уточним няколко понятия. ERP (enterprise resource planning) е система, която обединява поръчките, наличностите, покупките и счетоводството ви. Повече за възможностите ѝ можете да прочетете в ръководството ни какво представлява ERP системата.

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

При наложен платеж (COD) клиентът плаща на куриера при получаване на пратката, а след това Спиди ви изплаща събраната сума.

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

Според данните за компанията Спиди има над 35% дял от българския куриерски пазар и разполага с над 1 300 пункта, повече от 850 от които са автомати.

Какво може да прави ERP системата чрез API на Спиди

API (приложно-програмен интерфейс) е набор от правила, чрез които две системи обменят данни без ръчна намеса.

Спиди използва REST API. ERP системата изпраща уеб заявки и получава отговори в JSON - широко използван текстов формат за обмен на данни.

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

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

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

На страницата за интеграции Спиди изрично посочва, че разработването на нови функции и техническата поддръжка за този интерфейс са прекратени на 30 септември 2024 г. През 2025 г. той е изцяло изведен от употреба.

Ако плъгинът ви е настроен преди 2024 г. и оттогава не е обновяван, поискайте писмено потвърждение от доставчика, че използва REST API.

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

Три начина да свържете ERP системата със Спиди

Има три основни варианта: вградена ERP интеграция, междинна платформа или собствена разработка. Междинната платформа (middleware) е отделно приложение между ERP системата и Спиди, което преобразува данните във формат, разбираем за всяка от двете страни.

Когато сравнявате вариантите, обърнете внимание кой носи отговорност за поддръжката. Всяко допълнително приложение между ERP системата и Спиди е още едно място, където промяна от едната страна може да спре изпращането на пратки.

За повечето брандове вградената интеграция е най-лесна за поддържане, защото един доставчик отговаря за целия процес. Това е подходът, който избрахме за Prim.io.

Спиди е сред над 50-те вградени интеграции на Prim.io. Ако ви е нужна допълнителна функционалност, в документацията на API на Prim.io са описани заявките за работа с поръчки за продажба и начини на доставка.

От поръчката до доставката стъпка по стъпка

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

• Поръчката постъпва в системата. Тя идва от онлайн магазина или маркетплейса, а ERP системата записва адреса за доставка или избрания офис или автомат на Спиди.
• Количествата се резервират. ERP системата запазва артикулите за тази поръчка, така че да не бъдат продадени повторно през друг канал.
• Създава се товарителница. ERP системата изпраща данните за пратката към Спиди и записва върнатия номер на товарителницата към поръчката.
• Етикетът се разпечатва. Складът го отпечатва като PDF или в ZPL - формат за термопринтери за етикети.
• Номерът за проследяване се връща в системата. Той се записва към поръчката и се изпраща на клиента по имейл или SMS.
• Статусът се обновява. Информацията от куриера актуализира поръчката до доставката на пратката.
• Наложеният платеж се отчита. Когато Спиди изплати сумата, ERP системата я отнася към продажбата и я приключва.

Първата стъпка е особено важна за България. Според доклада на регулатора за куриерските услуги, цитиран от БТА, 83% от потребителите използват куриерски услуги, а 70,1% предпочитат доставка до офис или автомат.

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

При много интеграции липсва последната, седма стъпка. Документацията за интеграцията между Prim.io и Спиди описва целия процес - от товарителницата до приключената продажба.

Защо наложеният платеж е най-сложната част

Изпращането на пратките е видимата част от интеграцията. Отчитането на парите често е причината финансовият екип да остава до късно в края на месеца.

Докладът на регулатора за 2025 г., цитиран от БТА, показва, че под една трета от потребителите избират наложен платеж. При директно плащане на куриера обаче парите в брой все още преобладават. Според проучване на Payments Europe за България, представено от Economic.bg, 78% от плащащите директно на куриер продължават да предпочитат плащане в брой пред плащане с карта.

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

Как Спиди изплаща наложените платежи

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

За вътрешни пратки сумата се изплаща на първия работен ден след доставката. При изплащане по банков път таксата за наложен платеж в страната е 2,4% от сумата, но не по-малко от 0,61 евро.

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

Наричаме този проблем разминаване при наложените платежи (COD drift). Малки неотнесени суми се натрупват всеки ден, докато в края на месеца се появи разлика, която никой не може да обясни.

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

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

Има и две допълнителни настройки за наложения платеж, които е добре да уточните още в началото. Клиентите могат да платят на куриера с карта, за което таксата на Спиди е 0,96%. Ако не желаете да предлагате този вариант, той може да се изключи чрез API.

Вторият въпрос трябва да обсъдите със счетоводителя си. API поддържа обработка на наложения платеж като плащане в брой или като пощенски паричен превод. Преди да започнете работа, уточнете кой вариант отговаря на начина ви на отчитане по Наредба Н-18.

Когато клиентът иска преглед преди плащане

Много български купувачи искат да видят стоката, преди да платят. Чрез API на Спиди можете да предложите преглед или преглед и тест преди плащане. Вие определяте и кой поема разходите за връщане, ако клиентът откаже пратката.

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

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

Как да настроите интеграцията със Спиди

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

Основната работа е да проверите детайлите. При вградена интеграция връзките между полетата в двете системи вече са настроени.

Имате ли договор със Спиди и данни за API достъп

• Сключете договор със Спиди. Необходим е активен фирмен акаунт, за да можете да използвате API.
• Добавете анекс за наложен платеж, ако събирате суми чрез куриера. В API документацията на Спиди е посочено, че може да е необходим валиден договор и анекс за наложен платеж за съответната дестинация.
• Поискайте тестови данни за достъп. Изпратете имейл до api.registration@speedy.bg с име и фамилия, име на фирмата, телефонен номер и потребителско име в Teams, ако имате такова.

Кои полета трябва да бъдат свързани

Свързването на полетата означава да определите кое поле в ERP системата попълва съответното поле при Спиди. Най-често грешки възникват при следните пет:

• Адрес на подателя и получателя. Улицата и пощенският код трябва да отговарят на адресния формат на Спиди. В противен случай пратката няма да бъде създадена. API включва заявка за проверка на адреса, която е добре да се използва преди генериране на товарителницата.
• Идентификатор на офиса или автомата. Полето е задължително, когато клиентът избере офис или автомат вместо доставка на адрес. Списъкът с обекти на Спиди трябва да се синхронизира, за да са актуални и идентификаторите.
• Брой и тегло на пакетите. Тези стойности участват в изчисляването на цената и се отпечатват на етикета. Грешното тегло означава и грешна цена за доставка.
• Сума на наложения платеж. Това е точната сума, която куриерът трябва да събере. След въвеждането на еврото в България на 1 януари 2026 г. тя се задава в евро. Максималният наложен платеж за вътрешна пратка е 5 112,41 евро, а за пратка от или до автомат - 2 000 евро.
• Референция към поръчката (ref1/ref2). Тук се подава номерът на поръчката. Той остава свързан с пратката и помага на екипа ви бързо да намери съответната продажба.

Как да тествате преди началото на работа

• Създайте тестови пратки. Направете по няколко за всеки вид доставка, който предлагате - до адрес, офис или автомат.
• Проверете етикетите и номерата за проследяване. Разпечатайте всеки етикет и потвърдете, че номерът за проследяване е записан към поръчката. Една заявка за проследяване към Спиди може да включва до 10 пратки, затова групирайте проверките на статуса по 10.
• Проверете целия процес с една поръчка с наложен платеж. Уверете се, че Спиди получава правилната сума и референция към поръчката. След това проверете дали първата реално изплатена сума се свързва с правилната продажба.
• Тествайте и отказ на пратка. Ако предлагате преглед или тест преди плащане, изпратете тестова пратка, която получателят да откаже. Проверете дали очакваният наложен платеж се отменя и стоката се връща в наличност.

След като започнете работа, сверявайте изплатените наложени платежи всеки работен ден. Веднъж седмично преглеждайте и всички суми, които все още не са свързани с продажба. Броят на тези плащания е основният показател, който трябва да следите.

Предимства на вградената интеграция при разрастване на бизнеса

Всеки нов канал за продажби или куриер добавя още една връзка за поддръжка. Бранд, който изпраща със Спиди, често започва да работи и с Еконт, Sameday или BOX NOW заради покритието или цената.

При междинна платформа или собствена разработка всяка нова връзка се превръща в отделен проект. При вградена интеграция обикновено е въпрос на настройка.

Пазарът има възможност да расте още. Според Eurostat 78% от хората в ЕС са пазарували онлайн през 2025 г. В България разликата между дела на използващите интернет и дела на пазаруващите онлайн е 33 процентни пункта - една от най-големите в ЕС.

Според нас тази разлика показва потенциал за растеж. А всеки нов онлайн купувач означава и повече пратки за обработка.

При големи обеми ползата от интеграцията става особено видима. Prim.io обработва над 3,1 млн. поръчки всеки месец, а повечето брандове започват работа със системата за около шест седмици.

Ако сравнявате решения, в статията ни за най-добрите ERP системи за български eCommerce брандове ще откриете информация за местните изисквания за ДДС и работата с куриери. За складовите процеси и международните доставки прочетете ръководството ни за изпълнение на онлайн поръчки.

Как работи интеграцията със Спиди в Prim.io

В този раздел представяме собствения си продукт.

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

След това проследява пратката до доставката ѝ. При поръчки с наложен платеж създава плащане в посочената от вас каса и приключва продажбата. Така поръчката, складовите движения и финансовите записи се отразяват заедно.

В документацията ни препоръчваме плащанията да се отнасят към продажбите веднъж дневно, вместо на всеки час. Спиди е в една система с Еконт, DPD, BOX NOW и Sameday, така че добавянето на още един куриер става чрез настройка.

Основни изводи

• Интеграцията заменя ръчната работа в портала на куриера. ERP системата, свързана със Спиди, поема товарителниците, етикетите, проследяването и отчитането на наложените платежи - четири задачи, които екипите често изпълняват ръчно.
• Вече се използва само REST API. Спиди прекрати поддръжката на стария SOAP интерфейс (EPS) на 30 септември 2024 г. и го изведе изцяло от употреба през 2025 г.
• Отговорността за поддръжката е водеща при избора. Основната разлика между вградена интеграция, междинна платформа и собствена разработка е кой отстранява проблемите при промени.
• Идентификаторите на офисите и автоматите са задължителни. По данни, цитирани от БТА, 70,1% от българските потребители на куриерски услуги предпочитат доставка до офис или автомат.
• Сверявайте сумите с честотата, с която Спиди ги изплаща. Наложените платежи се изплащат всеки работен ден. Ежедневното сверяване ограничава неотнесените суми до поръчките от един ден.
• Prim.io е създадена за големи обеми. През системата преминават над 3,1 млн. поръчки месечно.

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

Предлага ли Спиди REST API за интеграция с ERP и онлайн магазини

Да. Спиди предлага REST API с обмен на данни в JSON. То обхваща избор на адрес и офис, изчисляване на цена, създаване на пратка, печат на етикети, проследяване и заявки за посещение на куриер.

Как изглежда интеграцията между ERP и куриер на практика

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

Работи ли още старата SOAP интеграция на Спиди

Не. Спиди прекрати поддръжката на SOAP интерфейса EPS на 30 септември 2024 г. и го изведе изцяло от употреба през 2025 г. Затова интеграциите трябва да използват REST API.

Как да изберете подходящия начин за интеграция с ERP

Изберете вградена интеграция, ако ERP системата ви предлага такава. Междинна платформа е вариант, ако трябва да запазите система без собствена връзка със Спиди. Към собствена разработка се насочете само ако имате разработчици, които да я поддържат.

Какво представлява платформата за ERP интеграции

Платформата за ERP интеграции, наричана още middleware или платформа за интеграция на корпоративни системи, е отделно приложение. То прехвърля данни между ERP системата и други приложения и услуги, например куриери и онлайн магазини.

Заключение

Когато свържете ERP системата със Спиди, всяка поръчка автоматично получава товарителница, етикет и проследяване. Интеграцията отнася и сумите от наложен платеж към правилната продажба - задачата, която най-често затруднява ръчната обработка.

Нашият съвет е да изберете вариант с възможно най-малко приложения за поддръжка и да сверявате наложените платежи всеки работен ден още от първата седмица. За повечето български брандове това означава вградена интеграция в ERP системата.

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