Tags
Header
Die XML Datei muss mit dieser Kopfinformation beginnen.Die Datei muss in Latin-1 codiert sein, damit die Daten richtig in die Datenbank übernommen werden und die Wawi sie korrekt darstellen kann.
tBestellungen
Unter der Header - Zeile befindet sich der Tag <tBestellungen>, welcher beliebig viele Bestellungen zum Import bereitstellen kann.tBestellung
Der Tag <tBestellung> enthält alle Tags die für den Import einer Bestellung verwendet werden. Zusätzlich stellt er Attribute bereit, über welchen der Import individuell gesteuert werden kann. Zum Beispiel kann hier definiert werden, ob ein Lieferschein erstellt oder gedruckt werden soll.Attribute
Folgende Attribute müssen/können im Tag <tBestellung> für den Import angegeben werden:- nRechnungErstellen: Gibt an ob eine Rechnung zum importierten Auftrag erstellt werden soll.
- nRechnungDrucken: Gibt an ob die erstelle Rechnung gedruckt werden soll (Erfordert: nRechnungErstellen = “1”)
- kRechnungsFormular: Gibt die Druckvorlage zum Druck der Rechnung an (Tabelle: tFormular Feld: kFormular vom nTyp = 2)
- nLieferscheinErstellen: Gibt an ob ein Lieferschein zum importieren Auftrag erstellt werden soll.->Achtung: Detailinformationen dazu werden unter den Auftragspositionen angegeben.
- nLieferscheinDrucken: Gibt an ob der erstellte Lieferschein gedruckt werden soll. (Erfordert: nLieferscheinErstellen = “1”)
- kLieferscheinFormular: Gibt die Druckvorlage zum Druck des Lieferscheins an (Tabelle: tFormular Feld: kFormular vom nTyp = 3)
- nAuftragDrucken: Gibt an ob der erstellte Lieferschein gedruckt werden soll.
- kAuftragsFormular: Gibt die Druckvorlage zum Druck des Lieferscheins an (Tabelle: tFormular Feld: kFormular vom nTyp = 1)
- kFirma: Gibt die Firma an, welche zum Auftrag hinterlegt werden soll (Tabelle: tfirma Feld: kFirma)
- tKunde_kKunde: Gibt den Kunden an, für welchen der Auftrag erstellt wird (Tabelle: tkunde Feld: kKunde) ->Achtung: Der Kunde muss in der Datenbank, in welche die XML importiert wird, vorhanden sein.
Tags
Innerhalb des Tags <tBestellung> werden die Informationen zur Bestellung hinterlegt, die übertragen werden sollen. Dies beinhaltet zum Einen Informationen, die direkt für den Auftrag erforderlich sind und zum Anderen Auflistungen der Positionen und Zahlungen. Des Weiteren werden hier die Lieferadresse und Zahlungsinformationen hinterlegt. Im Folgenden werden die Tags beschrieben, die unmittelbar in die Erzeugung eines Auftrags einfließen.- kSprache: Enthält einen Verweis auf die Sprache des Auftrags (Tabelle: tSprachen Feld: kSprache)
- cWaehrung: Währung wird hier als Text hinterlegt (im Beispiel: ‘EUR’)
- cBestellNr: Enthält die Bestellnummer. Sie wird automatisch über den Nummernkreis der Wawi ermittelt, sofern hier keine Bestellnummer angegeben wird.
- cInetBestellNr: Enthält eine von der Wawi abweichende Bestellnummer. z.B. die Nummer eines Kassenbons.
- tVersandArt_kVersandArt: Enthält einen Verweis auf die Versandart, mit welcher der Auftrag ausgeliefert wird. (Tabelle: tversandart Feld: kSprache) Versandarten können in den Wawi Statistiken individuell ausgewertet werden. Um importierte Aufträge auszuwerten empfiehlt sich aber die Verwendung einer Erweiterung (siehe unten) um das Tag (z.B. 151 für LS-Pos)
- dVersandt: Enthält das Datum, an welchem die Ware versendet wurde / wird. (Format: yyyy-mm-dd oder yyyy-mm-dd hh:nn:ss)
- dLieferdatum: Enthält das voraussichtliche Lieferdatum (Format: yyyy-mm-dd oder yyyy-mm-dd hh:nn:ss).
- cAnmerkung: Enthält eine Anmerkung zu Auftrag.
- dErstellt: Enthält das Datum der Auftragserstellung. (Format: yyyy-mm-dd oder yyyy-mm-dd hh:nn:ss)
- cBeschreibung: (K)Kurz- oder (L)Langbeschreibung des Artikels beim Druck.
- kZahlungsArt: Enthält einen Verweis auf die Zahlart, mit welcher der Auftrag bezahlt wird. (Tabelle: tZahlungsart Feld: kZahlungsart)
- nZahlungsziel: Das Zahlungsziel in Tagen.
tzahlung
Jeder Auftrag kann über beliebig viele Zahlungen bezahlt werden. Z.B. könnte ein Kunde einen Teil bar und einen anderen Teil per Überweisung bezahlen.- fBetrag: Enthält den Zahlbetrag.
- nAnzahlung: Gibt an ob es sich um eine Anzahlung handelt (“1” = Ja und “0” = Nein).
- kZahlungsart: Enthält einen Verweis auf die Zahlungsart. (Tabelle: tZahlungsart Feld: kZahlungsart) [ Ist die Zahlungsart nicht bekannt, kann hier einfach eine “0” eingetragen werden.]
- cZahlungsArtName: Wird in kZahlungsart “0” hinterlegt, kann hier der Name der gewünschten Zahlungsart hinterlegt werden.
- cHinweis: Hinweis zur Zahlung.
- nZahlungstyp: Zahlung = 0; Mahnung = 1; Skonto=2; Standard ist immer 0 (Zahlung)
tbestellpos
Jeder Auftrag beinhaltet beliebig viele Positionen, die im Tag <tbestellpos> einzeln definiert werden können. Hier bietet sich zusätzlich die Möglichkeit die Warenlagerausgänge zu einer Positionen anzugeben und somit den zu erstellenden (wenn gewünscht) Lieferschein zu definieren.- tArtikel_kArtikel: Beinhaltet einen Verweis auf den gewünschten Artikel und ist “0” bei Frei-Positionen (Tabelle: tartikel Feld: kArtikel).
- cArtNr: Beinhaltet die gewünschte Artikelnummer, die auf der Bestellung gedruckt werden soll (Im Normalfall ).
- fVKNetto: Beinhaltet den Netto-Verkaufspreis (pro Einheit) der Position. Der Brutto-Verkaufspreis ermittelt sich automatisch.
- fMwSt: Beinhaltet die Mehrwertsteuer in % (z.B. ‘19.00’ für 19 % MwSt).
- nAnzahl: Beinhaltet die Menge der Position.
- nType: Beinhaltet den Typ der Position (0 = Freiposition 1 = Artikel 2 = Versand). Freiposition können z.B. von Kassensystem genutzt werden um Freitextpositionen zu erzeugen. Achtung: Hier wird immer Menge und Preis mit 0 gedruckt.
- fRabatt: Beinhaltet einen Rabatt auf die Position (wird automatisch vom VK abgezogen!).
- fEKNetto: Beinhaltet den Netto-Einkaufspreis, sollte für die Statistik gepflegt werden. (Tabelle: tArtikel Feld: fEKNetto)
tbestelleigenschaft
Ein Tag <tbestellpos> kann beliebig viele Tags <tbestelleigenschaft> abbilden. Diese beinhalten jeweils einen Verweis auf eine kEigenschaftwert (entspricht einer Variation) (Tabelle: teigenschaftwert Feld: kEigenschaftWert)- kEigenschaftWert: Beinhaltet einen Verweis auf die Eigenschaft eines Variationsartikels, z.B. Größe L oder Farbe gelb.
twarenlagerausgang
Eine Position innerhalb eines Auftrags kann über verschiedene Lieferungen erfüllt werden. Diese werden über die <twarenlagerausgang>-Tags innerhalb des <tbestellpos>-Tags definiert. Wenn nichts ausgebucht werden soll, dann wird das <twarenlagerausgang>/-Tag ausgelassen.-
kArtikel: Beinhaltet den auszuliefernden Artikel. Bei Stücklisten z.B. werden hier die Komponenten ausgeliefert und mit der tatsächlich ausgebuchten Menge angegeben.
Beispiel: Eine Stückliste als Position mit der Menge 2 mit 2 Komponenten (jeweils 2 Stück in Komponente) ergibt zwei Tags von twarenlagerausgang:
- Artikel Komponente 1 mit Menge 4 (<Menge der Stückliste> (2) * <Anzahl der Komponenten in der Stückliste> (2) = (4))
- Artikel Komponente 2 mit Menge 4 (<Menge der Stückliste> (2) * <Anzahl der Komponenten in der Stückliste> (2) = (4))
- kWarenLagerEingang: Chargen- und MHD-Artikel werden immer einem Wareneingang zugeordnet, der den Eingang des Mindesthaltbarkeitsdatums-, bzw. der Charge definiert. Dazu kann der entsprechende Wert aus dem Feld kWarenLagerEingang aus der Tabelle tWarenLagerEingang mit der gewünschten Chargennummer, bzw. dem gewünschten MHD referenziert werden.
- kWarenLagerPlatz: Enthält den WarenLagerPlatz, von welchem die Ware geliefert wird. (Tabelle: tWarenLagerPlatz Feld: kWarenLagerPlatz) Das entsprechende WarenLager befindet sich in der Tabelle tWarenlager.
- fAnzahl: Gibt die Anzahl des Warenlagerausgangs an (Bei Seriennummernartikeln z.B. immer 1 pro Seriennummer).
- kLagerArtikel: Bei der Auslieferung von Seriennummern-Artikeln muss der entsprechende Lagerartikel angegeben werden, der die gewünschte Seriennummer enhält.
- In Zukunft wird es eine Prüfung geben, damit die Bestände nicht mehr so schnell zerstört werden können. Aktuell wird überprüft, ob genügend Bestand vorhanden ist.