BUSCA PREÇO AVANÇO: PASSO A PASSO DE CONFIGURAÇÃO

Guia rápido para deixar o app coletor pronto para uso. Leva cerca de 5 minutos.
ANTES DE COMEÇAR, TENHA EM MÃOS
• O celular ou coletor Android com internet (Wi-Fi ou dados móveis)
• O arquivo do app (app-busca-preco.apk)
• O número da loja (exemplo: 1)
• O token de consulta fornecido pela Avanço
• (Opcional) A imagem com a logo do supermercado
PARTE 1: INSTALAR O APP
Passo 1. Copie o arquivo app-busca-preco.apk para o aparelho (cabo USB, e-mail, WhatsApp ou pendrive).
Passo 2. No aparelho, abra o arquivo (pelo app "Arquivos" ou "Downloads").
Passo 3. Se o Android avisar que a instalação de fontes desconhecidas está bloqueada, toque em "Configurações" e ative "Permitir desta fonte". Depois volte e toque em "Instalar".
Passo 4. Ao terminar, toque em "Abrir". O app aparece com o nome "Busca Preço Avanço".
PARTE 2: CONFIGURAR O APP
Passo 5. Na tela inicial, toque na engrenagem (canto superior direito).
Passo 6. Preencha os campos:
• Ambiente (prefixo da URL da API): já vem preenchido com https://api.udi.avancoinfo.com.br. Só mude se a Avanço pedir.
• Número da loja: o número da loja onde o aparelho vai ficar. Exemplo: 1.
• Token de consulta: cole o token recebido. Toque no olhinho ao lado para conferir se digitou certo.
• Tempo de exibição do preço (segundos): por quanto tempo o preço fica na tela. O padrão é 5. Aceita de 1 a 60.
• Logo do supermercado: opcional. Toque em "Escolher arquivo" e selecione a imagem (PNG, JPG, WEBP ou SVG, até 2 MB). Para tirar, toque em "Remover logo".
Passo 7. Toque em "Salvar". Vai aparecer a mensagem "Configurações salvas."
Passo 8. Toque na seta (canto superior direito) para voltar à tela de busca.
PARTE 3: LIBERAR A CÂMERA
Passo 9. Na tela inicial, toque no ícone da câmera ao lado do campo de busca.
Passo 10. O Android vai perguntar se o app pode usar a câmera. Toque em "Permitir" (ou "Enquanto o app estiver em uso").
Negou sem querer? Vá em Configurações do Android > Apps > Busca Preço Avanço > Permissões > Câmera e escolha "Permitir".
PARTE 4: FAZER O PRIMEIRO TESTE
Passo 11. Aponte a câmera para o código de barras de um produto. O app lê sozinho.
Passo 12. Outra opção é digitar o código no campo e apertar Enter. Se o coletor tiver leitor físico, é só bipar o produto.
Passo 13. O resultado aparece na tela:
• Descrição do produto e código de barras
• Preço promocional (só aparece se o produto estiver em promoção)
• Preço normal
• Uma barra de tempo que esvazia e fecha o card sozinha
Se o preço apareceu, está tudo pronto.
SE ALGO DER ERRADO
• "Aplicação não configurada" ou "Número da loja não configurado": volte na engrenagem e preencha os campos.
• "Não foi possível conectar à API de preços": confira se o aparelho está com internet e se o campo Ambiente está correto.
• "Falha ao consultar a API (HTTP 401 ou 403)": o token está errado ou venceu. Confira se colou sem espaços ou peça um novo.
• "Produto não encontrado": o código pode estar errado ou o produto não existe na base. Tente de novo.
• "Produto não encontrado para a loja X": o produto não tem preço cadastrado para essa loja. Confira o número da loja nas configurações.
• "Permissão de câmera negada": libere a câmera como explicado na Parte 3.
• "Leitura por câmera não disponível neste dispositivo": use a digitação ou o leitor físico.
DICA FINAL
Depois de configurado, o app guarda tudo no aparelho. Não precisa configurar de novo ao fechar ou reiniciar. Para mudar a loja, o token ou a logo, é só voltar na engrenagem.
Dúvidas? Entre em contato com o suporte da Avanço: https://login.avancoinfo.com.br