Push-API für Bestände und Preise

Übersicht

Mit der Inventory And Pricing Push API von Waldom können Kunden Bestands- und Preisaktualisierungen über Server-zu-Server-POST-Benachrichtigungen erhalten. Dieser Echtzeit-Feed stellt sicher, dass Ihre Systeme mit den neuesten Produktdaten von Wald

Authentifizierung

Kunden müssen bei der Aktivierung der Push-API Authentifizierungsdaten angeben. Die folgenden Authentifizierungstypen werden unterstützt:

Anfrageformat

Waldom sendet Aktualisierungen per POST an den vom Kunden konfigurierten Endpunkt. Der Anfragetext ist ein Array mit bis zu 20 Bestands- und Preisdatensätzen. Diese Struktur entspricht der Antwort der GET-Version

• Content-Type: application/json
• Maximale Anzahl von Datensätzen pro Anfrage: 20
• Methode: POST
• Protokoll: HTTPS erforderlich

Beispiel für POST-Nutzlast

[
  {
    "Id": "10249120",
    "PartNumber": "1622994-1",
    "ManufacturerName": "TE CONNECTIVITY/AMP BRAND",
    "CustomerPartNumber": "",
    "LeadTime": null,
    "AvailableInventory": [],
    "OnOrderInventory": [],
    "MinOrderQuantity": "60000",
    "StandardPackQuantity": "5000",
    "TotalStockQuantity": 0,
    "Description": "Thick Film Resistors-SMD CRG0603 1% 750K",
    "UOM": null,
    "HTSCode": null,
    "Rohs": "Y",
    "ExportControlClassificationNumber": null,
    "DataSheetLink": "https://www.te.com/commerce/DocumentDelivery/DDEController?Action=srchrtrv&DocNm=1309350_PASSIVE_COMPONENT&DocType=Catalog+Section&DocLang=English&PartCntxt=1622994-1&DocFormat=pdf",
    "ImageLink": "http://www.te.com/catalog/common/images/PartImages/prfrcrl.jpg",
    "Pricing": {
      "Currency": "EUR",
      "PriceBreaks": [
        {
          "PriceBreakQuantity": 60000,
          "Price": 0.0017
        },
        {
          "PriceBreakQuantity": 200000,
          "Price": 0.0016
        },
        {
          "PriceBreakQuantity": 400000,
          "Price": 0.0015
        },
        {
          "PriceBreakQuantity": 1000000,
          "Price": 0.0014
        },
        {
          "PriceBreakQuantity": 2000000,
          "Price": 0.0013
        }
      ]
    }
  },
  {
    "Id": "10249143",
    "PartNumber": "1623009-1",
    "ManufacturerName": "TE CONNECTIVITY/AMP BRAND",
    "CustomerPartNumber": "",
    "LeadTime": null,
    "AvailableInventory": [
      {
        "ShipsFromRegion": "USA",
        "ShipsFromWarehouse": "RK",
        "AvailableDate": "2025-03-28T00:00:00Z",
        "Quantity": 100000,
        "DateCodes": [
          {
            "Quantity": 100000,
            "DateCode": "2017-07-01T00:00:00",
            "CountryOfOrigin": "TH",
            "GreenStock": true
          }
        ]
      }
    ],
    "OnOrderInventory": [],
    "MinOrderQuantity": "60000",
    "StandardPackQuantity": "5000",
    "TotalStockQuantity": 100000,
    "Description": "Thick Film Resistors-SMD CRG0603 1% 910R",
    "UOM": null,
    "HTSCode": null,
    "Rohs": "Y",
    "ExportControlClassificationNumber": null,
    "DataSheetLink": "https://www.te.com/commerce/DocumentDelivery/DDEController?Action=srchrtrv&DocNm=1309350_PASSIVE_COMPONENT&DocType=Catalog+Section&DocLang=English&PartCntxt=1623009-1&DocFormat=pdf",
    "ImageLink": "http://www.te.com/catalog/common/images/PartImages/prfrcrl.jpg",
    "Pricing": {
      "Currency": "EUR",
      "PriceBreaks": [
        {
          "PriceBreakQuantity": 60000,
          "Price": 0.0017
        },
        {
          "PriceBreakQuantity": 200000,
          "Price": 0.0016
        },
        {
          "PriceBreakQuantity": 400000,
          "Price": 0.0015
        },
        {
          "PriceBreakQuantity": 1000000,
          "Price": 0.0014
        },
        {
          "PriceBreakQuantity": 2000000,
          "Price": 0.0013
        }
      ]
    }
  }
]

Wiederholungsverhalten

• Wenn der empfangende Server mit HTTP 200 antwortet, gilt die Nachricht als erfolgreich empfangen.
• Jede andere Antwort (z. B. 4xx, 5xx oder Zeitüberschreitung) kann einen erneuten Versuch auslösen.
• Die Wiederholungsrichtlinien (Backoff, maximale Versuche) können während der Onboarding-Phase konfiguriert werden.
• Wichtig: Wenn die Erfolgsquote (erfolgreiche Antworten im Verhältnis zur Gesamtzahl der Versuche) unter 40 % fällt, behält sich Waldom das Recht vor, Ihre Push-API-Integration vorübergehend auszusetzen.

So fordern Sie Zugriff an

• Reichen Sie über Ihren CSR eine Anfrage ein, um unsere Push-API zu abonnieren.
• Fügen Sie Folgendes bei:
  • HTTPS-Endpunkt-URL
  • Gewählte Authentifizierungsmethode
  • Authentifizierungsdetails
  • E-Mail-Adresse des technischen Ansprechpartners

Nach der Validierung beginnt Waldom damit, Aktualisierungen zu Bestand und Preisen direkt an Ihren Endpunkt zu senden.