API push pre inventár a ceny

Prehľad

Waldom API pre zásoby a ceny umožňuje zákazníkom prijímať aktualizácie zásob a cien prostredníctvom oznámení POST medzi servermi. Tento zdroj v reálnom čase zabezpečuje, že vaše systémy zostanú synchronizované s najnovšími údajmi o produktoch od sp

Overenie

Zákazníci musia pri aktivácii Push API poskytnúť overovacie údaje. Podporované sú nasledujúce typy overovania:

Typ	Popis
Hlavička API kľúča	Statický kľúč odoslaný v prispôsobenej hlavičke HTTP
Základné overenie	užívateľské meno:heslo Zakódované v Base64 a odoslané v hlavičkách

Formát požiadavky

Waldom bude odosielať aktualizácie na konfigurovaný koncový bod zákazníka pomocou metódy POST. Telo požiadavky je pole s maximálne 20 záznamami o zásobách a cenách. Táto štruktúra zodpovedá odpovedi verzie GET rozhrania API InventoryAndPricing, ale

• Content-Type: application/json
• Maximálny počet záznamov na požiadavku: 20
• Metóda: POST
• Protokol: Vyžaduje sa HTTPS

Príklad obsahu požiadavky POST

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

Správanie pri opakovaní

• Ak prijímajúci server odpovie s HTTP 200, správa sa považuje za úspešne prijatú.
• Akákoľvek iná odpoveď (napr. 4xx, 5xx alebo časový limit) môže vyvolať opakované pokusy.
• Zásady opakovaného pokusu (backoff, max. počet pokusov) je možné konfigurovať počas onboarding.
• Dôležité: Ak miera úspešnosti (úspešné odpovede vs. celkový počet pokusov) klesne pod 40 %, spoločnosť Waldom si vyhradzuje právo dočasne pozastaviť vašu integráciu Push API.

Ako požiadať o prístup

• Pošlite žiadosť prostredníctvom vášho CSR, aby ste sa prihlásili k odberu nášho Push API.
• Uveďte:
  • URL koncového bodu HTTPS
  • Zvolenú metódu overovania
  • Podrobnosti o overovaní
  • E-mail technického kontaktu

Po overení začne Waldom posielať aktualizácie InventoryAndPricing priamo na váš koncový bod.