Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.
Tipp

Enthalten in GoliathAPI.dll ab DLL-Version: 1.0.0

Inhalt

Objektbeschreibung

JSON-Pfad

Ausprägungen

Beschreibung

Auftragsnummer

Dient nur zur Rückmeldung bei APIOperation.Aktion = [“Anlegen”, “Aktualisieren”] +
APIOperation.Aufgabe = “Verarbeiten”.

Bearbeiter

Benutzername

Es muss sich hierbei um einen Benutzer aus der Benutzertabelle handeln.

ExterneSystemreferenz

Dient als Referenz zum Vorsystem und warnt sofern eine Doppelverarbeitung erkannt wird.

Kopfdaten

Kopfdaten.Adressen[x]

Wenn beim Anlegen nicht angegeben, wird der Standard lt. Goliath-Programmlogik verwendet.

Kopfdaten.Adressen[x].Adresszeile1

Kopfdaten.Adressen[x].Adresszeile2

Kopfdaten.Adressen[x].Adresszeile3

Kopfdaten.Adressen[x].Land

Länderkürzel

Muss in der Ländertabelle vorhanden sein.

Kopfdaten.Adressen[x].Ort

Kopfdaten.Adressen[x].Plz

Kopfdaten.Adressen[x].Strasse

Kopfdaten.Adressen[x].Typ

Rechnungsadresse, Lieferadresse

Kopfdaten.Benutzerfelder

Kopfdaten.Benutzerfelder.UserCharacter1 bis 5

Kopfdaten.Benutzerfelder.UserDatum1 bis 5

Kopfdaten.Benutzerfelder.UserLogisch1 bis 5

Kopfdaten.Benutzerfelder.UserMemo1 bis 5

Kopfdaten.Benutzerfelder.UserNummerisch1bis 10

Kopfdaten.Referenzen

Kopfdaten.Referenzen.Ansprechpartner

{Anrede} + “ “ + {Vorname} + “ “ + {Nachname}

Muss bei den Ansprechpartnern des Kunden existieren. Die Leerzeichen sind bei fehlendem Vornamen beizubehalten. Bspw.: Herr Köhler

Kopfdaten.Referenzen.Bestelldatum

Kopfdaten.Referenzen.Bestellnummer

Kopfdaten.Referenzen.Kennzeichen

Kopfdaten.Versand

Kopfdaten.Versand.Art

Muss in Allgemeine Daten existieren. Wenn beim Anlegen nicht angegeben, wird der Standard lt. Goliath-Programmlogik verwendet.

Kopfdaten.Versand.Lieferbedingung

Muss in Allgemeine Daten existieren. Wenn beim Anlegen nicht angegeben, wird der Standard lt. Goliath-Programmlogik verwendet.

Kopfdaten.Versand.NurKomplettlieferung

Kopfdaten.Versand.Preis

Wenn beim Anlegen nicht angegeben, wird der Standard lt. Goliath-Programmlogik verwendet.

Kopfdaten.Versand.SteuersatzProzent

Muss in Kfm. Einstellungen existieren. Wenn beim Anlegen nicht angegeben, wird der Standard lt. Goliath-Programmlogik verwendet.

Kopfdaten.Zahlung

Kopfdaten.Zahlung.Art

Muss in Allgemeine Daten existieren. Wenn beim Anlegen nicht angegeben, wird der Standard lt. Goliath-Programmlogik verwendet.

Kopfdaten.Zusaetze

Kopfdaten.Zusaetze.Vertreter

Muss in Vertreterstamm existieren. Wenn beim Anlegen nicht angegeben, wird der Standard lt. Goliath-Programmlogik verwendet.

Kopfdaten.Zusaetze.Werbetext

Kundennummer

Muss in Kundenstamm existieren.

Positionen

Positionen.Artikel

Wenn beim Anlegen nicht angegeben, wird der Standard lt. Goliath-Programmlogik verwendet.

Positionen.Artikel.Artikelnummer

Wenn beim Anlegen nicht angegeben, wird der Standard lt. Goliath-Programmlogik verwendet.

Positionen.Artikel.Bezeichnung1

Wenn beim Anlegen nicht angegeben, wird der Standard lt. Goliath-Programmlogik verwendet.

Positionen.Artikel.Bezeichnung2

Wenn beim Anlegen nicht angegeben, wird der Standard lt. Goliath-Programmlogik verwendet.

Positionen.Artikel.EinstandspreisPerEinheit

Wenn beim Anlegen nicht angegeben, wird der Standard lt. Goliath-Programmlogik verwendet.
Ist immer Netto (exkl. Mehrwertsteuer).

Positionen.Artikel.Gewicht

Gewicht per Einzelstück.
Wenn beim Anlegen nicht angegeben, wird der Standard lt. Goliath-Programmlogik verwendet.

Positionen.Artikel.Hersteller

Muss in Allgemeine Daten existieren. Wenn beim Anlegen nicht angegeben, wird der Standard lt. Goliath-Programmlogik verwendet.

Positionen.Artikel.Iartnummer

Wird ausschließlich von der API zurückgemeldet, welcher Artikel lt. Positionen.Artikel.Identifikation verwendet wird.

Positionen.Artikel.Identifikation

Positionen.Artikel.Identifikation.Feld

Artikelnummer, Herstellernummer, Iartnummer

Positionen.Artikel.Identifikation.Wert

Bezieht sich auf Positionen.Artikel.Identifikation.Feld

Positionen.Artikel.PreisPerEinheit

Wenn beim Anlegen nicht angegeben, wird der Standard lt. Goliath-Programmlogik verwendet.

Positionen.Artikel.Preiseinheit

Muss in Allgemeine Daten existieren. Wenn beim Anlegen nicht angegeben, wird der Standard lt. Goliath-Programmlogik verwendet.

Positionen.Artikel.RabattsatzProzent

Wenn beim Anlegen nicht angegeben, wird der Standard lt. Goliath-Programmlogik verwendet.

Positionen.Artikel.SteuersatzProzent

Muss in Kfm. Einstellungen existieren. Wenn beim Anlegen nicht angegeben, wird der Standard lt. Goliath-Programmlogik verwendet.

Positionen.Artikel.Zusatztext

Wenn beim Anlegen nicht angegeben, wird der Standard lt. Goliath-Programmlogik verwendet.

Positionen.Benutzerfelder

Positionen.Benutzerfelder.UserCharacter1 bis 5

Positionen.Benutzerfelder.UserDatum1 bis 5

Positionen.Benutzerfelder.UserLogisch1 bis 5

Positionen.Benutzerfelder.UserMemo1 bis 5

Positionen.Benutzerfelder.UserNummerisch1bis 10

Positionen.Kundenartikelnummer

Positionen.Lagernummer

Zentrallager = 0, ansonsten die Lagernummer lt. Allgemeine Daten.

Positionen.Liefertermin

Positionen.Menge

Muss größer 0 sein.

Positionen.RecId

Eindeutige Positions-ID für das Aktualisieren der Position. Es werden nur noch nicht abgebuchte Positionen aktualisiert.

Positionen.Titeltext

Titel vor der Auftragsposition.

Projektdaten

Projektdaten.Bezeichnung

Projektdaten.Benutzerfelder

Projektdaten.Benutzerfelder.UserCharacter1 bis 5

Projektdaten.Benutzerfelder.UserDatum1 bis 5

Projektdaten.Benutzerfelder.UserLogisch1 bis 5

Projektdaten.Benutzerfelder.UserMemo1 bis 5

Projektdaten.Benutzerfelder.UserNummerisch1bis 10

Projektdaten.Dreieck

Projektdaten.KFBetreuer

Benutzername

Es muss sich hierbei um einen Benutzer aus der Benutzertabelle handeln.

Projektdaten.KundennummerAbwREEmpfaenger

Muss in Kundenstamm existieren.

Projektdaten.Notiz

Projektdaten.PreisIstBrutto

Die angegebenen Verkaufs-Preise in der JSON sind Brutto und das Projekt wird als bruttofakturiertes Projekt angelegt.

Projektdaten.TEBetreuer

Benutzername

Es muss sich hierbei um einen Benutzer aus der Benutzertabelle handeln.

Projektdaten.Typ

Muss in Allgemeine Daten existieren.

Projektdaten.Waehrung

Muss in Allgemeine Daten existieren.

Projektnummer

Dient zur Rückmeldung bei APIOperation.Aktion = [“Anlegen”] +
APIOperation.Aufgabe = “Verarbeiten”. Und als eindeutiger Identifikator für die APIOperation.Aktion = [“Aktualisieren”].

Objektbeispiele

Anlegen

Confluence prism macro
lineNumberstrue
downloadFilename
showPreviewstrue
showInvisibles
lineHighlightlineNumbersStart
dialogTitle
languageJSON
lineNumbersStart
limitHeight
clickableLinks
heightclickableLinks
{
    "APITyp": "GoliathAPIStandard",
    "APIVersion": "v1.0.0",
    "Einreicher": {
        "SystemID": "OFML-PROD",
        "TeilsystemID": "B2B"
    },
    "Transaktionen": [
        {
            "APIOperation": {
                "Aktion": "Anlegen",
                "Aufgabe": "Verarbeiten",
                "Typ": "Kundenauftrag",
                "Version": "v1.0.0"
            },
            "Daten": {
                "Bearbeiter": "TKOEHLER",
                "ExterneSystemreferenz": "24041988",
                "Kopfdaten": {
                    "Adressen": [
                        {
                            "Adresszeile1": "Musteradresse",
                            "Adresszeile2": "Test",
                            "Land": "DE",
                            "Ort": "Tettnang",
                            "PLZ": "88069",
                            "Strasse": "Bahnhostr 4711",
                            "Typ": "Rechnungsadresse"
                        },
                        {
                            "Adresszeile1": "Musteradresse",
                            "Adresszeile2": "Test",
                            "Land": "DE",
                            "Ort": "Tettnang",
                            "PLZ": "88069",
                            "Strasse": "Bahnhostr 4712",
                            "Typ": "Lieferadresse"
                        }
                    ],
                    "Benutzerfelder": {
                        "UserCharacter1": "Testinformation ",
                        "UserDatum1": "2018-11-21T00:00:00Z",
                        "UserLogisch1": true,
                        "UserMemo1": "BlaBla Zusatztext.\nin unserm schönen Memofeld.",
                        "UserNummerisch1": 156981325.14
                    },
                    "RabattsatzProzent": 2.5,
                    "Referenzen": {
                        "Ansprechpartner": "Frau Erika Musterfrau",
                        "Bestelldatum": "2022-12-16T00:00:00Z",
                        "Bestellnummer": "Bestellung 4711",
                        "Kennzeichen": "Kom: Mayr"
                    },
                    "Versand": {
                        "Art": "UPS",
                        "Lieferbedingung": "EXW- Ab Werk",
                        "NurKomplettlieferung": true,
                        "Preis": 5.92,
                        "SteuersatzProzent": 19
                    },
                    "Zahlung": {
                        "Art": "14 Tage 3 %, 30 Tage netto"
                    },
                    "Zusaetze": {
                        "Vertreter": "MDHEIN",
                        "Werbetext": "Das ist langer Werbetext."
                    }
                },
                "Kundennummer": 10000.0,
                "Positionen": [
                    {
                        "Artikel": {
                            "Artikelnummer": "10000123",
                            "Bezeichnung1": "Artikelbeschreibungstext 1",
                            "Bezeichnung2": "Artikelbeschreibungstext 2",
                            "EinstandspreisPerEinheit": 47.11,
                            "Gewicht": 0.25,
                            "Hersteller": "FAG",
                            "Identifikation": {
                                "Feld": "Artikelnummer",
                                "Wert": "10000123"
                            },
                            "Preiseinheit": "STK",
                            "PreisPerEinheit": 9.99,
                            "RabattsatzProzent": 10.0,
                            "SteuersatzProzent": 19.0,
                            "Zusatztext": "Dies ist ein wundervoller Artikel.\nNur für Kenner."
                        },
                        "Benutzerfelder": {
                            "UserCharacter1": "Testinformation ",
                            "UserDatum1": "2018-11-21T00:00:00Z",
                            "UserLogisch1": true,
                            "UserMemo1": "BlaBla Zusatztext.\nin unserm schönen Memofeld.",
                            "UserNummerisch1": 156981325.14
                        },
                        "Kundenartikelnummer": "ABC0005",
                        "Lagernummer": 0,
                        "Liefertermin": "2018-11-21T00:00:00Z",
                        "Menge": 5.0,
                        "Titeltext": "Order 1 - Palmberg"
                    },
                    {
                        "Artikel": {
                            "Identifikation": {
                                "Feld": "Herstellernummer",
                                "Wert": "135382"
                            }
                        },
                        "Menge": 3.0
                    }
                ],
                "Projektdaten": {
                    "Benutzerfelder": {
                        "UserCharacter1": "Testinformation ",
                        "UserDatum1": "2018-11-21T00:00:00Z",
                        "UserLogisch1": true,
                        "UserMemo1": "BlaBla Zusatztext.\nin unserm schönen Memofeld.",
                        "UserNummerisch1": 156981325.14
                    },
                    "Bezeichnung": "Kundenauftrag: 0815",
                    "Dreieck": false,
                    "KFBetreuer": "TKOEHLER",
                    "KundennummerAbwREEmpfaenger": 0,
                    "Notiz": "Freue mich auf die Lieferung.",
                    "PreisIstBrutto": false,
					"TEBetreuer": "MDHEIN",
                    "Typ": "SHOP",
                    "Waehrung": "EUR"
                }
            }
        }
    ]
}

Aktualisieren

Confluence prism macro
lineNumberstrue
downloadFilename
showPreviewstrue
showInvisibles
lineHighlightlineNumbersStart
dialogTitle
languageJSON
lineNumbersStart
limitHeight
clickableLinks
heightclickableLinks
{
    "APITyp": "GoliathAPIStandard",
    "APIVersion": "v1.0.0",
    "Einreicher": {
        "SystemID": "OFML-PROD",
        "TeilsystemID": "B2B"
    },
    "Transaktionen": [
        {
            "APIOperation": {
                "Aktion": "Aktualisieren",
                "Aufgabe": "Verarbeiten",
                "Typ": "Kundenauftrag",
                "Version": "v1.0.0"
            },
            "Daten": {
                "Bearbeiter": "TKOEHLER",
                "Kopfdaten": {
                    "Adressen": [
                        {
                            "Adresszeile1": "Musteradresse",
                            "Adresszeile2": "Test",
                            "Land": "DE",
                            "Ort": "Tettnang",
                            "PLZ": "88069",
                            "Strasse": "Bahnhostr 4712",
                            "Typ": "Lieferadresse"
                        }
                    ],
                    "Referenzen": {
                        "Bestellnummer": "Bestellung 4712"
                    }
                },
                "Kundennummer": 1659.0,
                "Positionen": [
                    {
                        "Artikel": {
                            "RabattsatzProzent": 50.0
                        },
						"RecId": "_6K30ZH6OK59588,37"
                    },
                    {
                        "Menge": 3.0,
						"RecId": "_6K30ZH6S159588,50"
                    }
                ],
                "Projektdaten": {
					"Benutzerfelder": {
                        "UserCharacter1": "PRJ_Testinformation "
                    },
                    "Typ": "HA"
                }
            }
        }
    ]
}