Funkciók

Hogyan kösd össze az Obliót az easySales-szel: teljes útmutató

easySales csapat · Frissítve 11 szeptember 2026 · 3 perc olvasás

Hogyan kösd össze az Obliót az easySales-szel: teljes útmutató

Kösd össze az Obliót az easySales-szel: a három belépési adat, mit csinál valójában a készletlevezetés, a számla- és nyugtasorozatok, az Oblio saját opciói és minden elutasítás jelentése.

Mit ad az Oblio összekötése

Csatlakoztatott Oblióval az easySales kiállítja a rendelés számláját, elküldi a vásárlónak, kifizetettként jelöli, sztornózza vagy érvényteleníti, és az Oblio saját készletét is naprakészen tudja tartani — anélkül, hogy megnyitnád az Obliót.

Ez az útmutató a teljes kapcsolatot végigveszi, beleértve azt a beállítást is, amely eldönti, kimennek-e a számlák.

Mielőtt elkezded

✓

Oblio fiók API-hozzáféréssel

A tokent az Oblio fiókbeállítások oldalán adják ki. Ha ott nincs token, a csomag nem tartalmaz API-hozzáférést, és a kapcsolat You are not allowed to use this API. hibával áll le.

✓

A CIF pontosan úgy, ahogy az Oblióban szerepel

A cég adószámát az Oblio fiókodban lévő cégekhez hasonlítjuk, nem csak formailag ellenőrizzük.

✓

Az Oblióban létrehozott számlasorozat

Az easySales a rendelésen szereplő sorozatot küldi. Minden lehetséges sorozatnak léteznie kell előbb az Oblióban, különben nem készül számla.

✓

Döntés a készletről

Le kell-e vezetni az Oblio raktárát a számla kiállításakor. Ha igen, a raktárnak pontosnak kell lennie — a kevés készlet az Oblióban megállítja a számlát.

1. lépés — Nyisd meg a Számlázás oldalt

Menj az Integrációk → Számlázás menüpontra, és keress rá arra, hogy oblio.

A Számlázás oldal az easySalesben Oblióra szűrve, a csatlakoztatott Oblio kártyával és a Szerkesztés gombbal.
Az Oblio kártya az Integrációk → Számlázás oldalon.

Nyomd meg a Bejelentkezés gombot az Oblio kártyán. Ha már van kapcsolatod, nyomd meg a Szerkesztés gombot.

2. lépés — A három belépési adat

Az Oblio kapcsolat űrlapja az easySalesben: Kapcsolat neve, Adószám, Felhasználónév (Email), Token, Igenre állított készletforrás, Raktár neve, Munkaállomás neve és Nyugta sorozat.
A kapcsolat. A három csillagos mező minden, amire az Obliónak szüksége van; a többi a számla kinézetét változtatja.
Mező Mi ez
Kapcsolat neve A saját neved ehhez a kapcsolathoz. Soha nem jut el az Oblióhoz.
Adószám A számlázó cég román CIF-je, pontosan úgy, ahogy az Oblióban szerepel. Minden kéréssel cif néven megy el; ha az Oblio nem ismeri a céget, The company with cif … does not exist a válasz.
Felhasználónév (Email) Az Oblio fiók e-mail címe. Az Oblio ezt használja API-ügyfélazonosítóként.
Token Az API-titok az Oblio fiókbeállításaiból. Nem az Oblio jelszavad.
A három kötelező mező

3. lépés — Mentés előtt dönts a készletről

A Használja a termékek készlet forrásaként a legfontosabb mező ezen az űrlapon — a román felület nevezi meg a legpontosabban: számlázáskor vezesd le a készletről.

4. lépés — Sorozatok, munkaállomás és a többi

Mező Mit csinál
Használja a termékek készlet forrásaként Igen esetén minden számla le is vezeti az árut az Oblio raktáráról. Lásd a fenti figyelmeztetést.
Raktár neve Az az Oblio-raktár, amelyről az áru lekerül. Opcionális, kis- és nagybetűérzékeny, és a gyakorlatban szükséges, amint a készletlevezetés be van kapcsolva, vagy egynél több raktárad van.
Munkaállomás neve Az az Oblio-munkapont, ahonnan a dokumentum kiállításra kerül. Opcionális, kis- és nagybetűérzékeny.
Nyugta sorozat Az a sorozat, amelyet az Oblio nyugtás beszedésnél használ. Minden más beszedési típusnál figyelmen kívül marad.
Ár frissítések küldése Az easySales árváltozásait elküldi a megfelelő Oblio-terméknek. Kötelező — az űrlap válasz nélkül nem mentődik.
Termékleírások használata A termék leírását teszi a számlasorra a puszta név helyett.
Sablon A számlára nyomtatott megjegyzés.
A kapcsolat többi része
Az Oblio űrlap alsó része: Ár frissítések küldése, Termékleírások használata és a Sablon mező a változógombokkal és a Mentés gombbal.
Az Ár frissítések küldése mezőt ki kell tölteni, mielőtt a kapcsolat mentődik.

A Sablon mező határozza meg a kapcsolatból készülő minden számlára nyomtatott megjegyzést. A fölötte lévő gombok a rendelésből illesztenek be értékeket — rendelésazonosító, platform, észrevételek, fuvarlevélszám, futár, fizetési mód.

5. lépés — Fejlett opciók

Itt semmi nem kötelező, de négy opció kizárólag az Oblióhoz tartozik, egy pedig megakadályozza a duplikált számlákat.

Egy Oblio kapcsolat fejlett opciói: Számla nyelve, Kibocsátó személyigazolvány száma, Kibocsátó neve, Esedékes nap és Fizetési típus.
A fejlett opciók első fele.
Opció Mit csinál
Számla nyelve Egyetlen nyelvet ír elő minden számlához. Üresen hagyva az easySales annak a webáruháznak vagy piactérnek a nyelvét használja, ahonnan a rendelés érkezett, ha az Oblio támogatja.
Kibocsátó személyigazolvány száma és Kibocsátó neve A számlán a kiállító személyeként jelennek meg. A román CNP pontosan 13 számjegyként van ellenőrizve.
Esedékes nap Hány nappal a kiállítás után esedékes a számla.
Fizetési típus Előírja az Oblio által rögzített beszedési típust — nyugta, pénztárbizonylat, kártya, átutalási megbízás és a többi. Üresen hagyva az easySales a rendelés fizetési módjából vezeti le. Nyugtát választva a fenti Nyugta sorozat kerül felhasználásra.
Terméknév választása Melyik név kerül a számlasorra: a termék saját neve vagy a rendelésben szereplő.
Kerület automatikus felismerése A címből állapítja meg a bukaresti kerületet, ha a rendelés nem tartalmazza.
Egyedi kedvezmény kód generálása Csak Oblio. Minden kedvezményt külön kódolt soron küld ahelyett, hogy összevonná őket.
Fordított adó beállítása Csak Oblio. Fordított adózásúként jelöli a számlát.
ÁFA név küldése csak 0%-os adónál Csak Oblio. Az ÁFA-mentesség nevét csak a nullkulcsos sorokon küldi el, nem mindegyiken.
Idempotencia kulcs engedélyezése Csak Oblio. Megakadályozza, hogy egy megismételt kérés második számlát hozzon létre ugyanarra a rendelésre.
Érdemes beállítani ezeket a fejlett opciókat
További Oblio fejlett opciók: Terméknév választása, Kerület automatikus felismerése, Egyedi kedvezmény kód generálása, Fordított adó beállítása, ÁFA név csak 0%-nál és Idempotencia kulcs engedélyezése.
A négy kizárólag Oblióhoz tartozó opció és az idempotencia kulcs, amely megelőzi a duplikált számlákat.

Az Oblio mint készletforrás

A fenti kapcsolat számlákat állít ki. Az easySales készletének az Oblióéval való szinkronban tartása egy második, külön kapcsolat, saját belépési adatokkal.

Az Oblio készletforrás kapcsolat űrlapja a kapcsolat nevével, adószámmal, tokennel, e-maillel és a raktár nevével.
A készletforrás kapcsolat külön áll, ugyanazon adatok saját másolatával.

Menj az Integrációk → Készlet források oldalra, nyomd meg a Bejelentkezés gombot az Oblio kártyán, és add meg ugyanazt az adószámot, tokent és e-mailt, valamint azt a raktárat, amelyből a készletet olvassuk.

Amikor az Oblio elutasít egy számlát

Az üzenet változatlanul érkezik az Obliótól, és a rendelésen jelenik meg. A készlet messze a leggyakoribb ok.

Mit mond az Oblio Mi a teendő
Nu am putut descarca gestiunea pentru acest document. Produsele urmatoare nu au stoc suficient: Az Oblio készlete kevés a felsorolt termékekből. Javítsd a készletet az Oblióban, vagy kapcsold ki a készletforrás használatát, ha nem vezeted naprakészen az Oblio raktárát.
Produsul "…" nu are stoc suficient. Ugyanez egyetlen termékre.
Concurrent requests timeout. Please make one request at a time. Az Oblio egyszerre több kérést kapott a fiókodra. Semmi nem vész el; a számla újra kiállítható.
Too Many Requests, check back later Az Oblio saját kéréskorlátja a fiókodra. Magától feloldódik.
The access token provided has expired Az Oblio a vártnál korábban zárta le a munkamenetet. Állítsd ki a számlát újra — az easySales új munkamenetet nyit, amikor a régi lejár.
Internal error. Please try again later. / üres vagy 504-es válasz Az Oblio nem válaszolt. Nálad nincs hiba; próbáld újra.
You are not allowed to use this API. Az Oblio fiók csomagja nem tartalmaz API-hozzáférést.
The company with cif … does not exist A kapcsolaton szereplő Adószám nem olyan cég, amely abban az Oblio fiókban létezik.
Tipul produsului nu a fost gasit, tipul trebuie sa fie unul din: Marfa, Semifabricate, … Egy termék típusa az Oblióban olyan, amelyet az Oblio itt nem fogad el. Javítsd a termék típusát az Oblióban.
Introdu o serie de document valida. Ez az easySales üzenete, nem az Oblióé: a rendelésen szereplő sorozat nem létezik az Oblio fiókodban.
Mit jelentenek az Oblio elutasításai

Sztornó, érvénytelenítés és fizetések

Művelet Mi történik az Oblióban
A rendelés kifizetettként jelölése A számla az Oblióban a Fizetési típus szerinti, vagy a rendelés fizetési módjából levezetett típussal kerül beszedésre. A nyugtás beszedés a Nyugta sorozatot használja.
Rendelés visszáruzása Az easySales sztornót kér az Obliótól az eredeti számlára.
Számla érvénytelenítése Az Oblio érvényteleníti a dokumentumot; a szám felhasznált marad, ahogy kell.
Számla törlése Csak addig lehetséges, amíg az Oblio engedi — különben érvényteleníteni kell.
Mit csinál még a kapcsolat

Gyakran ismételt kérdések

A kapcsolaton a készletforrás használata Igenre van állítva, így minden számla le is vezeti az árut az Oblio raktáráról — az Oblióban pedig nincs elég készlet a felsorolt termékekből. Vagy javítsd a készletet az Oblióban (és ellenőrizd, hogy a Raktár neve a megfelelő raktárra mutat, pontosan ugyanazzal az írásmóddal), vagy állítsd a készletforrást Nemre, ha nem vezeted naprakészen az Oblio raktárát. Ez a leggyakoribb oka annak, hogy egy Oblio-számla nem készül el.

Nem. Az Oblio külön API-titkot ad ki a fiókbeállítások oldalán, és az a token. A Felhasználónév (Email) mezőbe az a cím kerül, amelyre az Oblio fiók regisztrálva van. Ha a beállításoknál nincs token, az Oblio csomagod nem tartalmaz API-hozzáférést.

Ez az üzenet az easySalestől jön, és azt jelenti, hogy a sorozat nem létezik az Oblio fiókodban. Az easySales azt a sorozatot küldi, amely a rendelés forrásául szolgáló piactéren vagy webáruházon van beállítva, az Oblio pedig csak olyat fogad el, amelyet már ismer. Hozd létre az Oblióban, vagy állítsd át az easySalesben egy általa ismertre.

Nem. Az easySales munkamenetre váltja az e-mailt és a tokent, és lejáratkor magától megújítja. Ha a "The access token provided has expired" üzenetet látod egy rendelésen, állítsd ki a számlát újra — a kapcsolathoz nem kell hozzányúlni, hacsak nem cserélted a tokent az Oblióban.

Az Oblióban szereplő raktár nevével, karakterről karakterre — a mező kis- és nagybetűérzékeny, és a címke ezt jelzi is. Ugyanez vonatkozik a Munkaállomás nevére, amelynek egy Oblio-munkaponttal kell egyeznie. Másold ki mindkettőt az Oblióból.

A Fejlett opciók megjelenítése alatt állítsd a Fizetési típust nyugtára, és töltsd ki a kapcsolaton a Nyugta sorozatot egy olyan sorozattal, amely létezik az Oblióban. Amikor az easySales kifizetettként jelöli a rendelést, a beszedés arra a sorozatra kerül. Ha a Fizetési típust üresen hagyod, az easySales a rendelés fizetési módja alapján választ típust.

Kapcsold be az Idempotencia kulcs engedélyezése opciót a Fejlett opciók megjelenítése alatt. Az easySales ekkor a rendelésszámot is elküldi a számlával, és az Oblio nem hoz létre második dokumentumot olyan kérésre, amelyet már feldolgozott. Az opció rejtve marad, ha a fiók szándékosan több számlát enged rendelésenként.

Az első számlákat állít ki. A második az Oblio készletét olvassa be az easySalesbe, és külön kapcsolat, saját adószámmal, tokennel és e-maillel. Semmit nem osztanak meg, így ha az Oblióban tokent cserélsz, mindkettőt frissítened kell.

Igen. A rendelés visszáruzása sztornót kér az Obliótól az eredeti számlára, így a jóváíró dokumentum ugyanazokkal a sorozatszabályokkal jön létre, mint a számla.

Mert a Számla nyelve a Fejlett opciók megjelenítése alatt be van állítva, és minden számlára érvényes. Töröld ki, és az easySales annak a webáruháznak vagy piactérnek a nyelvét használja, ahonnan a rendelés érkezett, ha az Oblio támogatja.

Hasznos volt ez az útmutató?