ExpoWin XML-Importschnittstellenbeschreibung Version 4.1 FineSolutions AG Culmannstrasse 37 CH-8006 Zürich Telefon +41 44 245 85 85 Telefax +41 44 245 85 95 www.finesolutions.ch FineSolutions ExpoWin XML-Importschnittstellenbeschreibung Anpassungen: Dok.Version 1.0 SchemaVersion ExpoWinVersion 4.0 Geändert Geprüft von von Gau Datum Bemerkungen 15.10.2010 Erstausgabe 1.1 1.0 4.0 Gau 04.11.2010 1.2 1.0 4.0 Gau 08.11.2010 1.3 1.1 4.1 Gau 28.03.2011 1.4 1.2 4.1 Fap 25.04.2012 Ergänzung mit den Speditionsauftragsdaten und einem Beispiel. Fehlende Angaben unter Abschnitt „VerpackungsPositionsbezug“ ergänzt. Ergänzung mit den benutzerdefinierten Zusatzfeldern auf Kopfebene. postalCode auf 10 Zeichen erweitert printed : 24.07.12 last saved : 24.07.12 Seite: 2 von 27 XML_Importschnittstellenbeschreibung_v41_1_4.doc FineSolutions ExpoWin XML-Importschnittstellenbeschreibung Inhaltsverzeichnis 1 EINLEITUNG ......................................................................................................................................................... 4 2 AUFBAU ................................................................................................................................................................ 5 3 4 2.1 NAMENSGEBUNG DER XML-DATEI .................................................................................................................... 5 2.2 DOKUMENT-GRUNDSTRUKTUR .......................................................................................................................... 5 DATENKATALOG................................................................................................................................................. 6 3.1 PLAUSIBILISIERUNG .......................................................................................................................................... 6 3.2 DATENFORMATE ............................................................................................................................................... 6 3.3 BESCHREIBUNG DER ELEMENT-INDIKATOREN .................................................................................................... 6 3.4 ELEMENTBESCHREIBUNG KOPFDATEN ............................................................................................................... 7 3.5 ELEMENTBESCHREIBUNG BENUTZERDEFINIERTE ZUSATZFELDER...................................................................... 14 3.6 ELEMENTBESCHREIBUNG POSITIONSDATEN ..................................................................................................... 15 3.7 ELEMENTBESCHREIBUNG VERPACKUNGSDATEN............................................................................................... 20 3.8 ELEMENTBESCHREIBUNG VERPACKUNGS-POSITIONSBEZUG ............................................................................. 20 3.9 ELEMENTBESCHREIBUNG SPEDITIONSAUFTRAGSDATEN ................................................................................... 22 BEISPIEL EINER XML-DATEI............................................................................................................................ 25 printed : 24.07.12 last saved : 24.07.12 Seite: 3 von 27 XML_Importschnittstellenbeschreibung_v41_1_4.doc FineSolutions ExpoWin XML-Importschnittstellenbeschreibung 1 Einleitung Der Import von Auftrags- und Verpackungsdaten aus einem übergeordneten ERP-System ins ExpoWin wird über Dateien im XML-Format abgewickelt. Die Datei kann mehrere ERP-Aufträge (Fakturen) beinhalten. Die importierten Daten können durch Daten aus den in ExpoWin gepflegten Stammdaten ergänzt werden. Dieses Dokument beschreibt die Struktur und das Format der Import-Datei und die Regeln, die während des Einlesens der Daten berücksichtigt werden. printed : 24.07.12 last saved : 24.07.12 Seite: 4 von 27 XML_Importschnittstellenbeschreibung_v41_1_4.doc FineSolutions ExpoWin XML-Importschnittstellenbeschreibung 2 Aufbau 2.1 Namensgebung der XML-Datei Es kann ein beliebiger Dateiname verwendet werden. Die Dateiendung muss aber .xml sein. Für eine Zuordnung der Datei zum ERP-Auftrag und für die Rückverfolgbarkeit (Sicherung), ist es sinnvoll, einen möglichst aussagekräftigen Dateinamen zu verwenden (z.B. die Rechnungsnummer). 2.2 Dokument-Grundstruktur Es ist keine Dokument-Typ Definition (DTD) erforderlich. Die Gross/Kleinschreibweise der XML-Tags muss beachtet werden (case sensitive). Die grundsätzliche Struktur des XML-Dokumentes sieht folgendermassen aus: erpDocuments erpDocument Startknoten Hauptknoten pro ERP-Auftrag orderHeader Unterknoten von erpDocument. Enthält die Kopf.- und Adressdaten des ERP-Auftrages. orderHeaderCustFields Unterknoten von erpDocument. Enthält die benutzerdefinierten Zusatzdaten des ERP-Auftrages. orderItems Unterknoten von erpDocument. Hauptknoten für sämtliche Positionen innerhalb dem ERP-Auftrag. orderItem orderPackages orderPackage orderPackageItems orderPackageItem dispatchingOrder printed : 24.07.12 last saved : 24.07.12 Unterknoten von orderItems. Enthält die Detaildaten der Position. Dieser Knoten ist einmal pro Position vorhanden. Unterknoten von erpDocument. Hauptknoten für sämtliche Verpackungen innerhalb des ERP-Auftrages. Unterknoten von orderPackages. Enthält alle Verpackungsdaten innerhalb einer Verpackung. Unterknoten von erpDocument. Hauptknoten für den Bezug der Position zur Verpackung. Der Knoten ist nur vorhanden, wenn die Positionen verpackt sind. Unterknoten von orderPackageItems. Enthält die Bezugsdaten der Position zur Verpackung. Unterknoten von erpDocument. Enthält die Daten für den Speditionsauftrag. Seite: 5 von 27 XML_Importschnittstellenbeschreibung_v41_1_4.doc FineSolutions ExpoWin XML-Importschnittstellenbeschreibung 3 Datenkatalog 3.1 Plausibilisierung Beim Einlesen der Daten führt ExpoWin eine interne Plausibilisierung durch. Nach erfolgter Plausibilisierung wird dem Benutzer angezeigt, ob er die Ausfuhrzollanmeldung für den eingelesenen Auftrag ohne Überarbeitung vornehmen kann. Dazu müssen alle Muss-Felder entsprechend eingelesen bzw. automatisch durch die ExpoWinStammdaten ergänzt worden sein. Die Muss-Felder sind in der separaten Dokumentation „Schnittstellenbeschreibung e-dec Mussfelder mit ExpoWin“ beschrieben. 3.2 Datenformate ax a..x anx an..x nx n..x n..xx.x date time Nur Buchstaben mit einer fixen Länge x Nur Buchstaben mit einer max. Länge x Alphanumerische Zeichen mit einer fixen Länge x Alphanumerische Zeichen mit einer max. Länge x Ziffern mit einer fixen Länge x Ziffern mit einer max. Länge x Ziffern mit einer max. Länge x und Anzahl Dezimalstellen Datumsformat yyyy-MM-dd Zeitformat hhhh:mm:ss 3.3 Beschreibung der Element-Indikatoren Indikator „Ohne“ ? + * Beschreibung Element muss einmal vorkommen Die Verwendung dieses Indikators besagt, dass das Element null oder einmal vorkommen darf. Dieser Indikator besagt, dass das Element verwendet werden muss. Es muss mindestens einmal vorkommen, darf aber auch öfter vorkommen. Hier darf das Element mehrfach, einfach oder gar nicht vorkommen. Hinweis: Optionale Elemente ohne Inhalt dürfen im XML-Dokument nicht vorkommen. printed : 24.07.12 last saved : 24.07.12 Seite: 6 von 27 XML_Importschnittstellenbeschreibung_v41_1_4.doc FineSolutions ExpoWin XML-Importschnittstellenbeschreibung 3.4 Elementbeschreibung Kopfdaten Feld ERP-Auftrag Kopfdaten Mandantennummer XML-Element erpDocument orderHeader clientNumber Rechnungsnummer Rechnungsdatum Ind. + Format ? an..3 invoiceNumber invoiceDate ? an..35 date Auftragsnummer Bestellnummer des Kunden Lieferscheinnummer orderNumber purchaseOrderNumber ? ? an..35 an..35 deliveryNumber ? an..35 Rechnungsadresse Adressen-Nr (Kunden-Nr) Name 1 (Anschrift 1) Name 2 (Anschrift 2) Name 3 Name 4 Strasse 1 (Anschr. 3) Strasse 2 Postleitzahl Ort (Anschrift 4) ISO-Ländercode Telefon Telefax Mail USt.Id-Nr. EORI-Nr. Warenempf.-Adresse Adressen-Nr (Kunden-Nr) Name 1 (Anschrift 1) Name 2 (Anschrift 2) Name 3 Name 4 Strasse 1 (Anschr. 3) invoiceReceiver addressNumber ? ? an..17 name1 name2 name3 name4 street1 street2 postalCode city country phone telefax email valueAddedTaxIdentNumber eoriNumber goodsReceiver addressNumber ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? an..35 an..35 an..35 an..35 an..35 an..35 an..10 an..35 a2 an..25 an..25 an..80 an..15 an..17 name1 name2 name3 name4 street1 ? ? ? ? ? an..35 an..35 an..35 an..35 an..35 printed: 24.07.12 last saved: 24.07.12 Element/Attribut-Werte Bemerkungen Knoten der einzelnen Aufträge Knoten der Auftragskopfdaten Wenn kein Mandant eingelesen wird, wird der System-Mandant übernommen. Format: yyyy-mm-dd. Wenn kein Rechnungsdatum vorhanden ist, wird das Systemdatum verwendet Knoten Rechnungsempfänger ISO-Land, PLZ, Ort Knoten Warenempfänger an..17 Seite: 7 von 27 J:\Einführung_Expowin\Schnittstellenbeschreibung\XMLImport\Beschreibung\V1.4\XML_Importschnittstellenbeschreibung_v41_1_4.doc FineSolutions ExpoWin XML-Importschnittstellenbeschreibung Feld Strasse 2 Postleitzahl Ort (Anschrift 4) ISO-Ländercode Telefon Telefax Mail USt.Id-Nr EORI-Nr. Spediteur Adressen-Nr (Kunden-Nr) Name 1 Name 2 Name 3 Name 4 Strasse 1 Strasse 2 Postleitzahl Ort ISO-Ländercode Telefon Telefax Mail EORI-Nr. Korrespondenzadr. Adressen-Nr (Kunden-Nr) Name 1 Name 2 Name 3 Name 4 Strasse 1 Strasse 2 Postleitzahl Ort ISO-Ländercode Telefon Telefax Mail printed: 24.07.12 last saved: 24.07.12 XML-Element street2 postalCode city country phone telefax email valueAddedTaxIdentNumber eoriNumber carrier addressNumber Ind. ? ? ? ? ? ? ? ? ? ? ? Format an..35 an..10 an..35 a2 an..25 an..25 an..80 an..15 an..17 Element/Attribut-Werte Bemerkungen ISO-Land, PLZ, Ort Knoten Spediteur an..17 name1 name2 name3 name4 street1 street2 postalCode city country phone telefax email eoriNumber correspondence addressNumber ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? an..35 an..35 an..35 an..35 an..35 an..35 an..10 an..35 a2 an..25 an..25 an..80 an..17 name1 name2 name3 name4 street1 street2 postalCode city country phone telefax email ? ? ? ? ? ? ? ? ? ? ? ? an..35 an..35 an..35 an..35 an..35 an..35 an..10 an..35 a2 an..25 an..25 an..80 ISO-Land, PLZ, Ort Knoten Korrespondenzadresse an..17 ISO-Land, PLZ, Ort Seite: 8 von 27 J:\Einführung_Expowin\Schnittstellenbeschreibung\XMLImport\Beschreibung\V1.4\XML_Importschnittstellenbeschreibung_v41_1_4.doc FineSolutions ExpoWin XML-Importschnittstellenbeschreibung Feld Notifyadresse XML-Element notify Ind. * Format Adressen-Nr (Kunden-Nr) Name 1 Name 2 Name 3 Name 4 Strasse 1 Strasse 2 Postleitzahl Ort ISO-Ländercode Telefon Telefax Mail Bestimmungsland ISO-Code Incoterm Code Ortsangabe Beschreibung Sprachcode Mehrsprachigkeit Versandart Interne Bezeichnung: Code addressNumber ? an..17 name1 name2 name3 name4 street1 street2 postalCode city country phone telefax email deliveryDestination ? ? ? ? ? ? ? ? ? ? ? ? ? an..35 an..35 an..35 an..35 an..35 an..35 an..10 an..35 a2 an..25 an..25 an..80 a2 incoterm code location text language ? ? ? ? an..3 an..80 an..50 a2 dispatchType dispatchInternalCode ? ? an..50 an..5 Element/Attribut-Werte Bemerkungen Knoten Notifyadresse Es sind bis zu vier Notify-Adressen möglich ISO-Land, PLZ, Ort Knoten Incoterm EXW, FCA etc. Sprachcodes DE, FR, EN etc Voreinstellung= DE LKW, Luftfracht etc. Kann geliefert werden wenn eine automatische Nachbearbeitung über die ExpoWin-Stammdaten erwünscht wird. Beispiel: Wenn das vorgelagerte System einen Teil der Versandangaben wie Verkehrszweig, Zoll stelle und Immatrikulationsland LKW nicht pflegt, können diese im ExpoWin definiert werden. Dabei kann das vorgelagerte System ein Referenzcode übergeben damit ExpoWin die restlichen Versandangaben übernehmen und anzeigen kann. Interne Bezeichnung: Text Zahlungsbedingung Sachbearbeiter Kürzel (Zeichen) Name Fremdwährung printed: 24.07.12 last saved: 24.07.12 dispatchInternalText ? an..50 paymentTerm advisor token name foreignCurrency ? ? an..150 ? ? Knoten Sachbearbeiter an..10 an..50 Knoten Fremdwährung Seite: 9 von 27 J:\Einführung_Expowin\Schnittstellenbeschreibung\XMLImport\Beschreibung\V1.4\XML_Importschnittstellenbeschreibung_v41_1_4.doc FineSolutions ExpoWin XML-Importschnittstellenbeschreibung Feld Fremdwährung (ISO) Reziproker Umrechnungskurs XML-Element code exchangeRate Kursdimension Frachtkosten in Landeswährung in Fremdwährung Verpackungskosten in Landeswährung in Fremdwährung Versich.-kosten in Landeswährung in Fremdwährung Zollkosten in Landeswährung in Fremdwährung Sonstige Kosten in Landeswährung in Fremdwährung Mehrwertsteuer Betrag Prozent Lagerort Geschäftsbereich-ID Auftragsart Markierung Reihenfolge Text e-dec Meldung Versender Referenz rateDimension freightCosts valueLocalCurrency valueForeignCurrency packingCosts valueLocalCurrency valueForeignCurrency insuranceCosts valueLocalCurrency valueForeignCurrency customsCosts valueLocalCurrency valueForeignCurrency otherCosts valueLocalCurrency valuetForeignCurrency addedValueTax value percent storageLocation businessAreaCode orderType mark sequenceNumber text edecMessage consignorReference ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? * ? ? an..35 Dossier-Nr. Spediteur Anmeldungs-Nr. Anmeldezeitpunkt traderReference ? an..35 declarationNumber declarationTime ? ? an..22 n..2 Anmeldungstyp Begründung declarationType reason ? ? n..2 an..5 printed: 24.07.12 last saved: 24.07.12 Ind. ? Format a3 n..20 Element/Attribut-Werte Bemerkungen 1/Kurs muss übergeben werden, wenn Rechnungsbetrag LW und FW übergeben werden und Sammelaufträge erstellt werden. Voreinstellung= 1 Knoten Frachtkosten n..10 n..20 n..20 Knoten Verpackungskosten n..20 n..20 Knoten Versicherungskosten n..20 n..20 Knoten Zollkosten n..20 n..20 Knoten Sonstige Kosten n..20 n..20 Knoten Mehrwertsteuer n..20 n..20 an..35 an..10 an..3 Nur für statistische Zwecke Nur für statistische Zwecke n..10 an..100 Bis max. 100 Elemente Knoten für e-dec spezifische Felder Wird als Referenzfeld auf der e-dec Ausfuhrliste beim Versender angedruckt. Entspricht der Rechnungsnummer. Wird als Referenzfeld auf der e-dec Ausfuhrliste beim Spediteur angedruckt. 1 2 3 5 1 Gestellung Voranmeldung Nachträgliche Anmeldung Vorausanmeldung für Zulad (ZV) Definitiv Voreinstellung= 1 Voreinstellung= 1 Dieses Feld ist für einen Freipass vorgesehen. Seite: 10 von 27 J:\Einführung_Expowin\Schnittstellenbeschreibung\XMLImport\Beschreibung\V1.4\XML_Importschnittstellenbeschreibung_v41_1_4.doc FineSolutions ExpoWin XML-Importschnittstellenbeschreibung Feld Verkehrszweig Immatrik.-Land LKW Beförderungsmittel Kennzeichen Besondere Vermerke Reihenfolge Text Sprachcode für e-dec Ausfuhrliste XML-Element transportMode Ind. ? transportationCountry transportationNumber ? ? specialMention * sequenceNumber text language ? Zusammengefasste Meldung Mandant USt-ID Nr Dreiecksgeschäft zmMessage ? IntraStat-Meldung Steuer-Nr Intrast. Steuer-Nr Zusatz Geschäftsart-Code intraStatMessage clientValueAddedTaxIdentNo Format n1 a2 an..27 Dieser Sprachcode gibt die Sprache der Ausfuhrliste an. (DE, FR, IT, EN) Voreinstellung= DE Knoten Zusammengef. Meldung 0 1 Nein Ja Voreinstellung= 0 ? Knoten IntraStat-Meldung an..11 an..3 taxIdentNumber taxIdentNumberAddition ? an..5 procedureCode ? an..7 DE-Zollantrag requestOfDuty ? n1 Kopfzeilen headerText * Reihenfolge Text Fusszeilen sequenceNumber text footerText Reihenfolge Text Zusatztexte sequenceNumber text additionalTexts printed: 24.07.12 last saved: 24.07.12 e-dec Pflichtfeld bei Verkehrszweig 3 = Strasse n..10 an..70 a2 businessTypeCode Verfahren-Code Bemerkungen Knoten Bes. Vermerke Bis max. 99 Elemente an..15 an..1 triangulation Element/Attribut-Werte 2 Bahn 3 Strasse 4 Luft 5 Post 7 Pipeline 8 Schiff 9 Eigener Antrieb Mögliche Werte für DE-Anmeldung siehe Anhang 1 Mögliche Werte für DE-Anmeldung siehe Anhang 2 0 Nein 1 Ja Knoten für Kopfzeilentext Bis max. 500 Elemente n..10 an..100 * Knoten für Fusszeilentext Bis max. 500 Elemente n..10 an..100 ? Knoten für Zusatztext 1-10 Seite: 11 von 27 J:\Einführung_Expowin\Schnittstellenbeschreibung\XMLImport\Beschreibung\V1.4\XML_Importschnittstellenbeschreibung_v41_1_4.doc FineSolutions ExpoWin XML-Importschnittstellenbeschreibung Feld Zusatztext 1 Reihenfolge Text Zusatztext 2 Reihenfolge Text Zusatztext 3 Reihenfolge Text Zusatztext 4 Reihenfolge Text Zusatztext 5 Reihenfolge Text Zusatztext 6 Reihenfolge Text Zusatztext 7 Reihenfolge Text Zusatztext 8 Reihenfolge Text Zusatztext 9 printed: 24.07.12 last saved: 24.07.12 XML-Element additionalText1 title additionalText sequenceNumber text additionalText2 title additionalText sequenceNumber text additionalText3 title additionalText sequenceNumber text additionalText4 title additionalText sequenceNumber text additionalText5 title additionalText sequenceNumber text additionalText6 title additionalText sequenceNumber text additionalText7 title additionalText sequenceNumber text additionalText8 title additionalText sequenceNumber text additionalText9 Ind. ? Format Element/Attribut-Werte Bemerkungen Knoten für Zusatztext 1 an..100 * Bis max. 500 Elemente n..10 an..100 ? Knoten für Zusatztext 2 an..100 * Bis max. 500 Elemente n..10 an..100 ? Knoten für Zusatztext 3 an..100 * Bis max. 500 Elemente n..10 an..100 ? Knoten für Zusatztext 4 an..100 * Bis max. 500 Elemente n..10 an..100 ? Knoten für Zusatztext 5 an..100 * Bis max. 500 Elemente n..10 an..100 ? Knoten für Zusatztext 6 an..100 * Bis max. 500 Elemente n..10 an..100 ? Knoten für Zusatztext 7 an..100 * Bis max. 500 Elemente n..10 an..100 ? Knoten für Zusatztext 8 an..100 * Bis max. 500 Elemente n..10 an..100 ? Knoten für Zusatztext 9 Seite: 12 von 27 J:\Einführung_Expowin\Schnittstellenbeschreibung\XMLImport\Beschreibung\V1.4\XML_Importschnittstellenbeschreibung_v41_1_4.doc FineSolutions ExpoWin XML-Importschnittstellenbeschreibung Feld Reihenfolge Text Zusatztext 10 Reihenfolge Text Akkreditivtext Reihenfolge Text Versandinstruktion Auftrag Instruktions-ID Reihenfolge Text Versandinstruktion Sendung Instruktions-ID Reihenfolge Text printed: 24.07.12 last saved: 24.07.12 XML-Element title additionalText sequenceNumber text additionalText10 title additionalText sequenceNumber text letterOfCreditText sequenceNumber text shippingInstrOrder instructionNumber shippingInstruction sequenceNumber text shippingInstrDelivery instructionNumber shippingInstruction sequenceNumber text Ind. Format an..100 * Element/Attribut-Werte Bemerkungen Bis max. 500 Elemente n..10 an..100 ? Knoten für Zusatztext 10 an..100 * Bis max. 500 Elemente n..10 an..100 * Knoten für Akkreditivtext Bis max. 1000 Elemente n..10 an..100 * n..10 * Knoten für Versandinstruktionen auf Auftragsebene Bis max. 99 Elemente Bis max. 500 Elemente n..10 an..100 * n..10 * Knoten für Versandinstruktionen auf Sendungsebene Bis max. 99 Elemente Bis max. 500 Elemente n..10 an..100 Seite: 13 von 27 J:\Einführung_Expowin\Schnittstellenbeschreibung\XMLImport\Beschreibung\V1.4\XML_Importschnittstellenbeschreibung_v41_1_4.doc FineSolutions ExpoWin XML-Importschnittstellenbeschreibung 3.5 Elementbeschreibung Benutzerdefinierte Zusatzfelder Feld ERP-Auftrag Kopfdaten ID Textfelder 1-40 Num. Felder 1-20 Datumsfelder 1-10 printed: 24.07.12 last saved: 24.07.12 XML-Element erpDocument orderHeaderCustFields CustID sCustField1 … sCustField40 nCustField1…nCustField20 dCustField1…dCustField10 Ind. ? Format ? ? ? ? an..20 an..250 n..20 date Element/Attribut-Werte Bemerkungen Knoten der einzelnen Aufträge Knoten der benutzerdefinierten Zusatzkopfdaten ID welcher den Inhalt der benutzerdefinierten Felder beschreibt. Benutzerdefinierte Textfelder 1- 40. Benutzerdefinierte numerische Felder 1- 20. Benutzerdefinierte Datumsfelder 1-10. Seite: 14 von 27 J:\Einführung_Expowin\Schnittstellenbeschreibung\XMLImport\Beschreibung\V1.4\XML_Importschnittstellenbeschreibung_v41_1_4.doc FineSolutions ExpoWin XML-Importschnittstellenbeschreibung 3.6 Elementbeschreibung Positionsdaten Feld Knoten aller Positionen Positionsknoten Positions-Nr Artikel-Nr Artikelbezeichnung 1 Artikelbezeichnung 2 Artikelbezeichnung 3 Artikelbezeichnung 4 Artikelbezeichnung 5 Warenursprung Positionsmenge Masseinheit Mengeneinheit Einzelnettogewicht Eigenmasse (kg) Einzelpreis in Landeswährung Positionspreis in Landeswährung Einzelpreis in Fremdwährung Positionspreis in Fremdwährung Zolltarif-Nr Statistischer Schlüssel Warenbezeichnung 1 Warenbezeichnung 2 Warenbezeichnung 3 Seriennummer Gerätenummer Chargennummer ECCN-Nr. EKN-Nr. Präferenzberechtigt printed: 24.07.12 last saved: 24.07.12 XML-Element orderItems Ind. ? Format orderItem id number description1 description2 description3 description4 description5 origin quantity measure quantityUnit singleNetMass netMass singleValueLocalCurr + ? ? ? ? ? ? ? ? ? ? ? ? ? n..10 an..35 an..35 an..35 an..35 an..35 an..35 a2 n..20 an..10 n..20 n..20 n..20 n..20 valueLocalCurr ? n..20 singleValueForeignCurr ? n..20 valueForeignCurr ? n..20 tariffNumber statisticalCode ? ? n..8 n..3 tariffDescription1 tariffDescription2 tariffDescription3 serialNumber deviceNumber batchNumber eccnNumber eknNumber ? ? ? ? ? ? ? ? an..42 an..42 an..42 an..35 an..35 an..35 an..35 an..35 preferential ? n..1 Element/Attribut-Werte Bemerkungen ISO-Ländercode z.B. STK, KG, M etc. 1, 100, 1000 etc. Positions-Nettogewicht 0 1 nicht präferenzberechtigt präferenzberechtigt Export Control Classification Number Export Kontroll Nummer für Dual Use Güter (zivile und militärische Verwendung) Kann von ExpoWin automatisch gesetzt werden. Seite: 15 von 27 J:\Einführung_Expowin\Schnittstellenbeschreibung\XMLImport\Beschreibung\V1.4\XML_Importschnittstellenbeschreibung_v41_1_4.doc FineSolutions ExpoWin XML-Importschnittstellenbeschreibung Feld e-dec Message Veranlagungstyp XML-Element edecMessage customsClearanceType Ind. ? ? Format Element/Attribut-Werte n..2 1 2 3 4 5 6 7 Handelsware commercialGood ? n..1 Rückerstattungstyp refundType ? an..1 8 0 1 1 2 3 4 5 6 VOC Menge in kg Zusatzmenge UN-Gefahrencode Bewilligungspflicht vocQuantity additionalUnit UNDangerousGoodsCode permitObligation ? ? ? ? n..20 n..20 an..4 n..2 NZE-Pflichtcode nonCustomsLawObligation ? n..2 0 1 2 0 1 2 Bewilligungsdetails printed: 24.07.12 last saved: 24.07.12 permit * Bemerkungen Knoten für e-dec spezifische Felder Änderungen durch OZD möglich Normalabfertigung Veredelungsverkehr Reparaturverkehr Retourwaren Zollbegünstigung Tabak Zollfreie Abfertigung gem. ZG Abgabenfreie Veranlagung Nein Ja Rückerstattung der LenRückerstattung für Alkohol- oder VOC-Abgaben. Änderungen durch OZD kungsabgabe auf VOC möglich Antrag für Ausfuhrbeiträge Antrag auf Alkohol Antrag auf mindestens 2 der Rückerstattungstypen 1 bis 3 Rückerstattung Biersteuer Rückerstattung andere Nur wenn Rückerstattungstyp= 1 Für diejenigen Zolltarifnummern, welche eine Zusatzmenge benötigen 'Nicht bewilligungspflichtig Bewilligungspflichtig Bewilligungsfrei gemäss Deklarant ohne Kontrolle mit Kontrolle vor Freigabe der Ware ohne Kontrolle gemäss Deklarant NZE = Nicht Zollrechtliche Erlasse Knoten für Bewilligungsdetails. Nur nötig wenn permitObligation > 0 Bis max. 99 Elemente Seite: 16 von 27 J:\Einführung_Expowin\Schnittstellenbeschreibung\XMLImport\Beschreibung\V1.4\XML_Importschnittstellenbeschreibung_v41_1_4.doc FineSolutions ExpoWin XML-Importschnittstellenbeschreibung Feld Typ Stellencode Nummer Datum Zusätzliche Angaben NZE-Details Artencode XML-Element permitType Ind. ? Format n..2 permitAuthority ? n..2 permitNumber issueDate additionalInformation ? ? ? an..17 date an..70 nonCustomsLaw * nonCustomsLawType ? Element/Attribut-Werte Bemerkungen 1 Einzelbewilligung Änderungen durch OZD möglich 2 Generaleinfuhrbewilligung 3 Generallizenz 5 Verwendungsverpflichtung 6 Verpflichtung 7 Bewilligung zur periodischen Steueranmeldung 8 (beso) Verpflichtung Minöst 9 Nachweis Bio-Treibstoffe 10 Vorausfestsetzungsbescheinigung 99 Andere 80 Eidgenössische SteuerverÄnderungen durch OZD möglich waltung (ESTV) 96 EZV Minöst 97 EZV VOC 98 EZV Andere 99 Andere Nur für Waren die eine spezielle Bewilligung benötigen. Format: yyyy-MM-dd Knoten für NZE Details Bis max. 9 Elemente n..3 26 30 44 66 68 69 100 190 200 201 210 220 270 Reparatur-/Vered.verkehr printed: 24.07.12 last saved: 24.07.12 repairAndRefinement ? Kulturgut PIC Radioaktive Stoffe Abfälle Elektr.-Schrott Altholz Fleisch/ Fleischwaren (Veterinärrecht) Tierseuchen/ -schutz (Veterinärrecht) Artenschutz (Veterinärrecht) CITES Flora Edelmetallkontrolle Salzregal Pflanzenschutz Knoten für Reparatur- und Veredelungsverkehrs- Details Seite: 17 von 27 J:\Einführung_Expowin\Schnittstellenbeschreibung\XMLImport\Beschreibung\V1.4\XML_Importschnittstellenbeschreibung_v41_1_4.doc FineSolutions ExpoWin XML-Importschnittstellenbeschreibung Feld Verkehrsrichtung XML-Element direction Ind. ? Format n..1 Veredelungstyp refinementType ? n..1 Verfahrenstyp processType ? n..1 Abrechnungstyp billingType ? n..1 Positionstyp positionType ? n..1 temporaryAdmission ? n1 specialMention * Vorübergehende Verwendung Bes. Vermerke Reihenfolge Text IntraStat-Meldung EU Zolltarif-Nr Urspr.-Region Zusatzmenge sequenceNumber text intraStatMessage tariffNumber originRegionCode additionalUnit Gefahrengut Nr Klasse UN-Nr Bezeichnung Seitennummer Verpackungsgruppe Kennzeichen Merkblatt Unfall Merkblatt 1. Hilfe Flammpunkt Statistikdaten Produkte-Gruppe ProduktBezeichnung dangerousGoods id class unNumber description pageNumber packagingGroup indicator handoutAccident handoutFirstAid flashpoint statistic productGroup productDescription printed: 24.07.12 last saved: 24.07.12 Element/Attribut-Werte 1 aktiv (Reparatur in der Schweiz durchgeführt) 2 passiv (Reparatur wird ins Ausland gesendet) 1 Eigenveredelungsverkehr 2 Lohnveredelungsverkehr 1 Ordentliches Verfahren 2 Vereinfachtes Verfahren 3 Besonderes Verfahren 1 Nichterhebungsverfahren 2 Rückerstattungsverfahren 1 Ware, Lohn, Fracht 2 Neumaterial 3 Ware, Lohn, Neumaterial, Fracht 1 Ja 0 Nein Bemerkungen Freipass Knoten für Bes.-Vermerk Text Bis max. 69 Elemente n..10 an..100 ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? Knoten IntraStat Daten n..8 an..2 n1 0 Nein 1 Ja Knoten Gefahrengut an..11 an..7 an..4 an..254 an..28 an..32 an..20 an..40 an..36 an..84 Knoten für Statistikdaten an..10 an..35 Seite: 18 von 27 J:\Einführung_Expowin\Schnittstellenbeschreibung\XMLImport\Beschreibung\V1.4\XML_Importschnittstellenbeschreibung_v41_1_4.doc FineSolutions ExpoWin XML-Importschnittstellenbeschreibung Feld OZL: Total Best.Menge Offenes Zolllager Bestätigte Menge T2-Nummer Positionstexte Reihenfolge Text printed: 24.07.12 last saved: 24.07.12 XML-Element totalConfirmedQuantity bondedWarehouse confirmedQuantity t2Number itemTexts sequenceNumber text Ind. ? Format n..20 * Element/Attribut-Werte Bemerkungen Nur relevant wenn offenes Zolllager Knoten für OZL-Ware n..20 an..20 * n..10 an..80 Seite: 19 von 27 J:\Einführung_Expowin\Schnittstellenbeschreibung\XMLImport\Beschreibung\V1.4\XML_Importschnittstellenbeschreibung_v41_1_4.doc FineSolutions ExpoWin XML-Importschnittstellenbeschreibung 3.7 Elementbeschreibung Verpackungsdaten Feld Knoten aller Verpackungen Verpackungsknoten Verpackungs-ID VerpackungsSchlüssel Paketbezeichnung Anzahl Packstücke Länge Breite Höhe Masseinheit Bruttogewicht Tara in kg Volumen VerpackungsKategorie VerpackungsMarkierung Verpackungs-Nr. Verpackungstyp Containernummer Packstück Nr. von Packstück Nr. bis Übergeordnete Verpackungs-ID XML-Element orderPackages Ind. ? Format orderPackage id key + ? ? n..10 an..20 description quantity length width height measure grossMass tare volume ? ? ? ? ? ? ? ? ? an..55 n..10 n..5 n..5 n..5 an..2 n..20 n..20 n..20 category ? an..15 mark ? an..250 number type containerNumber numerationFrom numerationTo superiorPackageId ? ? ? ? ? ? an..30 an..3 an..11 n..10 n..10 n..10 Element/Attribut-Werte Bemerkungen Relevant, wenn auch Bezug zu den Positionen eingelesen wird. Sofern in ExpoWin-Stammdaten gepflegt, müssen die weiteren Daten nicht über die Schnittstelle geliefert werden. m, dm, cm etc Vorausgesetzt, L, B, H + Masseinheit werden geliefert, kann EW das Volumen selber errechnen Nur für statistische Zwecke Verpackungsmarkierung, nicht identisch mit Shipping Marks Zeichen (Nummer) Packstücke Eindeutige Verpackungsnummer, wie z.B. SSCC-Code Für Spediteur-Anbindungen Falls Zweitverpackung muss hier die ID der übergeordneten Verpackung geliefert werden. Die Zweitverpackung ist immer am Schluss aller beinhalteten Erstverpackungen zu definieren. (Zweitverpack-ID = MAX Erstverpack-ID + 1) 3.8 Elementbeschreibung Verpackungs-Positionsbezug Feld Knoten aller Positionsbezüge zur Verpackung printed: 24.07.12 last saved: 24.07.12 XML-Element orderPackageItems Ind. ? Format Element/Attribut-Werte Bemerkungen Knoten aller Bezugssätze Seite: 20 von 27 J:\Einführung_Expowin\Schnittstellenbeschreibung\XMLImport\Beschreibung\V1.4\XML_Importschnittstellenbeschreibung_v41_1_4.doc FineSolutions ExpoWin XML-Importschnittstellenbeschreibung Feld Positionsbezugsknoten Verpackungs-ID Positions-Nr Positionsmenge Positionsnettogewicht printed: 24.07.12 last saved: 24.07.12 XML-Element orderPackageItem packageId itemId itemQuantity itemNetMass Ind. + (?) (?) Format n..10 n..10 n..20 n..20 Element/Attribut-Werte Bemerkungen Knoten des einzelnen Bezuges Verpackung/Artikel Verpackungs-ID Gleiche Positionsnummer wie im Rechnungspositionssatz Entweder muss die Pos.-Menge oder das Pos.-Netto übergeben werden Seite: 21 von 27 J:\Einführung_Expowin\Schnittstellenbeschreibung\XMLImport\Beschreibung\V1.4\XML_Importschnittstellenbeschreibung_v41_1_4.doc FineSolutions ExpoWin XML-Importschnittstellenbeschreibung 3.9 Elementbeschreibung Speditionsauftragsdaten Feld Knoten der Speditionsauftragsdaten Abgangsstation Bestimmungsstation Eintreffdatum Flugdaten Verladedatum Abholdatum von Abholdatum bis Abholzeit von Abholzeit bis Ankunftsdatum von Ankunftsdatum bis Ankunftszeit von Ankunftszeit bis Versender-Doku Gefahrgut-Klasse Reihenfolge Text Gefahrgut-Bezeichnung Reihenfolge Text Fracht-Information Speditionskosten 1 Speditionskosten 2 Speditionskosten 3 Speditionskosten 4 Speditionskosten 5 Speditionskosten 6 Ladeadresse Adressen-Nr (Kunden-Nr) Name 1 Name 2 Name 3 Name 4 printed: 24.07.12 last saved: 24.07.12 XML-Element dispatchingOrder departureStation destinationStation arrivalDate flightInformation shipDate pickupDateFrom pickupDateTo pickupTimeFrom pickupTimeTo arrivalDateFrom arrivalDateTo arrivalTimeFrom arrivalTimeTo consignorDocuments dangerousGoodsClass sequenceNumber text dangerousGoodsDescr Ind. ? Format ? ? ? ? ? ? ? ? ? ? ? ? ? ? * an..45 an..45 date an..150 date date date time time date date time time an..250 Element/Attribut-Werte Bemerkungen Knoten für die Speditionsauftragsdaten Knoten Text Gefahrgut-Klassifikation n..10 an..100 * sequenceNumber text cargoInformation transportCost1 transportCost2 transportCost3 transportCost4 transportCost5 transportCost6 loadingAddress addressNumber ? ? ? ? ? ? ? ? ? name1 name2 name3 name4 ? ? ? ? Knoten Text Gefahrgut-Bezeichnung n..10 an..100 an..250 n..20 n..20 n..20 n..20 n..20 n..20 Knoten Ladeadresse an..17 an..35 an..35 an..35 an..35 Seite: 22 von 27 J:\Einführung_Expowin\Schnittstellenbeschreibung\XMLImport\Beschreibung\V1.4\XML_Importschnittstellenbeschreibung_v41_1_4.doc FineSolutions ExpoWin XML-Importschnittstellenbeschreibung Feld Strasse 1 Strasse 2 Postleitzahl Ort ISO-Ländercode Telefon Telefax Mail Ladeadresse Bemerkungen Bemerkung Reihenfolge Text LDL-Anb.:RE Kontaktperson LDL-Anb.: RE LDLKunden-Nr LDL-Anb.: WE Kontaktperson LDL-Anb.: WE LDLKunden-Nr printed: 24.07.12 last saved: 24.07.12 XML-Element street1 street2 postalCode city country phone telefax email loadingAddressRemarks Ind. ? ? ? ? ? ? ? ? ? Format an..35 an..35 an..10 an..35 a2 an..25 an..25 an..80 an..150 remarks sequenceNumber text invoiceReceiverContact * ? n..10 an..100 an..50 invoiceReceiverCustNumber ? an..30 goodsReceiverContact ? an..50 goodsReceiverCustNumber ? an..30 Element/Attribut-Werte Bemerkungen ISO-Land, PLZ, Ort Seite: 23 von 27 J:\Einführung_Expowin\Schnittstellenbeschreibung\XMLImport\Beschreibung\V1.4\XML_Importschnittstellenbeschreibung_v41_1_4.doc FineSolutions ExpoWin XML-Importschnittstellenbeschreibung Anhang 1: IntraStat – Geschäftsarten 11 Endgültiger Kauf/Verkauf 12 Ansichts- oder Probesendung, Sendungen mit Rückgaberecht 13 Kompensationsgeschäfte (Tauschhandel) 14 Verkauf an ausländische Reisende für deren persönlichen Bedarf 15 Finanzierungsleasing 21 Rücksendung von Waren 22 Lieferung als Ersatz für zurückgesandte Waren 23 Lieferung als Ersatz für nicht zurückgesandte Waren 31 Warenlieferung im Rahmen durch die EU ganz oder teilweise finanzierten Hilfsprogrammen 32 Andere Hilfslieferungen öffentlicher Stellen 33 Sonstige Hilfslieferungen 34 Sonstige Geschäfte ohne Gegenleistung 41 Lohnveredelung (Zur Lohnveredelung) 51 Lohnveredelung (nach Lohnveredelung) 63 Warensendungen zur Reparatur und Wartung gegen Entgelt 64 Warensendungen zur Reparatur und Wartung ohne Entgelt 65 Warensendungen nach Reparatur und Wartung gegen Entgelt 66 Warensendungen nach Reparatur und Wartung ohne Entgelt 71 Für militärische Zwecke 72 Für andere Zwecke 81 Lieferung von Baumaterial und Ausrüstung als Teil eines Generalvertrags 93 Vorübergehende Warenverkehre über 24 Monate 99 Nicht anderweitig erfasst Anhang 2: IntraStat – Verfahren 1000 Endgültige Versendung 1043 Wiederversendung nach wirtschaftl. Lohnveredelung 2200 Versendung zur wirtschaftl. Lohnveredelung printed: 24.07.12 last saved: 24.07.12 Seite: 24 von 27 J:\Einführung_Expowin\Schnittstellenbeschreibung\XMLImport\Beschreibung\V1.4\XML_Importschnittstellenbeschreibung_v41_1_4.doc FineSolutions ExpoWin XML-Importschnittstellenbeschreibung 4 Beispiel einer XML-Datei Folgendes Beispiel enthält ein Auftrag mit 2 Artikelpositionen und 1 Verpackung. Ein Bezug der Artikelpositionen zur Verpackung ist vorhanden. <?xml version="1.0" encoding="utf-8"?> <erpDocuments xmlns="http://www.expowin.ch/fscms/res//ExpoWin" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.expowin.ch/fscms/res//ExpoWin/ XML_Importschnittstellenbeschreibung_v41_1_1.xsd" schemaVersion="1.1"> <erpDocument> <orderHeader> <clientNumber>001</clientNumber> <invoiceNumber>25396</invoiceNumber> <invoiceDate>2010-08-04</invoiceDate> <orderNumber>291524</orderNumber> <purchaseOrderNumber>1100065796</purchaseOrderNumber> <deliveryNumber>65884</deliveryNumber> <invoiceReceiver> <addressNumber>195260</addressNumber> <name1>Cordoba Ibérica S.L.U.</name1> <street1>C/ Pallars 6</street1> <street2>Planta 2, Puerta 2</street2> <postalCode>08402</postalCode> <city>Granollers, Barcelona</city> <country>ES</country> <phone>93 860 33 24</phone> <valueAddedTaxIdentNumber>ESB65010266 </valueAddedTaxIdentNumber> </invoiceReceiver> <goodsReceiver> <addressNumber>195260</addressNumber> <name1>Cordoba Ibérica S.L.U.</name1> <street1>C/ Pallars 6</street1> <street2>Planta 2, Puerta 2</street2> <postalCode>08402</postalCode> <city>Granollers, Barcelona</city> <country>ES</country> <phone>93 860 33 24</phone> <valueAddedTaxIdentNumber>ESB65010266 </valueAddedTaxIdentNumber> </goodsReceiver> <carrier> <addressNumber>23490</addressNumber> <name1>Blickle Spedition</name1> <street1>Robert-Bosch-Str. 9</street1> <postalCode>73760</postalCode> <city>Ostfildern</city> <country>DE</country> <phone>0049 / 711 3416 77 90</phone> </carrier> <deliveryDestination>ES</deliveryDestination> <incoterm> <code>DDP</code> <location>Zürich</location> <text>DDP (delivery address), Incoterms 2000</text> </incoterm> <language>EN</language> <dispatchType>LKW</dispatchType> <dispatchInternalCode>EUK</dispatchInternalCode> <paymentTerm>30 days after date of the invoice, net</paymentTerm> <advisor> <token>NIM</token> printed : 24.07.12 last saved : 24.07.12 Seite: 25 von 27 XML_Importschnittstellenbeschreibung_v41_1_4.doc FineSolutions ExpoWin XML-Importschnittstellenbeschreibung </advisor> <foreignCurrency> <code>EUR</code> <exchangeRate>0.6329</exchangeRate> <rateDimension>1</rateDimension> </foreignCurrency> <freightCosts> <valueForeignCurrency>130.50</valueForeignCurrency> </freightCosts> <edecMessage> <transportMode>3</transportMode> <transportationCountry>DE</transportationCountry> <language>DE</language> </edecMessage> <footerText> <sequenceNumber>1</sequenceNumber> <text>Components will be sent together with your next shipment.No commercial value!Value only for customs</text> </footerText> <footerText> <sequenceNumber>2</sequenceNumber> <text> purposes!</text> </footerText> </orderHeader> <orderItems> <orderItem> <id>10</id> <number>Z20480C11111</number> <description1>Vorspannkonus kpl. für Bohrung</description1> <description2>D=45 mitmiSicherung, Material</description2> <origin>CH</origin> <quantity>31</quantity> <measure>PCS</measure> <quantityUnit>1</quantityUnit> <netMass>11.532</netMass> <valueForeignCurr>23448.40</valueForeignCurr> <tariffNumber>90319099</tariffNumber> <statisticalCode>999</statisticalCode> <tariffDescription1>Teile zu piezoelektrischen Messgeräten </tariffDescription1> <edecMessage> <customsClearanceType>1</customsClearanceType> <commercialGood>1</commercialGood> <permitObligation>2</permitObligation> <nonCustomsLawObligation>2</nonCustomsLawObligation> </edecMessage> </orderItem> <orderItem> <id>20</id> <number>6183AG</number> <description1>Quarz Sensor für</description1> <description2>Werkzeuginnendruck,d = 1mm</description2> <origin>DE</origin> <quantity>25</quantity> <measure>PCS</measure> <quantityUnit>1</quantityUnit> <netMass>8.35</netMass> <valueForeignCurr>23687.50</valueForeignCurr> <tariffNumber>90262000</tariffNumber> <statisticalCode>000</statisticalCode> <tariffDescription1>Druckmessgeräte</tariffDescription1> <edecMessage> <customsClearanceType>1</customsClearanceType> <commercialGood>1</commercialGood> <permitObligation>2</permitObligation> <nonCustomsLawObligation>2</nonCustomsLawObligation> printed : 24.07.12 last saved : 24.07.12 Seite: 26 von 27 XML_Importschnittstellenbeschreibung_v41_1_4.doc FineSolutions ExpoWin XML-Importschnittstellenbeschreibung </edecMessage> </orderItem> </orderItems> <orderPackages> <orderPackage> <id>1</id> <description>Karton</description> <quantity>1</quantity> <length>68</length> <width>54</width> <height>42</height> <measure>cm</measure> <grossMass>21.2</grossMass> <tare>1.318</tare> <volume>0.154</volume> <type>CT</type> </orderPackage> </orderPackages> <orderPackageItems> <orderPackageItem> <packageId>1</packageId> <itemId>10</itemId> <itemQuantity>31</itemQuantity> </orderPackageItem> <orderPackageItem> <packageId>1</packageId> <itemId>20</itemId> <itemQuantity>25</itemQuantity> </orderPackageItem> </orderPackageItems> </erpDocument> </erpDocuments> printed : 24.07.12 last saved : 24.07.12 Seite: 27 von 27 XML_Importschnittstellenbeschreibung_v41_1_4.doc