Integração ERPFlex x Eyemobile

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 Key e a Secret Key do seu grupo. Essas chaves costumam ser padrão para todas as filiais.
Point ID da 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) e Senha 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 EyeMobile para 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 Bandeiras para 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.

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 webhook para 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:

Acesse Cadastros > Integrações > Log de Integrações / Auditoria

Etapa A: Consultando Sucessos e Erros

No campo Integração ativa, selecione eyemobile · eyemobile.
No filtro Resultado, selecione Erros (para ver falhas) ou Sucessos (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”
- 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).

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 Sucessos e confirme que a referência agora exibe o cupom faturado com sucesso!

Faturamento

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