Функции

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

От екипа на easySales · Актуализирано 11 септември 2026 · 1 мин. четене

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

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

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

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

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

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

✓

Профил в Oblio с API достъп

Токънът се издава на страницата с настройки на профила в Oblio. Ако там няма токън, планът не включва API достъп и връзката ще откаже с You are not allowed to use this API.

✓

CIF точно както е в Oblio

Регистрационният номер се сверява с фирмите във Вашия профил в Oblio, а не само се проверява като формат.

✓

Серия на фактурите, създадена в Oblio

easySales изпраща серията от поръчката. Всяка серия, която може да бъде използвана, трябва първо да съществува в Oblio, иначе фактура не се издава.

✓

Решение за наличностите

Дали складът в Oblio да се извежда при издаване на фактура. Ако да, складът трябва да е точен — недостатъчна наличност в Oblio спира фактурата.

Стъпка 1 — Отворете страницата Софтуер за фактуриране

Отидете в Интеграции → Софтуер за фактуриране и потърсете oblio.

Страницата Софтуер за фактуриране в easySales, филтрирана до Oblio, с картата на Oblio в свързано състояние и бутон Редактирай.
Картата на Oblio в Интеграции → Софтуер за фактуриране.

Натиснете Свържи върху картата на Oblio. Ако вече имате връзка, натиснете Редактирай.

Стъпка 2 — Трите данни за достъп

Формата за връзка с Oblio в easySales с Наименование на връзката, Регистрационен номер на фирмата, Потребителско име (Email), Токън, включен източник на наличности, Име на склада, Име на работната станция и Серия.
Връзката. Трите полета със звездичка са всичко, което Oblio изисква; останалите променят как изглежда фактурата.
Поле Какво е
Наименование на връзката Вашето собствено име за тази връзка. Никога не стига до Oblio.
Регистрационен номер на фирмата Румънският CIF на фактуриращата фирма, точно както е в Oblio. Изпраща се с всяка заявка като cif; фирма, която Oblio не разпознава, връща The company with cif … does not exist.
Потребителско име (Email) Имейл адресът на профила в Oblio. Oblio го използва като API идентификатор на клиента.
Токън API тайната от настройките на профила в Oblio. Не е паролата Ви за Oblio.
Трите задължителни полета

Стъпка 3 — Решете за наличностите, преди да запазите

Използвайте като източник на наличности за продукти е най-важното поле във формата — румънският интерфейс го назовава най-точно: извеждай от склада при фактуриране.

Стъпка 4 — Серии, работна станция и останалото

Поле Какво прави
Използвайте като източник на наличности за продукти „Да“ кара всяка фактура да извежда и стоката от склада в Oblio. Вижте предупреждението по-горе.
Име на склада Складът в Oblio, от който излиза стоката. По избор, чувствително към регистъра и на практика необходимо веднага щом изнасянето от склад е включено или имате повече от един склад.
Име на работната станция Работната точка в Oblio, от която се издава документът. По избор, чувствително към регистъра.
Серия на квитанциите Серията, която Oblio използва, когато плащането се събира с квитанция. Игнорира се при всеки друг тип събиране.
Изпрати обновлението на цените Изпраща промените в цените от easySales към съответния продукт в Oblio. Задължително — формата не се запазва без отговор.
Използвайте описанието на продукта Поставя описанието на продукта на реда във фактурата вместо само името.
Шаблон Забележката, отпечатана върху фактурата.
Останалата част от връзката
Долната част на формата за Oblio: Изпрати обновлението на цените, Използвайте описанието на продукта и полето Шаблон с бутоните за променливи и бутона Запази.
Изпрати обновлението на цените трябва да бъде попълнено, преди връзката да се запази.

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

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

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

Разширените възможности на връзка с Oblio: Език на фактурите, CNP на издателя, Наименование, Срок за плащане и Тип на плащане.
Първата половина от разширените възможности.
Възможност Какво прави
Език на фактурите Налага един език за всички фактури. Оставено празно, easySales използва езика на магазина или маркетплейса, от който е дошла поръчката, ако Oblio го поддържа.
Създадена CNP и Наименование на издателя Отпечатват се върху фактурата като лицето, което я издава. Румънският CNP се проверява за точно 13 цифри.
Срок за плащане Колко дни след издаването е дължима фактурата.
Тип на плащане Налага типа на събиране, който Oblio записва — квитанция, касов бон, карта, платежно нареждане и останалите. Оставено празно, easySales го извежда от начина на плащане на поръчката. При избор на квитанция се използва Серията по-горе.
Избери име на продукта Кое име отива на реда във фактурата: собственото име на продукта или това от поръчката.
Автоматично откриване на област Определя района на Букурещ по адреса, когато поръчката не го съдържа.
Генерирай уникален код за отстъпка Само за Oblio. Изпраща всяка отстъпка на собствен кодиран ред, вместо да ги слива.
Задай обратен данък Само за Oblio. Отбелязва фактурата като обратно начисляване.
Изпращай име на ДДС само за 0% данък Само за Oblio. Изпраща името на освобождаването от ДДС само на редовете с нулева ставка, а не на всички.
Активирай ключ за идемпотентност Само за Oblio. Не позволява повторна заявка да създаде втора фактура за същата поръчка.
Разширени възможности, които си струва да зададете
Останалите разширени възможности на Oblio: Избери име на продукта, Автоматично откриване на област, Генерирай уникален код за отстъпка, Задай обратен данък, име на ДДС само при 0% и Активирай ключ за идемпотентност.
Четирите възможности, които съществуват само за Oblio, и ключът за идемпотентност срещу дублирани фактури.

Oblio като източник на наличности

Връзката по-горе издава фактури. Поддържането на наличностите в easySales в синхрон с Oblio е втора, отделна връзка със собствени данни за достъп.

Формата на връзката Oblio като източник на наличности с име на връзката, ЕИК, токън, имейл и име на склада.
Връзката за наличности е отделна, със собствено копие на същите данни за достъп.

Отидете в Интеграции → Източници на наличности, натиснете Свържи върху картата на Oblio и въведете същите ЕИК, токън и имейл, както и склада, от който се четат наличностите.

Когато Oblio откаже фактура

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

Какво казва Oblio Какво да направите
Nu am putut descarca gestiunea pentru acest document. Produsele urmatoare nu au stoc suficient: Наличността в Oblio не достига за изброените продукти. Коригирайте наличността в Oblio или изключете използването като източник на наличности, ако не поддържате склада в Oblio актуален.
Produsul "…" nu are stoc suficient. Същото за един продукт.
Concurrent requests timeout. Please make one request at a time. Oblio е получил няколко едновременни заявки за Вашия профил. Нищо не се губи; фактурата може да бъде издадена отново.
Too Many Requests, check back later Собственият лимит на заявките на Oblio за Вашия профил. Освобождава се сам.
The access token provided has expired Oblio е прекратил сесията по-рано от очакваното. Издайте фактурата отново — easySales създава нова сесия, когато старата изтече.
Internal error. Please try again later. / празен отговор или 504 Oblio не е отговорил. От Ваша страна няма проблем; опитайте отново.
You are not allowed to use this API. Профилът в Oblio няма API достъп в плана си.
The company with cif … does not exist Регистрационният номер на фирмата от връзката не е фирма в този профил в Oblio.
Tipul produsului nu a fost gasit, tipul trebuie sa fie unul din: Marfa, Semifabricate, … Продукт има в Oblio тип, който Oblio не приема тук. Коригирайте типа на продукта в Oblio.
Introdu o serie de document valida. Това съобщение е от easySales, а не от Oblio: серията от поръчката не съществува във Вашия профил в Oblio.
Какво означават отказите на Oblio

Кредитни известия, анулирания и плащания

Действие Какво се случва в Oblio
Отбелязване на поръчка като платена Фактурата се събира в Oblio с типа от Тип на плащане или с този, изведен от начина на плащане на поръчката. Събирането с квитанция използва Серията на квитанциите.
Връщане на поръчка easySales иска от Oblio сторно към първоначалната фактура.
Анулиране на фактура Oblio анулира документа; номерът остава използван, както трябва.
Изтриване на фактура Възможно е само докато Oblio го позволява — иначе фактурата се анулира.
Какво още прави връзката

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

Връзката е с включено използване като източник на наличности, така че всяка фактура извежда и стоката от склада в Oblio — а Oblio няма достатъчна наличност за изброените продукти. Или коригирайте наличността в Oblio (и проверете дали Име на склада сочи правилния склад, изписан по същия начин), или изключете настройката, ако не поддържате склада в Oblio актуален. Това е най-честата причина една фактура в Oblio да не се издаде.

Не. Oblio издава отделна API тайна на страницата с настройки на профила и това е токънът. В полето Потребителско име (Email) се въвежда адресът, на който е регистриран профилът в Oblio. Ако в настройките няма токън, планът Ви в Oblio не включва API достъп.

Това съобщение е от easySales и означава, че серията не съществува във Вашия профил в Oblio. easySales изпраща серията, зададена на маркетплейса или магазина, от който е дошла поръчката, а Oblio приема само серия, която вече има. Създайте я в Oblio или сменете серията в easySales с позната на Oblio.

Не. easySales разменя имейла и токъна за сесия и я подновява сам при изтичане. Ако видите "The access token provided has expired" върху поръчка, издайте фактурата отново — не е нужно да променяте връзката, освен ако не сте сменили токъна в Oblio.

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

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

Включете Активирай ключ за идемпотентност в Покажи разширените възможности. easySales тогава изпраща номера на поръчката заедно с фактурата и Oblio няма да създаде втори документ за заявка, която вече е обработил. Опцията е скрита, ако профилът умишлено допуска няколко фактури на поръчка.

Първата издава фактури. Втората чете наличности от Oblio в easySales и е отделна връзка със собствени ЕИК, токън и имейл. Те не споделят нищо, така че при смяна на токъна в Oblio трябва да обновите и двете.

Да. Връщането на поръчка иска от Oblio сторно към първоначалната фактура, така че кредитното известие се създава в Oblio по същите правила за серии като фактурата.

Защото Език на фактурите в Покажи разширените възможности е зададен и важи за всички фактури. Изчистете го и easySales ще използва езика на магазина или маркетплейса, от който е дошла поръчката, ако Oblio го поддържа.

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