Schnittstellenleitfaden: Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
FBO (Diskussion | Beiträge) |
FBO (Diskussion | Beiträge) |
||
| Zeile 6: | Zeile 6: | ||
=Vorbemerkungen= | =Vorbemerkungen= | ||
Im Folgenden werden die Austauschformate für die nicht spezifische Webshop-Schnittstelle aufgeführt. Die Schnittstelle ist eine von mehreren Schnittstellen, die genutzt werden können. | Im Folgenden werden die Austauschformate für die nicht spezifische Webshop-Schnittstelle aufgeführt. Die Schnittstelle ist eine von mehreren Schnittstellen, die genutzt werden können. | ||
==Hinweise für externe Entwickler== | |||
Da es immer wieder zu Konflikten in der Schnittstellenanpassung kommt, weisen wir explizit darauf hin, dass die vorliegende Schnittstelle seit vielen Jahren von verschiedenen Schnittstellenpartnern eingesetzt wird. Es handelt sich also um eine praxiserprobte und erwiesenermaßen robuste, funktionsfähige Schnittstelle. Die Schnittstelle wurde mit Fachleuten aus mehreren Unternehmen gemeinsam entwickelt. Sie wurde bereits erfolgreich für Systeme wie "Shopware" oder "Drinkware" implementiert und wird im Produktivbetrieb von Anwendern genutzt. | |||
Es gilt: | |||
* Die Schnittstelle ist voll funktionsfähig | |||
* Es werden alle zugrundeliegenden Normen und Spezifikationen eingehalten | |||
* Der Dateityp CSV wird mit deutschen Formatierungen und Zeichensätzen ausgegeben. Delimiter ist ";" | |||
* Der Dateityp XML wird RFC- und W3C-konform im UTF-8 Zeichensatz ausgegeben. | |||
* Die Protokolle FTP und JSON werden RFC- und W3C-konform angewendet. | |||
Daraus folgt: | |||
* Es werden '''keine Anpassung''' aufgrund von Einschränkungen oder Inkompatibilitäten auf der Seite des Shopsystems durchgeführt, auch nicht auf Anfrage oder gegen Kostenerstattung | |||
* Eine '''Erweiterung''' der Schnittstelle ist auf Anfrage und in jedem Fall kostenpflichtig, möglich. | |||
* Es muss nicht die Schnittstelle, sondern immer das Shopsystem angepasst werden. Dies ist nicht Aufgabe des Schnittstellenanbieters, sondern des Webshopentwicklers. | |||
{{Achtung|Sie erhalten auf Anfrage Hilfestellung zu Schnittstellendefinitionen, keinesfalls jedoch zu branchenspezifischen Themen. Für branchenspezifische Themen sprechen Sie ausschließlich Ihren Auftraggeber an. Vor der Implementierung fragen wir bei Ihrem Auftraggeber eine Freigeabe für die Erstattung der Beratungskosten an und dokumentieren den Aufwand}} | |||
==Formate== | ==Formate== | ||
Neben den branchenspezifischen Schnittstellen (KOLLEX, OctopusOrder, Refill, Gastivo) unterstützt FAKTURA-X auch | Neben den branchenspezifischen Schnittstellen (KOLLEX, OctopusOrder, Refill, Gastivo) unterstützt FAKTURA-X auch allgemeine EDI Formate. | ||
{{Tipp1|Informationen dazu erhalten Sie vom Hersteller}} | {{Tipp1|Informationen dazu erhalten Sie vom Hersteller}} | ||
= | {| class="wikitable" | ||
|+ Formatkennzeichen | |||
|- | |||
! Zeichen !! Bedeutung !!Format | |||
|- | |||
| A || Eindimensionaler String || UTF-8, ohne Delimiter | |||
|- | |||
| N || Gleitkommazahl || (-)n0,n, maximal 32-Bit | |||
|- | |||
| I || Ganzzahl || (-)i, maximal 32-Bit | |||
|- | |||
| B || Logischer Wert || True/False oder Wahr/Falsch, ohne Delimiter | |||
| | |||
| D || Datum || ISO 8601 JJJJ-MM-TT, Zeitanteil wird ignoriert | |||
|- | |||
| T|| |Uhrzeit || ISO 8601 hh:nn:ss, Millisekunden werden ignoriert | |||
|- | |||
| @ || Zeitstempel || JJJJ-MM-TT hh:nn:ss, Millisekunden werden ignoriert | |||
|} | |||
Es werden generell keine Delimiter eingesetzt. | |||
==Abweichende Definitionen== | ==Abweichende Definitionen== | ||