Funktionen

Oblio mit easySales verbinden: die vollständige Anleitung

Vom easySales-Team · Aktualisiert 11 September 2026 · 2 Min. Lesezeit

Oblio mit easySales verbinden: die vollständige Anleitung

Verbinden Sie Oblio mit easySales: die drei Zugangsdaten, was die Bestandsquelle wirklich bewirkt, Rechnungs- und Belegserien, die Oblio-eigenen Optionen und die Bedeutung jeder Ablehnung.

Was Ihnen die Verbindung mit Oblio bringt

Mit verbundenem Oblio stellt easySales die Rechnung zur Bestellung aus, schickt sie an die Kundin oder den Kunden, markiert sie als bezahlt, storniert sie und kann den Bestand in Oblio mitführen — ohne dass Sie Oblio öffnen.

Diese Anleitung deckt die gesamte Verbindung ab, einschließlich der Einstellung, die darüber entscheidet, ob Ihre Rechnungen überhaupt herausgehen.

Bevor Sie beginnen

✓

Ein Oblio-Konto mit API-Zugang

Der Token wird auf der Kontoeinstellungsseite in Oblio ausgestellt. Steht dort keiner, enthält der Tarif keinen API-Zugang und die Verbindung scheitert mit You are not allowed to use this API.

✓

Ihre CIF genau wie in Oblio

Die Handelsregisternummer wird gegen die Firmen in Ihrem Oblio-Konto geprüft, nicht nur auf ihr Format.

✓

Die in Oblio angelegte Rechnungsserie

easySales sendet die Serie der Bestellung. Jede Serie, die dabei vorkommen kann, muss zuerst in Oblio existieren, sonst entsteht keine Rechnung.

✓

Eine Entscheidung zum Bestand

Ob das Oblio-Lager beim Rechnungsstellen abgebucht werden soll. Wenn ja, muss es korrekt geführt sein — ein zu geringer Bestand in Oblio stoppt die Rechnung.

Schritt 1 — Öffnen Sie die Seite Rechnungssoftware

Gehen Sie zu Integrationen → Rechnungssoftware und suchen Sie nach oblio.

Die Seite Rechnungssoftware in easySales, gefiltert auf Oblio, mit der verbundenen Oblio-Karte und der Schaltfläche Bearbeiten.
Die Oblio-Karte unter Integrationen → Rechnungssoftware.

Klicken Sie auf der Oblio-Karte auf Verbinden. Besteht bereits eine Verbindung, klicken Sie auf Bearbeiten.

Schritt 2 — Die drei Zugangsdaten

Das Oblio-Verbindungsformular in easySales mit Verbindungsname, Handelsregisternummer, Benutzername (E-Mail), Token, aktivierter Bestandsquelle, Lagername, Arbeitsplatzname und Belegserie.
Die Verbindung. Die drei Pflichtfelder sind alles, was Oblio braucht; der Rest verändert das Aussehen der Rechnung.
Feld Was es ist
Verbindungsname Ihr eigener Name für diese Verbindung. Er erreicht Oblio nie.
Handelsregisternummer Die rumänische CIF der abrechnenden Firma, genau wie in Oblio hinterlegt. Sie geht mit jeder Anfrage als cif mit; eine Firma, die Oblio nicht kennt, endet mit The company with cif … does not exist.
Benutzername (E-Mail) Die E-Mail-Adresse des Oblio-Kontos. Oblio nutzt sie als API-Client-ID.
Token Das API-Geheimnis aus den Kontoeinstellungen in Oblio. Nicht Ihr Oblio-Passwort.
Die drei Pflichtfelder

Schritt 3 — Entscheiden Sie über den Bestand, bevor Sie speichern

Bestandsquelle verwenden ist das folgenreichste Feld dieses Formulars — die rumänische Oberfläche benennt es am klarsten: beim Rechnungsstellen aus dem Lager abbuchen.

Schritt 4 — Serien, Arbeitsplatz und der Rest

Feld Was es bewirkt
Bestandsquelle verwenden Ja lässt jede Rechnung die Ware zusätzlich aus dem Oblio-Lager abbuchen. Siehe die Warnung oben.
Lagername Das Oblio-Lager, aus dem die Ware abgeht. Optional, Groß-/Kleinschreibung beachten und in der Praxis nötig, sobald die Abbuchung aktiv ist oder Sie mehr als ein Lager führen.
Arbeitsplatzname Der Oblio-Arbeitspunkt, von dem das Dokument ausgestellt wird. Optional, Groß-/Kleinschreibung beachten.
Belegserie Die Serie, die Oblio verwendet, wenn eine Zahlung als Quittung vereinnahmt wird. Bei jeder anderen Zahlungsart ohne Wirkung.
Preisaktualisierungen senden Sendet Preisänderungen aus easySales an das passende Produkt in Oblio. Pflichtangabe — ohne Antwort speichert das Formular nicht.
Produktbeschreibung verwenden Setzt die Produktbeschreibung statt nur des Namens in die Rechnungszeile.
Vorlage Der auf der Rechnung gedruckte Vermerk.
Der Rest der Verbindung
Der untere Teil des Oblio-Formulars: Preisaktualisierungen senden, Produktbeschreibung verwenden und das Feld Vorlage mit den Variablen-Schaltflächen und der Schaltfläche Speichern.
Preisaktualisierungen senden muss beantwortet sein, bevor die Verbindung speichert.

Das Feld Vorlage legt den Vermerk fest, der auf jeder Rechnung aus dieser Verbindung gedruckt wird. Die Schaltflächen darüber fügen Werte aus der Bestellung ein — Bestellnummer, Plattform, Bemerkungen, Frachtbriefnummer, Kurier, Zahlungsart.

Schritt 5 — Erweiterte Optionen

Nichts davon ist Pflicht, aber vier dieser Optionen gibt es nur für Oblio, und eine verhindert doppelte Rechnungen.

Die erweiterten Optionen einer Oblio-Verbindung: Rechnungssprache, Aussteller-CNP, Name des Ausstellers, Fälligkeitsdatum und Zahlungsart.
Die erste Hälfte der erweiterten Optionen.
Option Was sie bewirkt
Rechnungssprache Erzwingt eine Sprache für alle Rechnungen. Leer gelassen nutzt easySales die Sprache des Shops oder Marktplatzes der Bestellung, sofern Oblio sie unterstützt.
Aussteller-CNP und Name des Ausstellers Erscheinen auf der Rechnung als ausstellende Person. Die rumänische CNP wird auf genau 13 Ziffern geprüft.
Fälligkeitsdatum Wie viele Tage nach Ausstellung die Rechnung fällig ist.
Zahlungsart Erzwingt die Vereinnahmungsart, die Oblio erfasst — Quittung, Kassenbon, Karte, Überweisung und die übrigen. Leer gelassen leitet easySales sie aus der Zahlungsart der Bestellung ab. Bei Quittung wird die Belegserie von oben verwendet.
Produktnamen wählen Welcher Name in die Rechnungszeile kommt: der Name des Produkts oder der aus der Bestellung.
Bezirk automatisch erkennen Ermittelt den Bukarester Sektor aus der Adresse, wenn die Bestellung ihn nicht enthält.
Eindeutigen Rabattcode generieren Nur Oblio. Sendet jeden Rabatt als eigene codierte Zeile, statt sie zusammenzufassen.
Umgekehrte Steuerschuldnerschaft festlegen Nur Oblio. Kennzeichnet die Rechnung als Reverse-Charge.
USt.-Namen nur bei 0 % Steuer senden Nur Oblio. Sendet den Namen der Steuerbefreiung nur auf Zeilen mit Nullsatz statt auf allen.
Idempotenzschlüssel aktivieren Nur Oblio. Verhindert, dass eine wiederholte Anfrage eine zweite Rechnung zur selben Bestellung erzeugt.
Erweiterte Optionen, die sich lohnen
Weitere erweiterte Oblio-Optionen: Produktnamen wählen, Bezirk automatisch erkennen, eindeutigen Rabattcode generieren, umgekehrte Steuerschuldnerschaft, USt.-Name nur bei 0 % und Idempotenzschlüssel aktivieren.
Die vier Optionen, die es nur für Oblio gibt, und der Idempotenzschlüssel gegen doppelte Rechnungen.

Oblio als Bestandsquelle

Die Verbindung oben stellt Rechnungen aus. Den Bestand in easySales mit dem in Oblio abzugleichen ist eine zweite, eigene Verbindung mit eigenen Zugangsdaten.

Das Formular der Oblio-Bestandsquelle mit Verbindungsname, Steuernummer, Token, E-Mail und Lagername.
Die Bestandsquelle ist eine eigene Verbindung mit einer eigenen Kopie derselben Zugangsdaten.

Gehen Sie zu Integrationen → Bestandsquellen, klicken Sie auf der Oblio-Karte auf Verbinden und tragen Sie dieselbe Steuernummer, denselben Token und dieselbe E-Mail ein, dazu das Lager, aus dem der Bestand gelesen wird.

Wenn Oblio eine Rechnung ablehnt

Die Meldung kommt unverändert von Oblio und wird an der Bestellung angezeigt. Der Bestand ist mit Abstand der häufigste Grund.

Was Oblio meldet Was zu tun ist
Nu am putut descarca gestiunea pentru acest document. Produsele urmatoare nu au stoc suficient: Der Bestand in Oblio reicht für die genannten Produkte nicht. Korrigieren Sie den Bestand in Oblio oder schalten Sie Bestandsquelle verwenden aus, wenn Sie das Oblio-Lager nicht pflegen.
Produsul "…" nu are stoc suficient. Dasselbe für ein einzelnes Produkt.
Concurrent requests timeout. Please make one request at a time. Oblio hat mehrere Anfragen für Ihr Konto gleichzeitig erhalten. Nichts geht verloren; die Rechnung kann erneut ausgestellt werden.
Too Many Requests, check back later Oblios eigenes Anfragelimit für Ihr Konto. Es löst sich von selbst.
The access token provided has expired Oblio hat die Sitzung früher beendet als erwartet. Stellen Sie die Rechnung erneut aus — easySales erzeugt eine neue Sitzung, sobald die alte abläuft.
Internal error. Please try again later. / leere Antwort oder 504 Oblio hat nicht geantwortet. Auf Ihrer Seite ist nichts falsch; versuchen Sie es erneut.
You are not allowed to use this API. Das Oblio-Konto hat in seinem Tarif keinen API-Zugang.
The company with cif … does not exist Die Handelsregisternummer auf der Verbindung ist keine Firma in diesem Oblio-Konto.
Tipul produsului nu a fost gasit, tipul trebuie sa fie unul din: Marfa, Semifabricate, … Ein Produkt hat in Oblio einen Typ, den Oblio hier nicht akzeptiert. Korrigieren Sie den Produkttyp in Oblio.
Introdu o serie de document valida. Diese Meldung kommt von easySales, nicht von Oblio: Die Serie der Bestellung existiert in Ihrem Oblio-Konto nicht.
Was Oblios Ablehnungen bedeuten

Gutschriften, Stornierungen und Zahlungen

Vorgang Was in Oblio passiert
Bestellung als bezahlt markieren Die Rechnung wird in Oblio mit der Art aus Zahlungsart vereinnahmt oder mit der aus der Zahlungsart der Bestellung abgeleiteten. Eine Vereinnahmung per Quittung nutzt Ihre Belegserie.
Bestellung zurücknehmen easySales fordert bei Oblio eine Stornorechnung zur ursprünglichen Rechnung an.
Rechnung stornieren Oblio storniert das Dokument; die Nummer bleibt verbraucht, wie es sein muss.
Rechnung löschen Nur möglich, solange Oblio es zulässt — andernfalls stornieren Sie sie.
Was die Verbindung sonst noch tut

Häufig gestellte Fragen

Auf der Verbindung steht Bestandsquelle verwenden auf Ja, also bucht jede Rechnung die Ware zusätzlich aus dem Oblio-Lager ab — und Oblio hat für die genannten Produkte nicht genug Bestand. Korrigieren Sie entweder den Bestand in Oblio (und prüfen Sie, ob Lagername auf das richtige Lager zeigt, exakt so geschrieben), oder setzen Sie Bestandsquelle verwenden auf Nein, wenn Sie das Oblio-Lager nicht pflegen. Das ist der häufigste Grund für eine gescheiterte Oblio-Rechnung.

Nein. Oblio stellt auf der Kontoeinstellungsseite ein eigenes API-Geheimnis aus, und das ist der Token. In das Feld Benutzername (E-Mail) gehört die Adresse, auf die das Oblio-Konto registriert ist. Steht dort kein Token, enthält Ihr Oblio-Tarif keinen API-Zugang.

Diese Meldung stammt von easySales und bedeutet, dass die Serie in Ihrem Oblio-Konto nicht existiert. easySales sendet die Serie, die am Marktplatz oder Shop der Bestellung hinterlegt ist, und Oblio akzeptiert nur eine Serie, die es bereits hat. Legen Sie sie in Oblio an oder ändern Sie die Serie in easySales auf eine bekannte.

Nein. easySales tauscht E-Mail und Token gegen eine Sitzung und erneuert sie selbst, wenn sie abläuft. Sehen Sie "The access token provided has expired" an einer Bestellung, stellen Sie die Rechnung einfach erneut aus — an der Verbindung müssen Sie nichts ändern, außer Sie haben den Token in Oblio gewechselt.

Mit dem Namen des Lagers in Oblio, Zeichen für Zeichen — das Feld beachtet Groß- und Kleinschreibung, und die Beschriftung sagt das. Dasselbe gilt für den Arbeitsplatznamen, der einem Oblio-Arbeitspunkt entsprechen muss. Kopieren Sie beide aus Oblio.

Setzen Sie unter Erweiterte Optionen anzeigen die Zahlungsart auf Quittung und tragen Sie in der Verbindung eine Belegserie ein, die es in Oblio gibt. Markiert easySales die Bestellung als bezahlt, wird die Vereinnahmung auf dieser Serie erfasst. Lassen Sie die Zahlungsart leer, wählt easySales die Art nach der Zahlungsart der Bestellung.

Aktivieren Sie unter Erweiterte Optionen anzeigen den Idempotenzschlüssel. easySales sendet dann die Bestellnummer mit der Rechnung, und Oblio erstellt für eine bereits verarbeitete Anfrage kein zweites Dokument. Die Option ist ausgeblendet, wenn Ihr Konto bewusst mehrere Rechnungen je Bestellung erlaubt.

Die erste stellt Rechnungen aus. Die zweite liest Bestände aus Oblio nach easySales und ist eine eigene Verbindung mit eigener Steuernummer, eigenem Token und eigener E-Mail. Sie teilen sich nichts, also müssen Sie nach einem Tokenwechsel in Oblio beide aktualisieren.

Ja. Die Rücknahme einer Bestellung fordert bei Oblio eine Stornorechnung zur ursprünglichen Rechnung an, sodass die Gutschrift in Oblio nach denselben Serienregeln entsteht wie die Rechnung.

Weil unter Erweiterte Optionen anzeigen eine Rechnungssprache gesetzt ist, und die gilt für jede Rechnung. Leeren Sie das Feld, dann nutzt easySales die Sprache des Shops oder Marktplatzes der Bestellung, sofern Oblio sie unterstützt.

War dieser Leitfaden hilfreich?