API – Bestand und Preisgestaltung

Produktionsendpunkte:
https://transact.ti.com/v2/store/products/
https://transact.ti.com/v2/store/products/catalog

Die Bestands- und Preis-API zeigt die Echtzeit-Lagerverfügbarkeit und Preise für bestellbare Teilenummern (OPN) und generische Teilenummern (GPN). Sie können damit auch einen vollständigen Katalog aller verfügbaren TI-Teilenummern abrufen.

Prüfen Sie vor der Bestellung die Verfügbarkeit der einzelnen Artikel. Push- vs. Retrieve-Implementierungen:

  • Retrieve: Führen Sie einen API-Aufruf durch, um bei Bedarf die neuesten Daten zu erhalten.
  • Push (Webhooks): Erhalten Sie Echtzeitbenachrichtigungen, wenn bestimmte Teile verfügbar werden. Verwenden Sie diese Option, um automatisierte Workflows auszulösen (weitere Informationen finden Sie unter „Push-Benachrichtigungen“).

Wichtige Preisgrenzen: Die Katalog-API ist auf eine Anfrage alle 4 Stunden (sechs Anfragen pro Tag) beschränkt. Wenn Sie diese Grenze überschreiten, kann Ihr API-Zugriff beschränkt oder widerrufen werden. Weitere Einschränkungen finden Sie unter „Preisgrenzen“.

Ablauf – Bestand und Preise

  1. Authentifizieren: Verwenden Sie Ihren zugewiesenen API-Schlüssel und -Ihr Geheimnis, um ein Zugriffstoken zu erhalten.
  2. Anfrage senden: Ihre Anfrage muss auch die gewünschten OPNs enthalten. Sie können mit ein und demselben gültigen Zugriffstoken mehrere Anfragen stellen.
  3. API-Antwort: Sie erhalten einen Statuscode (200 OK) und eine JSON-Zeichenfolge, die die Produktdaten enthält:
    • Verfügbarkeit: Das Feld „quantity“ zeigt die Anzahl der derzeit vorrätigen Artikel an.
    • Preise: In der JSON-Antwort enthalten (spezifisches Format hängt von der API ab)
    • Zukünftige Verfügbarkeit:
      • „Future Inventory“ gibt geschätzte Daten und Mengen für den erwarteten Bestand zurück.
      • „forecastQuantity“ kann Null sein, wenn unbekannt.
      • Das Feld "forecastDate" gibt die Woche der Verfügbarkeit und nicht das tatsächliche Datum der Verfügbarkeit an. Beide Daten und Mengen sind nur Prognosen und nicht verbindlich. 
  • Bestelllimits: Das Feld „Limit“ zeigt die maximal zulässige Menge pro Bestellung für diesen Artikel an (leer, wenn kein Limit vorhanden ist).
  • Zusätzliche Optionen: Weitere Abfrageparameter zur Verfeinerung der Suche finden Sie in der API-Spezifikation.

Wichtige Hinweise:

  • Informationen zum zukünftigen Bestand sind möglicherweise nicht für alle Artikel verfügbar.
  • Der Bestand wird nach dem Prinzip „Wer zuerst kommt, mahlt zuerst“ zugeteilt und kann nicht reserviert werden.
  • Richten Sie eventuell ein Bestandsabonnement ein, um Echtzeitbenachrichtigungen zu erhalten, wenn zusätzlicher Bestand verfügbar wird.

Beispiel

Das folgende Beispiel veranschaulicht, wie Sie Lagerverfügbarkeits- und Preisinformationen je Produkt abrufen können, indem Sie die Teilenummer AFE7799IABJ abfragen.

  • Der verfügbare Bestand beträgt 5.435 ("Menge:" 5435).
  • In diesem Beispiel ist die Menge jedoch auf einen Grenzwert von 50 ("Grenzwert:" 50) Einheiten pro Bestellung beschränkt.
  • Wenn das Produkt kein Bestelllimit hat, gibt die JSON-Antwort einen leeren Wert im Grenzwertfeld zurück.
  • Weitere Abfrageparameter finden Sie in der nachstehenden Spezifikation.  

 

Beispiel für eine Anforderung:

curl --request GET \   
--url 'https://transact.ti.com/v2/store/products/AFE7799IABJ?currency=USD' \
--header 'Authorization: Bearer {access_token}' \


Antwort auf eine erfolgreiche Anfrage:

{
  "tiPartNumber": "AFE7799IABJ",
  "genericPartNumber": "AFE7799",
  "buyNowURL": "https://www.ti.com/product/AFE7799/part-details/AFE7799IABJ",
  "quantity": 5435,
  "limit": 50,
  "pricing": [
    {
      "currency": "USD",
      "priceBreaks": [
        {
          "priceBreakQuantity": 1,
          "price": 2.03
        },
        {
          "priceBreakQuantity": 10,
          "price": 1.43
        },
        {
          "priceBreakQuantity": 25,
          "price": 1.35
        },      
"futureInventory": [
        {
            "forecastQuantity": 500,
            "forecastDate": "2023-06-25"
        },
        {
            "forecastQuantity": null,
            "forecastDate": "2023-07-02"
        }    ],
  "description": "8-Bit 200MSPS Low-Power Analog-to-Digital Converter (ADC) With Internal Sample and Hold",
  "minimumOrderQuantity": 1,
  "standardPackQuantity": 126,
  "exportControlClassificationNumber": "EAR99",
  "htsCode": "8542390001",
  "pinCount": 5,
  "packageType": "SOT-23 (DBV)",
  "packageCarrier": "Large T&R",
  "customReel": true,
  "lifeCycle": "ACTIVE"
}