Liberação
Disponibilizado a partir da Versão: 11/07/25.
Visão geral
A BuyHelp oferece descontos aos consumidores no momento da compra a partir da informação dos dados do cliente e dos produtos proporcionando maior economia.
Site: https://buyhelp.com.br/
Documentação API: https://sandbox.buyhelp.com.br/api/v1/documentation
Contratação e liberação no Msenha
Para a contratação deverá ser feita a liberação do Módulo “Integracao BuyHelp” do produto SGERP Linux.
Será necessário informar a URL e o TOKEN fornecidos pela BuyHelp para acesso e utilização da API de integração. Estas informações serão gravadas e enviadas no arquivo autorizaxxxx.sg.
Configurações no SGERP
Ao receber o arquivo autorizaxxxx.sg as configurações poderão ser conferidas na opção “Controle de Vendas > Controle de Loja > Manutenções > Parametros > Parametros de Pdv > [F6]Integração”:
Parametros de configuração:
URL: endereço da API BuyHelp.
Token: identificação e autorização para a API BuyHelp.
Motivo de desconto em itens: Tipo de desconto para a BuyHelp. Recomenda-se a criação de um motivo especifico na opção “Controle de Vendas > Controle de Loja > Manutenções > Tabelas… > Tabela de Tipos de desconto”, utilizar a opção “Ocultar..: Sim” para que este motivo não fique disponivel ao operador de caixa para uso em outros tipos de desconto.
Aceita descontos pelo PINPAD: Recomenda-se preecher com “S” para que o cliente possa confirmar o aceite do desconto no PINPAD.
Após realizar as configurações será necessário enviar a carga de configuração para os PDVs em “Controle de Vendas > Controle de Loja > Concentra > Configuração para PDVs”.
Aplicação dos descontos BuyHelp no PDV
O desconto da BuyHelp é calculado na finalização da venda, após a aplicação de todas as ofertas e descontos. Será solicitado o número do telefone celular do cliente para validação do cadastro.
Após a digitação do número será calculado e apresentado o possível desconto para aceite e o QGCode para que o cliente possa realizar o seu cadastro na BuyHelp caso ainda não tenha.
Após o aceite, o desconto será aplicado e acresentado na apresentação da mensagem referente ao total de descontos aplicados.
Será gravado no PDV logs de comunicação com a API BuyHelp “http_buyhelp_aaaammdd.log” na pasta /mnt/pdv/buyhelp.
Exemplo: http_buyhelp_20260407.log
Relatórios para acompanhamento
Quando estiver liberada a integração BuyHelp, ao realizar as vendas será gravado o campo VALGEBUYHE nas tabelas TMPPDV, FFDD, LOGPDV e MOVPRO referente ao preço gerencial da BuyHelp. Este preço trata-se do valor referencia para controle das margens.
No processo de geração de vendas, “Controle de Vendas > Vendas de PDV’s > Manutenções > Geração vendas diária”, o preço gerencial da da BuyHelp será gravado na tabela VENDIAXX (campo PREVEND17) sendo utilizado para o cálculo da rentabilidade e apresentado nas consultas e relatórios de vendas e retabilidade do sistema (que utilizam a tabela VENDIAXX). Exemplos:
“Controle de Vendas > Vendas de PDV’s > Consultas > Vendas/Rent. por Filial”
“Controle de Vendas > Vendas de PDV’s > Relatórios > Vendas/Rentabilidade por Filial”
| Autor | Descrição | Data |
| Marcos André | Desenvolvimento do manual | 07/04/2026 |
| Edgar Pontes | Revisão do manual | 07/04/2026 |