Consultas de exemplo

Altere sua região

Muitos dos nossos parceiros distribuidores oferecem diferentes níveis de estoque dependendo do país do usuário. A API usa, por padrão, os EUA e USD como país e moeda, mas isso pode ser substituído para obter resultados mais adequados à sua região.

Compare a consulta para a Grã-Bretanha:

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

... com a consulta nos EUA: 

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

Neste caso, neste dia específico, havia 1.370 peças disponíveis para envio ao Reino Unido. No entanto, usuários nos EUA veriam apenas 300 peças disponíveis.

Muitos distribuidores enviam para vários países ou não separam o estoque por país e, por isso, o país e a moeda informados não são usados como um filtro rígido.

Os códigos de país seguem o padrão ISO 3166 (alpha-2); os códigos de moeda seguem o padrão ISO 4217. 

Correspondência exata de MPN com fornecedores específicos

Usando a consulta SupMultiMatch :

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

Observe que isso filtrará pelas peças vendidas pelo(s) distribuidor(es) especificado(s). A lista de distribuidores está disponível aqui. Se outros distribuidores também venderem esta peça, eles também serão listados. Você sempre pode filtrá-los no seu processamento, se desejar.

Em vez do ID da empresa, por exemplo, "459", você pode especificar o nome da empresa, por exemplo, "Digi-Key". Aqui está um exemplo:

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

Peças de vendedores com informações de preço

Aqui está um exemplo de consulta que você pode usar no seu 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
            }
          }
        }
      }
    }
  }
}

Correspondência exata de peça

A consulta supMultiMatch permite inserir vários MPNs para recuperar dados e procura uma correspondência exata para cada um.

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

Filtrando peças em estoque

Ao pesquisar, você pode especificar que sejam incluídas apenas peças em estoque. Por exemplo:

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

Definir esse filtro como true significa que serão excluídas as peças que tenham no stock at all. Se uma peça tiver estoque de apenas um distribuidor, ela será considerada em estoque e retornada como parte da consulta.

Essa filtragem não considera o estoque do distribuidor de forma alguma — ela se aplica no nível da peça.

Aqui está um exemplo que você pode testar. Esta consulta procura por AEC-Q100 com uma paginação start de página 5, e inStockOnly definido como true:

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

MPNs inesperados sendo retornados

Ao pesquisar ou fazer correspondência, às vezes são encontradas peças adicionais cujos MPNs diferem apenas por caracteres não alfanuméricos, como - ou ..

Por exemplo, considere uma consulta supMultiMatch para o seguinte MPN:

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

Isso pode retornar vários MPNs, como ASV-18.432MHZ-EJ-T, bem como ASV-1.8432MHZ-E-J-T (e outros).

Esse comportamento se deve à forma como as peças são "tokenizadas" para indexação no mecanismo de busca elástica.

Os MPNs são divididos em tokens, ignorando caracteres especiais (por exemplo, CV 3-200/SPG pode se tornar `CV`, `3200`, `SPG`).

A correspondência então é feita usando trigramas (combinações de três letras). A busca deve corresponder totalmente a um MPN tokenizado, mas correspondências parciais dependem de trigramas. Por exemplo:

• 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

Usando curingas

Às vezes, pesquisar por um número de peça parcial retorna peças demais, ou você tem requisitos específicos para a correspondência de números de peça. Nesses casos, você pode usar curingas para refinar sua busca.

• O caractere * corresponde a qualquer sequência de caracteres (incluindo zero caracteres).

• O caractere ? corresponde a qualquer caractere único.

Os curingas podem ser usados em qualquer lugar dentro de um número de peça. Usar curingas para encontrar o meio de um número de peça é desnecessário — curingas no início e no fim são adicionados automaticamente. Por exemplo, *74LS25* retorna os mesmos resultados que 74LS25.

Se você adicionar um ou mais curingas a um termo, nenhum outro curinga será adicionado automaticamente. Isso pode ser usado para fazer buscas por prefixo. Por exemplo, lv40 encontra peças que contêm lv40 em qualquer lugar do número da peça, enquanto lv40* encontra apenas peças que começam com lv40.

Lead time de fábrica para peças

Há dois campos que você pode consultar na API.

1. factoryLeadDays em SupOffer retorna o número de dias para adquirir peças da fábrica.

2. estimatedFactoryLeadDays em SupPart retorna o lead time estimado de fábrica em dias, derivado de ofertas de distribuidores confiáveis.

Aqui está um exemplo de consulta para vendedores autorizados:

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

Peças similares

Ao pesquisar ou fazer correspondência de peças, você pode especificar o retorno de similarParts. São peças identificadas pela Nexar como semelhantes em especificação e funcionalidade. Aqui está um exemplo de consulta:

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