↑↓ вибірEnter відкритиEsc закрити

    1. Elbuz
    2. Керівництво користувача Elbuz
    3. Продажі та документи
    4. Каси ПРРО

    Як підключити касу eparagony.pl до Elbuz

    6 хв читанняОновлено

    eparagony.pl — каса для магазину в Польщі. Elbuz надсилає продаж в eparagony, той друкує чек на вашому фіскальному принтері, а покупець отримує електронний e-paragon за посиланням. В Elbuz вписуєте три значення з листа eparagony: client_id, client_secret і posId.

    Що це дає:

    • Продаєте з Elbuz у Польщі — чек пробивається на принтері сам, касир не набирає його вручну.
    • Хочете спершу спробувати — з тестовими ключами eparagony чек проходить увесь шлях без принтера.
    • Каса в Україні — вам потрібна не ця стаття, а Вчасно.Каса або Checkbox.

    З чого почати: укладіть договір з eparagony.pl і дочекайтеся листа з доступами.

    Що вміє каса eparagony.pl

    Розділ «Каси ПРРО» описує українські каси. eparagony.pl стоїть у тій самій групі «Фіскальні чеки», але працює за польськими правилами: чек друкує фіскальний принтер, а не програмний РРО.

    Що підготувати в eparagony.pl

    1. Договір. Його укладає магазин з eparagony.pl напряму, Elbuz стороною договору не є. Тарифи — на eparagony.pl.
    2. Лист з доступами. Після реєстрації eparagony надсилає client_id, client_secret і posId — ідентифікатор вашого магазину.
    3. Принтер. Фіскальний принтер підключається до eparagony через їхню програму eDPS, за документацією eparagony. Elbuz до принтера напряму не звертається.
    4. Ставки ПДВ на принтері. Літери мають відповідати стандарту: A 23 %, B 8 %, C 5 %, D 0 %, E — звільнення. Elbuz надсилає саме ці літери.

    Як налаштувати касу в Elbuz

    Де: Кабінет → Налаштування системи → «Інші налаштування» → плитка «Зовнішні сервіси та інтеграції» → група «Фіскальні чеки» → рядок «eparagony.pl», олівець.

    Форма «Підключення eparagony.pl» з ключами доступу, posId, фірмою та перемикачами
    1client_id
    2client_secret
    3posId
    4Тестове середовище (sandbox)
    1. client_id з листа eparagony.
    2. Збережене значення показується крапками.
    3. Ідентифікатор магазину з того самого листа.
    4. Для тестових ключів eparagony.
    ПолеЩо вписати або вибрати
    АктивністьУвімкніть, коли впишете всі три значення. Вимкнена каса в документах не пропонується
    client_id, client_secretЗ листа eparagony. Збережений client_secret у полі показується крапками
    posIdІдентифікатор магазину з того самого листа
    Фірма«Будь-яка» або фірма, документи якої йдуть через цю касу
    Платник ПДВУвімкнено — ставка береться з рядка документа або товару. Вимкнено — усі рядки йдуть зі ставкою E
    Чек при оплаті за посиланнямЧек друкується сам, коли покупець повністю оплатив за посиланням
    Тестове середовище (sandbox)Увімкніть для тестових ключів eparagony. Для справжніх — вимкніть
    Накладений платіжЯк і в інших кас: «Чек при відправці» або «Не видавати»

    Форма зберігається сама: унизу з’являється «Збережено». Нові client_id чи client_secret скидають збережений вхід, і наступний чек увійде вже з ними. Перемикача закриття зміни тут немає: зміну й денний звіт (raport dobowy) веде принтер.

    Як перевірити в тестовому середовищі

    1. Впишіть тестові ключі eparagony, увімкніть «Тестове середовище (sandbox)» і «Активність».
    2. Відкрийте своє замовлення у злотих і натисніть «Фіскальний чек».
    3. Виберіть спосіб оплати й натисніть «Видати чек». Elbuz чекає підтвердження до 25 секунд.

    Результат: номер чека, сума, дата, позначка «тестовий, нефіскальний» і посилання «Відкрити чек» на e-paragon. У тестовому середовищі замість принтера працює емулятор eparagony. Тому відкритий e-paragon завжди показує послугу кейтерингу на 460 PLN з датою 2022 року — так влаштовано в eparagony, це не помилка Elbuz.

    Результат видачі тестового чека eparagony.pl
    1Номер чека
    2тестовий, нефіскальний
    3Відкрити чек
    1. Номер, сума в злотих і дата зберігаються в документі.
    2. Тестове середовище: чек без юридичної сили.
    3. Посилання на e-paragon.

    Щоб перейти на справжню касу, замініть ключі на бойові й вимкніть «Тестове середовище (sandbox)». Тестовий чек не заважає надрукувати справжній за тим самим документом.

    Що потрапляє в чек

    Чек видається так само, як в інших кас: кнопкою «Фіскальний чек» у документі, з вікна «Каса» або сам при оплаті за посиланням. Як працює діалог чека — у статті про чеки.

    В ElbuzНа чеку eparagony
    «Платник ПДВ» увімкнено, ставка 23 / 8 / 5 / 0 %A / B / C / D
    Перемикач «Платник ПДВ» вимкненоE — звільнення, для всіх рядків
    ГотівкаGotówka
    КарткаKarta
    Переказ на поточний рахунок, переказ з карткиPrzelew
    Решта способів: інтернет-еквайринг, QR, безготівково тощоMobilna
    Знижка на документокремий рядок «Rabat»

    Чек видається лише за документом у злотих і лише як чек продажу всієї суми: чека авансу чи повернення eparagony.pl не друкує. Назва товару на чеку обрізається до 42 знаків — це межа принтера. Після підтвердження в документі зберігаються номер чека й посилання на e-paragon.

    Сценарії

    Магазин у Польщі продає через сайт з оплатою за посиланням

    Що зробити. Підключіть касу й увімкніть «Чек при оплаті за посиланням».

    Що вийде. Коли покупець оплатив замовлення повністю, чек друкується на принтері сам, а посилання на e-paragon з’являється в документі. Не вийшло — адміністратори отримують сповіщення, а Elbuz повторює спробу щогодини.

    Продаж у магазині з вікна «Каса»

    Що зробити. Підключіть eparagony.pl і продавайте з «Каси» як звичайно.

    Що вийде. Кожен продаж пробивається на фіскальному принтері, касир не набирає чек на принтері вдруге.

    Є фірма в Україні й фірма в Польщі

    Що зробити. Підключіть обидві каси й прив’яжіть кожну до своєї фірми в полі «Фірма».

    Що вийде. Документ польської фірми в злотих піде в eparagony.pl, документ української фірми в гривнях — у Checkbox чи Вчасно.Касу.

    Що робити, коли чек не виходить

    Повідомлення каси eparagony.pl
    Що ви бачитеЧому такЩо зробити
    «Касу не підключено. Увімкніть її й впишіть ключ у «Зовнішні сервіси» → «Фіскальні чеки».» Каса вимкнена, порожнє одне з трьох полів або фірма каси не підходить документу Перевірте форму каси (налаштування)
    «Ця каса видає чеки лише у валюті PLN: у документі інша валюта.» Документ не в злотих Змініть валюту документа на PLN
    «Чек не видано: eparagony: auth HTTP …» eparagony не прийняв client_id чи client_secret, або тестові ключі вписано без перемикача «Тестове середовище» (чи навпаки) Перепишіть ключі з листа й перевірте перемикач
    «Чек не видано: eparagony: VAT rate 20 is not a Polish rate (23, 8, 5, 0)» У рядку документа чи в товарі не польська ставка Поставте товарам польські ставки (як задати ставку) і видайте чек знову
    «Каса eparagony.pl видає лише чеки продажу: чек повернення чи авансу тут не створюється.» У діалозі чека вибрано вид «Аванс (часткова оплата)» або в «Касі» продано подарунковий сертифікат Дочекайтеся повної оплати й видайте «Повний чек із товарами»
    «Чек не видано: eparagony: payment … is not supported» Частину продажу оплачено подарунковим сертифікатом або зарахованим авансом Через eparagony.pl такий продаж не пробивається; як оформити його, вирішує бухгалтер
    «Чек не підтверджено: eparagony: the fiscal printer has not confirmed the receipt yet (…). Натисніть ще раз: повтор не створить другого чека.» Принтер не підтвердив чек за 25 секунд: наприклад, він вимкнений або eDPS не запущено Перевірте принтер і натисніть «Видати чек» знову: Elbuz знайде той самий документ в eparagony
    «Чек не видано: eparagony: fiscal printer error …» Принтер відмовив друкувати, причина — у тексті після двокрапки Усуньте причину на принтері або в eDPS і видайте чек знову

    Часті запитання

    Як покупець отримає e-paragon?

    Посилання на e-paragon зберігається в документі як «Відкрити чек». Elbuz не передає в eparagony email і телефон покупця, тому посилання надішліть покупцю самі.

    Покупець повернув товар. Що робити в Elbuz?

    Оформіть документ повернення як звичайно. Чека повернення не буде: у Польщі повернення записують у реєстр повернень продавця, тому в поверненні Elbuz касу eparagony.pl не пропонує.

    Покупець оплатив частину за посиланням. Чи буде чек?

    Ні: чека авансу eparagony.pl не друкує, тож за частковою оплатою Elbuz чек не видає. Коли покупець доплатить за посиланням, чек на всю суму надрукується сам. Доплату іншим способом закрийте кнопкою «Фіскальний чек».

    Що буде, якщо вимкнути «Активність»?

    Кнопка чека зникне з нових документів, автоматичні чеки припиняться. Документи з виданими чеками кнопку зберігають, ключі у формі лишаються.

    Чи треба відкривати зміну в Elbuz?

    Ні. Зміну й денний звіт веде принтер, Elbuz лише надсилає продажі.

    Де це і хто має доступ

    Меню
    Кабінет → Налаштування системи → «Інші налаштування» → «Зовнішні сервіси та інтеграції» → група «Фіскальні чеки» → eparagony.pl
    Видача чека
    картка замовлення покупця або рахунку → «Фіскальний чек»; вікно «Каса»
    Право доступу
    вікно «API та токени доступу» у «Правах груп»
    Підготувати
    договір з eparagony.pl, лист з client_id, client_secret і posId, фіскальний принтер з eDPS

    Суміжні теми

    Чи була стаття корисною?

    Не вистачає функції? Напишіть нам.

    Ми додамо її безкоштовно, якщо вона знадобиться й іншим.

    Якщо це потрібно тільки вам — домовимося окремо.

    Зміст статті

    Запропонувати доробку

    Спробувати безкоштовно