Функции

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

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

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

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

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

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

FGO акаунт с API достъп

API потребителят от стъпка 1 може да бъде създаден само на план FGO, който включва API достъп. Проверете своя план във FGO, преди да започнете.

API потребител, създаден във FGO

Не обичайният Ви вход. FGO генерира парола за него и точно тази парола easySales нарича Частен ключ.

Вашият CUI

Румънският данъчен номер, показан в Setări → Firmă (Настройки → Фирма) във FGO.

Готова за използване серия фактури

С API права, валиден период и все още налични номера. Това е стъпката, която най-често се пропуска.

Стъпки 1 до 3 се извършват във FGO, а не в easySales. Всяка от тях се проваля по свой начин и пропускането на която и да е води до съобщение за грешка, което придобива смисъл едва след като знаете за какво се отнася — затова си струва да направите и трите, преди да отворите easySales.

Стъпка 1 — Създайте API потребителя във FGO

В административния панел на FGO отворете Setări → Utilizatori (Настройки → Потребители) и добавете API потребител. FGO генерира парола за него: копирайте я още сега, защото точно тя е това, което easySales нарича Частен ключ.

Стъпка 2 — Позволете на FGO да приема заявки от easySales

Във FGO отворете Setări → eCommerce → Setări API (Настройки → eCommerce → Настройки на API) и добавете https://easy-sales.com към списъка със сайтове, на които е разрешено да се свързват през API.

Стъпка 3 — Подгответе серията фактури

Във FGO отворете Setări → Serii Documente (Настройки → Серии документи) и проверете серията, с която възнамерявате да фактурирате. Тя се нуждае от правото User API — както върху самия API потребител, така и върху записа за всички потребители — и от период From / To, който покрива днешната дата и в който все още има останали номера.

Стъпка 4 — Свържете FGO в easySales

Отидете в Конфигурация → Интеграции → Софтуер за фактуриране и намерете плочката FGO.

Екранът Софтуер за фактуриране в easySales, филтриран по FGO, със свързаната плочка FGO, румънското знаме и действието Редактирай.
FGO в Интеграции → Софтуер за фактуриране.

Натиснете Свържете и попълнете формата.

Формата за връзка с FGO в easySales с Наименование на връзката, Регистрационен номер на фирмата, Частен ключ, Вид на фактурата, Метод за корелация на продукта, Използвайте като източник на наличности за продукти, SAGA складов код и шаблона за забележки към фактурата с бутоните за променливи.
Цялата връзка. Частният ключ е паролата, която FGO генерира за Вашия API потребител.
Поле Какво прави
Наименование на връзката Задължително. Вашият собствен етикет. Става име на таба, ако свържете повече от един FGO акаунт.
Регистрационен номер на фирмата Задължително. Тук се въвежда CUI — румънският данъчен номер, точно както FGO го показва в Setări → Firmă (Настройки → Фирма).
Частен ключ Задължително. Паролата, която FGO генерира за API потребителя от стъпка 1. Показва се в явен вид в тази форма, а не скрита.
Вид на фактурата Какъв документ да се издава във FGO — Factura за обикновена фактура, като общо има единадесет опции, сред които Proforma, Aviz (стокова разписка), обратно начисляване и режим на маржа.
Метод за корелация на продукта Как easySales казва на FGO за кой артикул се отнася даден ред. SKU изпраща складовия код на продукта, а при липса — неговото SKU. Име не изпраща никакъв код и оставя FGO да съпостави по наименованието на артикула.
Използвайте като източник на наличности за продукти Задължително, но за FGO не променя нищо — въпреки името си, не то прави FGO източник на наличности. Това, което наистина кара FGO да изпише стоката, е Saga складовият код по-долу.
SAGA складов код Складът във FGO, срещу който се осчетоводява всеки ред от фактурата — това е, което кара FGO да изпише стоката от наличност. Напишете го точно както складът се казва във FGO. Оставете го празно, ако не водите наличности там.
Шаблон Свободен текст, който се отпечатва в забележките на фактурата. Бутоните отгоре вмъкват променливи — номер на поръчката, номер на товарителница, куриер, начин на плащане или списък на поръчаните продукти.
Формата за връзка с FGO

Стъпка 5 — Разширени възможности

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

Разгънатите разширени възможности на FGO връзката с идентификационни кодове на такси, които съпоставят Доставка с TRANSP и Отстъпка с DISC, Премахни специални символи, настройките за гаранция и Изключи отстъпките от фактурите, а най-долу бутоните Клонирай, Изтрий и Запази.
Идентификационните кодове на такси са тези, които си струва да се зададат: те казват на FGO към кой артикул принадлежи ред за доставка или за отстъпка.
Настройка Какво прави
Идентификационни кодове на такси Съпоставя редовете за доставка, отстъпка и такса с кодовете на артикули, които използвате във FGO. Задайте на всеки вид, текста, който се съдържа в наименованието на таксата, и кода на артикула във FGO. Без това тези редове пристигат като несъпоставени артикули.
Използвайте описанието на продукта Избира какво влиза в колоната с описание на фактурата — нищо, кода на продукта, името му, свойствата му или EAN.
Избери име на продукта Кое от трите имена, които easySales пази, да се отпечата: името на продукта в склада, каталожното име или името на офертата.
Изобразявай подаръчните продукти като отделна отстъпка Слага безплатните артикули във фактурата като ред с отстъпка, вместо като продукт с нулева цена.
Премахни специални символи Премахва специалните символи от имената и адресите на клиентите преди изпращане. Полезно, когато FGO отказва диакритичен знак или символ.
Генерирай гаранция при фактуриране Създава едновременно и гаранционна карта по избран от Вас шаблон и може да я обедини в същия PDF с фактурата.
Изключи отстъпките от фактурите Оставя редовете с отстъпки изцяло извън документа.
Разширени настройки, които си струват

Стъпка 6 — Кажете на easySales коя серия да използва

Връзката не носи серия. easySales определя по една за всяка поръчка, в този ред: серията, зададена на маркетплейс връзката, от която е дошла поръчката, след това зададената на уебсайта, след това вече наличната върху самата поръчка.

Издаване на фактури

Откъде Действие Серия
Списъкът с поръчки Бързо създаване в колоната за фактура Взема се от поръчката
Страницата на самата поръчка Създай фактура Взема се от поръчката
Списъкът с поръчки, няколко наведнъж Създай фактура — до 50 поръчки, по една фактура за всяка Определя се за всяка поръчка
Група за обработка Създай фактура Определя се за всяка поръчка
Автоматизационен поток Действието за създаване на фактура Определя се за всяка поръчка
Откъде можете да издадете фактура във FGO

Когато една фактура се провали

Отказите на FGO се предават дословно, на румънски, независимо на какъв език използвате easySales. Те са точни, стига да можете да ги разчетете — таблицата по-долу обяснява всеки от тях.

Какво казва FGO Какво да направите
Platforma https://easy-sales.com nu este inregistrata in FGO Стъпка 2 е пропусната. Добавете адреса във FGO, в Setări → eCommerce → Setări API.
Registrul pentru seria … nu este definit sau a expirat. Серията няма API права, периодът ѝ е изтекъл или номерата са свършили. Проверете и трите в Setări → Serii Documente.
Campul 'Serie' este obligatoriu. До FGO изобщо не е достигнала серия. Задайте такава на маркетплейс връзката или на уебсайта.
Hash-ul transmis nu este corect. Частният ключ е грешен или е сменен във FGO. Поставете отново актуалния.
Utilizatorul nu exista sau nu are drepturi de acces. API потребителят е изтрит или е загубил правата си. Създайте го отново в Setări → Utilizatori.
Codul unic nu exista sau nu este asociat. Стойността в Регистрационен номер на фирмата не съвпада с CUI на FGO акаунта.
Campul Client[CodUnic] este obligatoriu. Клиентът е фирма, но поръчката няма CUI. Добавете го в данните за фактуриране на поръчката.
Judetul … nu exista in nomenclator Адресът за фактуриране няма окръг или има такъв, който FGO не разпознава. Изберете окръга върху поръчката.
CotaTVA … nu exista in nomenclator. ДДС ставката на един от редовете не съществува във FGO. Добавете тази ставка във FGO или я коригирайте върху поръчката.
Factura este deja stornata. За тази фактура вече съществува сторно.
Factura a fost transmisa in SPV. Nu se poate anula. Фактурата е подадена към ANAF и вече не може да бъде анулирана — вместо това издайте сторно фактура.
Какво означават най-честите откази на FGO (FGO отговаря на румънски)

По избор — FGO като източник на наличности

FGO може да казва на easySales и с каква наличност разполагате. Това е втора, отделна връзка в Конфигурация → Интеграции → Източници на наличности, със същия CUI и същата парола на API потребителя, и трябва да бъде прикачена към уебсайт, преди изобщо нещо да се синхронизира.

Екранът Източници на наличности в easySales, където FGO е настроен като източник на наличности — връзка, отделна от тази за фактуриране.
Четенето на наличности от FGO е втора връзка, със собствено копие на същите данни за достъп.

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

При съвсем нова FGO връзка първият запис може да не задържи настройките под данните за достъп — вида на фактурата, метода за корелация и разширените опции. Отворете връзката отново, задайте ги пак и запишете втори път. Струва си да проверите дори когато Ви се струва, че е записано: приблизително една от всеки пет FGO връзки работи със стойности по подразбиране, които никой не е избирал.

FGO приема по една фактура в секунда за акаунт, така че партидата се разпределя във времето, а всичко, което не успее да мине, влиза в опашка и се преопитва около 45 минути. След това се изоставя, а причината се записва върху поръчката — и нищо не Ви уведомява. Филтрирайте списъка с поръчки по Грешка по фактурата след всяка групова обработка; там ще ги намерите.

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

easySales поглежда маркетплейс връзката, от която е дошла поръчката, след това уебсайта, след това самата поръчка, и използва първата намерена серия. Ако никъде няма зададена, изпраща INV, която почти сигурно не съществува във Вашия FGO акаунт. Не можете да изберете серия в момента на фактуриране, затова я задайте на маркетплейс връзките и на уебсайтовете си.

Той посочва склада във FGO, срещу който се осчетоводява всеки ред от фактурата, и това е, което кара FGO да изпише стоката при издаване на фактурата. Попълнете го, ако водите наличности във FGO, точно както складът е наименуван там. Оставете го празен, ако не водите. Обърнете внимание, че падащото меню „Използвайте като източник на наличности за продукти“ в същата форма не управлява това, въпреки името си.

И двете FGO връзки, ако имате две. Обновете Частния ключ на връзката в Софтуер за фактуриране и — ако използвате FGO и като източник на наличности — на връзката в Източници на наличности. Фактурирането ще се оплаче веднага с „Hash-ul transmis nu este corect“; връзката за наличности се проваля тихо и може да продължи да показва данните от последното успешно четене.

Да, като отделна връзка в Интеграции → Източници на наличности, със същия CUI и същата API парола, прикачена към уебсайт. Тя е само за четене: наличностите пътуват от FGO към easySales и никога обратно, и презаписват това, което easySales пази. Продуктите се съпоставят по име или по Код на продукта, а продукт, чийто код не съвпада с нищо във FGO, се поставя на нулева наличност.

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