Endpunkte
Versandangebote anfordern
POST | https://api.iglobalstores.com/2.0/shipping-quotes - Erstellen Sie eine neue Anfrage für Versandangebote zu Artikeln im Warenkorb, die Einfuhrzölle und Steuern sowie Informationen zur Überprüfung von Artikelbeschränkungen enthalten.
HTTPS-Anfrage
| Feld | Hinweise |
|---|---|
| HTTP-Methode | POST |
| Endpunkt-URL | https://api.iglobalstores.com/2.0/shipping-quotes |
| Protokoll | HTTPS |
| Nachrichtenformat | JSON |
| Akzeptieren HTTP-Header | Accept: application/json |
| Sicherheitstoken-HTTP-Header | serviceToken: your-test-token-valueFügen Sie Ihrer HTTPS-Anfrage einen Header mit dem Namen serviceToken und einem Wert Ihres Test-Sicherheits-API-Tokens hinzu. (Kontaktieren Sie Ihren Account Manager für dieses Token) |
| Content-Type-HTTP-Header | Content-Type: application/jsonDa Sie JSON-Daten an den Dienst senden werden, fügen Sie Ihrer HTTPS-Anfrage einen Header mit dem Namen Content-Type und einem Wert von application/json hinzu |
JSON SCHLÜSSEL/WERT-PAARE im Anfragekörper
Nachrichtenformat: JSON
Beispielanfrage
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
{
"boxCount": null,
"items": [
{
"cartItemId": 1,
"detailedDescription": "description including options, material content, etc",
"category": "sunglasses",
"productId": "17898-675234",
"sku": "oakley-123",
"unitPrice": 199.0,
"quantity": 1,
"length": 2.5,
"width": 6.5,
"height": 2.5,
"dimensionalUnits": null,
"weight": 4,
"weightUnits": "OZ",
"hsCode": null,
"brandName": "Oakley",
"countryOfOrigin": "CN"
},
{
"cartItemId": 2,
"detailedDescription": "description including options, material content, etc",
"category": "sunglasses",
"productId": "17898-675235",
"sku": "oakley-125",
"unitPrice": 179.0,
"quantity": 1,
"length": 2.5,
"width": 6.5,
"height": 2.5,
"dimensionalUnits": null,
"weight": 4,
"weightUnits": "OZ",
"hsCode": null,
"brandName": "Oakley",
"countryOfOrigin": "CN"
}
],
"shippingAmountOverride": null,
"shipFromAddress": null,
"shipToAddress": {
"name": "John Doe",
"address1": "123 S West Elm St",
"address2": null,
"address3": null,
"city": "Calgary",
"state": "Alberta",
"stateCode": "AB",
"postalCode": "T2P 5G8",
"countryCode": "CA"
}
}
Anforderung JSON-Definitionen
| Feld | Anmerkungen |
|---|---|
boxCount | Dieses Feld beschreibt die Kartons, die zum Versand der Bestellung verwendet werden. Es wird nicht erwartet, dass ein Händler dies zum Zeitpunkt der Bestellung weiß; wenn es jedoch bekannt ist, kann es in folgendem spezifischen Format übergeben werden.Beispielwert: 22x15x15(1),8x8x4(2),32x22x14(1)Format: Komma-getrennte Liste der Kartonabmessungen und Anzahl. Im obigen Beispiel gibt es insgesamt 4 Kartons. Der erste Karton in der Liste wird 22 Zoll lang, 15 Zoll breit und 15 Zoll hoch sein. Es wird nur ein Karton dieser Größe verwendet. Es wird zwei Kartons der Größe 8x8x4 Zoll geben. Es ist akzeptabel, die gleiche Kartonabmessung mehrmals zu übergeben, wenn das für Sie einfach ist, so wie dies: "22x15x15(1),22x15x15(1)", was bedeutet, 2 Kartons der Größe 22x15x15 Zoll. |
items ERFORDERLICH | Eine Liste von Artikelkarten |
items[index].brandName | Der Markenname des spezifischen Artikels hilft unserer Regeln-Engine am besten zu bestimmen, ob eine Einschränkung für den Artikel für das Zielland gilt.Auch wenn der Markenname eines Artikels mit einer spezifischen Einschränkung übereinstimmt oder nicht, wird unsere Regeln-Engine die SKU des Artikels und/oder productId verwenden, um besser zu entscheiden, ob der Artikel tatsächlich in das Zielland eingeschränkt ist. Bitte senden Sie den Markennamen, wenn verfügbar.Beispielwerte: "Oakley" oder "Nike" oder null |
items[index].cartItemId ERFORDERLICH | Dieses Feld ist erforderlich, um den Artikel speziell innerhalb der Liste der Artikel zu identifizieren. Es kann so einfach sein wie ein Indexwert. Wir werden diese cartItemId verwenden, um einen Artikel zu identifizieren, wenn er in der JSON-Antwort eingeschränkt ist. Stellen Sie also sicher, dass Sie in der Lage sind, den gleichen Artikel in Ihrem Warenkorb anhand dieser cartItemId zu identifizieren, die Sie uns übergeben.Beispielwerte: 1 oder 2 oder 3 |
items[index].category | Die Produktkategorien - das spezifische Produkt, zu dem es gehört. Die Kategorie wird unserer Regeln-Engine am besten helfen zu bestimmen, ob eine Einschränkung für den Artikel für das Zielland gilt.Auch wenn die Kategorie eines Artikels mit einer spezifischen Einschränkung übereinstimmt oder nicht, wird unsere Regeln-Engine die SKU des Artikels und/oder productId verwenden, um besser zu entscheiden, ob der Artikel tatsächlich in das Zielland eingeschränkt ist.Format: Eine durch Pipe getrennte Liste von Kategorienamen. Jeder Kategoriename kann ein oder mehrere Wörter sein. Wenn ein Artikel in mehr als einer Kategorie existiert, listen Sie bitte beide auf, getrennt durch ein Pipe "" Zeichen.Beispiel: Werte "Sonnenbrillen" oder "AbendzubehörHandtaschen" |
items[index].countryOfOrigin | Das Herkunftsland ist das Land, in dem der Artikel hergestellt wurde oder ursprünglich herkommt. Das Herkunftsland hilft unserem Regelwerk am besten zu bestimmen, ob eine Beschränkung für den Artikel im Zielland gilt. Einige Länder erlauben bestimmte Arten von Waren aus bestimmten anderen Ländern nicht. Beispielswerte: "CN" für China oder "US" für die Vereinigten Staaten oder null |
items[index].detailedDescription ERFORDERLICH | Dieses Feld ist einfach Text, sollte jedoch so viele Informationen wie möglich über den gekauften Artikel enthalten. Zum Beispiel den vollständigen Namen und die Artikelnummer, falls zutreffend, die ausgewählte Farbe oder andere Optionen, Materialinhalt und jeglichen Beschreibungstext, den Sie für den Artikel haben. Es gibt viele verschiedene Arten von Einfuhrbeschränkungen in ausländische Länder, wie z.B. Lederschuhe nach Italien. Manchmal ist der einzige Weg, diese beschränkten Artikel zu erkennen, die detailedDescription. Hinweis: Selbst wenn die detailedDescription eines Artikels einem bestimmten Verbotstext entspricht oder nicht, wird unser Regelwerk die Artikelnummer und/oder die productId des Artikels verwenden, um besser zu entscheiden, ob der Artikel tatsächlich in das Zielland eingeführt werden darf. Für beste Ergebnisse senden Sie bitte so viele Informationen wie möglich im Feld detailedDescription. Beispielswert: "Tory Burch, Robinson - Double Zip' Tote, Farbe: New Carnival, Materialinhalt: Leder, Farbintensives Leder verleiht einer ordentlich strukturierten Tote eine auffällige Anziehungskraft, abgerundet mit Logo-Hardware und gerollten Griffen für einen vollkommen raffinierten Look. Magnetverschluss mit zwei Reißverschlussfächern. Innen Reißverschluss-, Wand- und Handyfächer. Schützende Metallfüße. Leder. Von Tory Burch; importiert." |
items[index].height | Dies ist die Höhe Ihres Artikels. Es gibt ein weiteres Feld namens dimensionalUnits, in dem Sie Zoll oder Zentimeter für diese Messung angeben. Bitte geben Sie die Höhe ohne Kommas und mit nicht mehr als zwei Dezimalstellen an. Beispielswert: 25,5 Ihre Versandkosten werden am genauesten sein, wenn Sie dieses Feld ausfüllen. |
items[index].hsCode | Dies ist der HS-Code, der den Artikel in ausländischen Ländern identifiziert. Die Angabe des hsCode hilft dabei, den richtigen Einfuhrzoll rate für den spezifischen Artikel korrekt zu identifizieren. Nicht erforderlich, wenn nicht verfügbar - wir kümmern uns darum, wenn Sie ihn nicht haben. Format: Entweder ein 10-stelliger oder 6-stelliger Code; kann die Trennzeichen "." enthalten oder nicht. Beispielswerte: "20.4560.0000" oder "20.4560" oder "204560" (10- oder 6-stellige Codes sind akzeptabel) |
items[index].length | Dies ist die Länge Ihres Artikels. Es gibt ein weiteres Feld namens dimensionalUnits, in dem Sie Zoll oder Zentimeter für diese Messung angeben. Bitte geben Sie die Länge ohne Kommas und mit nicht mehr als zwei Dezimalstellen an. Beispielswert: 25,5 Ihre Versandkosten werden am genauesten sein, wenn Sie dieses Feld ausfüllen. |
items[index].productId | Dies ist Ihre Produkt-ID für den spezifischen Artikel. Unser Regelwerk wird diesen Wert als ID verwenden, um gelernte Artikelinformationen mit Ihrem Artikel zu verknüpfen. Beispielswert: "17898-675235" Bitte geben Sie mindestens die productID oder die SKU an. Die Angabe beider Werte ist bevorzugt. |
items[index].quantity ERFORDERLICH | Dies ist die Menge, die für den spezifischen Artikel gekauft wird. Bitte geben Sie eine positive Ganzzahl ohne Kommas und ohne Dezimalstellen an. Beispielswerte: 1 oder 9999 (wir bevorzugen, dass Sie mehr Artikel verkaufen als weniger!) |
items[index].sku | Dies ist Ihre SKU für den spezifischen Artikel. Unser Regelwerk wird diesen Wert als ID verwenden, um gelernte Artikelinformationen mit Ihrem Artikel zu verknüpfen. Beispielswert: "oakley-125" Bitte geben Sie mindestens die productId oder die SKU an. Die Angabe beider Werte ist bevorzugt. |
items[index].unitPrice ERFORDERLICH | Dies ist der Stückpreis Ihres Artikels in USD (US-Dollar). Bitte geben Sie den Preis ohne Kommas, ohne das Dollarzeichen "$" und mit zwei Dezimalstellen an. Beispielswert: 2102,99 |
items[index].weight | Dies ist das Gewicht Ihres Artikels. Es gibt ein weiteres Feld namens weightUnits, in dem Sie Pfund, Unzen, Gramm oder Kilogramm für diese Messung angeben. Bitte geben Sie dies ohne Kommas und mit höchstens zwei Dezimalstellen an. Beispielwert: 4.2 Ihre Versandkosten werden am genauesten sein, wenn Sie dieses Feld übergeben. |
items[index].weightUnits | Standardmäßig auf "LB" für Pfund eingestellt. Die Maßeinheit für den Gewichtswert. Wenn auf null gesetzt, wird "LB" (Pfund) angenommen. Beispielwerte: "LB" für Pfund oder "OZ" für Unzen oder "G" für Gramm oder "KG" für Kilogramm oder null |
items[index].width | Dies ist die Breite Ihres Artikels. Es gibt ein weiteres Feld namens dimensionalUnits, in dem Sie Zoll oder Zentimeter für diese Messung angeben. Bitte geben Sie dies ohne Kommas und mit höchstens zwei Dezimalstellen an. Beispielwert: 25.5 Ihre Versandkosten werden am genauesten sein, wenn Sie dieses Feld übergeben. |
shipFromAddress | Wenn als null übergeben, verwenden wir eine Standard shipFromAddress, die mit Ihrem Händlerkonto verknüpft ist. Dies ist die Adresse, von der aus die Bestellung versendet wird, d.h. Ihr Lager. Dies ist eine Karte, die die folgenden Adressfelder enthält: address1, address2, address3, city, state, stateCode, postalCode, countryCode. Diese enthaltenen Felder sind je nach Land erforderlich oder nicht erforderlich. Der Lokalisierungs-Endpunkt gibt zurück, welche spezifischen Adressfelder für jedes Land erforderlich sind oder nicht. Hinweis: stateCode ist immer nicht erforderlich und wird nicht im Lokalisierungs-Endpunkt angegeben. Sie können stateCode übergeben, wenn verfügbar. |
shippingAmountOverride | Dies wird nur verwendet, wenn Sie die Versandkosten vor dem Aufruf der API kennen. Es handelt sich um USD (US-Dollar). Bitte geben Sie dies ohne Kommas, ohne ein Dollarzeichen "$" und mit zwei Dezimalstellen an. Diese Funktion funktioniert nicht, ohne sie mit einem Zonos-Vertreter einzurichten. Beispielwert: 212.99 |
shipToAddress ERFORDERLICH | Dies ist die Adresse, an die die Bestellung versendet wird. Dies ist eine Karte, die die folgenden Adressfelder enthält: name, address1, address2, address3, city, state, stateCode, postalCode, countryCode. Diese enthaltenen Felder sind je nach Land erforderlich oder nicht erforderlich. Der Lokalisierungs-Endpunkt gibt zurück, welche spezifischen Adressfelder für jedes Land erforderlich sind. Hinweis: name und stateCode sind immer nicht erforderlich und werden nicht im Lokalisierungs-Endpunkt angegeben. Sie können name und/oder stateCode übergeben, wenn verfügbar. |
HTTPS-Antwort
Nachrichtenformat: JSON
Beispielantwort nur für Kanada & Australien
Hinweis: Die tatsächlichen Antworten enthalten alle unterstützten Länder.
Beispielanfrage
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
{
"shippingQuotes": [
{
"id": "bcdbdbcd-0145-4d3b-a54e-0de3cdce5a0a",
"carrier": "UPS",
"conversionRate": 1.32,
"currencyCode": "CAD",
"displayName": "Express Air 2-4 Day Delivery",
"duty": 10.2,
"dutyTaxBrokerageFee": 5.0,
"dutyTaxCarrierPrepaymentFee": 5.0,
"dutyTaxEnabled": true,
"dutyTaxForced": false,
"dutyTaxTotal": 29.38,
"dutyTaxUnderDeminimus": false,
"restrictedItems": [
{
"cartItemId": 1,
"message": "We are unable to sell Oakley products to your country.",
"reasonCode": "BRAND_COUNTRY"
},
{
"cartItemId": 2,
"message": "We are unable to sell Oakley products to your country.",
"reasonCode": "BRAND_COUNTRY"
}
],
"shippingTotal": 23.62,
"taxOrVat": 9.18
},
{
"id": "80c57724-ab4e-4997-8477-08b668fef103",
"carrier": "USPS",
"conversionRate": 1.32,
"currencyCode": "CAD",
"displayName": "Post 5-10 Day Delivery",
"duty": 9.2,
"dutyTaxBrokerageFee": 5.0,
"dutyTaxCarrierPrepaymentFee": 5.0,
"dutyTaxEnabled": true,
"dutyTaxForced": false,
"dutyTaxTotal": 27.38,
"dutyTaxUnderDeminimus": false,
"restrictedItems": [
{
"cartItemId": 1,
"message": "We are unable to sell Oakley products to your country.",
"reasonCode": "BRAND_COUNTRY"
},
{
"cartItemId": 2,
"message": "We are unable to sell Oakley products to your country.",
"reasonCode": "BRAND_COUNTRY"
}
],
"shippingTotal": 13.62,
"taxOrVat": 8.18
}
]
}
Antwort-JSON-Definitionen
| Feld | Anmerkungen |
|---|---|
shippingQuotes | Dies ist eine Liste von Versandangeboten. |
shippingQuotes[index].carrier | Der Spediteur, auf den sich das Versandangebot bezieht. Wird nur dann auf null gesetzt, wenn der Händler generische Versandprofile einrichten möchte, die nicht spezifisch für einen Spediteur sind. Versandangebote müssen nicht spezifisch für einen Spediteur sein; können es aber sein. Kontaktieren Sie Ihren Account Manager, um Hilfe bei der Einrichtung Ihrer Versandprofile zu erhalten.Beispielwerte: UPS oder FEDEX oder DHL oder USPS oder CAPOST oder null |
shippingQuotes[index].displayName | Anzeigename für die Versandoption, geeignet zur Anzeige für den Käufer. Diese Werte sind für den Händler anpassbar. Kontaktieren Sie Ihren Account Manager, um dies zu tun.Beispielwert: „Express Air 2-4 Tage Lieferung“ |
shippingQuotes[index].duty | Der Einfuhrzollbetrag, der im dutyTaxTotal enthalten ist. Dieser Betrag ist in USD, enthält keine Kommas und hat zwei Dezimalstellen.Beispielwert: 8.29 |
shippingQuotes[index] .dutyTaxBrokerageFee | Dies ist die Gebühr, die der ausländische Importmakler Ihnen für die Bearbeitung Ihrer Einfuhrzölle und -steuern berechnet. Dieser Betrag ist im dutyTaxTotal enthalten. Der Betrag ist in USD, enthält keine Kommas und hat zwei Dezimalstellen.Beispielwert: 5.00 |
shippingQuotes[index] .duyTaxCarrierPrepaymentFee | Dies ist die Gebühr, die der Spediteur Ihnen berechnet, um die Zölle und Steuern an das Einfuhrland zu prepay. Dieser Betrag ist im dutyTaxTotal enthalten. Dieser Betrag ist in USD, enthält keine Kommas und hat zwei Dezimalstellen.Beispielwert: 5.00 |
shippingQuotes[index] .duyTaxEnabled | Ob dieses Versandangebot es dem Käufer ermöglicht, seine Einfuhrzölle und -steuern zu prepay. Wenn auf false gesetzt, sollte das dutyTaxTotal ignoriert werden.Beispielwerte: true oder false |
shippingQuotes[index] .duyTaxForced | Ob dieses Versandangebot den Käufer zwingt, seine Einfuhrzölle und -steuern zu prepay. Wenn auf true gesetzt, sollten Sie das dutyTaxTotal in die Bestellung aufnehmen und dem Käufer erklären, dass dies bei dieser speziellen Versandoption erforderlich ist. Wenn auf false gesetzt, können Sie dem Käufer die Wahl lassen, ob er seine Einfuhrzölle und -steuern zu prepay möchte.Beispielwerte: true oder false |
shippingQuotes[index].dutyTaxTotal | Die Gesamtkosten für Zoll und Steuern für das angegebene Versandangebot. Zoll und Steuern können optional, nicht verfügbar oder für das angegebene Versandangebot zwingend erforderlich sein. Dieser Betrag ist nicht im shippingTotal enthalten. Dieser Betrag ist in USD, enthält keine Kommas und hat zwei Dezimalstellen.Beispielwert: 19.55 |
shippingQuotes[index] .dutyTaxUnderDeMinimis | Ob der Gesamtbetrag der Bestellung mit dieser speziellen Versandoption unter dem Steuer-/Mehrwertsteuerfreibetrag und dem Zollfreibetrag liegt. Wenn auf true gesetzt, wird das dutyTaxTotal auf 0.00 gesetzt, und Sie sollten den Kunden darüber informieren, dass für seine Bestellung keine Einfuhrzölle oder -steuern anfallen. Zwingen Sie außerdem die Vorauszahlung von Zöllen und Steuern, da die Kosten 0.00 betragen. |
shippingQuotes[index].id | Ein Bezeichner für das spezifische Versandangebot; eine 36-stellige UUIDBeispielwert: bcdbdbcd-0145-4d3b-a54e-0de3cdce5a0a |
shippingQuotes[index].restrictedItems | Dies ist eine Liste von Maps, die Details zu allen Artikeln im Warenkorb enthalten, die mit diesem spezifischen Versandangebot eingeschränkt sind. Jeder eingeschränkte Artikel hat einen reasonCode. Der Grund kann spezifisch für die Versandoption sein oder auch nicht. Einige Gründe für Artikelbeschränkungen sind auf länderspezifische Einfuhrbestimmungen, Markenbeschränkungen oder sogar vom Händler erstellte Regeln zurückzuführen. Jedes Mal, wenn ein Versandoption vom Käufer ausgewählt wird, sollten die Warenkorbartikel mit der restrictedItems-Liste des Versandangebots abgeglichen werden. Wenn einige der Warenkorbartikel eingeschränkt sind, sollte dem Käufer eine Nachricht angezeigt werden, und die eingeschränkten Artikel sollten aus der Gesamtbestellung entfernt werden, usw. |
shippingQuotes[index] .restrictedItems[index].cartItemId | Dies ist die cartItemId aus dem Anfrage-JSON eines eingeschränkten Warenkorbaritkels. Sie sollten in der Lage sein, diese cartItemId mit einem bestimmten Artikel im Warenkorb Ihres Käufers in Verbindung zu bringen. Beispielswerte: 1 oder 2 oder 3 |
shippingQuotes[index] .restrictedItems[index].message | Dies ist eine Nachricht, die dem Käufer angezeigt werden kann, warum der Artikel eingeschränkt ist. Diese Nachrichten können vom Händler angepasst werden. Bitte kontaktieren Sie Ihren Zonos-Vertreter für weitere Details. Beispielswert: "Wir können Oakley-Produkte nicht in Ihr Land verkaufen." |
shippingQuotes[index] .restrictedItems[index].reasonCode | Dies ist der Grundcode für die Einschränkung des Artikels. Einschränkungen sind immer länderspezifisch, und unsere Grundcodes machen das offensichtlich. Beispielswerte: BRAND_COUNTRY oder IMPORT_COUNTRY oder EXPORT_COUNTRY oder CARRIER_COUNTRY oder MERCHANT_COUNTRY. BRAND_COUNTRY bedeutet, dass Sie angegeben haben, dass Sie eine Marke nicht an eine bestimmte Gruppe von Ländern verkaufen können. IMPORT_COUNTRY bedeutet, dass das einführende Land den Import des Artikels nicht zulässt. EXPORT_COUNTRY bedeutet, dass das exportierende Land (normalerweise die Vereinigten Staaten) den Export des Artikels nicht zulässt. CARRIER_COUNTRY bedeutet, dass der spezifische Spediteur den Artikel nicht transportieren wird. MERCHANT_COUNTRY bedeutet, dass Sie eine benutzerdefinierte Einschränkungsregel festgelegt haben, die der Artikel ausgelöst hat. |
shippingQuotes[index] .shippingTotal | Die Gesamtkosten für den Versand des angegebenen Versandangebots. Versandangebote können auch einen Betrag für dutyTaxTotal enthalten, der nicht in dieser shippingTotal enthalten ist. Dieser Betrag ist in USD, enthält keine Kommas und enthält zwei Dezimalstellen. Beispielswert: 25,82 |
shippingQuotes[index].taxOrVat | Der in dutyTaxTotal enthaltene Steuer- oder Mehrwertsteuerbetrag. Für einige Länder handelt es sich um eine Steuer, für andere um eine Mehrwertsteuer. Dieser Betrag ist in USD, enthält keine Kommas und enthält zwei Dezimalstellen. Beispielswert: 4,35 |
Landed Cost API Legacy
Erfahren Sie, wie die Legacy Landed Cost API funktioniert.Die folgenden Informationen beziehen sich auf unsere Legacy Landed Cost API. Sehen Sie sich unsere Landed Cost API für die neueste Version an.
Der Endpunkt für Versandangebote akzeptiert Details über den Warenkorb Ihres Käufers, liefert Versandangebote inklusive Einfuhrzöllen und Steuern sowie Informationen zur Überprüfung von Artikelbeschränkungen. Diese zurückgegebenen Versandangebote basieren auf Versandprofilen, die vor der Verwendung dieses API-Endpunkts eingerichtet wurden.
Wir haben Standard-Versandprofile für Testzwecke, aber Sie müssen mit Ihrem Account Manager zusammenarbeiten, um die tatsächlichen Versandprofile und Einstellungen einzurichten, die Ihr Unternehmen verwenden möchte.