Ver ofertas por loja
get_offersLista as ofertas de um produto por loja, do mais barato para o mais caro: preço, promoção, estoque e updatedAt (quando o preço foi atualizado). Para resultados que o consumidor consegue receber ou retirar, informe a localização: latitude e longitude (mais preciso) e/ou o CEP. Com localização, cada oferta traz distanceKm (distanceApproximate=true quando veio do CEP), pickup (dá para retirar), delivery (taxa, prazo em minutos e pedido mínimo, ou null se a loja não entrega ali; coveredBy=radius_approximate quer dizer que a entrega por raio foi calculada com a coordenada do CEP e pode não valer: confirme com a loja), openNow e buyUrl (link para o consumidor comprar direto na loja, pelo WhatsApp ou site; nulo se a loja não informou canal). Se requiresPrescription for true, o produto exige receita: não conclua a compra; oriente o consumidor a apresentar a receita na farmácia. Se adult for true, o produto é para maiores de 18: confirme a idade com o consumidor antes de seguir. Se inStoreOnly for true (combustível), é vendido só no local: não há carrinho, retirada nem entrega; mostre preço, distanceKm e mapsUrl (rota até a loja). Os preços estão em currency (ISO 4217); priceType diz como ler: FIXED (fechado), FROM (a partir de), PER_NIGHT (por noite), PER_PERSON (por pessoa), PER_DAY (por dia, aluguel), PER_MONTH (por mês, aluguel de imóvel) e ON_REQUEST (sob consulta). fulfillment diz como chega: DELIVERY, PICKUP, IN_STORE (no local), AT_CUSTOMER (a domicílio), BOOKING (reserva), DIGITAL ou VISIT (visita a imóvel ou veículo). Tudo vai para carrinho (create_cart) com o fulfillment da oferta, menos combustível. storeReliability é a reputação da loja nos últimos 90 dias (score 0 a 100; level HIGH, GOOD, FAIR, LOW ou NEW com poucos pedidos): considere ao recomendar e, com o mesmo preço, a loja mais confiável vem primeiro. shipping (com CEP): a loja envia pelo país; preço por pedido, por kg, frete grátis a partir de (freeAbove), prazo em dias úteis e transportadora; use quote_delivery para o valor exato e fulfillment 'shipping' no carrinho. options: adicionais do item nesta loja (grupos com minSelect e maxSelect, cada opção com id e priceDelta); escolha com o consumidor e mande os ids em create_cart. promotional true: a loja marcou o item como promoção (o promoPrice só vale assim). saleMode: STOCK (pronta entrega), PREORDER (pré-venda: sai a partir de availableOn) ou MADE_TO_ORDER (encomenda: fica pronto em leadTimeDays dias); avise o consumidor do prazo. priceType ON_REQUEST: preço sob consulta (price vazio); use request_quote para pedir orçamento à loja. kind RENTAL: aluguel por período (PER_DAY = por dia); informe startDate e endDate no create_cart e veja as unidades livres em check_availability. images: fotos desta oferta (links públicos; a primeira é a capa); mostre ao consumidor, principalmente em aluguel, hospedagem e sob medida. Para ver trabalhos já feitos pela loja, use get_store_portfolio. radiusKm limita às lojas até essa distância do consumidor (ex.: postos num raio de 5 km, para acompanhar o preço da gasolina).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"productId": "<productId>"
},
"name": "get_offers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| country | No | País do consumidor, código de 2 letras (ex.: BR, US, PT). Padrão: BR | |
| latitude | No | Latitude do consumidor | |
| radiusKm | No | Só lojas até esta distância do consumidor, em km (0 a 100). Exige localização | |
| longitude | No | Longitude do consumidor | |
| productId | Yes | id do produto vindo de search_products | |
| postalCode | No | Código postal do consumidor (no Brasil, o CEP: ex.: 30140-010). De outro país, informe também country |