API für Bestellungen

Bestellung erstellen

Test-Endpunkt: 
https://transact.ti.com/v2/store/orders/test

Produktionsendpunkt:
https://transact.ti.com/v2/store/orders/

Die API für Bestellungen gibt Ihnen die Möglichkeit, Bestellungen direkt über Ihr System zu erstellen und zu verwalten. Rufen Sie für bessere Nachverfolgung und Verwaltung detaillierte Bestellinformationen ab.

 

Bevor Sie beginnen:

  • Bestand und Preise überprüfen: Verwenden Sie vor dem Erstellen einer Bestellung die Inventar- und Preis-API, um die Verfügbarkeit und den Preis einzelner Artikel zu bestätigen.
  • API-Checkout-Profil aktivieren: Sie müssen ein API-fähiges Checkout-Profil in Ihrem Firmenkonto einrichten. Weitere Informationen zum Erstellen von Konten und Profilen finden Sie in der Anleitung „Erste Schritte“.
  • Wenn ein Checkout-Profil fehlt: Stellen Sie sicher, dass das Checkout-Profil vollständig ist und eine zulässige Zahlungsmethode hinzugefügt wurde (siehe Zahlungsinformationen für weitere Informationen).


Testen:

Verwenden Sie den Testendpunkt (https://transact.ti.com/v2/store/orders/test), um den Prozess und die Antwort der Auftragserstellung zu simulieren. Denken Sie daran, dass diese Daten nur zu Demonstrationszwecken dienen.

Anmerkungen zur Bestellung:

  • In den Feldern „customerOrderComments“ und „customerItemComments“ können Sie mit Ihrer Bestellung zusätzliche Informationen übermitteln.
  • Die Daten sind nur für den Kunden bestimmt und werden nicht von TI validiert.
  • Im Beispiel unten wird das Array „customerOrderComments“ verwendet, um ein Array aus durch Pipes getrennten Strings zu übergeben, um die Jobnummer und den Namen der Person anzugeben, die die Bestellung aufgibt.

Beispiel:

    "customerOrderComments": [
      {
        "message": "jobNumber|54851-50"
      },
      {
        "message": "orderedBy|John Smith"
      } 
 ]    

Ablauf der Auftragserstellung:

  1. Authentifizieren Sie sich mit Ihrem zugewiesenen API-Schlüssel und Geheimnis.
  2. Überprüfen Sie die Produktverfügbarkeit und die aktuellen Preise mit der Bestands- und Preis-API.
  3. Die API antwortet mit einem Statuscode (200 OK) und einer JSON-Antwort, die die angeforderten Produktdaten enthält.
  4. Nachdem Sie die Verfügbarkeit mit der Bestands- und Preis-API bestätigt haben, erstellen Sie Ihre Bestellung mit der gewünschten Nutzlast und senden Sie sie an die Bestell-API.
  5. Sie erhalten eine Antwort mit einem Statuscode (201 OK) und einer JSON-Bestätigung Ihrer Bestellung. 

 

#!/bin/bash
curl --request POST \
--url 'https://transact.ti.com/v2/store/orders/test' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <


Beispielantwort:

{
  "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"
    }
  ],
  "customerOrderComments": [
    {
      "message": "string"
    }
  ],
  "orderPlacedTime": "string",
  "paymentType": "string",
  "currencyISO": "string",
  "totalTax": 0,
  "checkoutProfileIdentifier": "string",
  "totalDeliveryCost": 0,
  "totalDiscount": 0,
  "couponCodes": "string"
}