Produto: maxPedido
Versão mínima para a validação no maxPedido: 4.050.1
Visão Geral
A integração com o Hub Gera foi desenvolvida para simplificar e automatizar a aplicação de campanhas comerciais progressivas com a metodologia da indústria Colgate, garantindo mais agilidade, precisão e consistência nas operações do dia a dia.
Na prática, isso significa que regras mais complexas — como descontos, brindes, precificação dinâmica e descontos progressivos — são aplicadas automaticamente, reduzindo erros manuais e aumentando a eficiência da equipe comercial.
O Hub Gera funciona como o responsável por processar e validar todas as regras comerciais, enquanto o maxPedido atua como a ferramenta que o vendedor utiliza no dia a dia para realizar pedidos de forma rápida, segura e alinhada com as estratégias definidas pela empresa.
Passo a passo
1. Solicitar ao time GERA a chave de integração (GUID) que permite a
comunicação entre o hub Gera e o maxPedido.
2. Verificar parametrizações:
| Parâmetro | Descrição |
| HABILITA_SISTEMA_GERA | Habilitar quais usuários utilizarão o maxPedido + Gera |
| CNPJ_SISTEMA_GERA | Inserir o CNPJ do contrato Gera no formado xx.xxx.xxx/xxxx-xx (alterar de acordo com o CNPJ da empresa que o vendedor vai trabalhar, trate o parâmetro para o cnpj filial etc) |
| GUID_DISTRIBUIDOR_GERA | Inserir o GUID de distribuidor do contrato Gera (informado pela Gera) |
| DISTRIBUIDORES_GERA | Inserir os códigos dos fornecedores (codfornec do ERP) utilizados para a Gera buscar as informações necessárias. Inserir os fornecedores separados por vírgula (,) sem espaço. (Geralmente utilizado o código dos itens vinculados à colgate) |
IMPORTANTE
Para os usuários que irão utilizar o maxpedido + hubGera, é necessário que as campanhas progressivas da máxima sejam desabilitadas para o usuário e o acompanhamento das campanhas ser feito exclusivamente pela aba OFERTAS!
3. Baixar e instalar Aplicativo Gera disponível na Google Play, utilizado para viabilizar a sincronização e
execução das regras comerciais.
Requisitos recomendados:
https://api.geravi.com.br/#a62b1d31-c500-4a47-a5d2-aa262f32558f
Componente | Especificação |
Sistema Operacional | Android 11 ou superior |
Processador | Qualcomm Snapdragon série 700 ou equivalente |
Memória RAM | 6 GB |
Armazenamento livre | 1 GB |
3. Antes de iniciar o pedido, é necessário realizar uma sincronização manual no maxPedido, com o aplicativo da gera em segundo plano, fazendo isso, iremos Gerar o token automaticamente para o usuário e trazer:
• Ofertas
• Recomendações de produtos
• Classificações comerciais (Consultado na tela de informações do cliente)
Obs.: Só é possível confeccionar um pedido quando a sincronização com o hub Gera tenha sido concluída
Para acompanhar a sincronização do hubGera, é possível verificar pelas notificações do aparelho ou aguardar a sincronização ser concluída na tela inicial do maxPedido.
4. Na aba de tabela, são exibidos os produtos conforme o portfólio recomendado pela
indústria, já considerando os dados sincronizados.
5. A aba ofertas centraliza todas as campanhas da Gera com:
• Filtros: em andamento, não positivadas e positivadas
• Botão de recalcular ofertas
IMPORTANTE
Sempre que o vendedor atingir uma oferta, clicar em recalcular ofertas para ver na aba itens os descontos que ele ganhou na negociação.
6. Brindes conquistados: Ao atingir as regras das campanhas, os brindes ficam
disponíveis para consulta na aba de ofertas.
7. Inserir itens e fechar pedido:
• Descontos são aplicados automaticamente conforme as ofertas atingidas
• Ao finalizar, o sistema alerta sobre oportunidades não aproveitadas e pede para ser executada um recálculo das ofertas
• Pedido é enviado para processamento do hub Gera normalmente
Suporte e Quem Consultar
Quando acionar o Suporte Gera
- Manutenção e disponibilidade do Hub Gera
(ex: sistema fora do ar, instabilidade, indisponibilidade) - Geração e validação de tokens de acesso
(ex: erro de autenticação, necessidade de sincronização por falha de acesso) - Cálculo de preço, descontos e brindes
(ex: valores incorretos retornados para o app) - Definição de portfólio recomendado (mix)
(ex: sugestões de produtos inconsistentes ou ausentes) - Status de fechamento e autorizações comerciais
(ex: pedidos não aprovam, status não atualiza corretamente)
Quando acionar o Suporte Máxima
- Dados não atualizam, falha ao sincronizar pedidos ou informações
- Filtros não funcionam, dados inconsistentes na visualização
- Produtos aparecendo indevidamente ou sendo bloqueados sem motivo
Críticas dos Pedidos Gera
Abaixo, há todos os exemplos de críticas que podem acontecer nos pedidos com a Gera:
| Mensagem no Sistema | Ação/Diagnóstico |
| Aguardando processamento no HubGera | Fluxo normal de fila de processamento. |
| Pedido fechado, aguardando aprovação no HubGera | Regras de negócio validadas, aguarda liberação comercial pela Gera. |
| Pedido aprovado, aguardando retorno da autorização do HubGera | Transição interna para autorização final da Gera. |
| Erro ao aprovar pedido no HubGera. Clique em "Reprocessar Gera" ou aguarde o reprocessamento automático. | Ocorre quando houve algum problema de integração da Gera. Será liberado um novo botão ao segurar o pedido "Reprocessar Gera", se o pedido continuar com divergência de preço, consultar o Suporte Gera. |
| Pedido processado, aguardando envio nuvem | Pronto para integração com o ERP via Nuvem. |
| Pedido com divergência de preço HubGera. Clique em "Reprocessar Gera" ou aguarde o reprocessamento automático. | Quando ocorrer, irá aparecer opção de editar o pedido na timeline, contudo, antes, o vendedor deve sincronizar o aplicativo para atualizar os dados no HubGera. (Obs.: Sempre que editar nesse cenário, iremos mostrar uma dialog de alerta para lembrar o vendedor de sincronizar o aplicativo). O sistema tenta a cada 15 min reprocessar pedido enviar sem descontos, se usar swipe, também realiza o processamento. |
| Erro ao gerar autorizações no HubGera. Clique em "Reprocessar Gera" ou aguarde o reprocessamento automático. | Ocorre quando houve algum problema de integração da Gera. Será liberado um novo botão ao segurar o pedido "Reprocessar Gera", se o pedido continuar com divergência, consultar o Suporte Gera. O sistema tenta a cada 15 min reprocessar pedido enviar sem descontos, se usar swipe, também realiza o processamento. |
| Erro no fechamento do pedido no HubGera. Edite o pedido, retire os itens inválidos e envie-o novamente. | Ocorre quando houve algum problema de integração da Gera. Será liberado um novo botão ao segurar o pedido "Reprocessar Gera", se o pedido continuar com divergência, consultar o Suporte Gera. O sistema tenta a cada 15 min reprocessar pedido enviar sem descontos, se usar swipe, também realiza o processamento. |
| Erro no fechamento - Falha técnica HubGera. Clique em "Reprocessar Gera" ou aguarde o reprocessamento automático. | Ocorre quando houve algum problema de integração da Gera. Será liberado um novo botão ao segurar o pedido "Reprocessar Gera", se o pedido continuar com divergência de preço, consultar o Suporte Gera. O sistema tenta a cada 15 min reprocessar pedido enviar sem descontos, se usar swipe, também realiza o processamento. |
Artigo criado por João Pedro Alves