Dieser Artikel richtet sich an Entwickler, die die Methode GetShipAdvise.
verwenden möchten, um eine Liste gültiger Produkte vom Shipment Server zurückzubekommen.
Hinweis: Dieser Artikel hebt nur die verschiedenen verfügbaren Optionen für die Methode hervor.
Sie müssen Ihren eigenen Geschäftsablauf, Ihre Logik und Fehlerbehandlung anwenden.
Inhalt dieses Artikels:
Hinweis: Sie können die Entwicklertools verwenden, um die Anfragen zu testen.
GetShipAdvise
Die Methode gibt die Produkte zurück, die die CSR-Validierungen bestehen, und wenn mit der Option RequiredDeliveryDate angefragt, innerhalb eines bestimmten Datums geliefert werden.
Hinweis: Sowohl die Versandregeln als auch die Carrier Performance-Konfiguration werden normalerweise von einem technischen Berater von nShift konfiguriert.
Optionen, die mit der Methode verwendet werden können:
- Abrufen einer Liste gültiger Produkte
- Abrufen einer Liste gültiger Produkte mit Preisen
- Abrufen einer Liste gültiger Produkte mit ETA
- Abrufen einer Liste gültiger Produkte, die innerhalb eines Datums geliefert werden können
Abrufen einer Liste gültiger Produkte
{
"ServiceLevel": "Service_Level_Configured_For_ShipAdvisor",
}Alle gültigen Produkte werden ohne Preis- oder ETA-Informationen zurückgegeben.
Abrufen einer Liste gültiger Produkte mit Preisen
{
"ServiceLevel": "Service_Level_Configured_For_ShipAdvisor",
"Price": "fixed"
}Der Preis-Schlüssel kann auch wie folgt konfiguriert werden:
- "1" - Ruft CPC auf und verwendet den zurückgegebenen Price1.
- "2" - Ruft CPC auf und verwendet den zurückgegebenen Price2.
- "fixed" - Verwendet den im CSR-Konfigurationsdatei am Produkt konfigurierten Preis über den Price-Knoten.
Abrufen einer Liste gültiger Produkte mit ETA
{
"ServiceLevel": "Service_Level_Configured_For_ShipAdvisor",
"Deliverydate": "ETAWS"
}Es werden sowohl Produkte mit als auch ohne ETA zurückgegeben.
Hinweis: Dies erfordert die Definition einer Konfigurationsdatei, die die vereinbarte Lieferzeit mit Ihrem Carrier enthält.
Kontaktieren Sie den nShift-Kundendienst, falls dies benötigt wird.
Abrufen einer Liste gültiger Produkte, die innerhalb eines Datums geliefert werden können
{
"ServiceLevel": "Service_Level_Configured_For_ShipAdvisor",
"RequiredDeliveryDate": "2019-09-10"
}Es werden nur Produkte zurückgegeben, die vor dem RequiredDeliveryDate geliefert werden können.
Produkte, die nicht mit ETA konfiguriert sind, werden ebenfalls herausgefiltert.
Das Datum muss im ISO 8601-Format "yyyymmdd" vorliegen; die Uhrzeit wird automatisch hinzugefügt.
Das oben genannte Datum wird also als 2019-09-10T23:59:00 interpretiert.
Hinweis: Dies erfordert die Definition einer Konfigurationsdatei, die die vereinbarte Lieferzeit und die geplante Abholung mit Ihrem Carrier enthält. Kontaktieren Sie den nShift-Kundendienst, falls dies benötigt wird.
Daten
Im Request sollten nur Informationen zur Sendung enthalten sein. Alles bezüglich Dienstleistungen, Warentypen oder Produkt-ID sollte nicht enthalten sein.
{
"Addresses": [
{
"Kind": 1,
"Name1": "Name1 - Empfänger",
"Street1": "Testadresse 1",
"PostCode": "7400",
"City": "Herning",
"CountryCode": "DK",
"Email": "noreply@nshift.com"
}
],
"Lines": [
{
"PkgWeight": 1000,
"Number": 1
}
]
}Siehe diesen Artikel hier für grundlegende Beispiele des Datenobjekts, oder verwenden Sie die Entwicklertools zum Erstellen.
Für eine erweiterte Nutzung müssen Sie das Shipment Server - Appendix verwenden.