API de inventario y precios
Puntos finales de producción:
https://transact.ti.com/v2/store/products/
https://transact.ti.com/v2/store/products/catalog
La interfaz de programación de aplicaciones (API) de inventario y precios ofrece disponibilidad de inventario y precios en tiempo real para los números de piezas que se pueden pedir (OPN) y números de piezas genéricas (GPN), así como la posibilidad de obtener un catálogo completo de todos los números de piezas de TI. Antes de crear un pedido, debe comprobar la disponibilidad de los distintos artículos. La API está disponible en implementaciones de notificaciones push o de recuperación de datos. La API de notificaciones push enviará un enlace web a su sistema en tiempo real cuando una pieza individual esté disponible y se puede utilizar para activar flujos de automatización. Consulte las notificaciones automáticas para obtener más información.
NOTE: La API de catálogo está limitada a una solicitud cada cuatro horas para un total de seis solicitudes al día. Superar este límite puede dar lugar a la limitación o revocación de su acceso a la API. Consulte los límites de tarifa para conocer los límites adicionales. Consulte los límites de velocidad para conocer los límites adicionales.
Descripción general del flujo de precios de inventario
- Autentíquese con la clave API y la palabra secreta asignadas.
- Una vez que reciba el token de acceso, envíe una solicitud que incluya el OPN. Se pueden realizar varias solicitudes en la misma sesión con el token de acceso siempre que el token no haya caducado.
- La API responderá con un código de estado, 200 OK, y una cadena JSON que contiene los datos del producto.
- Dispone de parámetros de consulta adicionales para delimitar su búsqueda. Consulte las especificaciones a continuación.
El campo "Future inventory" (Inventario futuro) devolverá una matriz de fechas y cantidades previstas en las que se espera que haya más inventario disponible. El campo "forecastQuantity" (cantidad prevista) puede devolver un valor nulo si la cantidad es desconocida. El campo "forecastDate" (fecha prevista) representa la semana de disponibilidad y no la fecha real de disponibilidad. Tanto las fechas como las cantidades son meras previsiones y no están garantizadas. El inventario estará disponible por orden de llegada y no podrá reservarse. Se recomienda que configure una suscripción al inventario para recibir notificaciones cuando haya inventario adicional disponible. Nota: No todas las piezas dispondrán de información de inventario futuro.
El siguiente ejemplo, que ilustra cómo recuperar la disponibilidad de inventario y la información de precios por producto, corresponde a la consulta del número de pieza AFE7799IABJ. El inventario disponible es de 5435 ("cantidad": 5435); sin embargo, en este ejemplo, la cantidad está restringida a un límite de 50 ("límite": 50) unidades por pedido. Si el producto no tiene un límite de pedidos, la respuesta JSON devolverá un valor en blanco en el campo de límite. Para conocer otros parámetros de consulta, consulte la especificación que figura a continuación.
Ejemplo de solicitud:
curl --request GET \ --url 'https://transact.ti.com/v2/store/products/AFE7799IABJ?currency=USD' \ --header 'Authorization: Bearer {access_token}' \
Respuesta a una solicitud correcta:
{ "tiPartNumber": "AFE7799IABJ", "genericPartNumber": "AFE7799", "buyNowURL": "https://www.ti.com/product/AFE7799/part-details/AFE7799IABJ", "quantity": 5,435, "limit": 50, "pricing": [ { "currency": "USD", "priceBreaks": [ { "priceBreakQuantity": 1, "price": 2.03 }, { "priceBreakQuantity": 10, "price": 1.43 }, { "priceBreakQuantity": 25, "price": 1.35 }, "futureInventory": [ { "forecastQuantity": 500, "forecastDate": "2023-06-25" }, { "forecastQuantity": null, "forecastDate": "2023-07-02" } ], "description": convertidor analógico a digital (ADC) de baja potencia, 8 bits y 200 MSPS con muestra interna y retención.", "minimumOrderQuantity": 1, "standardPackQuantity": 126, "exportControlClassificationNumber": "EAR99", "htsCode": "8542390001", "pinCount": 5, "packageType": "SOT-23 (DBV)", "packageCarrier": "Large T&R", "customReel": true, "lifeCycle": "ACTIVE" }