Dieser Artikel richtet sich an Entwickler, die Sendungen basierend auf dem Token erstellen möchten, das von der Methode GetShipAdvise zurückgegeben wird.
Hinweis: Dies dient nur als einfaches Beispiel.
Sie müssen Ihre eigene Geschäftslogik und Fehlerbehandlung implementieren.
Inhalt dieses Artikels:
Der Token-Schlüssel
Ein spezieller Schlüssel, der Product, GoodsType, Services und Werte aus den im CSR-Dokument verwendeten Expressions enthalten kann.
Die Idee hinter dem Token ist, dass Sie das Datenobjekt nicht mehr um die oben genannten Informationen erweitern müssen.
Sie müssen lediglich den Token-Schlüssel im Options-Objekt hinzufügen.
Hinweis: Sie können die Developer Tools verwenden, um die Anfragen zu testen
Beispiel
Senden einer Anfrage an die Methode GetShipAdvise mit den untenstehenden Options- und Datenobjekten:
Options:
{
"ServiceLevel": "Service_Level_Configured_For_SA"
}Data:
{
"Addresses": [
{
"Kind": 1,
"Name1": "Name1 - Receiver",
"Street1": "Test address 1",
"PostCode": "7400",
"City": "Herning",
"CountryCode": "DK",
"Email": "noreply@nshift.com"
}
],
"Lines": [
{
"PkgWeight": 1000,
"Number": 1
}
]
}Führt zu einer Antwort wie dieser:
{
"Products": [
{
"ProdConceptID": 113,
"ProdCSID": 349,
"ProdName": "GLS DK - Normal erhvervspakke",
"CustomFields": {
"type": "Home Delivery"
},
"Services": [
{
"serviceid": 11008,
"name": "Privat Levering"
},
{
"serviceid": 11014,
"name": "Flex Delivery"
}
],
"Token": "11008|11014_0_0_547_517_349_113_0_0__0_...",
"SupportsDropPoint": 0
}
]
}Siehe die CSR-Konfiguration, um zu verstehen, warum diese Produkte zurückgegeben wurden.
Wenn Sie nun das Token im Options-Objekt für die Anfrage an die Methode SubmitShipment verwenden:
Options:
{
"Labels": "PNG",
"Token": "11008|11014_0_0_547_517_349_113_0_0__0_..."
}Und weiterhin dasselbe Data-Objekt wie in der Anfrage an GetShipAdvise verwenden:
{
"Addresses": [
{
"Kind": 1,
"Name1": "Name1 - Receiver",
"Street1": "Test address 1",
"PostCode": "7400",
"City": "Herning",
"CountryCode": "DK",
"Email": "noreply@nshift.com"
}
],
"Lines": [
{
"PkgWeight": 1000,
"Number": 1
}
]
}Wenn Sie die Antwort prüfen, sollte diese eine Sendung enthalten, die auf dem Token des von GetShipAdvise zurückgegebenen Produkts basiert.
Die ProdConceptID, die Senderadresse (Expressions), der GoodsType und die Services sollten nun angewendet worden sein.
{
"ShpCSID": 3375,
"ShpESID": 3233700847,
"ShpTag": "EF59D0A0-0EF3-4155-AEB9-3516B076ECC0",
"InstallationID": "30000364023",
...
"Services": [
11008,
11014
]
}
Shipping Rules
Die Konfigurationsdatei enthält die Produkte und Validierungen, die für die Methode GetShipAdvise in diesem Artikel verwendet werden.
<?xml version="1.0" encoding="utf-8"?>
<CSR carriervalidation="0" defaultservicelevel="Service_Level_Configured_For_SA">
...
</CSR>