Schnittstellenleitfaden: Unterschied zwischen den Versionen

Aus FAKTURA-X Wiki
Zur Navigation springen Zur Suche springen
(Die Seite wurde neu angelegt: „* '''für den Stammdatenexport an externe Webshop-Systeme''' * '''für den Auftragsimport aus externen Webshop-Systemen''' ''Stand Dezember 2021'' =Vorbemerk…“)
 
Zeile 34: Zeile 34:


===Feldbeschreibungen Datei "Kunden.csv“===
===Feldbeschreibungen Datei "Kunden.csv“===
//->
 
<!--//////////    Tabelle ANFANG      //////////-->
<!--//////////    Tabelle ANFANG      //////////-->
{| class="wikitable"
{| class="wikitable"
|-
|-
! Feld!! Typ!! Information
! Feld !! Typ !! Information
|-
|-
KDNr || A20 (eingeschränkter Zeichensatz) || Eindeutige Identnummer
KDNr || A20 (eingeschränkter Zeichensatz) || Eindeutige Identnummer
|}
 
|-
|-
Anrede A10 Anrede, optional
Anrede | A10 | Anrede, optional
|-
|-
Vorname A80 Vorname, optional
Vorname | A80 | Vorname, optional
|-
|-
Name/Firma A80 Firmenname oder Name
Name/Firma | A80 | Firmenname oder Name
|-
|-
Zusatz A80 optional Abteilung etc.
Zusatz | A80 | optional Abteilung etc.
|-
|-
Strasse A20 Straße mit Hausnummer
Strasse | A20 | Straße mit Hausnummer
|-
|-
PLZ A5 ohne Nationalitätskennzeichen
PLZ A5 ohne Nationalitätskennzeichen

Version vom 23. Dezember 2021, 14:06 Uhr

  • für den Stammdatenexport an externe Webshop-Systeme
  • für den Auftragsimport aus externen Webshop-Systemen

Stand Dezember 2021

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.

Formate

Neben den branchenspezifischen Schnittstellen (KOLLEX; OctopusOrder, Refill, Gastivo) unterstützt FAKTURA-X auch algemeine EDI Formate.

Informationen dazu erhalten Sie vom Hersteller

Abweichende Definitionen

Sollte eine Anforderung mit diesem Leitfaden nicht abgedeckt werden können, sprechen Sie uns bitte an.

Eine Anpassung oder Erweiterung ist nach Absprache kostenpflichtig möglich.

Bereitstellung von Daten

Im einfachsten Fall werden Stammdaten als CSV-Daten bereitgestellt und auf einen FTP-Server übertragen. Die Auftragsdaten werden als XML-Dateien von einem FTP-Server herutergeladen und verarbeitet. Das Abrufen und Verarbeiten der Aufträge kann automnatisch oder manuell erfolgen.

  • Informationen für die Auftragsverarbeitung finden Sie hier.
  • Die Einstellungen für für den Datenaustausch mit WEBDRINK finden Sie hier.
  • Die Einstellungen für für den Datenaustausch mit Shopware oder Magento u.ä. finden Sie hier.

Stammdatenexport als CSV

Folgende Standards werden voreingestellt:

  • Daten werden durch Semikola getrennt, bereitgestellt. Jeder Datensatz wird mit einem Semikolon abgeschlossen.
  • Es werden keine Delimiter verwendet, der Typ eines Datensatzes ergibt sich aus der Reihenfolge.
  • Der Zeichensatz ist Windows 1252 (ANSI).
Eine Anpassung oder Erweiterung ist nach Absprache kostenpflichtig möglich.

Feldbeschreibungen Datei "Kunden.csv“

KDNr || A20 (eingeschränkter Zeichensatz) || Eindeutige Identnummer
Feld Typ Information

|- Anrede | A10 | Anrede, optional |- Vorname | A80 | Vorname, optional |- Name/Firma | A80 | Firmenname oder Name |- Zusatz | A80 | optional Abteilung etc. |- Strasse | A20 | Straße mit Hausnummer |- PLZ A5 ohne Nationalitätskennzeichen |- Ort A80 Ort |- Telefon A20 Telefon 1, optional |- Mobil A20 Telefon 2, optional |- Email A255 Mehrfacheinträge mit „,“ getrennt |- StNr A40 StNr. oder USt.ID, optional |- BIC A10 ohne Leerzeichen, optional |- IBAN A30 Darf Leerzeichen enthalten, optional |- Bar L [FALSCH, WAHR] Kunde muss bei Lieferung zahlen |- Gewerbe L [FALSCH, WAHR] Gewerbe oder Privatkunde |- Limit N [-1, 0, n] -1 = gesperrt, 0 = kein Limit |- Preisgruppe I [1-n] Preisgruppenliste |-

|}

Optional: Feldbeschreibungen Datei "Lieferadressen.csv“

//->

Feldbeschreibungen Datei "Artikel.csv“

//->

Optional: Feldbeschreibungen Datei "Favoriten.csv“

//->

Optional: Feldbeschreibungen Datei "Sonderpreise.csv“

//->

Auftragsimport als XML

//->

Entität "Order"

//->

Entität "Article"

//->

Entität "DeliveryDetails"

//->

Entität "Customer"

//->

Entität "DeliveryAddress"

//->

Entität "BankDetails"

//->

Beispieldateien

//->