Cégjelző API Service

Átfogó magyar cégadat-integráció az Odoo rendszerhez

A Cégjelző API Service modul zökkenőmentesen köti össze Odoo rendszerét a Cégjelző céginformációs API-jával, így azonnali hozzáférést biztosít a magyar vállalkozások adataihoz, pénzügyi kimutatásaihoz és egy hatékony cégfigyelő (watchlist) rendszerhez – mindezt közvetlenül az Odoo-ból.

Főbb jellemzők

🔍 Cégkeresés és automatikus kiegészítés (Autocomplete)

• Többszempontú keresés – Adószám, cégjegyzékszám vagy cégnév alapján

• Okos név-kiegészítés – Cégnév-előtag egyezés (minimum 3 karaktertől)

• Típus szerinti szűrés – Cégek, egyéni vállalkozók, civil szervezetek

• Lapozás (Pagination) és aktív státusz szerinti szűrés

📊 Pénzügyi adatok elérése

• 30+ pénzügyi mutató cégenként (árbevétel, adózott eredmény, EBITDA, eszközök, kötelezettségek, saját tőke és még sok más)

• Többéves történeti adatok megfelelő pénznem- és szorzókezeléssel

• Biztonságos hiányzóérték-kezelés (null-value handling)

👁️ Cégfigyelő rendszer (Watchlist Management) Teljes körű, előfizető-alapú cégfigyelő rendszer a vállalkozások folyamatos nyomon követésére:

• Cégek hozzáadása a figyelőlistához – Adószám alapján, automatikus lista-létrehozással

• Cégek eltávolítása a figyelőlistáról – Korlát megkerülésével törléskor

• Figyelőlisták szervezése – Előfizetőnként több elnevezett lista, egyedi list_key azonosítóval

• Maximális kapacitás – Listánként akár 2000 cég követése

🔔 Cégadat-változások nyomon követése

• Napi változásészlelés – Automatikusan detektálja a megfigyelt cégek adatváltozásait

• Dátumtartomány szerinti lekérdezés – Változások lekérése tetszőleges időszakra (from_date / to_date)

• Mezőszintű változáskövetés – Pontosan látható, mely címsorok/mezők módosultak

• Okos gyorsítótárazás (Caching) – A hatékonyság érdekében eltárolja a megváltozott mezőkulcsokat és a teljes cégadatot is

• Kizárólag aktív tételek szűrése – Csak a jelenleg aktív figyelőlistás elemek frissítéseit adja vissza

🔐 Előfizetői és API-kezelés

• Token-alapú hitelesítés – Biztonságos ügyfél-token érvényesítés

• Kreditfelhasználás nyomon követése – Minden kérés rögzíti a felhasznált krediteket

• Hatókör-alapú (Scope) jogosultság – Cégfigyelő jogosultságok érvényesítése

• Részletes eseménynaplózás (Logging) – Minden kérés, hiba és hatókör-használat rögzítésre kerül

Integrált API Végpontok (Endpoints)

Elérhető pénzügyi mutatók

Bevételi és eredmény mutatók

• Árbevétel

• Egyéb bevételek

• Üzemi/üzleti eredmény

• Adózott eredmény

• EBITDA

• Adózás előtti eredmény

Eszköz mutatók

• Befektetett eszközök

• Forgóeszközök

• Tárgyi eszközök

• Készletek

• Pénzeszközök

• Követelések

• Értékpapírok

Források és kötelezettségek

• Saját tőke

• Hosszú lejáratú kötelezettségek

• Rövid lejáratú kötelezettségek

• Kötelezettségek összesen

• Céltartalék

Költség és ráfordítás mutatók

• Anyagjellegű ráfordítások

• Személyi jellegű ráfordítások

• Értékcsökkenési leírás

• Fizetendő kamatok

• Adófizetési kötelezettség

Üzleti előnyök

• ✅ Azonnali cégellenőrzés – Partnerek valós idejű validációja

• ✅ Hitelkockázat-értékelés – Pénzügyi helyzet elemzése a megállapodások előtt

• ✅ Proaktív cégfigyelés – Értesítés a megfigyelt cégek adatváltozásairól

• ✅ Automatizált adatfeltöltés – A manuális adatbevitel és a hibák csökkentése

• ✅ Megfelelőség (Compliance) – Pontos jogi és adózási adatok biztosítása

• ✅ Mélyreható pénzügyi elemzés – Többéves trendek és teljesítmények vizsgálata

Felhasználási területek

• Értékesítés & CRM – Prospektusok ellenőrzése és az érdeklődők (leads) adatainak gazdagítása

• Könyvelés & Pénzügy – Partner adószámok érvényesítése és pénzügyi adatok beemelése

• Kockázatkezelés (Credit Management) – Ügyfelek pénzügyi stabilitásának nyomon követése

• Beszerzés – Beszállítói adatok és hitelesség ellenőrzése

• Megfelelőség (Compliance) – Üzleti partnerek jogi változásainak követése

• Üzleti elemzés (BI) – Piaci szereplők teljesítményének elemzése az idő múlásával

Technikai jellemzők

🔐 Biztonságos API integráció

• Biztonságos API-kulcs alapú hitelesítés (X-Api-Key fejléc + ügyfél azonosító)

• HTTPS titkosított adatátvitel

• Nem tárol adatokat – kizárólag valós idejű lekérdezéseket végez

• GDPR megfelelőség

🌐 Többkörnyezetes támogatás

• Termelési (Production) API – Éles cégadatok elérése

• Fejlesztési (Development) API – Tesztelési és fejlesztési környezet

• Keresési (Search) API – Dedikált keresési szolgáltatás

• Kapcsolati (Connection) API – Céghálózati és kapcsolati adatok

📦 Részletes hibakezelés és kódok

• AC01–AC03 – Hitelesítési és beviteli validációs hibák

• CSA04–CSA10 – Cégfigyelő hozzáadási hibák (duplikáció, nem található, ütközés, kapacitás)

• CSD06–CSD07 – Cégfigyelő eltávolítási hibák

• CSG02–CSG06 – Frissítés-lekérdezési hibák

Integráció az Odoo moduljaival

• CRM integráció: Cégadatok automatikus kitöltése adószám alapján, érdeklődők ellenőrzése a hivatalos cégjegyzékben.

• Pénzügy / Könyvelés: Partner adószámok validálása, pénzügyi mutatók automata betöltése, jogi megfelelőség.

• Értékesítés: Gyors cégkeresés az árajánlatadás során, pénzügyi stabilitás-ellenőrzés és hitelkeret-becslés.

Telepítés és követelmények

• Odoo 13.0 vagy újabb verzió

• Python requests könyvtár

• Érvényes Cégjelző API előfizetés és API-kulcs

• Aktív internetkapcsolat az API-hívásokhoz

Nyissa meg a magyar üzleti adatvagyon kapuját az Odoo-ban a Cégjelző API Service modullal – keressen, ellenőrizzen és figyeljen cégeket erőfeszítések nélkül! Elengedhetetlen integráció azon magyar vállalkozások számára, amelyeknek megbízható, naprakész cégadatokra és proaktív változáskövetésre van szükségük közvetlenül az Odoo rendszerükben.