Beschreibung JSON-Schnittstelle Office-SI
Office-SI und einige Erweiterungen benutzen dieses Format.
Über dieses Format können auch Aufträge automatisch in Office-SI erzeugt werden:
Zielspeicherort der JSON-Dateien:
Das Wurzelverzeichnis lautet [Datenbankpfad]\uniimport\files\.
Die Dateien müssen in [Datenbankpfad]\uniimport\files\RootInOrders erzeugt werden.
Office-SI wird spätestens nach einigen Minuten diese Dateien lesen, und Ihnen zum Import vorschlagen.
Evt. sind nicht alle Felder hier beschrieben.
Codierung: ANSI
Die UID Felder müssen eindeutig sein, die globale UID wird mit der UID eine Auftrages kombiniert, und dient zum Verhindern doppelter Importe.
JSON-Format:
Blau: Demodaten
Rot: Beschreibung
{
"Description":"Eine Beschreibung der Quelle",
Templates ist ein Array für Vorlagen aus Office-SI
Mindestens ein Eintrag muss vorhanden sein
Country enthält die Namen der Länder, bei denen diese Vorlage genutzt werden soll
Subject und Body wird nur bei automatischen Emailversand benutzt
Über die nächsten beiden Felder wird eine Vorlage aus Office-Si ausgewählt
Description: durchsucht die Beschreibung der Vorlage
PrintName: durchsucht den Namen der Vorlage
Wildcards sind hierbei erlaubt
In diesem Beispiel wird die 1. Vorlage aus Office-SI benutzt, das ist eine Vorlage vom Typ Rechnung.
"Templates":[
{
"Countrys":"DefaultCountry",
"Subject":"Email Subject",
"Body":"Email Body",
"Description":"*", In der Beschreibung der Vorlagen suchen
"PrintName":"*", In Namen der Vorlagen suchen
"default":true Als Standardvorlage, wenn keine andere gefunden wurde
}
],
Globale Vorgaben:
"AutoCloseOrder":false, Auftrag wird sofort abgeschlossen
"CanAutoPrintOrder":false, Auftrag kann automatisch gedruckt werden
"CanAutoSendOrder":false, Auftrag kann automatisch gesendet werden
"FindAsMail":true, Adresse wird über Email gesucht, andernfalls über die Kundennummer
"NettoPrices":true, Quelle enthält Nettopreise
"TaxImport":false, Steuer wird importiert
Adressfelder aus Office-SI. Mittlere 20 Felder: 1..20, von links oben nach rechts unten, Werte ausserhalb werden ignoriert
Diese Angaben werden für den Import neuer Adressen benötigt
"Email_ID":0,
"NoAsEmail_ID":1,
"Telephon_ID":2,
"EUUID_ID":3,
"UID":"544AEADA-8EF9-A094-5331-0A0C05E6DD6F", UID der Quelle
Orders ist ein Array der Aufträge
"Orders":[
{
Parts ist ein Array der Artikel
"Parts":[
{
"Quantity":1, Menge
"Unit":"piece", Einheit
"Description1":"Produkt 1", Text1
"Description2":"", Text2
"Number":"demo1", Artikelnummer
"DeliverNumber":"", Bestellnummer
"SerialNumber":"", Seriennummer
"LongText":"", Langtext (einfach)
"Price":16.95, Preis
"Rabatt":0, Rabatt
"TaxRate":0.19 Steuer, nur bei Import der Steuer, es werden absolute Angaben (19) und relative(0.19) erkannt
}
],
"UID":"1002", Eindeutige Nummer des Auftrages, wird mit der UID der Quelle kombiniert
"CustomerNumber":"1000", Kundennummer
"Date":"03.11.2014", Datum, am besten als ISO8601 angeben
"Company":"se-cs", Firmenname
"Salutation1":"", Anrede1
"Salutation2":"", Anrede2
"FirstName":"sigbert", Vorname
"LastName":"engelhardt", Nachname
"Street":"katzhagen 8", Strasse
"ZipCode":"37339", PLZ
"Town":"hundeshagen", Ort
"Country":"DE", Land
Das gleiche für Lieferanschrift:
"DeliverCompany":"se-cs",
"DeliverSalutation1":"",
"DeliverSalutation2":"",
"DeliverFirstName":"sigbert",
"DeliverLastName":"engelhardt",
"DeliverStreet":"katzhagen 8",
"DeliverZipCode":"37339",
"DeliverTown":"hundeshagen",
"DeliverCountry":"DE",
"DeliverEmail":"md5@se-cs.de", Emailadresse Lieferanschrift
"NoAsEmail":"", Gefüllt:Auftrag wird garantiert nicht per Email versendet
"Telephon":"", Telefon
"EUUID":"", EU-UID des Kunden
"Info1":"", Auftrag Info1
"Info2":"", Auftrag Info2
"Info3":"", Auftrag Info3
"Info4":"", Auftrag Info4
"Info5":"", Auftrag Info5
"Info6":"", Auftrag Info6
"Info7":"", Auftrag Info7
"Info8":"", Auftrag Info8
"Info9":"", Auftrag Info9
"Info10":"", Auftrag Info10
"Intern":"", Auftrag Internes Feld
"HeaderText":"", Auftrag Kopftext
"FooterText":"", Auftrag Fusstext
"NoTax":false Auftrag, keine Steuer berechnen
}
]
}
Hier ein lauffähiges Bespiel:
Lediglich der Eintrag "Description": "RECHNUNGIMPORT", ...
muss der Beschreibung einer Vorlage in OfficeSI entsprechen (Seite 2 Vorlagen, Beschreibung)
{
"Order": [
{
"Parts": [
{
"Quantity": 8,
"Unit": "Stück",
"Description1": "Paulmann 968.49 Stromschienensystem, E14, silber",
"Number": "C0-BUM5-YWUR",
"Price": 132.8,
"TaxRate": 0
},
{
"Quantity": 3,
"Unit": "Stück",
"Description1": "Paulmann 97655 Stromschienensystem, silber",
"Number": "0W-GW6K-ETLL",
"Price": 15.09,
"TaxRate": 0
}
],
"Adress": [
{
"AdressUpdateMode": true,
"Group": "Amazon",
"Company": "\r\n",
"FirstName": "",
"LastName": "Rainer Muster",
"Street": "Unterlaimbach 1",
"ZipCode": "4190",
"Town": "Bad Irgenwo",
"Country": "AT ",
"Email": "hrq9xjasdadadat@marketplace.amazon.de",
"Telephon": "032323444"
}
],
"UID": "306-5911532-4942722",
"Date": "2016-08-23T14:18:19+00:00",
"Info1": "306-5911532-4942722",
"HeaderText": "",
"FooterText": ""
},
{
"Parts": [
{
"Quantity": 2,
"Unit": "Stück",
"Description1": "Paulmann 926.59 Deckenleuchte, Aluminium, GU10, weiß",
"Number": "FY-FT2Y-R2W0",
"Price": 56,
"TaxRate": 0
}
],
"Adress": [
{
"AdressUpdateMode": true,
"Group": "Amazon",
"Company": "kekse",
"FirstName": "Bruno",
"LastName": "Hund",
"Street": "Musterstrasse 2",
"ZipCode": "28733",
"Town": "Bremerhafen",
"Country": "DE",
"Email": "82mwasdasdac4cly9nzb2c@marketplace.amazon.de",
"Telephon": "0421-6334347647"
}
],
"UID": "028-0426210-4591529",
"Date": "2016-08-24T06:03:53+00:00",
"Info1": "028-0426210-4591529",
"HeaderText": "",
"FooterText": ""
}
],
"Description": "CSV",
"Templates": [
{
"Countrys": "DefaultCountry",
"Subject": "",
"Body": "",
"Description": "RECHNUNGIMPORT",
"PrintName": "",
"default": true
}
],
"AutoCloseOrder": false,
"CanAutoPrintOrder": false,
"CanAutoSendOrder": false,
"FindAsMail": false,
"NettoPrices": false,
"TaxImport": true,
"Email_ID": 1,
"NoAsEmail_ID": -1,
"Telephon_ID": -1,
"EUUID_ID": -1,
"UID": "amazon"
}