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