API de notificaciones push de inventario y precios
Descripción
La API de inventario y precios de Waldom permite a los clientes recibir actualizaciones de inventario y precios a través de notificaciones POST de servidor a servidor. Esta fuente en tiempo real garantiza que sus sistemas permanezcan sincronizados con los
Autenticación
Los clientes deben proporcionar credenciales de autenticación al habilitar la API de notificaciones push. Se admiten los siguientes tipos de autenticación:
| Tipo | Descripción |
|---|---|
| Encabezado de clave API | Una clave estática enviada en un encabezado HTTP personalizado |
| Autenticación básica | nombre de usuario:contraseña Codificado en Base64 y pasado en encabezados |
Formato de solicitud
Waldom enviará las actualizaciones mediante un método POST al punto final configurado por el cliente. El cuerpo de la solicitud es una matriz de hasta 20 registros de inventario y precios. Esta estructura coincide con la respuesta de la versión GET
- Tipo de contenido: application/json
- Máximo de registros por solicitud: 20
- Método: POST
- Protocolo: Se requiere HTTPS
Ejemplo de carga útil 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
}
]
}
}
]Comportamiento de reintento
- Si el servidor receptor responde con HTTP 200, se considera que el mensaje se ha recibido correctamente.
- Cualquier otra respuesta (por ejemplo, 4xx, 5xx o tiempo de espera agotado) puede desencadenar un nuevo intento.
- Las políticas de reintento (retraso, número máximo de intentos) se pueden configurar durante la incorporación.
- Importante: Si la tasa de éxito (respuestas exitosas frente al total de intentos) cae por debajo del 40 %, Waldom se reserva el derecho de suspender temporalmente su integración con la API Push.
Cómo solicitar acceso
- Envíe una solicitud a través de su CSR para suscribirse a nuestra API Push.
- Incluya:
- URL del punto final HTTPS
- Método de autenticación elegido
- Detalles de autenticación
- Correo electrónico de contacto técnico
Una vez validado, Waldom comenzará a enviar las actualizaciones de InventoryAndPricing directamente a su punto final.