Tartalomra ugrás

FairPay Integration

Automatizált kintlévőség-bejelentés a FairPay rendszerébe

A nélkülözhetetlen kapcsolat az Odoo Könyvelés és a FairPay között a lejárt számlákat és adósokat kezelő magyar vállalkozások számára.

A FairPay Integration összeköti az Odoo könyvelési rendszerét a FairPay adósságkezelő platformmal, automatikusan szinkronizálva az ügyfeleket (adósokat), a számlákat és a kifizetéseket. Ez a modul biztosítja, hogy a lejárt és kifizetetlen számlák manuális beavatkozás nélkül bejelentésre kerüljenek a FairPay felé, áramvonalasítva a kintlévőség-kezelési és hitelminősítési folyamatokat.

Főbb jellemzők

👤 Automatikus adós-szinkronizálás (Debtor Sync)

  • Adósok automatikus létrehozása a FairPay-ben, amint számlát állít ki az ügyfélnek

  • Okos adószám-párosítás – Keresés teljes vagy részleges (8 jegyű) adószám alapján

  • Módosítások átvezetése – A név, cím, telefonszám vagy e-mail változása automatikus frissítést vált ki

  • Kizárólag magyar (HU) partnerekhez – Csak az érvényes adószámmal rendelkező magyar partnerek kerülnek szinkronizálásra

  • Többvállalatos (Multi-Company) működés – Cégfüggő mezők a vállalatonkénti adós-azonosítókhoz

  • Kivétellista (Opt-out) – A FairPay szinkronizálás partnerenként tetszőlegesen kikapcsolható

📄 Számla-szinkronizálás

  • Automatikus számlabeküldés – Lezárt (posted) kimenő számlák szinkronizálása megerősített magyar EDI státusszal

  • Duplikáció elleni védelem – Új számla létrehozása előtt ellenőrzi a már meglévőket

  • Teljes számlaadat-átadás – Adós, számlaszám, pénznem, bruttó összeg, kiállítási és teljesítési/fizetési határidő dátumok

  • Automatikus lezárás kiegyenlítéskor – Bezárja a FairPay számlát, amint a kifizetetlen maradványösszeg nullára csökken

  • Tömeges szinkronizálás támogatása – A frissítést igénylő jelzők kötegelt (batch) szinkronizálást indítanak el

💰 Fizetési pontozás és egyeztetés (Reconciliation Sync)

  • Automatikus fizetéspárosítás – Összeköti az Odoo könyvelési egyeztetéseket a FairPay kifizetésekkel dátum és összeg alapján

  • Fizetés létrehozása – Új fizetéseket rögzít a FairPay-ben a párosítatlan tételeknél

  • Törlések kezelése – Eltávolítja a FairPay kifizetéseket, ha a könyvelési egyeztetési sorokat törlik

  • Okos újrapárosítás – Helyreállítja az elárvult kapcsolatokat, és kizárólag összeg alapján újra összehangolja azokat

🔄 Automatikus változásészlelés

  • Partner módosítási kiváltóokok (Triggers) – Figyeli a kulcsfontosságú mezőket (cégtípus, ország, név, adószám, cím, telefon, e-mail)

  • Számlalezárási kiváltóokok – Megjelöli a számlákat frissítésre a _post műveletkor

  • Egyeztetési kiváltóokok – Megjelöli a számlákat frissítésre a részleges egyeztetések létrehozásakor/módosításakor

  • Vállalatonkénti jelzők – odootech_fairpay_update_required a függőben lévő szinkronizálások nyomon követésére

Üzleti előnyök

  • ✅ Kevesebb manuális munka – Nincs több kézi adatbevitel a FairPay felületén

  • ✅ Gyorsabb adósságbehajtás – Az adósadatok azonnal elérik a FairPay rendszerét

  • ✅ Pontos adatok – A kétirányú szinkronizálás konzisztensen tartja a rekordokat

  • ✅ Többvállalatos támogatás – Működik az Odoo különálló vállalatai között is

  • ✅ Auditálhatóság – Teljes nyomon követhetőség a tárolt FairPay azonosítókon keresztül

  • ✅ Jogszabályi megfelelőség – Integrálódik a magyar EDI számlaállapotokhoz

Technikai jellemzők

Partner modell kiterjesztések

  • odootech_disable_fairpay → Partnerenkénti tiltás (opt-out)

  • odootech_fairpay_debtor_id → Kapcsolódó FairPay adós azonosító

  • odootech_fairpay_update_required → Függőben lévő szinkronizáció jelzője

Számla modell kiterjesztések

  • odootech_fairpay_invoice_id → Kapcsolódó FairPay számla azonosító

  • odootech_fairpay_update_required → Függőben lévő szinkronizáció jelzője

Egyeztetés (Reconciliation) modell kiterjesztések

  • odootech_fairpay_payment_id → Kapcsolódó FairPay fizetési azonosító

Okos adatleképezés (Data Mapping)

  • Adós típusa: CORPORATION (Cég) / INDIVIDUAL (Magánszemély) az is_company alapján

  • Számlázási cím: Ország, irányítószám, város, utca — automatikusan formázva

  • Kapcsolattartók: Kinyerve az elsődleges és másodlagos e-mailekből, normalizált telefonszámokkal

  • Adószám tisztítás: Kizárólag számjegyek, 11 jegyű validációval

  • Telefonszám normalizálás: 06… → +36…, 00… → +…

Hibakezelés és naplózás

  • Teljes körű naplózás az Odoo _logger funkcióján keresztül

  • A nem felkészített vállalatok vagy érvénytelen partnerek biztonságos kihagyása

  • HTTP-szintű hibakezelés az összes API-hívásnál

A működési folyamat áttekintése (Workflow)

  1. Partner számlázása → Az adós automatikusan létrejön a FairPay-ben (ha magyar és érvényes az adószáma)

  2. Számla lezárása (Post) → Megjelölve FairPay szinkronizálásra

  3. Szinkronizálás futása → A számla létrejön a FairPay-ben a teljes részletezettséggel

  4. Fizetés beérkezése → A részleges egyeztetés párosítja vagy létrehozza a FairPay kifizetést

  5. Számla teljes kiegyenlítése → A FairPay számla automatikusan lezárásra kerül

  6. Partneradatok változása → Az adós frissítésre megjelölve és újraszinkronizálva

Konfiguráció

  • A FairPay engedélyezése vállalatonként (odootech_enable_fairpay)

  • Az API hitelesítő adatok vállalati szinten konfigurálhatók

  • Magyar EDI számlaállapotokat igényel (confirmed / confirmed_warning)

  • Működik az Odoo gyári account (Könyvelés) moduljával

Felhasználási területek

  • Magyar KKV-k – A késedelmes fizetések automatikus bejelentése a FairPay felé

  • Kintlévőség-kezelő csapatok – A FairPay és az Odoo vevőanalitika folyamatos szinkronban tartása

  • Pénzügyi és könyvelési osztályok – A duplázott adatbevitel megszüntetése

  • Többvállalatos cégcsoportok – Központi FairPay adatszolgáltatás entitásonként

Követelmények

  • Odoo 16.0 vagy újabb verzió

  • Telepített account (Könyvelés) modul

  • Magyar EDI lokalizáció (l10n_hu_edi)

  • Aktív FairPay kereskedői fiók és API-hozzáférés

Áramvonalasítsa kintlévőség-kezelését, és tartsa naprakészen a FairPay rendszerét automatikusan – telepítse a FairPay Integration modult még ma!