Как да свържеш eMAG (Румъния, България, Унгария) с eficio: ръководство стъпка по стъпка
Добавяш IP адресите на eficio в списъка с разрешени IP адреси в акаунта си в eMAG, след което попълваш в eficio потребителското име и паролата за API. След свързването поръчките от eMAG влизат сами в модула „Поръчки“, а наличностите, цените и фактурите се изпращат обратно към eMAG.
Защо да свържеш eMAG с eficio
Когато eMAG е свързан, поръчките от Румъния, България и Унгария влизат в същия списък като тези от останалите ти канали, а това, което правиш в eficio, се изпраща обратно към eMAG. eficio чете поръчките от акаунта ти на всеки 30 секунди.
- активните поръчки се изтеглят и се поддържат актуални, включително анулиранията, направени директно в eMAG;
- връщанията от eMAG се появяват в модула „Връщания“;
- офертите се четат веднъж на час, с наличността, цената, позицията в Buy Button и най-добрата цена;
- наличността и цената от eficio се изпращат към офертите в eMAG;
- фактурата, издадена чрез свързаната програма за фактуриране, се прикачва към поръчката в eMAG.
Какво да подготвиш предварително
- акаунт на продавач в eMAG Marketplace за всяка държава, която искаш да свържеш;
- потребителското име и паролата за API от акаунта в eMAG Marketplace; ако работиш с отделен API код, дръж под ръка и него (полето не е задължително);
- достъп до Настройки → API в акаунта в eMAG, за да добавиш адресите на сървъра на eficio в списъка с разрешени IP адреси (whitelist):
78.46.23.243и2a01:4f8:201:23cd::2; - серията, с която искаш да се издават фактурите за поръчките от eMAG, ако имаш свързана програма за фактуриране.
Стъпка 1 — Добави IP адресите на eficio в акаунта си в eMAG
В акаунта в eMAG Marketplace за държавата, която свързваш, отваряш Настройки → API и добавяш в whitelist двата адреса по-горе. Намираш ги и в прозореца за свързване в eficio: кликваш върху адреса и той се копира сам.
Без тази стъпка тестът на връзката не минава, дори ако потребителското име и паролата са верни.
Стъпка 2 — Отвори картата на eMAG в eficio
В менюто вляво отваряш „Integrări“ (Интеграции) и в „Canale de vânzare“ (Канали за продажба) избираш „Marketplace“ (Маркетплейс). Всяка държава има своя карта: „eMAG România“, „eMAG Bulgaria“ и „eMAG Ungaria“ (eMAG Румъния, България и Унгария). Лесно намираш картата с полето „Caută un marketplace“ (Търси маркетплейс) или с филтъра по държава вдясно. На картата на избраната държава натискаш „Conectează“ (Свържи).
Стъпка 3 — Попълни данните за API и езика
Отваря се прозорецът „Conectează eMAG România“ (Свържи eMAG Румъния) или този за избраната държава. Попълваш:
- „Nume utilizator (API eMAG)“ (Потребителско име за API в eMAG) и „Parolă API“ (Парола за API), и двете задължителни;
- „Cod API (opțional)“ (API код, по избор), само ако в акаунта в eMAG използваш отделен API код;
- „Nume conexiune“ (Име на връзката), името, под което виждаш акаунта в eficio;
- „Limbă conținut“ (Език на съдържанието), езикът, на който се публикува продуктовата страница в този канал; по подразбиране е румънски за Румъния, български за България и унгарски за Унгария, а продуктите без превод на избрания език се блокират при публикуване;
- „Status pentru comandă nouă“ (Статус за нова поръчка), статусът, с който новите поръчки, импортирани от eMAG, влизат в eficio.
Стъпка 4 — Настройките за цена, ДДС, фактуриране и доставка
- „Adaos preț“ (Надценка): процентът, който се добавя върху цената от eficio за всички оферти в eMAG на акаунта; когато го промениш, цените се изпращат отново за всички оферти във фонов режим, а ти получаваш известие, когато е готово;
- „Plătitor de TVA“ (Регистриран по ДДС), „Rata TVA implicită“ (Ставка на ДДС по подразбиране), „Cota TVA transport“ (Ставка на ДДС за транспорта) и „Țara TVA“ (Държава за ДДС): започват с 21% и Румъния; изключваш „Plătitor de TVA“, ако фирмата не е регистрирана по ДДС;
- „Seria de facturare“ (Серия на фактурите): серията на фактурите за поръчките от този канал (например MV);
- „Cont de facturare“ (Акаунт за фактуриране): появява се само когато имаш свързани няколко акаунта за фактуриране, и в него избираш чрез кой акаунт се фактурират поръчките от канала;
- „Tip pachet implicit“ (Тип пратка по подразбиране): „Colet“, „Plic“ или „Palet“ (колет, плик или палет);
- „Termen de livrare implicit“ (Срок за доставка по подразбиране): между 0 и 90 дни, за продуктите без собствен срок, зададен в страницата на продукта → „Detalii“ (Детайли) → „Termen de livrare eMAG“ (Срок за доставка в eMAG); 0 означава, че eficio не променя срока, зададен директно в eMAG, а нова стойност се изпраща веднага към офертите на акаунта.
Накрая натискаш „Conectează & testează“ (Свържи и тествай).
Какво се случва, след като запазиш
eficio проверява данните директно в eMAG. Ако всичко е наред, получаваш съобщението „Conexiune reușită cu eMAG RO“ (Успешна връзка с eMAG RO), съответно с BG или HU, а картата преминава в статус „Conectat“ (Свързан), с езика на съдържанието и момента на последния импорт.
- поръчките се четат автоматично на всеки 30 секунди; ако не искаш да чакаш, избираш „Importă comenzi“ (Импортирай поръчки) от менюто на картата (трите точки) и потвърждаваш с „Importă acum“ (Импортирай сега);
- офертите на акаунта се синхронизират веднъж на час и ги виждаш в „Marketplace → Oferte“ (Маркетплейс → Оферти);
- какво се изпраща към eMAG при всяка промяна (наличността, цената или и двете) избираш в „Stocuri și depozite → Sincronizări stoc & preț“ (Наличности и складове → Синхронизации на наличност и цена); по подразбиране се изпращат и двете;
- фактурата, издадена чрез свързаната програма за фактуриране, се прикачва към поръчката в eMAG, а проверка, която се прави всеки час, изпраща отново фактурите от последните 3 дни, които не са стигнали до eMAG;
- когато отвориш нова поръчка от eMAG, eficio я премества в „În procesare“ (В обработка) и я потвърждава в eMAG; ако предпочиташ да започваш обработката ръчно, изключваш опцията „Procesează comanda nouă când o deschid“ (Обработвай новата поръчка, когато я отворя) в „Setări → Firmă → Setări generale“ (Настройки → Фирма → Общи настройки) и използваш бутона „Pornește procesarea“ (Започни обработката) в страницата на поръчката.
Чести проблеми
- „Conectare eșuată“ (Неуспешно свързване) със съобщение за IP (от типа „Invalid vendor ip“): провери дали и двата адреса на eficio са в whitelist в акаунта в eMAG за държавата, която свързваш;
- „Lipsesc utilizator sau parolă eMAG“ (Липсват потребител или парола за eMAG): едно от задължителните полета е останало празно;
- друго съобщение: това е самият отговор, получен от eMAG; намираш го с „Vezi loguri“ (Виж логовете) от менюто на картата;
- „eMAG nu răspunde momentan (503 …)“ (eMAG не отговаря в момента): недостъпността е при eMAG; импортът се повтаря автоматично на всеки 30 секунди и изтегля пропуснатите поръчки, когато eMAG отново е достъпен;
- картата показва грешка: след като отстраниш причината, натискаш „Reconectează“ (Свържи отново); ако проблемът остане, натискаш „Deschide tichet“ (Отвори тикет).
Какво следва
- свържи куриера на eMAG, за да се издават товарителниците за поръчките от eMAG директно от eficio;
- свържи програмата за фактуриране: SmartBill, Oblio, FGO или Sedona;
- остави фактурата и товарителницата да се издават сами с автоматичните потоци.
Често задавани въпроси
Мога ли да свържа eMAG Румъния, България и Унгария в един и същ акаунт в eficio?
Колко често се изтеглят поръчките от eMAG?
Какво прави полето „Adaos preț“?
Мога ли да оставя eficio да коригира цената ми за Buy Button?
Пиши ни какво виждаш на екрана и ще ти помогнем да завършиш свързването. Виж също какво прави интеграцията с eMAG.

