O Eyemobile é uma solução de Ponto de Venda (PDV) e frente de caixa móvel operada diretamente em maquininhas inteligentes de cartão (smart POS – Android/iOS) ou tablets. Ele permite registrar pedidos presenciais, emitir comprovantes e receber pagamentos na frente de caixa com alta mobilidade.
Do que se trata a Integração?
A integração tem como objetivo centralizar e automatizar o recebimento de vendas presenciais (PDV) no ERPFlex. Toda venda ou cupom gerado na ponta do Eyemobile é transmitido automaticamente para o ERPFlex, alimentando o faturamento, realizando a baixa do estoque e alimentando o controle financeiro em um único repositório.
Regras Fundamentais de Mapeamento & Vendas:
- Associação de Produtos (SKU): O código do produto (SKU) cadastrado na Eyemobile deve ser exatamente igual ao código no ERPFlex. Na primeira venda, o sistema realiza o vínculo automático e salva as chaves na tabela Integradados.
- Multilojas em Unidade Única (Point ID): Na Eyemobile, todas as lojas/filiais podem estar sob a mesma credencial global. O direcionamento correto das vendas para a filial correspondente no ERPFlex é feito exclusivamente pelo preenchimento do campo Point ID.
- Suporte a NF-e (Modelo 55): Além de cupons fiscais/NFC-e, o sistema suporta vendas corporativas (para CNPJ) faturadas na Eyemobile via NF-e (Modelo 55), gravando impostos, chave de acesso e o status transmitido no ERPFlex.
O que você precisa antes de começar?
Antes de preencher os campos no ERPFlex, verifique se você já possui estes dados em mãos:
- Credenciais Eyemobile: Solicite à equipe da Eyemobile a
Access Keye aSecret Keydo seu grupo. Essas chaves costumam ser padrão para todas as filiais. Point IDda Loja: Obtenha o código único UUID que identifica o ponto de venda/filial específico na Eyemobile.- Credenciais de API ERPFlex (APU): Cada empresa/filial do ERPFlex deve utilizar seu próprio
Usuário API (APU)eSenha API (APU).
Passo a Passo de Configuração no ERPFlex
- Acesse o ERPFlex pelo menu: Configurador de Integrações > Eyemobile.
- No topo da página, marque a caixa
[x] Integração Ativa.

Passo 1: Aba “Credenciais” (Identificação e Flexibilidade de Ambiente)
Nesta aba, informamos as chaves de comunicação da API:
| Campo | O que preencher / Funcionamento |
Access Key / Secret Key |
Cole as chaves fornecidas pela Eyemobile (X-EYEMOBILE-ACCESS-KEY e X-EYEMOBILE-SECRET-KEY). São padronizadas para o grupo. |
Usuário API (APU) / Senha API |
Cole o usuário e senha específicos da filial no ERPFlex. |
Ambiente API Eyemobile |
URL base da Eyemobile. Permite alterar livremente para o ambiente de homologação ([https://staging-api.eyemobile.com.br](https://staging-api.eyemobile.com.br)) sem travar a base de produção caso precise realizar testes! |
Ambiente API ERPFlex |
Mantenha o padrão: [https://api.erpflex.com.br](https://api.erpflex.com.br). |
URL pdvserver EyeMobile |
Mantenha o padrão: [http://eyemobile.erpflex.com.br](http://eyemobile.erpflex.com.br). |
Token ERPFlex |
Chave gerada automaticamente pelo sistema após salvar. |
Passo 2: Aba “Parâmetros” (Vínculo de Loja, Taxas e Bandeiras TEF)
- Loja EyeMobile (Point ID): [Campo Obrigatório] Cole o
Point ID(código UUID da loja na Eyemobile). Sem ele, o sistema não sabe qual filial do ERPFlex deve receber o cupom. - Taxa de Serviço: Caso cobre taxa de serviço (ex.: 10% de garçom), selecione o produto/serviço correspondente no ERPFlex (
SB1_ID). (Nota: Se a taxa for cobrada no caixa e o campo não estiver preenchido, o ERPFlex absorve o valor somando-o diretamente no total do último item da nota). - Formas de Pagamento e Bandeiras:
- Clique no botão
Atualizar formas EyeMobilepara puxar os tipos de pagamento do caixa. - Para cada forma (Dinheiro, Cartão, PIX, etc.), selecione a Forma de Pagamento correspondente no ERPFlex.
- Mapeamento de Bandeiras: Em pagamentos por cartão, clique em
Bandeiraspara vincular opcionalmente cada bandeira (Elo, Hipercard, Amex, etc.) a uma forma de pagamento e código TEF específicos no ERPFlex. Isso garante conciliação bancária perfeita! Caso não deseje separar por bandeira, vincule uma forma genérica de cartão para todas.

- Clique no botão
Passo 3: Aba “Webhook e URLs” (Avisos em Tempo Real & Validação de Conexão)
O Webhook avisa o ERPFlex instantaneamente assim que um cartão é passado na maquininha.
-
Clique no botão verde
Ligar webhookpara ativar. -
Validador de Credenciais: O próprio botão de ativar funciona como teste de conexão. Se houver qualquer dado incorreto nas abas Credenciais ou Parâmetros (como Point ID errado), o Webhook recusará a ligação e exibirá uma mensagem de erro na tela.

Passo 4: Aba “Integração” (Ajustes de Desempenho e Ferramentas de Resgate)
-
Realizar De/Para (Novo!): Clique neste botão ao cadastrar uma nova loja ou filial. Ele consulta a Eyemobile e cria previamente a tabela de equivalência de produtos no ERP. Isso otimiza o processamento e torna a importação das vendas muito mais rápida.
-
Integrar Vendas Pendentes na Fila: Puxa os cupons que ficaram represados no servidor da Eyemobile (mecanismo Lock/Confirm).
-
Integrar Vendas por Período Selecionado: Permite buscar vendas em um intervalo de datas (limite máximo de 30 dias por busca para evitar sobrecarga no servidor). O sistema valida cada cupom e não duplica vendas já registradas.
-
Integrar Venda por
transaction_id: Permite reprocessar individualmente uma venda específica informando o ID de transação fornecido pela Eyemobile.

Auditoria de Integração e Conciliação Financeira
Para acompanhar o status das vendas ou identificar erros de cadastro:
Etapa A: Consultando Sucessos e Erros
- No campo Integração ativa, selecione
eyemobile · eyemobile. - No filtro Resultado, selecione
Erros(para ver falhas) ouSucessos(para ver vendas importadas). - Informe a Data inicial e Data final da pesquisa e clique no botão
Buscar. - O painel superior mostrará o contador geral do período (Integrados, Com erro e Totais).
- Integrados: Vendas importadas com sucesso no ERPFlex.
- Erros: Vendas que não entraram devido a algum problema de cadastro (por exemplo, um produto vendido na maquininha que não estava cadastrado no ERPFlex).
Etapa B: Entendendo a Coluna “Referência” e o Contador de Tentativas
Na tabela de resultados, observe a coluna Referência:
- Ela exibe o número do cupom e a quantidade de tentativas realizadas pelo sistema até aquele momento. Exemplo: Cupom 759 · 8 tentativas ou Cupom 56 · 2 tentativas.
- Toda vez que o sistema tenta importar um cupom que falha (ou quando você solicita o reprocessamento manual), uma nova tentativa é registrada.
- Ao filtrar por Sucessos, você verá cupons que anteriormente tinham erros, mas que após a correção do cadastro foram integrados com a mensagem: “Faturamento incluído com sucesso.”.
Etapa C: Investigando a Causa do Erro (Botão JSON </>)
Quando um cupom apresentar protocolo HTTP 422 (Erro de Validação):
-
Vá até o lado direito da linha e clique no botão
</>na coluna JSON.

-
Uma janela se abrirá com duas abas superiores:
- Aba “Última tentativa”: Exibe o ID do log, o ID da transação da Eyemobile, a orientação na caixa Como corrigir e o detalhe técnico do erro.
- Exemplo de mensagem de erro:
- Itens incompletos: NFC-e tem 1 det(s) e só 0 item(ns) resolvido(s) no ERP.
- Produto não encontrado: product_name=”produto” sku=”código”
- Exemplo de mensagem de erro:
- Aba “Tentativas (X)”: Traz uma tabela histórica com a evolução cronológica de todas as tentativas daquele mesmo cupom (data/hora, ID do log, protocolo e mensagem de retorno).

- Aba “Última tentativa”: Exibe o ID do log, o ID da transação da Eyemobile, a orientação na caixa Como corrigir e o detalhe técnico do erro.
Etapa D: Como Corrigir o Cadastro e Reprocessar a Venda
-
Anote o SKU do produto: Na mensagem do erro, veja qual é o produto e o código SKU faltante.
-
Cadastre no ERPFlex: Vá até o cadastro de produtos do ERPFlex e crie o produto utilizando exatamente o mesmo código SKU.
-
Reprocesse: Volte para o Configurador de Integrações > Eyemobile, abra a aba Integração, informe a data em Integrar Vendas por Período (ou cole o ID no campo transaction_id) e clique em
Integrar. -
Confirmação: Acesse a tela de Auditoria, filtre por
Sucessose confirme que a referência agora exibe o cupom faturado com sucesso!


Faturamento
As vendas integradas serão listadas na tela de Faturamento.













































