API Push pour les stocks et les prix

Présentation

L'API Push pour l'inventaire et la tarification de Waldom permet aux clients de recevoir des mises à jour sur l'inventaire et la tarification via des notifications POST de serveur à serveur. Ce flux en temps réel garantit que vos systèmes restent synchron

Authentification

Les clients doivent fournir des informations d'authentification pour activer l'API Push. Les types d'authentification suivants sont pris en charge :

Saisir	Description
En-tête de clé API	Clé statique envoyée dans un en-tête HTTP personnalisé
Authentification de base	nom d'utilisateur:mot de passe Encodé en Base64 et transmis dans les en-têtes

Format de la requête

Waldom enverra les mises à jour au point de terminaison configuré par le client via une requête POST. Le corps de la requête est un tableau contenant jusqu'à 20 enregistrements d'inventaire et de tarification. Cette structure correspond à la répons

• Content-Type: application/json
• Nombre maximal d'enregistrements par requête : 20
• Méthode : POST
• Protocole : HTTPS requis

Exemple de charge utile 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
        }
      ]
    }
  }
]

Comportement de réessai

• Si le serveur destinataire répond avec HTTP 200, le message est considéré comme ayant été reçu avec succès.
• Toute autre réponse (par exemple, 4xx, 5xx ou délai d'attente) peut déclencher une nouvelle tentative.
• Les politiques de nouvelle tentative (délai d'attente, nombre maximal de tentatives) sont configurables lors de l'intégration.
• Important : Si le taux de réussite (réponses réussies par rapport au nombre total de tentatives) tombe en dessous de 40 %, Waldom se réserve le droit de suspendre temporairement votre intégration de l'API Push.

Comment demander l'accès

• Envoyez une demande via votre CSR pour vous abonner à notre API Push.
• Veuillez inclure :
  • URL du point de terminaison HTTPS
  • Méthode d'authentification choisie
  • Les détails d'authentification
  • L'adresse e-mail du contact technique

Une fois validé, Waldom commencera à envoyer les mises à jour InventoryAndPricing directement à votre point de terminaison.