Endpunkte
Anforderung der abgeschlossenen Bestelldetails
POST | https://api.iglobalstores.com/2.0/order-completed - Erstellen Sie eine neue Anfrage für Informationen zu einer abgeschlossenen Bestellung.
HTTPS-Anforderung
| Feld | Hinweise |
|---|---|
| HTTP-Methode | POST |
| Endpunkt-URL | https://api.iglobalstores.com/2.0/order-completed |
| Protokoll | HTTPS |
| Nachrichtenformat | JSON |
| Akzeptieren des HTTP-Headers | Accept: application/json |
| Sicherheitstoken HTTP-Header | serviceToken: Ihr-Test-Token-WertFügen Sie Ihrem HTTPS-Request 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 Service senden werden, fügen Sie Ihrem HTTPS-Request einen Header mit dem Namen Content-Type und einem Wert von application/json hinzu |
JSON-Schlüssel/Wert-Paare im Anforderungskö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
{
"billingAddress": {
"address1": "123 S West Elm St",
"address2": null,
"address3": null,
"city": "Calgary",
"countryCode": "CA",
"postalCode": "T2P 5G8",
"state": "Alberta",
"stateCode": null
},
"billingCompany": null,
"billingEmail": "jdoe@jdoe.com",
"billingName": "John E. Doe",
"billingPhone": "+1 555-555-5555",
"orderGrandTotal": 1225.89,
"orderNumber": "854725421",
"paymentTypeCode": "PAYPAL",
"prepaidDutyTax": true,
"shippingQuoteId": "bcdbdbcd-0145-4d3b-a54e-0de3cdce5a0a",
"shipToCompany": null,
"shipToEmail": "jdoe@jdoe.com",
"shipToName": "John Doe",
"shipToPhone": "+1 555-555-5555"
}
Definitionen für JSON-Anfragen
| Feld | Hinweise |
|---|---|
billingAddress ERFORDERLICH | Dies ist die Rechnungsadresse der Bestellung. Dies ist eine Karte, die die folgenden Adressfelder enthält: address1, address2, address3, city, state, stateCode, postalCode und countryCode. Diese enthaltenen Felder sind je nach Land erforderlich oder nicht erforderlich. Der Lokalisierungs-Endpunkt gibt an, welche spezifischen Adressfelder für jedes Land erforderlich oder nicht erforderlich sind. Hinweis: stateCode ist immer nicht erforderlich und wird nicht im Lokalisierungs-Endpunkt angegeben. Sie können stateCode übergeben, wenn verfügbar. |
billingCompany OPTIONAL | Dies ist der Name des Rechnungsunternehmens der Bestellung. |
billingEmail ERFORDERLICH | Dies ist die Rechnungs-E-Mail-Adresse der Bestellung. |
billingName ERFORDERLICH | Dies ist der vollständige Rechnungsname der Bestellung. |
billingPhone ERFORDERLICH | Dies ist die Rechnungs-Telefonnummer der Bestellung. |
items[index].orderGrandTotal ERFORDERLICH | Dies ist der Gesamtbetrag, den der Käufer für die Bestellung in USD (US-Dollar) bezahlt hat. Bitte ohne Kommas, ohne Dollarzeichen "$" und mit zwei Dezimalstellen angeben. Beispielwert: 2102.99 |
items[index].orderNumber ERFORDERLICH | Dies ist Ihre Bestellnummer für die neu abgeschlossene Bestellung. Beispielwert: 854725421 |
paymentTypeCode ERFORDERLICH | Die Zahlungsmethode, die der Käufer verwendet hat, um für die Bestellung zu bezahlen. Beispielwerte: PayPal oder Visa oder MC oder AMEX oder DISC |
prepaidDutyTax ERFORDERLICH | Hat der Käufer sich dafür entschieden, seine Einfuhrzölle und Steuern im Voraus zu prepay oder wurde er gezwungen, sie im Voraus zu prepay? Wenn ja, auf true setzen; wenn nicht, auf false setzen. Beispielwerte: true oder false |
shippingQuoteId ERFORDERLICH | Dies ist die ID des Versandangebots, das der Käufer ausgewählt hat. Die Warenkorbdetails müssen dieselben sein wie zum Zeitpunkt des Abrufs der Versandangebote. Wenn sich die Warenkorbdetails geändert haben, sollten Sie neue Versandangebote angefordert haben, bevor Sie die Bestellung des Käufers abschließen. |
shipToCompany OPTIONAL | Dies ist der Name des Unternehmens der Person, die die versandte Bestellung erhalten wird. |
shipToEmail ERFORDERLICH | Dies ist die E-Mail-Adresse der Person, die die versandte Bestellung erhalten wird. |
shipToName ERFORDERLICH | Dies ist der vollständige Name der Person, die die versandte Bestellung erhalten wird. |
shipToPhone ERFORDERLICH | Dies ist die Telefonnummer der Person, die die versandte Bestellung erhalten wird. |
HTTPS-Antwort
Nachrichtenformat: JSON
Beispielantwort nur für Kanada & Australien
Hinweis: Die tatsächlichen Antworten enthalten alle unterstützten Länder.
Beispielantwort
1
2
3
4
5
6
7
{
"igOrderId": "e55a4efc-e615-49af-b3a4-afcda87e9e5e",
"deniedParty": {
"flagged": true,
"source": "source reference for review"
}
}
Antwort JSON-Definitionen
| Feld | Hinweise |
|---|---|
deniedParty | Dies ist eine Karte der Ergebnisse der Überprüfung auf abgelehnte Parteien. Wenn auf null gesetzt, wurde die Überprüfung auf abgelehnte Parteien nicht durchgeführt. Kontaktieren Sie Ihren Zonos-Vertreter, wenn Sie auf dieses Problem stoßen. |
deniedParty.flagged | Ob diese Bestellung mit einem Eintrag in den abgelehnten Parteien der Zonos-Konsolidierungslisten übereinstimmt. Wenn true, überprüfen Sie diese Bestellung, bevor Sie sie bearbeiten. Im Zweifelsfall bearbeiten Sie keine Bestellung, die als true markiert ist. Beispielswerte: true oder false |
deniedParty.source | Wenn das Feld flagged auf true gesetzt wurde, enthält dieses Feld Quellverweise, die nützlich sind, um zu überprüfen, warum die Bestellung als Übereinstimmung mit einer abgelehnten Partei markiert wurde. |
igOrderId | Zonos-Kennung für die neu abgeschlossene Bestellung. Beispielswert: e55a4efc-e615-49af-b3a4-afcda87e9e5e |
Legacy Order Completed API
Erfahren Sie, wie die Legacy Order Complete API funktioniert.
Der Order Completed-Endpunkt akzeptiert die endgültigen Details der Bestellung des Käufers, überprüft die Bestelldetails auf abgelehnte Parteien und gibt die Ergebnisse zusammen mit einer spezifischen Bestellnummer von Zonos zurück.