库存与定价推送API

概述

Waldom 的《库存与定价推送 API》使客户能够通过服务器到服务器的 POST 通知接收库存和定价更新。该实时数据源确保您的系统与 Waldom 的最新产品数据保持同步。

身份验证

启用推送API时，客户需提供身份验证凭证。支持以下验证类型：

类型	描述
API密钥标头	通过自定义HTTP头部发送的静态密钥
基本认证	用户名:密码 Base64编码后通过头部传递

请求格式

Waldom将通过POST方式将更新推送至客户配置的端点。请求主体为最多20条库存与定价记录的数组。该结构与库存与定价API的GET版本响应一致，但以推送形式发送。

• Content-Type: application/json
• 每次请求最多记录数： 20
• 方法： POST
• 协议： 必须使用HTTPS

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
        }
      ]
    }
  }
]

重试行为

• 如果接收服务器响应为 HTTP 200，则认为消息已成功接收。
• 任何其他响应（例如 4xx、5xx 或超时）都可能触发重试。
• 重试策略（后退、最大尝试次数）可在入职期间进行配置。
• 重要提示：若成功率（成功响应数/总尝试次数）低于40%，Waldom保留暂时暂停您推送API集成的权利。

如何申请访问权限

• 请通过您的客户服务代表提交申请以订阅我们的推送API。
• 请包含：
  • HTTPS 端点网址
  • 选定的认证方式
  • 认证详细信息
  • 技术联系人邮箱

验证通过后，Waldom将直接向您的端点推送库存与定价更新。