Voorraad- en prijs-push-API

Overzicht

Met Waldom's Voorraad- en prijs-push-API kunnen klanten voorraad- en prijsupdates ontvangen via server-naar-server POST-meldingen. Deze realtime feed zorgt ervoor dat uw systemen gesynchroniseerd blijven met de nieuwste productgegevens van Waldom.

Authenticatie

Klanten moeten authenticatiegegevens verstrekken wanneer ze de Push API inschakelen. De volgende authenticatietypen worden ondersteund:

Type	Beschrijving
API-sleutelheader	Een statische sleutel die in een aangepaste HTTP-header wordt verzonden
Basisauthenticatie	gebruikersnaam:wachtwoord Base64-gecodeerd en doorgegeven in headers

Verzoekformaat

Waldom zal updates POST naar het door de klant geconfigureerde eindpunt. De verzoektekst is een array van maximaal 20 voorraad- en prijsrecords. Deze structuur komt overeen met het antwoord van de GET-versie van d

• Content-Type: application/json
• Max. aantal records per verzoek: 20
• Methode: POST
• Protocol: HTTPS vereist

Voorbeeld POST-payload

[
  {
    "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
        }
      ]
    }
  }
]

Herhalingsgedrag

• Als de ontvangende server reageert met HTTP 200, wordt het bericht als succesvol ontvangen beschouwd.
• Elk ander antwoord (bijv. 4xx, 5xx of time-out) kan een nieuwe poging activeren.
• Het beleid voor herhalingen (backoff, max. aantal pogingen) kan tijdens de onboarding worden geconfigureerd.
• Belangrijk: Als het succespercentage (succesvolle reacties ten opzichte van het totale aantal pogingen) onder de 40% daalt, behoudt Waldom zich het recht voor om uw Push API-integratie tijdelijk op te schorten.

Toegang aanvragen

• Dien een verzoek in via uw CSR om u te abonneren op onze push-API.
• Vermeld daarbij:
  • HTTPS-eindpunt-URL
  • Gekozen authenticatiemethode
  • Authenticatiegegevens
  • E-mailadres van technische contactpersoon

Na validatie begint Waldom met het rechtstreeks doorsturen van InventoryAndPricing-updates naar uw eindpunt.