Tabellen- und Feldreferenz von Ventoo Shipping

Diese Seite beschreibt sämtliche Tabellen und Aufzählungen, die Ventoo Shipping bereitstellt. Pro Tabelle sind Objekt-ID, Funktion und alle persistenten Felder mit Datentyp und Beschreibung dokumentiert.

Übersicht

Tabelle

Objekt-ID

Zweck

Carrier Setup VTO

70679800

Verbindungs- und Authentifizierungsdaten pro Spediteur.

Carrier Service Option VTO

70679801

Stammdaten zu Serviceoptionen pro Spediteur.

Shipment Label Header VTO

70679802

Kopfdaten eines Versandetiketts.

Shipment Label Line VTO

70679803

Transporteinheiten / Pakete eines Etiketts.

Label Notification VTO

70679804

Hinweismeldungen pro Etikett.

Label Service Option VTO

70679805

Zugeordnete Serviceoptionen pro Etikett.

Shipping Setup VTO

70679806

Globale Versandeinrichtung (Singleton).

Carrier Notification VTO

70679807

Stammdaten zu Hinweismeldungscodes pro Spediteur.

Tabelle Carrier Setup VTO (70679800)

Caption: Spediteureinrichtung. Verwaltet die Verbindungsdaten eines Spediteurs. Primärschlüssel ist Code.

Feldnr.

Name

Datentyp

Beschreibung

1

Code

Code[10]

Spediteurcode. Verweist auf Shipping Agent.Code. Setzt beim Validieren automatisch die Beschreibung.

2

Beschreibung

Text[100]

Anzeigename des Spediteurs.

3

Spediteur-Typ

Enum Carrier Type VTO

Bestimmt den eingesetzten Konnektor (z. B. Planzer).

4

Aktiviert

Boolean

Steuert, ob der Spediteur für Etiketten verwendet werden darf (Initialwert true).

10

Basis-URL Test

Text[250]

API-Endpunkt der Testumgebung.

11

Basis-URL Produktion

Text[250]

API-Endpunkt der Produktivumgebung.

12

Produktion verwenden

Boolean

Steuert, welche Basis-URL verwendet wird.

20

OAuth-Token-URL

Text[250]

Token-Endpunkt für den Client-Credentials-Flow.

21

OAuth-Client-ID

Text[100]

Client-ID. Wird beim Validieren in IsolatedStorage (OAuth_ClientId_<Code>) abgelegt.

22

OAuth-Client-Secret

Text[100]

Client-Secret. Wird beim Validieren in IsolatedStorage (OAuth_ClientSecret_<Code>) abgelegt.

23

OAuth-Scope

Text[250]

Optionaler Scope-Parameter.

30

Standard-Etikettenformat

Enum Label Format Type VTO

Standardformat (PDF oder ZPL).

31

Standard-Etikettenauflösung (dpi)

Integer

Standardauflösung in DPI (Initialwert 200).

40

Konto-ID

Code[20]

Planzer-Konto-ID (6 Stellen).

41

Kunden-ID

Code[20]

Planzer-Kunden-ID (6 Stellen).

42

Abteilungs-ID

Code[20]

Planzer-Abteilungs-ID (2 Stellen).

50

API-Aufrufe protokollieren

Boolean

Aktiviert die Speicherung von Request- und Response-JSON pro Etikett.

60

Abfrageparameter NachrichtArt

Text[100]

Optionaler Query-Parameter NachrichtArt.

61

Abfrageparameter System

Text[100]

Optionaler Query-Parameter System.

Wichtige Prozeduren (Auszug): SetOAuthClientId, GetOAuthClientId, SetOAuthClientSecret, GetOAuthClientSecret, HasOAuthClientId, HasOAuthClientSecret.

Tabelle Carrier Service Option VTO (70679801)

Caption: Spediteur-Serviceoption. Stammdaten der pro Spediteur verfügbaren Serviceoptionen. Primärschlüssel: Spediteurcode, Servicecode.

Feldnr.

Name

Datentyp

Beschreibung

1

Spediteurcode

Code[20]

Verweis auf Carrier Setup VTO.

2

Servicecode

Code[20]

Spediteurspezifischer Servicecode (z. B. 2030001).

10

Beschreibung

Text[100]

Anzeigetext der Serviceoption.

30

Aktiviert

Boolean

Steuert, ob die Option zur Auswahl angeboten wird (Initialwert true).

Tabelle Shipment Label Header VTO (70679802)

Caption: Versandetikett-Kopf. Primärschlüssel: Eintrag Nr. (Auto-Increment). Zusätzliche Schlüssel: Status und Quelldokumenttyp + Quelldokumentnr.

Allgemein

Feldnr.

Name

Datentyp

Beschreibung

1

Eintrag Nr.

Integer

Auto-Increment-Primärschlüssel.

2

Spediteurcode

Code[20]

Verweis auf Carrier Setup VTO.

3

Status

Enum Label Status VTO

Aktueller Status (Initialwert Entwurf).

4

Quelldokumenttyp

Enum Source Document Type VTO

Verkaufsauftrag, Gebuchte Lieferung oder Manuell.

5

Quelldokumentnr.

Code[20]

Nummer des Quelldokuments.

6

Referenz

Text[40]

Vom Anwender vergebene Referenz (max. 40 Zeichen).

Abholadresse

Feldnr.

Name

Datentyp

100

Abholname

Text[100]

101

Abholname 2

Text[50]

102

Abholadresse

Text[100]

103

Abholstrassennr.

Text[50]

104

Abholpostleitzahl

Code[20]

105

Abholort

Text[40]

106

Abhollandcode

Code[10]

107

Abholkontakt

Text[50]

108

Abholtelefon

Text[30]

109

Abhol-Mobiltelefon

Text[20]

110

Abhol-E-Mail

Text[100]

111

Abholanweisung

Text[70]

Lieferadresse

Feldnr.

Name

Datentyp

200

Liefername

Text[100]

201

Liefername 2

Text[50]

202

Lieferadresse

Text[100]

203

Lieferadresse 2

Text[50]

204

Lieferpostleitzahl

Code[20]

205

Lieferort

Text[40]

206

Lieferlandcode

Code[10]

207

Lieferkontakt

Text[100]

208

Liefertelefon

Text[30]

209

Liefer-Mobiltelefon

Text[30]

210

Liefer-E-Mail

Text[80]

211

Lieferanweisung

Text[70]

Daten und Zeiten

Feldnr.

Name

Datentyp

300

Abholdatum

Date

301

Abholzeit von

Time

302

Abholzeit bis

Time

310

Lieferdatum

Date

311

Lieferzeit von

Time

312

Lieferzeit bis

Time

Etiketteneinstellungen

Feldnr.

Name

Datentyp

Beschreibung

400

Etikettenformat

Enum Label Format Type VTO

Initialwert PDF.

401

Etikettenauflösung (dpi)

Integer

Auflösung in DPI; für ZPL Pflicht.

Gefahrgut und sonstige Daten

Feldnr.

Name

Datentyp

500

Gefahrgutcode

Integer

501

Gefahrgut-Punkte

Integer

600

Warenwert

Integer

601

Anzahl Paletten

Integer

602

Anzahl Rahmen

Integer

603

Anzahl Deckel

Integer

Ergebnis / Response

Feldnr.

Name

Datentyp

Beschreibung

701

Fehlermeldung

Text[2048]

Validierungs- oder Spediteurfehler.

702

Request JSON

Blob

Gesendetes JSON-Payload, sofern Logging aktiviert.

703

Response JSON

Blob

Empfangene Antwort, sofern Logging aktiviert.

704

Label PDF

Media

Vom Spediteur geliefertes Etikett.

Metadaten

Feldnr.

Name

Datentyp

Beschreibung

800

Erstellt von

Code[50]

Wird beim Insert auf UserId gesetzt.

801

Erstellt am

DateTime

Wird beim Insert auf CurrentDateTime gesetzt.

802

Gesendet am

DateTime

Zeitpunkt des API-Aufrufs.

Tabelle Shipment Label Line VTO (70679803)

Caption: Versandetikett-Zeile / Transporteinheit. Primärschlüssel: Etikett Eintragsnr., Zeilennr.

Feldnr.

Name

Datentyp

Beschreibung

1

Etikett Eintragsnr.

Integer

Verweis auf Shipment Label Header VTO.

2

Zeilennr.

Integer

Auto-Split-Key der Zeile.

10

Inhalt

Text[100]

Paketinhalt.

20

Gewicht (kg)

Decimal

Gewicht in Kilogramm, eine Dezimalstelle (MinValue = 0).

21

Länge (cm)

Integer

Länge in Zentimetern.

22

Breite (cm)

Integer

Breite in Zentimetern.

23

Höhe (cm)

Integer

Höhe in Zentimetern.

30

Strichcode

Text[30]

Vom Spediteur geliefert (schreibgeschützt).

31

Transporteinheitsnr.

Text[50]

Vom Spediteur geliefert (schreibgeschützt).

32

Tracking-Link

Text[250]

Vom Spediteur geliefert (schreibgeschützt, Drilldown öffnet die URL).

Tabelle Label Notification VTO (70679804)

Caption: Etikett-Hinweismeldung. Primärschlüssel: Etikett Eintragsnr., Zeilennr.

Feldnr.

Name

Datentyp

Beschreibung

1

Etikett Eintragsnr.

Integer

Verweis auf Shipment Label Header VTO.

2

Zeilennr.

Integer

Auto-Split-Key.

10

Hinweismeldungscode

Code[20]

Wird gegen Carrier Notification VTO validiert.

11

Wert

Text[200]

Inhalt der Hinweismeldung. Wird gegen die Maximallänge des Codes geprüft.

12

Beschreibung

FlowField (Text[100])

Lookup aus Carrier Notification VTO.

20

Spediteurcode-Filter

FlowFilter (Code[20])

Filter für die Berechnung der Beschreibung.

Tabelle Label Service Option VTO (70679805)

Caption: Etikett-Serviceoption. Primärschlüssel: Etikett Eintragsnr., Servicecode.

Feldnr.

Name

Datentyp

Beschreibung

1

Etikett Eintragsnr.

Integer

Verweis auf Shipment Label Header VTO.

2

Servicecode

Code[20]

Frei wählbarer Servicecode des Spediteurs.

10

Beschreibung

FlowField (Text[100])

Lookup aus Carrier Service Option VTO.

Tabelle Shipping Setup VTO (70679806)

Caption: Versandeinrichtung. Singleton-Tabelle (Primärschlüssel Primary Key).

Feldnr.

Name

Datentyp

Beschreibung

1

Primärschlüssel

Code[10]

Konstant leer; nur ein Datensatz.

10

Standard-Spediteurcode

Code[20]

Standardspediteur für neue Etiketten.

11

Auto-Druck nach Erstellung

Boolean

Aktiviert den automatischen Druck nach Erfolg.

12

Standardabholung von Firma

Boolean

Übernimmt die Firmendaten in die Abholadresse (Initialwert true).

Prozedur GetRecordOnce() legt den Datensatz beim ersten Zugriff an, falls er noch nicht existiert.

Tabelle Carrier Notification VTO (70679807)

Caption: Spediteur-Hinweismeldung. Stammdaten zu Hinweismeldungscodes pro Spediteur. Primärschlüssel: Spediteurcode, Hinweismeldungscode.

Feldnr.

Name

Datentyp

Beschreibung

1

Spediteurcode

Code[20]

Verweis auf Carrier Setup VTO.

2

Hinweismeldungscode

Code[20]

Spediteurspezifischer Code (z. B. remark, routing1).

10

Beschreibung

Text[100]

Anzeigetext der Hinweismeldung.

20

Maximallänge

Integer

Maximale Länge des Hinweismeldungswerts (1–2048, Initialwert 200).

30

Aktiviert

Boolean

Steuert die Auswahlbarkeit (Initialwert true).

40

Erforderlich

Boolean

Markiert die Hinweismeldung als Pflicht (Initialwert false).

Aufzählungen

Carrier Type VTO (70679800)

Erweiterbar. Implementiert das Interface Carrier Connector VTO.

Wert

Caption

Implementierung

0

(leer)

Dummy Connector VTO (No-Op, Standardimplementierung)

1

Planzer

Planzer Connector VTO

Label Status VTO (70679801)

Nicht erweiterbar.

Wert

Caption

0

Entwurf

1

Gesendet

2

Erfolg

3

Fehler

4

Abgebrochen

Source Document Type VTO (70679802)

Erweiterbar.

Wert

Caption

0

Verkaufsauftrag

1

Gebuchte Lieferung

2

Manuell

Label Format Type VTO (70679803)

Nicht erweiterbar.

Wert

Caption

0

PDF

1

ZPL

Seitenobjekte (Übersicht)

Seite

Objekt-ID

Typ

Spediteureinrichtung (Liste)

70679800

List

Spediteureinrichtungskarte

70679801

Card

Versandeinrichtung

70679802

Card (Administration)

Versandetiketten

70679803

List

Versandetikettenkarte

70679804

Card

Transporteinheiten / Pakete

70679805

ListPart

Hinweismeldungen

70679806

ListPart

Serviceoptionen

70679807

ListPart

Spediteur-Serviceoptionen

70679808

List (Administration)

Versandetikett erstellen

70679809

Card (Assistent)

Spediteur-Hinweismeldungen

70679810

List (Administration)

Codeunits und Berichte

Objekt

Objekt-ID

Beschreibung

Shipment Label Mgt. VTO

70679800

Zentrale Orchestrierung des Etiketten-Lebenszyklus.

Planzer Connector VTO

70679801

Konkrete Planzer-Implementierung des Spediteur-Konnektor-Interfaces.

Planzer Auth VTO

70679802

OAuth-2.0-Client für Planzer, inkl. Token-Cache.

Dummy Connector VTO

70679803

Platzhalter-Implementierung des Konnektor-Interfaces.

Shipping Events VTO

70679804

Veröffentlicht die Integrationsereignisse.

Ship Label Print Events VTO

70679820

Event-Subscriber, der PDF-Etiketten in BC-Berichte injiziert.

Planzer Label Print VTO (Bericht)

70679801

Schlanker RDLC-Bericht zur Nutzung der BC-Druckerauswahl.