2026-06-23 · 8 мин четене

Новата версия на eMAG API и защо стабилната ERP↔eMAG връзка вече е задължителна

Накратко: eMAG обнови своя Marketplace API до версия 4.5.1. За продавача това не е козметична промяна — заявките вече се проверяват по-строго, а нещата, които „просто работеха" при ръчно подаване, започват да връщат грешки. Точно сега е моментът връзката между вашия ERP и eMAG да е здрава, а не закърпена. По-долу обясняваме какво се промени и как MEGZO Vortex поема тежката част.

Какво се промени в eMAG API v4.5.1

eMAG не е просто витрина — той е програмен интерфейс, през който вашите системи „разговарят" с платформата. С версия 4.5.1 този разговор стана по-взискателен. Ето конкретиката, без излишни технически думи.

По-строг формат на заявките

Всяко обаждане към eMAG вече трябва да обвива данните в точно определена структура — полето data със списък вътре. Отговорът на eMAG също носи флаг isError, който трябва да е false, за да се счита заявката за успешна. Валидацията е по-стегната от преди: дребна грешка във формата, която старите версии прощаваха, сега спира операцията. На практика това означава, че самоделните скриптове и „временните" интеграции започват да чупят.

Оферти и цени — детайлите имат значение

Пълното публикуване на продукт минава през product_offer/save, а по-леките промени на наличност и цена — през offer/save. Тук има няколко капана, които струват пари, ако се сбъркат:

Цените се подават без ДДС. Ако изпратите цена с включено ДДС, продавате на грешна стойност.
За всяка оферта са задължителни минимална и максимална продажна цена. Без тях офертата не минава.
Ставката на ДДС се чете отделно, през vat/read — тоест системата ви трябва да знае коя ставка важи, не да я гадае.

Поръчки с краен срок

Новите поръчки се изтеглят с order/read и всяка трябва изрично да бъде потвърдена с order/acknowledge. Имате около 48 часа да обработите поръчката. Пропуснат срок означава забавяне, недоволен клиент и удар по рейтинга ви като продавач.

Товарителници и фактури

При изпращане използвате awb/save — важното е, че самият eMAG генерира номера на товарителницата и финализира поръчката. Готовата фактура (PDF, който вече сте издали) се прикача към поръчката чрез order/attachments/save, подавайки нейния адрес. eMAG не издава фактурата вместо вас — само я приема.

Лимити и достъп

API-то има тавани на скоростта: около 12 заявки в секунда за поръчки и около 3 в секунда за останалите ресурси. Достъпът е с Basic автентикация и IP адрес в белия списък — тоест заявките трябва да идват от точно определен сървър. Удряне в тези лимити без правилно поведение води до отказани заявки.

Защо това прави стабилната интеграция критична

Докато продавате няколко артикула, ръчната работа в панела на eMAG е поносима. Щом обемът расте — повече SKU-та, повече канали, повече поръчки на ден — всяка от горните дребни правила се превръща в риск. Грешен формат спира публикуване. Пропуснато потвърждение изяжда 48-часовия прозорец. Изпратена наличност, която не отчита вече продаденото, води до overselling — продавате нещо, което го няма, и после се извинявате на клиента.

Истинският въпрос не е „мога ли да се свържа с eMAG", а „издържа ли връзката ми, когато нещо се обърка" — а в реалния свят винаги се обърква.

Как MEGZO Vortex доставя надеждната връзка

MEGZO Vortex стои между вашия ERP и eMAG и поема цялата сложност на API v4.5.1, така че вие да гледате един екран, не документация.

Вашият ERP остава единственият източник на истина. Двупосочна синхронизация: каталог, наличности и цени излизат навън към eMAG; поръчките влизат навътре към ERP-а.
Защита от overselling. Наличността се изпраща с предпазен буфер, а ежедневна реконсилиация хваща всяко разминаване, преди да стане проблем.
Никакви дублирани поръчки. Всяка поръчка от eMAG става точно една продажба в ERP-а — идемпотентно, дори при повторно подаване.
Автоматични повторни опити с изчакване, съобразени с лимитите на eMAG. Заявка, която не успее окончателно, попада в опашка за неуспели операции (dead-letter queue) с известие и възможност за повторно пускане — нищо не се губи безшумно.
Ежедневна реконсилиация на поръчки, на разминавания в наличност и цена, и откриване на „осиротели" записи.
Товарителница и фактура се предават автоматично. Подчертаваме: ние не издаваме фискални фактури — само прикачаме фактурата, която вашият ERP вече е произвел.
Изолация на всеки клиент, криптирани при съхранение достъпи и пълна проследимост на всяка синхронизация.

ERP системи, които свързваме с eMAG

Готови да свържете ERP-а си с eMAG?

Кажете ни с каква система работите и ще видите връзката на живо — без двойно въвеждане и без overselling. Започнете от vortex.megzo.biz/start/.

← Blog