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 API de inventario y precios proporciona disponibilidad de inventario y precios en tiempo real para los números de piezas que se pueden pedir (OPN) y los números de piezas genéricas (GPN). También puede usarla para obtener un catálogo completo de todos los números de piezas de TI disponibles.

Antes de realizar un pedido, compruebe la disponibilidad de cada artículo. Implementaciones de notificaciones push frente a recuperación:

  • Recuperación: Realice una llamada a la API para obtener los datos más recientes cuando sea necesario.
  • Notificaciones push (webhooks): Reciba notificaciones en tiempo real cuando haya piezas específicas disponibles. Use esta función para activar flujos de trabajo automatizados (consulte las notificaciones push para obtener más información).

Límites de uso importantes: La API de catálogo está restringida a 1 solicitud cada 4 horas (6 solicitudes al día). Si se supera este límite, se puede restringir o revocar su acceso a la API. Consulte los límites de uso para obtener más información.

Flujo de inventario y precios

  1. Autenticación: Utilice su clave API y palabra secreta asignadas para obtener un token de acceso.
  2. Envíe una solicitud: Incluya los OPN deseados en su solicitud. Puede realizar varias solicitudes con el mismo token de acceso válido.
  3. Respuesta de la API: recibirá un código de estado (200 OK) y una cadena JSON que contenga los datos del producto:
    • Disponibilidad: el campo “quantity” (Cantidad) muestra el número de artículos actualmente en stock.
    • Precios: se incluye en la respuesta JSON (el formato específico depende de la API).
    • Disponibilidad futura:
      • el campo “Future Inventory” (Inventario futuro) devolverá las fechas y cantidades estimadas para el próximo inventario.
      • El campo “forecastQuantity” (Cantidad prevista) puede ser nulo si se desconoce.
      • 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. 
  • Límites de pedidos: el campo “limit” (Límite) muestra la cantidad máxima permitida por pedido para este artículo (en blanco si no hay un límite).
  • Opciones adicionales: consulte la especificación de la API para obtener más parámetros de consulta a fin de delimitar su búsqueda.

Notas importantes:

  • Es posible que la información futura no esté disponible para todas las piezas.
  • El inventario se asigna por orden de llegada y no podrá reservarse.
  • Puede configurar una suscripción al inventario para recibir notificaciones en tiempo real cuando haya un inventario adicional disponible.

Ejemplo

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": 5435,
  "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": "8-Bit 200MSPS Low-Power Analog-to-Digital Converter (ADC) With Internal Sample and Hold",
  "minimumOrderQuantity": 1,
  "standardPackQuantity": 126,
  "exportControlClassificationNumber": "EAR99",
  "htsCode": "8542390001",
  "pinCount": 5,
  "packageType": "SOT-23 (DBV)",
  "packageCarrier": "Large T&R",
  "customReel": true,
  "lifeCycle": "ACTIVE"
}