API für Bestellungen
Bestellung abrufen
Produktionsendpunkt:
https://transact.ti.com/v2/store/orders/
Rufen Sie Informationen zu Ihren Bestellungen mit der API zum Abrufen von Bestellungen ab.
Ihre Möglichkeiten:
- Sehen Sie sich eine Liste Ihrer letzten Bestellungen an (standardmäßig zeigt sie die letzten 30 Tage).
- Erhalten Sie Informationen zu einer bestimmten Bestellung anhand der Bestellnummer.
Schritte:
- Authentifizierung: Sie benötigen Ihren zugewiesenen API-Schlüssel und Ihr Geheimnis, um sich bei der API zu authentifizieren.
- API-Anforderung: Schicken Sie eine Abfrage an die API für Bestellungen, um den Bestellstatus und zusätzliche Details zu erhalten.
- API-Antwort: Sie erhalten eine Antwort mit einem Statuscode (200 OK) und einer JSON-Datei, die Ihre Bestelldetails enthält.
- Bestellungen nach Datum filtern (optional):
- Um einen Datumsbereich festzulegen, fügen Sie die Abfrageparameter „startDate“ und „endDate“ in Ihre Anfrage ein.
- Zum Beispiel: https://transact.ti.com/v2/store/orders?startDate=2021-05-01&endDate=2025-05-31
- Spezifische Bestelldetails abrufen:
- Um detaillierte Informationen zu einer bestimmten Bestellung zu erhalten, fragen Sie die API für Bestellungen mit der Bestellnummer ab.
- Zum Beispiel: "https://transact.ti.com/v2/store/orders/T999999999"
Beispielanforderung unter Angabe der Bestellnummer:
curl --request GET \
--url 'https://transact.ti.com/v2/store/orders/{orderNumber}'
--header 'Authorization: Bearer {access_token}' \
Example response:
{
"orderNumber": 0,
"orderStatus": "string",
"customerPurchaseOrderNumber": "string",
"subTotal": 0,
"totalPrice": 0,
"lineItems": [
{
"tiPartNumber": "string",
"tiPartDescription": "string",
"quantity": "string",
"status": "string",
"unitPrice": 0,
"customReelIndicator": true
}
],
"shippingAddress": [
{
"addressType": "string",
"firstName": "string",
"lastName": "string",
"company": "string",
"addressLine1": "string",
"addressLine2": "string",
"town": "string",
"state": "string",
"postalCode": "string",
"country": "string",
"email": "string",
"phoneNumber": "string",
"companyURL": "string"
}
],
"billingAddress": [
{
"addressType": "string",
"firstName": "string",
"lastName": "string",
"company": "string",
"addressLine1": "string",
"addressLine2": "string",
"town": "string",
"state": "string",
"postalCode": "string",
"country": "string",
"email": "string",
"phoneNumber": "string",
"companyURL": "string"
}
],
"orderMessages": [
{
"code": "string",
"type": "string",
"Message": "string"
}
],
"customerOrderAttributes": [
{
"attribute": "string"
}
],
"orderPlacedTime": "string",
"paymentType": "string",
"currencyISO": "string",
"totalTax": 0,
"checkoutProfileIdentifier": "string",
"totalDeliveryCost": 0,
"totalDiscount": 0,
"couponCodes": "string"
}