Feld-Mapping Dokumentation: reybex → Aldi
Übersicht
Diese Dokumentation beschreibt die Integration zwischen reybex und Aldi. Hinweis: Aldi unterstützt derzeit keine Material-Updates über die API. Die Integration ist auf das Abrufen und Aktualisieren von Bestellungen beschränkt.
⚠️ WICHTIGER HINWEIS
Diese Dokumentation unterliegt kontinuierlichen Änderungen.
Die Integration zwischen reybex und Aldi befindet sich in ständiger Entwicklung. Daher kann es vorkommen, dass:
- Neue Felder hinzugefügt werden - Um zusätzliche Funktionen zu unterstützen oder neue Aldi-Features zu nutzen
- Felder temporär entfernt werden - Wenn unerwartete Probleme auftreten, die negative Auswirkungen auf die Artikel haben
Empfehlung:
Bitte überprüfen Sie regelmäßig die aktuelle Dokumentation und testen Sie Änderungen in einer Testumgebung, bevor Sie sie in der Produktion einsetzen.
Verwendung dieser Dokumentation
Diese Dokumentation beschreibt die aktuelle Funktionalität der Aldi-Integration.
Wichtige Konzepte
reybex-Artikelstruktur
- Material: Ein Artikel/Produkt in reybex
- MaterialVariant: Eine Variante eines Artikels in reybex (z.B. Größe, Farbe)
- MaterialMarktplace: Marktplatz-spezifische Einstellungen für einen Artikel
Aldi-Produktstruktur
- Product: Das Produkt in Aldi
- REST API: Aldi Vendor Web Services
1. Aktuelle Funktionalität
1.1 Material-Update (updateMaterials)
Nicht implementiert: Die updateMaterials-Methode gibt derzeit null zurück.
1.2 Bestellungen (updateOrders)
Aldi unterstützt das Aktualisieren von Bestellungen:
| Aldi Feld | reybex Feld | Beschreibung | Bedingung |
|---|---|---|---|
consignment.vendorConsignmentCode |
order.delNoteDoc.docNumber |
Lieferschein-Nummer | Immer |
consignment.statusText |
Immer "SHIPPED" |
Status-Text | Immer |
consignment.trackingId |
order.licensePlate |
Tracking-ID | Immer |
consignment.trackingLink |
order.trackingCode |
Tracking-Link | Immer |
consignment.carrier |
order.carrierShortName |
Versandunternehmen | Immer |
consignment.shippingDate |
Aktuelles Datum (formatiert) | Versanddatum | Immer |
consignment.status |
Immer "SHIPPED" |
Status | Immer |
consignment.expectedDelivery |
Immer "2025-02-05" |
Erwartete Lieferung | Immer |
consignment.entries[].orderEntryNumber |
item.id |
Bestellposition-Nummer | Immer |
consignment.entries[].quantity |
item.deliveredQuantity |
Gelieferte Menge | Immer |
consignment.entries[].packageEntries[].vendorPackageCode |
order.licensePlate |
Paketcode | Immer |
consignment.entries[].packageEntries[].statusText |
Immer "SHIPPED" |
Paket-Status | Immer |
consignment.entries[].packageEntries[].trackingId |
order.licensePlate |
Paket-Tracking-ID | Immer |
consignment.entries[].packageEntries[].trackingLink |
order.trackingCode |
Paket-Tracking-Link | Immer |
consignment.entries[].packageEntries[].status |
Immer "SHIPPED" |
Paket-Status | Immer |
2. Export-Felder-Gruppen
Die Übertragung wird durch Export-Felder-Gruppen gesteuert:
| Export-Gruppe | Beschreibung | Übertragene Aldi-Felder |
|---|---|---|
| NICHT VERFÜGBAR | Material-Updates | Nicht implementiert |
3. Besondere Verhaltensweisen
3.1 REST API mit OAuth
Aldi verwendet REST API mit OAuth:
- Bestellungen-Update: POST /aldivendorwebservices/2.0/{siteCode}/vendor/{vendorId}/orders/{orderId}/consignments (JSON)
- Authentifizierung: OAuth 2.0 (Bearer Token)
3.2 OAuth-Authentifizierung
- Token wird über
/authorizationserver/oauth/tokenabgerufen - Grant Type:
password - Scope:
basic - Basic Auth mit
authUsernameundauthPassword
3.3 Site Code
- Standard:
"DE" - Kann über
params.siteCodeangepasst werden
3.4 Material-Update
- Material-Updates sind derzeit nicht implementiert
- Die
updateMaterials-Methode gibtnullzurück
4. Zusammenfassung: Vollständige Feld-Mappings
Produkt-Ebene
| Aldi Feld | reybex Feld | Export-Gruppe | Hinweise |
|---|---|---|---|
| - | - | NICHT VERFÜGBAR | Material-Updates nicht implementiert |
Bestellungen-Ebene
| Aldi Feld | reybex Feld | Export-Gruppe | Hinweise |
|---|---|---|---|
vendorConsignmentCode |
order.delNoteDoc.docNumber |
- | - |
statusText |
Immer "SHIPPED" |
- | - |
trackingId |
order.licensePlate |
- | - |
trackingLink |
order.trackingCode |
- | - |
carrier |
order.carrierShortName |
- | - |
shippingDate |
Aktuelles Datum | - | - |
status |
Immer "SHIPPED" |
- | - |
expectedDelivery |
Immer "2025-02-05" |
- | - |
entries[].orderEntryNumber |
item.id |
- | - |
entries[].quantity |
item.deliveredQuantity |
- | - |
entries[].packageEntries[] |
order.licensePlate, order.trackingCode |
- | - |
5. API-Endpunkte
- Bestellungen-Update:
POST /aldivendorwebservices/2.0/{siteCode}/vendor/{vendorId}/orders/{orderId}/consignments(JSON) - OAuth-Token:
POST /authorizationserver/oauth/token(x-www-form-urlencoded) - Material-Update: Nicht implementiert
- Authentifizierung: OAuth 2.0 (Bearer Token)
Version: 1.0
Erstellt: 2024
Zielgruppe: Externe Nutzer ohne reybex-Kenntnisse