Consultas de ejemplo

Cambie su región

Muchos de nuestros socios distribuidores ofrecen distintos niveles de inventario según el país del usuario. La API usa por defecto US y USD para país y moneda, pero estos valores se pueden sobrescribir para obtener resultados más adecuados para su región.

Compare la consulta para Gran Bretaña:

query GBMatch {
  supMultiMatch(
    country: "GB"
    currency: "GBP"
    queries: [{ mpn: "AR 32 HZL-TT", limit: 3 }]
  ) {
    parts {
      sellers(authorizedOnly: true) {
        company {
          name
        }
        offers {
          inventoryLevel
        }
      }
    }
  }
}

... con la consulta en EE. UU.: 

query USMatch {
  supMultiMatch(
    queries: [{ mpn: "AR 32 HZL-TT", limit: 3 }]
  ) {
    parts {
      sellers(authorizedOnly: true) {
        company {
          name
        }
        offers {
          inventoryLevel
        }
      }
    }
  }
}

En este caso, en este día en particular, había 1.370 piezas disponibles para enviar a GB. Sin embargo, quienes estuvieran en EE. UU. solo verían 300 piezas disponibles.

Muchos distribuidores realizan envíos a varios países o no segregan el stock por país, por lo que el país y la moneda de entrada no se usan como un filtro estricto.

Los códigos de país siguen la norma ISO 3166 (alpha-2); los códigos de moneda siguen la norma ISO 4217. 

Coincidencia exacta de mpn con proveedores específicos

Usando la SupMultiMatch consulta:

query MultiMatch {
  supMultiMatch(
    queries: [{mpn: "FH12-5S-1SH(55)", limit: 2}]
    options: {filters: {distributor_id: ["459", "1106", "2401", "2628", "2454", "3261", "12947"]}}
  ) {
    hits
    parts {
      mpn
      name
      sellers {
        company {
          name
        }
        offers {
          prices {
            price
            currency
          }
        }
      }
    }
  }
}

Tenga en cuenta que esto filtrará las piezas vendidas por el/los distribuidor(es) especificado(s). La lista de distribuidores está disponible aquí. Si otros distribuidores también venden esta pieza, también aparecerán en la lista. Siempre puede filtrarlos en su procesamiento si lo desea.

En lugar del ID de empresa, por ejemplo, "459", puede especificar el nombre de la empresa, por ejemplo, "Digi-Key". Aquí tiene un ejemplo:

query MultiMatch {
  supMultiMatch(
    queries: [{mpn: "FH12-5S-1SH(55)", limit: 2}]
    options: {filters: {distributor_id: ["Digi-Key"]}}
  ) {
    hits
    parts {
      mpn
      name
      sellers {
        company {
          name
        }
        offers {
          prices {
            price
            currency
          }
        }
      }
    }
  }
}

Piezas de vendedores con información de precios

Aquí tiene una consulta de ejemplo que puede usar en su IDE:

query FindPrices {
  supSearch(q: "AEC-Q100", limit: 3) { 
    results {
      part {
        mpn
        manufacturer {
          name
        }
        sellers(includeBrokers: false) {
          company {
            name
          }
          offers {
            clickUrl
            inventoryLevel
            prices{
              price
              currency
              quantity
            }
          }
        }
      }
    }
  }
}

Coincidencia exacta de pieza

La consulta supMultiMatch le permite introducir varios MPN para recuperar datos y busca una coincidencia exacta para cada uno.

query MatchParts {
  supMultiMatch(queries: [{mpn: "G3VM-101PR"}]) {
    hits
    reference
    parts {
      id
      slug
      mpn
      manufacturer {
        name
      }
    }
  }
}

Filtrado de piezas en stock

Al buscar, puede especificar que solo se incluyan piezas que estén en stock. Por ejemplo:

supSearch(q: "LM339", limit: 1, inStockOnly: true) { ... }

Establecer este filtro en true significa que se excluyen las piezas que tienen no stock at all. Si una pieza tiene inventario de un solo distribuidor, se considera en stock y se devuelve como parte de la consulta.

Este filtrado no tiene en cuenta en absoluto el stock del distribuidor; se aplica a nivel de pieza.

Aquí tiene un ejemplo que puede probar. Esta consulta busca AEC-Q100 con una start página de paginación de 5, y inStockOnly establecido como true:

query in_stock_filter{
  supSearch(q: "AEC-Q100", start: 5, inStockOnly: true) { 
    results {
      
      part {
        mpn
        manufacturer {
          name
        }
        sellers(includeBrokers: false) {
          company {
            name
          }
        }
      }
    }
  }
}

Se están devolviendo MPN inesperados

Al buscar o hacer coincidencias, a veces se encuentran piezas adicionales cuyos MPN difieren solo en caracteres no alfanuméricos, como - o ..

Por ejemplo, considere una consulta supMultiMatch para el siguiente MPN:

query MultiMatch {
  supMultiMatch(queries: {mpn: "ASV-18432MHZ-EJ-T", limit: 5}) {
    hits
    parts {
      mpn
    }
  }
}

Esto puede devolver varios MPN, como ASV-18.432MHZ-EJ-T así como ASV-1.8432MHZ-E-J-T (y otros).

Este comportamiento se debe a la forma en que las piezas se "tokenizan" para su indexación en el motor de búsqueda elástico.

Los MPN se dividen en tokens, ignorando caracteres especiales (p. ej., CV 3-200/SPG podría convertirse en `CV`, `3200`, `SPG`).

La coincidencia se realiza luego usando trigramas (combinaciones de tres letras). La búsqueda debe coincidir completamente con un MPN tokenizado, pero las coincidencias parciales dependen de los trigramas. Por ejemplo:

• Match: "CV 3-20", "CV 320", "00 SPG" - Each part aligns with at least one full token

• No Match: "CV 3", "CV 3-", "CV 32" - No part of these aligns with any token

Uso de comodines

A veces, buscar por un número de pieza parcial devuelve demasiadas piezas, o tiene requisitos específicos para la coincidencia del número de pieza. En estos casos, puede usar comodines para refinar su búsqueda.

• El carácter * coincide con cualquier secuencia de caracteres (incluidos cero caracteres).

• El carácter ? coincide con cualquier carácter individual.

Los comodines se pueden usar en cualquier parte de un número de pieza. Usar comodines para encontrar la parte media de un número de pieza es innecesario: los comodines iniciales y finales se añaden automáticamente. Por ejemplo, *74LS25* devuelve los mismos resultados que 74LS25.

Si añade uno o más comodines a un término, no se añaden automáticamente otros comodines. Esto puede usarse para hacer búsquedas por prefijo. Por ejemplo, lv40 encuentra piezas que contienen lv40 en cualquier parte del número de pieza, mientras que lv40* encuentra solo piezas que comienzan con lv40.

Plazo de entrega de fábrica para piezas

Hay dos campos que puede consultar en la API.

1. factoryLeadDays en SupOffer devuelve el número de días necesarios para adquirir piezas de fábrica.

2. estimatedFactoryLeadDays en SupPart devuelve el plazo estimado de entrega de fábrica en días derivado de ofertas de distribuidores de confianza.

Aquí tiene una consulta de ejemplo para vendedores autorizados:

query LeadDaysSearch {
  supSearch(q: "IRL3803STRLPBF", limit: 2) {
    results {
      part {
        mpn
        estimatedFactoryLeadDays
        sellers(authorizedOnly: true) {
          offers {
            factoryLeadDays
          }
        }
      }
    }
  }
}

Piezas similares

Al buscar o hacer coincidencias de piezas, puede especificar que se devuelva similarParts. Estas son piezas identificadas por Nexar como similares en especificación y funcionalidad. Aquí tiene una consulta de ejemplo:

query SimilarParts {
  supSearch(q: "LM339MX", limit: 1) {
    hits
    results {
      part {
        id
        mpn
        name
        manufacturer { name }
        similarParts {
          id
          mpn
          manufacturer { name }
        }
      }
    }
  }
}