JavaScript bitte einschalten für diese Dokumentation

PlusFakt Enterprise - Online-Handbuch

Navigation: Schnittstellen > Auftragsimport

XML Auftragsimport von PlusFakt Enterprise

Themen Zurück Top Vor Menü

Inhaltsverzeichnis

PlusFakt Enterprise Auftrag-Import Format XML V1.0

Beispieldatei XML

Erläuterung zu den Feldern

Auftragskopf

Auftragskommentar

Kundendaten

Zahlungsbedingung

Bankdaten

Kundenkommentar

Daten zur Lieferanschrift

Kommentar zur Lieferanschrift

Abweichende Rechnungsdaten

Positionen

 

 

PlusFakt Enterprise Auftrag-Import Format XML V1.0

 

PlusFakt Enterprise bietet zahlreiche Möglichkeiten, Daten zu Im- und Exportieren. So auch ganz besonders standardisierte Auftragsdaten.

 

Diese Daten müssen im PlusFakt ENTERPRISE Standard-XML-Format vorliegen. Richten Sie diese bitte gemäß folgender Beispieldatei ein:

   

   

   

Beispieldatei XML

 

<?xml version="1.0" encoding="utf-8"?>

<!--PlusFakt Enterprise XML Auftragsimport-->

<bestellungen>
<plattform>ihrePlattform</plattform>

 <bestellung>

   <bestellnr>47110815</bestellnr>

   <datum>2014-01-01 08:50:43</datum>

   <typ></typ>

   <bestellung_kommentar></bestellung_kommentar>

   <kunde_anlegen>1</kunde_anlegen>

   <kundennr_extern>111222</kundennr_extern>

  <kundennr>OPTIONAL</kundenNr>

   <plusfakt_idkunde>OPTIONAL</plusfakt_idkunde>

   <anrede></anrede>

   <zuname>Muster</zuname>

   <vorname>Max</vorname>

   <firmenname>Musterfirma</firmenname>

   <strasse>Musterstr. 6</strasse>

   <adresszeile2></adresszeile2>

   <plz>54422</plz>

   <ort>Züsch</ort>

  <land>Deutschland</land>

   <tel1>0650311111</tel1>

   <tel2></tel2>

   <telmobil1></telmobil1>

   <telmobil2></telmobil2>    
   <email>muster@muster.de</email>

   <fax1>06503123123</fax1>

   <fax2></fax2>

  <ustid>Umsatzsteuer-ID</ustid>

   <iban>DE22 2222 1222 2221 6089 75</iban>

   <swift>MALADEE1DKH</swift>

   <bankname>Sparkasse</bankname>

   <kontoinhaber> Muster Max</kontoinhaber>

   <sepa_mandat>1665565410245991291</sepa_mandat>

   <sepa_datum>01.01.2014</sepa_datum>

   <sepa_zusatz></sepa_zusatz>

   <kommentar_zum_kunde>guter Kunde</kommentar_zum_kunde>

   <la_zuname>Test</la_zuname>

   <la_vorname></la_vorname>

   <la_firmenname></la_firmenname>

   <la_strasse>Teststr. 1</la_strasse>

   <la_adresszeile2></la_adresszeile2>

   <la_plz>66987</la_plz>

   <la_ort>Testdorf</la_ort>

  <la_land>Deutschland</la_land>

   <la_tel1></la_tel1>

   <la_tel2></la_tel2>

   <la_telmobil1></la_telmobil1>

   <la_telmobil2></la_telmobil2>

   <la_email></la_email>

   <la_fax1></la_fax1>

   <la_fax2></la_fax2>

   <kommentar_zur_lieferanschrift></kommentar_zur_lieferanschrift>

   <rch_zuname></rch_zuname>

   <rch_vorname></rch_vorname>

   <rch_firmenname></rch_firmenname>

   <rch_strasse></rch_strasse>

   <rch_adresszeile2></rch_adresszeile2>

   <rch_plz></rch_plz>

   <rch_ort></rch_ort>

  <rch_land>D</rch_land>

   <rch_tel1></rch_tel1>

   <rch_tel2></rch_tel2>

   <rch_telmobil1></rch_telmobil1>

   <rch_telmobil2></rch_telmobil2>

   <rch_email></rch_email>

   <rch_fax1></rch_fax1>

   <rch_fax2></rch_fax2>

   <positionen>

     <position>

       <artikeltyp></artikeltyp>

       <plusfakt_id>155975</plusfakt_id>

       <ean>5234569871254</ean>

       <herstellernr>2244</herstellernr>

       <anzahl>2</anzahl>

       <artikelnr>195/65R15</artikelnr>

       <artikel_beschreibung>Bridgestone Eco Sport</artikel_beschreibung>

       <artikel_beschreibung2></artikel_beschreibung2>

       <mwst>0.19</mwst>

       <preis>15.00</preis>

       <hersteller>Bridgestone</hersteller>

       <pos>1</pos>

       <position_kommentar></position_kommentar>

     </position>

   </positionen>

 </bestellung>

</bestellungen>

 

 

 

 

Erläuterung zu den Feldern

Auftragskopf

 

<?xml version="1.0" encoding="utf-8"?>

<!--PlusFakt Enterprise XML Auftragsimport-->

<bestellungen>

<plattform>IhrePlattform</plattform>

 <bestellung>

   <bestellnr>47110815</bestellnr>

   <datum>2014-01-01 08:50:43</datum>

   <typ></typ>

  <bestelltvon>Meyer</bestelltvon>

 

Feldname

Beschreibung

Pflichtfeld

plattform

Der Name Ihrer Plattform ohne Leerzeichen Bsp: tyre24, tyre100, delti

nein

bestellnr

Bestell Nr.des Auftrags

ja

datum

Datum des Auftrags

ja

typ

Auftragstyp:

Wenn Zubehörartikel oder ähnliches übertragen werden.

Muss mit dem PlusFakt Support besprochen werden

nein

bestelltvon

Hier wird der Name des Bestellers angezeigt. Hier kann es sich aber auch um einen eigener Merker für Filialbestellungen handeln, der später durch PlusFakt entsprechend in der Bestellung zugeordnet werden kann

 

Bsp:

<bestelltvon>101</bestelltvon>

bei Bestellung durch Filiale 101

nein

 

 

Auftragskommentar

<bestellung_kommentar></bestellung_kommentar>

 

Feldname

Beschreibung

Pflichtfeld

bestellung_kommentar

Kommentar zum Auftrag

nein

 

 

Kundendaten

 

<kunde_anlegen>1</kunde_anlegen>

  <kundennr_extern>111222</kundennr_extern>

  <kundennr>OPTIONAL</kundennr>

   <anrede>Herr</anrede>

   <zuname>Muster</zuname>

   <vorname>Max</vorname>

   <firmenname>Musterfirma</firmenname>

   <strasse>Musterstr. 6</strasse>

   <adresszeile2>Adresszeile 2</adresszeile2>

   <plz>54422</plz>

   <ort>Züsch</ort>

  <land>D</land>

   <tel1>0650311111</tel1>

   <tel2>0650311112</tel2>

   <telmobil1>0170123456</telmobil1>

   <telmobil2>01711234567</telmobil2>    
   <email>muster@muster.de</email>

   <fax1>06503123123</fax1>

   <fax2>06503123124</fax2>

  <ustid>Umsatzsteuer-ID</ustid>

 

Feldname

Beschreibung

Pflichtfeld


kunde_anlegen

1 = Kunde wird geprüft ob er vorhanden ist, falls nicht wird er angelegt(Achtung Siehe Adressfelder) 0 =  Kunde wird nicht angelegt, externe KundenNr_extern = Verknüpfung zum Kunde

ja


kundennr_extern

Kunden Nr zur Verknüpfung des Auftrags.

 

Erklärung:

Diese Nummer ist zur internen Verknüpfung mit dem Kunden. Sie muss pro Kunde statisch sein und darf sich nicht ändern.

 

ja, oder kundennr

Eines dieser Felder muss gefüllt werden/vorhanden sein. Vorzugsweise sollte die Kundennr_extern genutzt werden.

kundennr

Ihre KundenNr, die sie von ihrem Lieferant mitgeteilt bekommen haben oder noch erfragen müssen.

nein

anrede

zuname

vorname

firmenname

strasse

adresszeile2

plz

ort

land

tel1

tel2

telmobil1

telmobil2

email

fax1

fax2

ustid

kommentar_zum_kunde

Adressfelder

nein außer

wenn kunde_anlegen = 1 zuname/strasse/plz/ort = ja


 

Zahlungsbedingung

Im Normalfall nimmt PlusFakt, die beim Kunden hinterlegten Zahlungsbedingungen, bzw. die Zahlungsbedingung, die bei der Anlage des Kunden über deinen Vorlage Kunden festgelegt wurde.
Reichen diese Möglichkeiten nicht aus kann ein zusätzlicher XML-Tag verwendet werden in dem die ID oder dieser genaue Name der hinterlegten Zahlungsbedingung in PlusFakt übermittelt wird.

 

<idzahlungsbedingung>99</idzahlungsbedingung>

 

 

Feldname

Beschreibung

Pflichtfeld

idzahlungsbedingung

ID oder Name der in PlusFakt hinterlegten Zahlungsbedingung

Nein

 

Bankdaten

 

 

<iban>DE22 2222 1222 2221 6089 75</iban>

   <swift>MALADEE1DKH</swift>

   <bankname>Sparkasse</bankname>

   <kontoinhaber> Muster Max</kontoinhaber>

   <sepa_mandat>1665565410245991291</sepa_mandat>

   <sepa_datum>01.01.2014</sepa_datum>

   <sepa_zusatz>Zusatz</sepa_zusatz>

 

 

Feldname

Beschreibung

Pflichtfeld

iban

swift

bankname

kontoinhaber

sepa_mandat

sepa_datum

sepa_zusatz

 

Bankdaten und SEPA

ja

 

 

Kundenkommentar

 

<kommentar_zum_kunde>guter Kunde</kommentar_zum_kunde>

 

Feldname

Beschreibung

Pflichtfeld

kommentar_zum_kunde

Kommentar zum Kunden

nein

 

 

 

Daten zur Lieferanschrift

 

 

   <la_zuname>Nachname</la_zuname>

   <la_vorname>Vorname</la_vorname>

   <la_firmenname>Testfirma</la_firmenname>

   <la_strasse>Teststr. 1</la_strasse>

   <la_adresszeile2>Zweite Adresszeile</la_adresszeile2>

   <la_plz>66987</la_plz>

   <la_ort>Testdorf</la_ort>

  <la_land>D</la_land>

   <la_tel1>01234/567890</la_tel1>

   <la_tel2>01234/567891</la_tel2>

   <la_telmobil1>0170/1234567</la_telmobil1>

   <la_telmobil2>0170/1234568</la_telmobil2>

   <la_email>mail@email.de</la_email>

   <la_fax1>01234/567892</la_fax1>

   <la_fax2>01234/567893</la_fax2>

 

Feldname

Beschreibung

Pflichtfeld

la_zuname

la_vorname

la_firmenname

la_strasse

la_adresszeile2

la_plz

la_ort

la_land

la_tel1

la_tel2

la_telmobil1

la_telmobil2

la_emai

la_fax1

la_fax2

kommentar_zur_lieferanschrift

 

Lieferanschrift

Wenn gefüllt wird diese als Lieferanschrift genommen

nein

 

 

Kommentar zur Lieferanschrift

 

   <kommentar_zur_lieferanschrift>Schöne Anschrift</kommentar_zur_lieferanschrift>

 

 

Feldname

Beschreibung

Pflichtfeld

kommentar_zum_kunde

Kommentar zum Kunden

nein

 

 

 

Abweichende Rechnungsdaten

 

   <rch_zuname>Name</rch_zuname>

   <rch_vorname>Vorname</rch_vorname>

   <rch_firmenname>Firma Top</rch_firmenname>

   <rch_strasse>Topstraße</rch_strasse>

   <rch_adresszeile2>Zweitezeile</rch_adresszeile2>

   <rch_plz>55445</rch_plz>

   <rch_ort>Ortsdorf</rch_ort>

  <rch_land>D</rch_land>

  <rch_tel1>06503124578</rch_tel1>

   <rch_tel2>06503124579</rch_tel2>

   <rch_telmobil1>01509875421</rch_telmobil1>

   <rch_telmobil2>01509862142</rch_telmobil2>

   <rch_email>mail@rechnungsmail.de</rch_email>

   <rch_fax1>06503852741</rch_fax1>

   <rch_fax2>06503852963</rch_fax2>

 

Feldname

Beschreibung

Pflichtfeld

rch_zuname

rch_vorname

rch_firmenname

rch_strasse

rch_adresszeile2

rch_plz

rch_ort

rch_land

rch_tel1

rch_tel2

rch_telmobil1

rch_telmobil2

rch_emai

rch_fax1

rch_fax2

 

Lieferanschrift

Wenn gefüllt wird diese als Lieferanschrift genommen

nein

 

 

 

 

 

Positionen

 

  <positionen>

     <position>

       <artikeltyp></artikeltyp>

       <plusfakt_id>155975</plusfakt_id>

       <ean>5234569871254</ean>

       <herstellernr>2244</herstellernr>

       <anzahl>2</anzahl>

       <artikelnr>195/65R15</artikelnr>

       <artikel_beschreibung>Bridgestone Eco Sport</artikel_beschreibung>

       <artikel_beschreibung2></artikel_beschreibung2>

       <mwst>0.19</mwst>

       <preis>15.00</preis>

       <hersteller>Bridgestone</hersteller>

       <pos>1</pos>

       <position_kommentar></position_kommentar>

     </position>

    <position>

     …

    </position>

   </positionen>

 </bestellung>

</bestellungen>

 

 

Feldname

Beschreibung

Mussfeld

artikeltyp        

Siehe Auftragstyp

nein

plusfakt_id    

Eindeutige PlusFakt Nummer zur direkten Verknüpfung des Artikels

ja

oder ean/herstellernr gefüllt

ean

EAN des Artikels

nein wenn plusfakt_id gefüllt

herstellernr

Hersteller Nr (Achtung Hersteller muss gefüllt sein)

nein wenn plusfakt_id gefüllt

anzahl

Anzahl

ja

artikelnr

ArtikelNr

ja

artikel_beschreibung

Artikelbeschreibung

nein

artikel_beschreibung2

Artikelbeschreibung2

nein

mwst

Mwst

nein

preis

Preis

ja

hersteller

Hersteller

nein außer wenn herstellernr gefüllt

pos

Auftragsposition

nein

position_kommentar

Kommentar zur position

nein