A FGO csatlakoztatása az easySales-hez: teljes beállítási útmutató
Csatlakoztasd a román FGO számlázást az easySales-hez: a három FGO-oldali lépés, minden kapcsolati beállítás, a számlakiállítás módjai, a FGO román hibaüzenetei és a FGO készletforrásként.
Mit ad a FGO csatlakoztatása
A FGO román számlázó szolgáltatás. Az easySales-hez kötve úgy állítja ki egy rendelés számláját, hogy semmit nem kell újra begépelned — a rendeléslistából, magából a rendelésből, tömegesen vagy automatikusan, egy folyamat lépéseként. Ugyanaz a FGO API-felhasználó másodszor is felhasználható, egy külön kapcsolatban: arra, hogy az easySales beolvassa a FGO-ban vezetett készleteket.
Mielőtt nekikezdesz
FGO-fiók API-hozzáféréssel
Az 1. lépésben létrehozott API-felhasználó csak olyan FGO-csomagon hozható létre, amely tartalmaz API-hozzáférést. Ellenőrizd a csomagodat az FGO-ban, mielőtt nekikezdesz.
A FGO-ban létrehozott API-felhasználó
Nem a szokásos belépésed. A FGO jelszót generál hozzá, és ez a jelszó az, amit az easySales Magánkulcsnak hív.
A CUI-d
A román adószám, amelyet a FGO a Setări → Firmă (Beállítások → Cég) oldalon mutat.
Használatra kész számlasorozat
API-jogokkal, érvényes időszakkal és még szabad sorszámokkal. Ez az a lépés, amit a legtöbben kihagynak.
Az 1-3. lépés a FGO-ban történik, nem az easySales-ben. Mindegyiknek külön hibája van, és bármelyik kihagyása olyan hibaüzenetet eredményez, aminek csak akkor van értelme, ha tudod, mire vonatkozik — ezért érdemes mind a hármat elvégezni, mielőtt megnyitod az easySales-t.
1. lépés — Hozd létre az API-felhasználót a FGO-ban
A FGO adminisztrációs felületén nyisd meg a Setări → Utilizatori (Beállítások → Felhasználók) menüpontot, és vegyél fel egy API-felhasználót. A FGO jelszót generál hozzá: másold ki most, mert ezt hívja az easySales Magánkulcsnak.
2. lépés — Engedd meg a FGO-nak, hogy fogadja az easySales hívásait
A FGO-ban nyisd meg a Setări → eCommerce → Setări API (Beállítások → eCommerce → API-beállítások) oldalt, és vedd fel a https://easy-sales.com címet azoknak az oldalaknak a listájára, amelyek API-n keresztül csatlakozhatnak.
3. lépés — Készítsd elő a számlasorozatot
A FGO-ban nyisd meg a Setări → Serii Documente (Beállítások → Dokumentumsorozatok) oldalt, és ellenőrizd azt a sorozatot, amellyel számlázni szeretnél. Szüksége van a User API jogosultságra — magán az API-felhasználón és az összes felhasználóra vonatkozó bejegyzésen is —, valamint egy From / To időszakra, amely lefedi a mai napot, és amelyben még maradt szabad sorszám.
4. lépés — Csatlakoztasd a FGO-t az easySales-ben
Nyisd meg a Beállítás → Integrációk → Számlázás menüpontot, és keresd meg a FGO csempét.
Nyomd meg a Bejelentkezés gombot, és töltsd ki az űrlapot.
| Mező | Mit csinál |
|---|---|
| Kapcsolat neve | Kötelező. A saját elnevezésed. Ez lesz a fül neve, ha egynél több FGO-fiókot kötsz be. |
| Adószám | Kötelező. A román adószámod, a CUI, pontosan úgy, ahogy a FGO a Setări → Firmă (Beállítások → Cég) oldalon mutatja. |
| Magánkulcs | Kötelező. Az a jelszó, amelyet a FGO az 1. lépésben létrehozott API-felhasználóhoz generált. Ezen az űrlapon nyíltan látszik, nincs elrejtve. |
| A számlák típusai | Melyik FGO-dokumentumtípus készüljön — Factura a szokásos számlához, összesen tizenegy lehetőséggel, köztük Proforma, Aviz (szállítólevél), fordított adózás és különbözet szerinti adózás. |
| A termékek azonosításának a módszere | Hogyan mondja meg az easySales a FGO-nak, melyik cikkre vonatkozik egy sor. Az SKU a termék készletkódját küldi, ennek hiányában az SKU-t. A Név semmilyen kódot nem küld, és a FGO-ra bízza a párosítást a cikk neve alapján. |
| Használja a termékek készlet forrásaként | Kötelező, de a FGO esetében semmit nem változtat — a neve ellenére nem ez teszi készletforrássá. Ami valóban leveteti a FGO-val az árut a készletről, az az alatta lévő Saga Raktár Kód. |
| Saga Raktár Kód | Az a FGO-raktár, amelyre minden számlasor könyvelődik — ez az, ami leveteti a FGO-val az árut a készletről. Pontosan úgy írd be, ahogy a raktár neve a FGO-ban szerepel. Hagyd üresen, ha nem vezetsz ott készletet. |
| Sablon | Szabad szöveg, amely a számla megjegyzés rovatába kerül. A fölötte lévő gombok változókat szúrnak be — rendelésazonosító, AWB-szám, futár, fizetési mód vagy a megrendelt termékek listája. |
5. lépés — Fejlett opciók
A fejlett szakasz össze van csukva, és semmi nem kötelező benne, de két beállítása olyan problémákat old meg, amelyeket egyébként nehéz felderíteni.
| Beállítás | Mit csinál |
|---|---|
| Díj azonosítókódok | A szállítási, kedvezmény- és díjsorokat felelteti meg a FGO-ban használt cikkkódoknak. Adj meg mindegyikhez egy típust, azt a szöveget, amit a díj neve tartalmaz, és a FGO cikkkódot. Enélkül ezek a sorok azonosítatlan cikként érkeznek. |
| Termékleírások használata | Megválasztja, mi kerül a számla leírás oszlopába — semmi, a termék kódja, a neve, a tulajdonságai vagy az EAN-ja. |
| Terméknév választása | Az easySales-ben tárolt három név közül melyik kerül nyomtatásra: a termék neve a raktárkezelésben, a katalógusnév vagy az ajánlat neve. |
| Az ajándéktermékeket külön kedvezményként jelenítse meg | Az ingyenes tételeket kedvezménysorként teszi a számlára, nem nulla árú termékként. |
| Speciális karakterek eltávolítása | Kiszedi a speciális karaktereket a vevőnevekből és címekből a küldés előtt. Hasznos, ha a FGO elutasít egy ékezetet vagy egy szimbólumot. |
| Garancia generálása számlázáskor | Ugyanakkor garancialevelet is készít egy általad választott sablonból, és ezt be tudja fűzni a számlával azonos PDF-be. |
| Kedvezmények kizárása a számlákból | A kedvezménysorokat teljesen kihagyja a dokumentumból. |
6. lépés — Mondd meg az easySales-nek, melyik sorozatot használja
A kapcsolat nem hordoz magával sorozatot. Az easySales rendelésenként oldja fel, ebben a sorrendben: a piactéri kapcsolaton beállított sorozat, amelyről a rendelés érkezett, majd a webáruházon beállított, végül a rendelésen már szereplő.
Számlák kiállítása
| Honnan | Művelet | Sorozat |
|---|---|---|
| A rendeléslista | Gyors létrehozás a számla oszlopban | A rendelésről |
| A rendelés saját oldala | Számla létrehozása | A rendelésről |
| A rendeléslista, több rendelés egyszerre | Számla létrehozása — legfeljebb 50 rendelés, mindegyikhez egy számla | Rendelésenként feloldva |
| Egy csoportosított folyamat | Számla létrehozása | Rendelésenként feloldva |
| Egy automatizálási folyamat | A számlakészítő művelet | Rendelésenként feloldva |
Ha egy számla nem sikerül
A FGO elutasításait az easySales szó szerint továbbadja, románul, bármilyen nyelven használod is az easySales-t. Pontos üzenetek, ha egyszer el tudod olvasni őket — az alábbi táblázat mindegyiket megmagyarázza.
| Amit a FGO mond | Mit kell tenni |
|---|---|
Platforma https://easy-sales.com nu este inregistrata in FGO
|
A 2. lépés kimaradt. Vedd fel a címet a FGO-ban, a Setări → eCommerce → Setări API oldalon. |
Registrul pentru seria … nu este definit sau a expirat.
|
A sorozatnak nincs API-joga, lejárt az időszaka, vagy elfogytak a sorszámai. Mind a hármat nézd meg a Setări → Serii Documente oldalon. |
Campul 'Serie' este obligatoriu.
|
Egyáltalán nem jutott el sorozat a FGO-hoz. Állíts be egyet a piactéri kapcsolaton vagy a webáruházon. |
Hash-ul transmis nu este corect.
|
A magánkulcs hibás, vagy lecserélték a FGO-ban. Illeszd be újra az aktuálisat. |
Utilizatorul nu exista sau nu are drepturi de acces.
|
Az API-felhasználót törölték, vagy elvesztette a jogait. Hozd létre újra a Setări → Utilizatori oldalon. |
Codul unic nu exista sau nu este asociat.
|
Az Adószám mezőbe írt érték nem egyezik a FGO-fiók CUI-jával. |
Campul Client[CodUnic] este obligatoriu.
|
A vevő cég, de a rendelésen nincs CUI. Írd be a rendelés számlázási adataihoz. |
Judetul … nu exista in nomenclator
|
A számlázási címen nincs megye, vagy olyan van, amit a FGO nem ismer. Válaszd ki a megyét a rendelésen. |
CotaTVA … nu exista in nomenclator.
|
Az egyik soron szereplő áfakulcs nem létezik a FGO-ban. Vedd fel azt a kulcsot a FGO-ban, vagy javítsd a rendelésen. |
Factura este deja stornata.
|
Ehhez a számlához már létezik sztornó. |
Factura a fost transmisa in SPV. Nu se poate anula.
|
A számlát beadták az ANAF-hoz, és már nem lehet érvényteleníteni — helyette sztornó számlát kell kiállítani. |
Nem kötelező — a FGO mint készletforrás
A FGO azt is meg tudja mondani az easySales-nek, mennyi készleted van. Ez egy második, külön kapcsolat a Beállítás → Integrációk → Készlet források menüpontban, ugyanazzal a CUI-val és ugyanazzal az API-felhasználói jelszóval, és hozzá kell rendelni egy webáruházhoz, mielőtt bármi szinkronizálódna.
