Интеграция на eMAG Marketplace с ERP: пълно ръководство

eMAG е най-големият маркетплейс в България, Румъния и Унгария. Ако продавате там сериозно, порталът на eMAG бързо престава да е достатъчен: поръчките се преписват на ръка в склада, наличността в портала изостава от реалната, а всяка грешка в адрес или сума се плаща при доставката.

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

Какво прави интеграцията

Интеграцията е двупосочна, но двете посоки не са равностойни. От eMAG към вас идват поръчките и офертите; от вас към eMAG отиват потвърждения, наличности и данни за доставка.

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

Какво ви трябва, преди да започнете

Три неща, и второто е единственото, което не зависи от вас:

• Активен акаунт на продавач в eMAG Marketplace с подписан договор.
• API потребител, поискан от eMAG. Това НЕ е вашият вход в портала - това е отделен технически потребител с имейл и парола, който eMAG създава по заявка.
• IP адресът на вашата ERP система, добавен от eMAG в списъка с разрешени адреси за този потребител.

Стъпките

1. Поискайте API достъп от вашия акаунт мениджър в eMAG или през тикет в Marketplace портала. Опишете, че искате технически потребител за интеграция с ERP система.
2. Вземете от вашата ERP система изходящия ѝ IP адрес. Дайте го на eMAG, за да го добавят в списъка с разрешени адреси - без това всяка заявка получава отказ.
3. Изберете държавата: eMAG България, Румъния и Унгария са отделни акаунти с отделни поръчки и оферти. Ако продавате в две държави, свързвате два акаунта.
4. Въведете имейла и паролата на API потребителя в екрана за интеграции на ERP системата и стартирайте теста на връзката.
5. След успешен тест изтеглете офертите си и ги мапнете към продуктите в каталога. Това е стъпката, която прави наличността реална.
6. Проверете първите поръчки, които влизат - адрес, редове, суми - преди да пуснете процеса без надзор.

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

Трите най-чести грешки

1. „You are not allowed to use this API“

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

Как да го стесните: ако сте сигурни в имейла и паролата, почти винаги причината е IP адресът. Поискайте от eMAG да потвърдят кои адреси са разрешени за този потребител и ги сравнете с адреса, който ви дава ERP системата.

2. Заявките връщат само първата страница

Ако интеграцията ви е собствена разработка: eMAG приема параметрите като JSON тяло на заявката. Изпратени като form данни, те се приемат без грешка и се игнорират тихо - включително страницирането и филтрите. Резултатът е, че системата вижда първите 100 записа и решава, че това са всички. Няма съобщение за грешка, което да ви подскаже.

3. Часовете на поръчките са изместени

Времената в отговорите на eMAG са в местната часова зона на съответния пазар, не в UTC. Ако системата ги приеме за UTC, всяка поръчка получава час, различен от реалния с два или три часа според сезона. Това не чупи нищо видимо, но обърква всеки отчет по дни и всеки срок за изпращане.

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

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

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

Колко време отнема реално

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

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

Какво печелите накрая

• Нула преписани поръчки и нула грешки от преписване в адреси и суми.
• Една наличност за eMAG и за всички останали канали, така че един и същ артикул не се продава два пъти.
• Товарителница директно от поръчката, с наложен платеж, попълнен от сумата с ДДС.
• Отчети, в които приходите от eMAG стоят до приходите от останалите канали.

Ако искате да видите как изглежда това при нас: страницата на eMAG интеграцията описва точно какво изтегляме, какво изпращаме и какво ви трябва за свързването.