Felder für Actions

  • Aktualisiert am Feb 5, 2025
  • Veröffentlicht am Sep 26, 2024
  • 2 Gelesene Minute(n)
Prev Next

Header Felder

Im WebService Call müssen bei allen Calls folgende Header Felder angegeben werden:

Feld

Beschreibung und Infos

Feld-Typ

Service

Muss immer mit “CONBOX” belegt werden

STRING

Language

Nach ISO 639-1 Sprachcode

STRING

UserCode

Vom Betreiber der CONBOX Umgebung definierter Benutzer-Code

STRING

Body Felder für Request

Feld

Beschreibung und Infos

Feld-Typ

Mandatory (M) / Optional (O)

Relevant in Actions

Action

  • Add

  • Copy

  • Update

  • SilentCopy

  • Delete

  • Purchase

  • SaveDocumentAs

  • SetReadyDocument

STRING (keine Beschränkung - nur JSON / fixe Werte)

M

Allen

Amount

Menge

INTEGER

Add = O
Copy = O
Update = O
SilentCopy = O

Add
Copy
Update
SilentCopy

DocNbr

Belegnummer im Fremdsystem

(wird in moveIT CONBOX als Kopfstatus und Betreff eingetragen – bei Neuanlage)

STRING (X(8))

M

Allen

DocTyp

1 = Angebot
2 = Auftrag

Bei "Purchase" darf nur 2 (Auftrag) angegeben werden.

INT

Add = M
SaveDocumentAs = M
Purchase = M
Copy = M
SilentCopy = M

Add
SaveDocumentAs
Purchase
Copy
SilentCopy

PosNbr

Positionsnummer im Fremdsystem

(wird in moveIT CONBOX als Positionsstatus eingetragen – bei Neuanlage)

STRING (X(8))

Allen

Purchase - Bleibt die PosNbr leer, werden alle Positionen des Beleges bestellt, ansonsten nur die dort angegebenen (z. B. "PosNbr": "Pos01,Pos02,Pos03",)

SrcPosNbr

Quellpositionsnummer

Externe Nummer

STRING (X(8))

Copy = M
SilentCopy = M

Copy
SilentCopy

SrcDocNbr

Quellbelegnummer
Externe Nummer

STRING (X(8))

Copy = M
SilentCopy = M

SaveDocumenAs = M

Copy

SilentCopy
SaveDocumentAs

SrcDocTyp

Quellbelegtyp

INTEGER

Copy = M
SilentCopy = M
SaveDocumenAs = M

Copy
SilentCopy
SaveDocumentAs

WarNbr

Modellnummer in moveIT

WarNbr = leer → eKatalog öffnet sich
WarNbr = mehrdeutig / WarNbr = unbekannt → eKatalog öffnet sich, gefiltert nach dem Wert
WarNbr = Lieferant → eKatalog öffnet sich, gefiltert auf den Lieferant
WarNbr = eindeutig → der Konfigurator öffnet sich für das Modell

STRING

Add = M
Copy = O
Update = O

Add

Copy
Update

PosImgHeight

Höhe der Positionsgrafik bei Rückgabe (Standardwert=300)

INT

O

PosImgWidth

Breite der Positionsgrafik bei Rückgabe (Standardwert=300)

INT

O

Subject

Betreff des Belegs überschreiben

STRING

O

Purchase

ExtPchNbr

Externe Bestellnummer

STRING

O

Purchase

FinalCustomerLndCde

Ländercode des Endkunden (nach Liste der Kfz-Nationalitätszeichen)

STRING

O

Purchase

LVNumber

Sichtbare Positionsnummern. Füllt moveIT CONBOX Feld „LV-Nr.“

Bei den Actions „Copy“ und „SilentCopy“ wird die „LV-Nr.“ immer mitkopiert und kann wiederum mit der Action „Update“ editiert werden.

STRING (15)

O

Update

ConfiguratorParams

Übergabe von Frageparameter(n) aus dem Fremdsystem in die Stammdatenkonfiguration von moveIT ISS+, die dort als Makrovariablen zur Verfügung stehen (nur in Abstimmung mit dem Stammdaten-Lieferant möglich!).

„WarNbr“ muss mit einer Artikel- oder Modellnummer gefüllt worden sein.

ARRAY

O

Add
Update
Copy

  • ParamName

Name des Parameters im Fremdsystem

STRING

  • ParamValue

Parameterwert

Jeder Parameter wird als eigene Variable an den moveIT ISS+ Macrointerpreter übergeben. Als Präfix im Macrointerpreter wird „ExtPrm_“ verwendet. Dadurch wird aus dem Parameter „PrmBreite“ aus dem Fremdsystem im Macrointerpreter „ExtPrm_PrmBreite“. Auf die Variable „ExtPrm_PrmBreite“ kann dann in den Macros abgefragt werden.

IF DEFINED (ExtPrm_PrmBreite) THEN BEGIN

IF TYPE$ (ExtPrm_PrmBreite = "NUM" THEN P_VALUE1 = ExtPrm_PrmBreite

ELSE P_VALUE1 = VAL (ExtPrm_PrmBreite)

ENDIF

IF DEFINED (ExtPrm_PrmHoehe) THEN BEGIN

IF TYPE$ (ExtPrm_PrmHoehe = "NUM" THEN P_VALUE2 = ExtPrm_PrmHoehe

ELSE P_VALUE2 = VAL (ExtPrm_PrmHoehe)

ENDIF

STRING, NUMBER, BOOLEAN

DlvAdr

Hiermit kann eine abweichende Lieferadresse an moveIT CONBOX übergeben werden

ARRAY

O

Purchase

  • AdrTit

Lieferadresse Titel

STRING

  • AdrNam01

Lieferadresse Name 1

STRING

  • AdrNam02

Lieferadresse Name 2

STRING

  • OrdNam

Lieferadresse Ansprechpartner (wird in moveIT CONBOX im Feld „Besteller“ gespeichert)

STRING

  • AdrStr

Lieferadresse Straße

STRING

  • AdrLnd

Lieferadresse Land

STRING

  • AdrPcd

Lieferadresse Postleitzahl

STRING

  • AdrReg

Lieferadresse Ort

STRING

PosData

Positionsbezogene Daten

ARRAY

O

Purchase

  • PosNbr

Externe Positionsnummer auf die LVNbr und NotTxt sich beziehen soll

STRING

  • LVNbr

Externe Positionsnummer

STRING

  • NotTxt

Fertigungshinweis der in den Korrespondenzen gespeichert wird

STRING (X(2000))

ReadyStatus

Setzen des Belegstatus auf FERTIG oder NICHT FERTIG

BOOL

SetReadyStatus = M

SetReadyStatus


Response Felder

Folgende Felder sind zusätzlich relevant und können je nach Action-Typ im Response enthalten sein

Feld

Beschreibung und Infos

Feld-Typ

Success

Gibt an, ob die Verarbeitung erfolgreich war

BOOL

ErrorMessage

Sollte der Call auf eine Verarbeitungs-Fehler laufen und somit auch Success=FALSE sein, so wird die entsprechende Fehlermeldung hier angezeigt. Feld im Response immer vorhanden, aber nur gefüllt wenn Success=FALSE.

STRING

ActionToken

Enthält den eindeutigen, einmaligen verwendbaren Token, der bei der Initialisierung für eine aktive Action zurück übergeben wird.

STRING

PositionGUID

moveIT GUID der Hauptposition die erzeugt wurde

STRING

WarNbr

moveIT Modellnummer

STRING

WarDsc

moveIT Modellbezeichnung

STRING

WarDscEx1

moveIT erweiterte Modellbezeichnung 1

STRING

WarDscEx2

moveIT erweiterte Modellbezeichnung 2

STRING

FCoPrc

Berechneter Netto Einkaufspreis

STRING

ListPrice

Listenpreis

STRING

PosImg

Das generierte Produktbild

BASE64

PosImgURL

URL zum generierten Produktbild

STRING

ProductText

Produkttext Plain

STRING

ProductTextRTF

Produkttext RTF

STRING

PrdGrp

Produktgruppen-Code des Artikels/Modells wie in XPRO PrdGrp

STRING

PrdGrcpDsc

Ausgeschriebene Produktgruppen-Bezeichnung des Artikels/Modells wie in XPRO PrdGrp

STRING

ConfiguratorParams

Rückübergabe von Konfigurationswerten aus moveIT ISS+ an das Fremdsystem

ARRAY

  • ParamName

Name des Parameters in moveIT ISS+

STRING

  • ParamValue

Parameterwert

Die moveIT ISS+ Stammdatenentwickler müssen die Rückgabeparameter in der Variable „ExtPrm_Return“ als kommagetrennte Liste setzen ("PrmBreite,PrmHoehe,PrmFarbe").

Es besteht ferner die Möglichkeit eine doppelt verkettete Liste (Pipe-getrennt) inklusive der Datentypen zurückzugeben ("PrmBreite,PrmHoehe,PrmFarbe" -> "PrmBreite|INTEGER,PrmHoehe|INTEGER,PrmFarbe|CHARACTER"). In diesem Fall erhalten alle Parameter den zugewiesenen Datentyp.

ExtPrm_Return = FpRoBehTyp + ",Testxy," + FpRoFarbeKast

STRING, NUMBER, BOOLEAN

Verwandte Artikel