> For the complete documentation index, see [llms.txt](https://docs.solutioo.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.solutioo.de/dpd-connector-premium/referenz-and-datenmodell/datenmodell-and-tabellen.md).
# Datenmodell & Tabellen
## Datenmodell & Tabellen
Der DPD Connector nutzt eigene Tabellen im Objekt-ID-Bereich **72242606–72243464** sowie Erweiterungen der Standardtabellen *Artikel*, *Debitor* und *Verkaufsbeleg*. Diese Seite gibt einen vollständigen Überblick – nützlich für eigene Berichte, Auswertungen (z. B. per Excel/Power BI) oder die Fehleranalyse.
{% hint style="info" %}
**Konvention:** Alle App-Objekte tragen das Präfix **SOU**/**SOUDPD** (solutioo). Die hier genannten Objekt-IDs und Feld-Nummern können bei einem Update abweichen; maßgeblich ist immer die installierte App-Version.
{% endhint %}
### Beziehungsübersicht (ER-Diagramm)
```mermaid
erDiagram
Configuration ||--o{ DepotAccount : "kopiert Absender"
Configuration ||--o{ SenderAddress : "kopiert Absender"
DepotAccount ||--o{ PackageHead : "Depot Account Code"
SenderAddress ||--o{ PackageHead : "Sender Code"
Box ||--o{ PackageHead : "Box Code"
PackageHead ||--|{ PackageLine : "Header ID"
PackageHead ||--o| HazardousData : "Package Head ID"
PackageHead ||--o| InternationalData : "Package Head ID"
InternationalData ||--|{ InvoiceLine : "Entry No."
HazardousMaster ||--o{ HazardousData : "UN No"
HazardousMaster ||--o{ Item : "DPD Hazardous UN No"
PackageHead ||--o{ TrackingEvent : "DPD Shipment No / MPS ID"
PackageHead ||--o{ ProofOfDelivery : "DPD Shipment No / MPS ID"
```
Das Herzstück ist der **Paketkopf** (*SOU DPD Package Head*): An ihm hängen die Paketzeilen, optional die Gefahrgut- und Zolldaten sowie – nach dem Upload – Trackingereignisse und Abliefernachweise.
{% hint style="warning" %}
Gefahrgut- und Zolldaten sind über die Felder **Package Head ID + Package Type + Document No.** logisch mit dem Paketkopf verknüpft (kein harter Fremdschlüssel). **Tracking** und **Abliefernachweise** werden über die **DPD-Sendungsnummer** bzw. die **MPS-ID** zugeordnet.
{% endhint %}
### Konfiguration & Stammdaten
SOUDPD Configuration (72242606) – zentrale Mandanten-Einrichtung
**Schlüssel:** Code
Enthält Zugangsdaten (Delis-ID/Passwort oder Cloud User ID/Token), Diensttyp (Depot/Cloud), Absenderadresse, Ausgabeformat (PDF/ZPL), Papierformat, Modus (Sandbox/Produktion), Retourenlager, Sender-EORI/USt-IdNr. sowie die **Feature-Toggles** (Gefahrgut, International, Höherversicherung, Predict, Tracking-Push, SFTP-Import, Azure-Diagnose). Wird an *Depot Account* und *Sender Address* kopiert. Siehe [Feldreferenz](/dpd-connector-premium/verbindung-and-konfiguration/dpd-konfiguration-feldreferenz.md).
SOUDPD Depot Account (72243460) – DPD-Konten je Mandant/Zweck
**Schlüssel:** Code
Für Multi-Mandant-/Multi-Konto-Betrieb: eigene Zugangsdaten, Versanddepot, Zweck (*Versand* / *Retoure* / *beides*), Absenderfelder, Standard-Absenderadresse. Siehe [Depot-Konten](/dpd-connector-premium/stammdaten-einrichten/depot-konten-multi-mandant.md).
SOUDPD Sender Address (72243430) – Absenderadressen
**Schlüssel:** Code
Mehrere Absender (Name, Straße, PLZ, Ort, Land, EORI, USt-IdNr., Versanddepot). Siehe [Absenderadressen](/dpd-connector-premium/stammdaten-einrichten/absenderadressen-mehrere-absender.md).
SOUDPD Product Setup (72243456) – Versandprodukte
**Schlüssel:** Product (Enum)
Je Produkt: aktiv ja/nein, **SO-Code**, Produktcode, erlaubte Optionen (Small/Unfrei/Samstag/ID-Check/Predict), Gefahrgut-Kennzeichen, **Max. Gewicht (kg)**, Sortierung. Siehe [Versandprodukte & SOCodes](/dpd-connector-premium/stammdaten-einrichten/versandprodukte-and-socodes.md).
SOUDPD Boxes (72242609) – Kartons für Smart Packing
**Schlüssel:** Code
Maße (Länge/Breite/Höhe in mm/cm), Eigengewicht, Max-Gewicht (g), Produkttyp-Zuordnung. Siehe [Boxen & Smart Packing](/dpd-connector-premium/stammdaten-einrichten/boxen-and-smart-packing.md).
SOUDPD Hazardous Master (72243436) – Gefahrgut-Stammdaten
**Schlüssel:** UN No
UN-Nummer, Bezeichnung, Klasse, Verpackungsgruppe, Klassifizierungscode, Nebengefahr, Tunnelcode, LQ-Zulassung + Max-LQ-Gewicht, Beförderungskategorie, **Faktor**, NEM-Relevanz. Siehe [Gefahrgut-Stammdaten](/dpd-connector-premium/stammdaten-einrichten/gefahrgut-stammdaten.md).
SOUDPD Shipping Rate (72243451) – Versandtarife
**Schlüssel:** Product, Zone Code, Max Weight – optionale Tarifhinterlegung je Produkt/Zone/Gewicht.
### Pakete & Positionen
SOU DPD Package Head (72242616) – der Paketkopf
**Schlüssel:** ID (autom.), Type, Document No.
Zentrale Sendungstabelle. Wichtige Felder:
| Bereich | Felder |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| Bezug | Type (Angebot/Lieferung/Auftrag/Manuell), Document No., Box Code, Sender Code, Depot Account Code |
| Gewicht/Maße | Weight, Weight UOM (g/kg), Länge/Breite/Höhe, Custom Dimensions, Manual Weight |
| Upload | Uploaded, Upload Date, **DPD Shipment No**, DPD Routing Code, **MPS ID** |
| Etikett | Label PDF (Blob), Label Image, MPS Label Image, Print Format |
| Benachrichtigung | Notification Channel (Email/SMS), Notification Value, Notification Language |
| Optionen | Parcelshop ID, LQ Shipment, Tyres Shipment, Personal Delivery Type, Insurance Amount/Currency/Content, Pickup-Felder, Drop Authorization |
| Status | Tracking Status (Enum), Tracking Text, Tracking Date |
| Produkt | Product Type (Enum) |
SOU DPD Package Line New (72242615) – Paketzeilen
**Schlüssel:** Header ID, Type, Document No., Line No
Zuordnung Artikel → Paket: Item No., Quantity, **Weight (in Gramm)**, Länge/Breite/Höhe. Verweist über **Header ID** auf den Paketkopf.
### Gefahrgut & Zoll
SOU DPD Hazardous Data (72243423) – Gefahrgutdaten je Paket
**Schlüssel:** Entry No. (autom.) · Sekundär: Package Head ID + Type + Document No.
UN-Nummer, Klasse, Verpackungsgruppe/-code, Klassifizierungscode, Gefahrgutgewicht, NEM, Beschreibung, Nebengefahr, Tunnelcode, **Faktor** und die berechneten **Punkte** (= Gewicht × Faktor, nicht editierbar). Siehe [Gefahrgut-Sendung](/dpd-connector-premium/sendungen-erstellen-praxis/gefahrgut-sendung.md).
SOU DPD International Data (72243421) – Zolldaten je Paket
**Schlüssel:** Entry No. (autom.) · Sekundär: Package Head ID + Type + Document No.
Lieferbedingung (Incoterms-Enum), Zollwert, Währung, Ausfuhrgrund (Enum), Rechnungsnummer, Wareninhalt, Sender-/Empfänger-EORI/USt-IdNr., Empfängeranschrift für die Handelsrechnung. Siehe [Internationale Sendung & Zoll](/dpd-connector-premium/sendungen-erstellen-praxis/internationale-sendung-and-zoll.md).
SOU DPD Invoice Line (72243422) – Zollpositionen
**Schlüssel:** International Data Entry No., Line No.
Positionen der Handelsrechnung: HS-Code (Customs Tarif), Menge, Wert, Ursprungsland, Netto-/Bruttogewicht, Beschreibung. Verweist über **International Data Entry No.** auf die Zolldaten.
### Tracking & Nachweise
SOUDPD Tracking Event (72243463) – Trackingereignisse
**Schlüssel:** Entry No. (autom.)
Vom DPD-Push gelieferte Statusmeldungen: Paketnummer, Statuscode/-text, Scan-Zeitpunkt, Depot/Ort, **zugeordneter Status** (Enum), Verarbeitet-Kennzeichen, Rohdaten (Blob). Zuordnung zum Paket über DPD-Sendungsnummer/MPS-ID.
SOUDPD Proof of Delivery (72243464) – Abliefernachweise (POD)
**Schlüssel:** Entry No. (autom.)
Zustellnachweise mit Zustellzeitpunkt, Unterzeichner, Dateiname, Dokument (Blob). Siehe [Status & Tracking verfolgen](/dpd-connector-premium/sendungen-erstellen-praxis/status-and-tracking-verfolgen.md).
### Protokolle & Sonstiges
Weitere Tabellen
| Tabelle | ID | Zweck |
| --------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **SOU API Call Log** | 72242607 | Protokoll aller DPD-API-Aufrufe (Request/Response, Erfolg, Meldung). Siehe [Fehlerbehebung](/dpd-connector-premium/test-and-betrieb/api-aufruf-protokoll-and-fehlerbehebung.md). |
| **SOUDPD Import Log** | 72243448 | Protokoll der Stammdaten-Importe (HAZSUBSTANCE/GeoRouting). |
| **SOUDPD Cancellation Log** | 72242610 | BC-interne Stornos (Datum, Beleg, Paket, Sendungsnummer). |
| **SOUDPD Direct Shipment** | 72243442 | Direktversand ohne Verkaufsbeleg. |
| **SOUDPD Activities Cue** | 72243450 | Kennzahlen für die Rollencenter-Kacheln. |
### Erweiterte Standardtabellen (TableExt)
Der Connector ergänzt DPD-Felder an bestehenden Tabellen:
| Standardtabelle | Ergänzte DPD-Felder (Auszug) |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Artikel** | Versandmaße (L/B/H), Gefahrgut + UN-Nummer + Verpackungscode + Gefahrgutgewicht + LQ, ID-/Alterskontrolle, Versicherung + Wert, Food, Reifen, Standard-Absender/Depot. Siehe [Artikel-Einrichtung](/dpd-connector-premium/beleg-and-stammdaten-optionen/artikel-einrichtung.md). |
| **Debitor** | Standardprodukt, Paketshop-ID, Empfängertyp, Predict-Kanal/Wert/Sprache, ID-Check, Samstagszustellung, Standard-Versicherung, Empfänger-EORI/USt, Lieferbedingung, Ausfuhrgrund. Siehe [Debitor-Einrichtung](/dpd-connector-premium/beleg-and-stammdaten-optionen/debitor-einrichtung.md). |
| **Verkaufskopf** | Produkt, SO-Code, Paketshop, Predict, Samstag, Unfrei, ID-Check, Versicherungswert, Absender, Abstellgenehmigung. |
| **Geb. Verkaufslieferung** | Gespiegelte DPD-Felder (schreibgeschützt) für die Nachvollziehbarkeit gebuchter Lieferungen. |
### Verwandte Themen
* [Enum- & Options-Referenz](/dpd-connector-premium/referenz-and-datenmodell/enum-and-options-referenz.md) – alle Auswahlwerte im Detail
* [DPD-Konfiguration (Feldreferenz)](/dpd-connector-premium/verbindung-and-konfiguration/dpd-konfiguration-feldreferenz.md) – Felder der zentralen Einrichtung
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.solutioo.de/dpd-connector-premium/referenz-and-datenmodell/datenmodell-and-tabellen.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.