Haben Sie vor, eine andere externe Anwendung mit ABRA Flexi zu verbinden? In diesem Leitfaden versuchen wir, Ihnen einen Überblick über die in diesen Fällen am häufigsten verwendeten Tagesordnungen (Protokolle) zu geben.
Eine vollständige Übersicht über die Datensätze finden Sie in der sogenannten Datensatzliste in unserer Webanwendung. Der Rechnername (oder API-Name) ist das, was Sie in der entsprechenden URL eingeben.
Wie man eine solche URL zusammenstellt, wird in einem anderen Lehrgang behandelt. Sie sollten auch wissen, welche Formate unterstützt werden. Wenn wir ein paar andere nützliche Funktionen beim Zusammenstellen einer URL herausgreifen können, sind Filterung oder Detaillierungsgrad hilfreich, aber der gesamte API-Leitfaden und die XML-Beispieldateien werden sich als nützlich erweisen.
Wir haben auch einen allgemeinen Leitfaden für die Migration von Daten aus einem anderen System. Der Lehrgang ist jedoch eher im Sinne einer Umstellung des Buchhaltungssystems und der damit verbundenen Datenkonvertierung zu verstehen.
Datenübertragung
Die wohl häufigste Anwendungsverknüpfung ist die Verknüpfung des ABRA-Flexi-Buchhaltungssystems mit dem E-Shop. Es gibt jedoch viele weitere Verbindungen, z. B. mit Lagersystemen, Dispositionssoftware, CRM-Systemen usw. Dabei geht es um die Arbeit mit Daten, die zwischen Systemen verschoben werden können.
Wenn Sie sich in einer externen Anwendung über Änderungen an bestimmten Daten in Flexi informieren wollen, nennt man das WebHooks.
Bestellungen
Die Übertragung von Bestellungen aus dem E-Shop an Flexi kann wohl als die häufigste Lösung der implementierten Verbindungen angesehen werden. Meistens werden sie auch automatisch übertragen (entweder einzeln oder in Stapeln).
Endpunkt
/bestellung-erhalten
Beispiel-URL
Beispielanfrage
<winstrom version="1.0"> <order-accepted> <id>code:OBP0080/2021</id><datVyst>2021-06-16</datVyst> <sumTotal>1000.0</sumTotal> <sumCelMen>0.0</sumTotalMen> <Währung>Code:CZK</Währung><Firm>Code:2776</firm> <description></description> <polozkyDokladu> <obobjednavka-prijata-polozka><name>testovaci_polozka</name><cenik>code:TEST</price> <store>code:PLZEN</store><mnozMj>1.0</mnozMj> <priceMj>300</priceMj> <currency>code:CZK</currency></order-accepted-item> </itemsDocument></order-accepted> </winstrom>
Bei der Auftragsübermittlung kann der Auftrag direkt ausgeführt werden oder die Auftragspositionen können beim Lieferanten bestellt werden.
Rechnungen
Die Übertragung von Rechnungen aus dem E-Shop ist wahrscheinlich der zweithäufigste Vorgang. Wenn Sie nur Rechnungen übertragen, überspringen Sie wahrscheinlich die Auftragsübertragung.
Endpunkt
/Rechnung-ausgestellt
Beispiel-URL
Standardmäßig erzeugt eine Rechnung ein Bestandsdokument, d.h. einen Lieferschein. Die Einstellungen können in der Rechnungsart geändert werden.
Verzeichnis
Die Bestellung oder Rechnung (oder das Dokument im Allgemeinen) enthält Informationen über den Kunden. Diese wird im Adressbuch gespeichert. Alle anderen Geschäftspartner, z. B. Lieferanten, sind ebenfalls in dem Verzeichnis gespeichert.
Endpunkt
/addressar
Beispiel-URL
Beispielanfrage
<winstrom version="1.0"> <addresar> <id>code:ABRA</id><name>ABRA Software a.s.</nazev> <ic>25097563</ic> <dic>CZ25097563</dic><straet>Jeremiášova 1422/7B</street><city>Prag</city> <psc>155 00</psc> <stat>code:CZ</stat> </address> </winstrom>
Das Verzeichnis kann zusammen mit einem Dokument (Bestellung, Rechnung) in einer einzigen Anfrage erstellt werden.
Die Preisliste
Sie müssen eine Preisliste (oder Produktliste) von oder zu Flexi synchronisieren? Dann sind Sie auf der Suche nach einem Preislisteneintrag.
Endpunkt
/Preisliste
Beispiel-URL
Beispielanfrage
<winstrom version="1.0"> <cenik> <code>TEST</code><name>test_item</name> <priceZakl>263.5</priceZakl> <typeCenyDphK>typeCeny.ohneDph</typCenyDphK> <typStocksK>typStocks.goods</typStocksK><typSzbDphK>typSzbDph.dphZakl</typSzbDphK> <stock>true</stock></price> </winstrom>
Lagerkarten sind mit der Preisliste für Lagerartikel verknüpft. Sie erfassen den Bestandsstatus der jeweiligen Artikel.
Individuelle Preisliste
Sie können auch eine individuelle Preisliste in Flexi hochladen. Dies kann mit verschiedenen Unternehmen, Unternehmensgruppen oder Währungen verbunden sein. Wir können individuelle Einkaufspreise und individuelle Verkaufspreise hochladen.
Endpunkt Verkaufspreis
/Abonnent
Beispiel-URL
Beispielanfrage
<winstrom version="1.0"> <odberatel> <salePrice>0.5</salePrice> <price>code:TEST</price> <company>ABRA</company> <currency>code:EUR</currency> </odberatel> </winstrom>
Endpunkt der Ankaufspreise
/Lieferant
Beispiel-URL
Beispielanfrage
<winstrom version="1.0"> <Lieferant> <Preis>Code:TEST</Preis> <Firma>Code:LIEFERANT</Firma> <Kaufpreis>200</Kaufpreis> <Währung>Code:CZK</Währung> </Lieferant> </winstrom>
Individuelle Preise können auch direkt in der App eingerichtet werden, wir haben auch eine Anleitung dazu.
Vorrätige Karten
Für Lagerkarten (vor allem bei E-Shops) ist die Abfrage des Lagerbestands bei Flexi eine recht gängige Lösung. Sie können dies anhand der Bestandskarten herausfinden.
Endpunkt
/stock-card
Beispiel-URL
Die Bestandskarten werden in der Regel nicht importiert, sondern der Bestandsstatus wird aus ihnen abgerufen. Bestandskarten in Flexi haben keinen Einfluss auf den Bestandsstatus, sondern nur auf die Bestandsbewegungen. Wenn Sie den Lagerstatus durch Importieren beeinflussen müssen, importieren Sie die Lagerbewegungen.
Lagerbewegungen
Eingang oder Versand. Ein Dokument, das den Status des Lagers beeinflusst. Nützlich bei der Verbindung von Lager- und Versandsystemen.
Endpunkt
/Stock-Bewegung
Beispiel-URL
Beispielanfrage
<winstrom version="1.0"> <storage-movement> <id>code:S-0093/2021</id><datVyst>2021-08-09</datVyst><sumTotal>10000.0</sumTotal> <Währung>Code:CZK</Währung><Firma>Code:ABRA</Firma> <Dokument-Felder> <stock-movement-field><name>testing_field</name> <cenik>code:TEST</price> <warehouse>code:PLZEŇ</warehouse><mnozMj>1.0</mnozMj> <priceMj>300</priceMj> <currency>code:CZK</currency></stock-movement-item> </stock-movement-item></stock-movement></winstrom>
Offenbar werden Aktienbewegungen in der Regel direkt in Flexi erzeugt. Die Versand- und Lagersysteme müssen sie jedoch erstellen oder Informationen über sie erhalten.
Das war alles aus den Basisdatensätzen, die Sie bei der Verbindung mit einer externen Anwendung verwenden. Es gibt noch viele weitere Datensätze, die über die API verfügbar sind und die Sie hier finden.
Bevor Sie mit der Arbeit beginnen, empfehlen wir Ihnen, die API-Dokumentation zu studieren. Dort finden Sie alle beschriebenen Prozesse, die mit der API implementiert werden können.