API push per inventario e prezzi

Panoramica

L'API push per inventario e prezzi di Waldom consente ai clienti di ricevere aggiornamenti su inventario e prezzi tramite notifiche POST da server a server. Questo feed in tempo reale garantisce che i vostri sistemi rimangano sincronizzati con i dati più

Autenticazione

I clienti devono fornire credenziali di autenticazione quando abilitano l'API push. Sono supportati i seguenti tipi di autenticazione:

Formato della richiesta

Waldom invierà gli aggiornamenti tramite POST all'endpoint configurato dal cliente. Il corpo della richiesta è un array di massimo 20 record di inventario e prezzi. Questa struttura corrisponde alla risposta della versione GET dell'API InventoryAnd

• Content-Type: application/json
• Numero massimo di record per richiesta: 20
• Metodo: POST
• Protocollo: HTTPS richiesto

Esempio di payload 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
        }
      ]
    }
  }
]

Comportamento di riprova

• Se il server ricevente risponde con HTTP 200, il messaggio è considerato ricevuto con successo.
• Qualsiasi altra risposta (ad esempio 4xx, 5xx o timeout) può attivare un nuovo tentativo.
• Le politiche di riprova (backoff, numero massimo di tentativi) sono configurabili durante l'onboarding.
• Importante: Se il tasso di successo (risposte riuscite rispetto al totale dei tentativi) scende al di sotto del 40%, Waldom si riserva il diritto di sospendere temporaneamente l'integrazione della tua API Push.

Come richiedere l'accesso

• Invia una richiesta tramite il tuo CSR per iscriverti alla nostra API push.
• Includi:
  • URL dell'endpoint HTTPS
  • Metodo di autenticazione scelto
  • Dettagli di autenticazione
  • Indirizzo e-mail del contatto tecnico

Una volta convalidato, Waldom inizierà a inviare gli aggiornamenti di InventoryAndPricing direttamente al tuo endpoint.