FGO mit easySales verbinden: die vollständige Einrichtungsanleitung
Verbinden Sie FGO mit easySales: die drei Schritte, die zuerst in FGO passieren, jede Verbindungseinstellung, wie Rechnungen entstehen, was jeder FGO-Fehler bedeutet und FGO als Bestandsquelle.
Was Ihnen die FGO-Verbindung bringt
FGO ist ein rumänischer Rechnungsdienst. Mit easySales verbunden, stellt er die Rechnung zu einer Bestellung aus, ohne dass Sie irgendetwas abtippen — aus der Bestellliste, aus der Bestellung selbst, als Massenaktion oder automatisch aus einem Flow. Denselben FGO-API-Benutzer können Sie ein zweites Mal verwenden, in einer getrennten Verbindung, um Bestände aus FGO in easySales einzulesen.
Bevor Sie beginnen
Ein FGO-Konto mit API-Zugriff
Der API-Benutzer aus Schritt 1 lässt sich nur in einem FGO-Tarif anlegen, der API-Zugriff enthält. Prüfen Sie Ihren Tarif in FGO, bevor Sie beginnen.
Ein in FGO angelegter API-Benutzer
Nicht Ihr normaler Login. FGO erzeugt dafür ein Passwort, und dieses Passwort ist das, was easySales Privater Schlüssel nennt.
Ihre CUI
Die rumänische Steuernummer, die FGO unter Setări → Firmă anzeigt. Sie kommt in das Feld Handelsregisternummer, auch wenn die Beschriftung etwas anderes nahelegt.
Eine einsatzbereite Rechnungsserie
Mit API-Berechtigungen, gültigem Zeitraum und noch freien Nummern. Dieser Schritt wird am häufigsten übersehen.
Die Schritte 1 bis 3 finden in FGO statt, nicht in easySales. Jeder davon hat eine eigene Fehlerquelle, und wenn Sie einen überspringen, erhalten Sie eine Fehlermeldung, die erst dann Sinn ergibt, wenn Sie wissen, worauf sie sich bezieht — es lohnt sich also, alle drei zu erledigen, bevor Sie easySales öffnen.
Schritt 1 — Den API-Benutzer in FGO anlegen
Öffnen Sie im FGO-Verwaltungsbereich Setări → Utilizatori (Einstellungen → Benutzer) und legen Sie einen API-Benutzer an. FGO erzeugt dafür ein Passwort: Kopieren Sie diesen Wert sofort, denn genau er ist das, was easySales Privater Schlüssel nennt.
Schritt 2 — FGO Aufrufe von easySales erlauben
Öffnen Sie in FGO Setări → eCommerce → Setări API (Einstellungen → eCommerce → API-Einstellungen) und tragen Sie https://easy-sales.com in die Liste der Websites ein, die sich per API verbinden dürfen.
Schritt 3 — Die Rechnungsserie vorbereiten
Öffnen Sie in FGO Setări → Serii Documente (Einstellungen → Dokumentenserien) und prüfen Sie die Serie, mit der Sie fakturieren wollen. Sie braucht die Berechtigung User API — sowohl am API-Benutzer selbst als auch am Eintrag für alle Benutzer — und einen Von-/Bis-Zeitraum, der das heutige Datum abdeckt und in dem noch Nummern frei sind.
Schritt 4 — FGO in easySales verbinden
Gehen Sie zu Konfiguration → Integrationen → Rechnungssoftware und suchen Sie die Kachel FGO.
Klicken Sie auf Verbinden und füllen Sie das Formular aus.
| Feld | Funktion |
|---|---|
| Verbindungsname | Pflichtfeld. Ihre eigene Bezeichnung. Sie wird zum Reiternamen, sobald Sie mehr als ein FGO-Konto verbinden. |
| Handelsregisternummer | Pflichtfeld. Trotz der Beschriftung gehört hier Ihre CUI hinein, so wie FGO sie unter Setări → Firmă anzeigt — nicht die Handelsregisternummer. |
| Privater Schlüssel | Pflichtfeld. Das Passwort, das FGO in Schritt 1 für den API-Benutzer erzeugt hat. Es wird in diesem Formular im Klartext angezeigt und nicht maskiert. |
| Rechnungstypen | Welchen FGO-Belegtyp Sie ausstellen — Factura für die gewöhnliche Rechnung, insgesamt elf Optionen, darunter Proforma, Aviz, Reverse-Charge und die Differenzbesteuerung. |
| Produktzuordnungsmethode | Wie easySales FGO mitteilt, auf welchen Artikel sich eine Position bezieht. SKU sendet den Bestandscode des Produkts und weicht auf dessen SKU aus. Name sendet keinen Code und überlässt FGO die Zuordnung über den Artikelnamen. |
| Bestandsquelle verwenden | Pflichtfeld, ändert für FGO aber nichts. Was FGO tatsächlich dazu bringt, den Bestand abzubuchen, ist der Saga-Lagercode weiter unten. |
| Saga-Lagercode | Das FGO-Lager, gegen das jede Rechnungsposition gebucht wird — das ist es, was FGO die Ware ausbuchen lässt. Tragen Sie ihn genau so ein, wie das Lager in FGO heißt. Lassen Sie ihn leer, wenn Sie dort keinen Bestand führen. |
| Vorlage | Freitext, der in die Bemerkungen der Rechnung gedruckt wird. Die Schaltflächen darüber fügen Platzhalter ein — Bestellnummer, AWB-Nummer, Kurier, Zahlungsart oder eine Liste der bestellten Produkte. |
Schritt 5 — Erweiterte Optionen
Der Bereich Erweiterte Optionen anzeigen ist zugeklappt, und nichts darin ist Pflicht. Zwei der Einstellungen lösen aber Probleme, die sonst schwer zu diagnostizieren sind.
| Einstellung | Funktion |
|---|---|
| Gebühren-Identifikationscodes | Ordnet Versand-, Rabatt- und Gebührenpositionen den Artikelcodes zu, die Sie in FGO verwenden. Sie geben je einen Slug, den Text, den der Gebührenname enthält, und den FGO-Artikelcode an. Ohne das kommen diese Positionen als nicht zugeordnete Artikel an. |
| Produktbeschreibung verwenden | Bestimmt, was in die Beschreibungsspalte der Rechnung wandert — nichts, der Produktcode, der Produktname, die Produkteigenschaften oder die Produkt-EAN. |
| Produktnamen wählen | Welcher der drei in easySales geführten Namen gedruckt wird: Lagerproduktname, Produktname oder Angebotsname. |
| Geschenkprodukte als separaten Rabatt anzeigen | Stellt Gratisartikel als Rabattposition auf die Rechnung statt als Produkt mit Preis null. |
| Sonderzeichen entfernen | Entfernt Sonderzeichen aus Kundennamen und Adressen vor dem Senden. Nützlich, wenn FGO ein diakritisches Zeichen oder ein Symbol ablehnt. |
| Bei der Rechnungsstellung eine Garantie erstellen | Erzeugt gleichzeitig eine Garantieurkunde aus einer von Ihnen gewählten Vorlage und kann sie mit der Rechnung in dieselbe PDF-Datei zusammenführen. |
| Rabatte von Rechnungen ausschließen | Lässt Rabattpositionen vollständig vom Beleg weg. |
Schritt 6 — easySales sagen, welche Serie zu verwenden ist
Die Verbindung selbst trägt keine Serie. easySales ermittelt sie pro Bestellung in dieser Reihenfolge: die Serie an der Marktplatzverbindung, aus der die Bestellung stammt, dann die an der Website hinterlegte, dann die, die bereits an der Bestellung selbst steht.
Rechnungen ausstellen
| Von wo | Bedienelement | Serie |
|---|---|---|
| Die Bestellliste | Schnell erstellen in der Rechnungsspalte | Von der Bestellung übernommen |
| Die Seite einer Bestellung | Rechnung erstellen | Von der Bestellung übernommen |
| Die Bestellliste, mehrere auf einmal | Rechnung erstellen als Massenaktion — bis zu 50 Bestellungen, je eine Rechnung | Pro Bestellung ermittelt |
| Eine Verarbeitungsgruppe | Rechnung erstellen | Pro Bestellung ermittelt |
| Ein Automatisierungs-Flow | Die Aktion Rechnung erstellen | Pro Bestellung ermittelt |
Wenn eine Rechnung scheitert
Die Ablehnungen von FGO werden wortwörtlich durchgereicht, auf Rumänisch, ganz gleich in welcher Sprache Sie easySales verwenden. Sie sind präzise, sobald man sie lesen kann.
| Was FGO meldet | Was zu tun ist |
|---|---|
Platforma https://easy-sales.com nu este inregistrata in FGO
|
Schritt 2 wurde übersprungen. Tragen Sie die Adresse in FGO unter Setări → eCommerce → Setări API ein. |
Registrul pentru seria … nu este definit sau a expirat.
|
Die Serie hat keine API-Rechte, ihr Zeitraum ist abgelaufen oder ihre Nummern sind aufgebraucht. Prüfen Sie alle drei Punkte unter Setări → Serii Documente. |
Campul 'Serie' este obligatoriu.
|
Es ist überhaupt keine Serie bei FGO angekommen. Hinterlegen Sie eine an der Marktplatzverbindung oder an der Website. |
Hash-ul transmis nu este corect.
|
Der private Schlüssel ist falsch oder wurde in FGO gewechselt. Fügen Sie den aktuellen erneut ein. |
Utilizatorul nu exista sau nu are drepturi de acces.
|
Der API-Benutzer wurde gelöscht oder hat seine Rechte verloren. Legen Sie ihn unter Setări → Utilizatori neu an. |
Codul unic nu exista sau nu este asociat.
|
Der Wert im Feld Handelsregisternummer stimmt nicht mit der CUI des FGO-Kontos überein. |
Campul Client[CodUnic] este obligatoriu.
|
Der Kunde ist ein Unternehmen, an der Bestellung steht aber keine CUI. Ergänzen Sie sie in den Rechnungsdaten der Bestellung. |
Judetul … nu exista in nomenclator
|
Die Rechnungsadresse hat keinen Kreis oder einen, den FGO nicht kennt. Wählen Sie den Kreis an der Bestellung. |
CotaTVA … nu exista in nomenclator.
|
Der Mehrwertsteuersatz einer Position existiert in FGO nicht. Legen Sie ihn in FGO an oder korrigieren Sie ihn an der Bestellung. |
Factura este deja stornata.
|
Zu dieser Rechnung existiert bereits eine Stornorechnung. |
Factura a fost transmisa in SPV. Nu se poate anula.
|
Die Rechnung wurde bei der ANAF eingereicht und lässt sich nicht mehr annullieren — stellen Sie stattdessen eine Stornorechnung aus. |
Optional — FGO als Bestandsquelle nutzen
FGO kann easySales auch mitteilen, wie viel Bestand Sie führen. Das ist eine zweite, getrennte Verbindung unter Konfiguration → Integrationen → Bestandsquellen, mit derselben CUI und demselben API-Benutzerpasswort, und sie muss an eine Website gehängt werden, bevor überhaupt etwas synchronisiert.
