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

  1. Acesse o ERPFlex pelo menu: Configurador de Integrações > Eyemobile.
  2. 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:

  1. Acesse Cadastros > Integrações > Log de Integrações / Auditoria
Etapa A: Consultando Sucessos e Erros
  1. No campo Integração ativa, selecione eyemobile · eyemobile.
  2. No filtro Resultado, selecione Erros (para ver falhas) ou Sucessos (para ver vendas importadas).
  3. Informe a Data inicial e Data final da pesquisa e clique no botão Buscar.
  4. 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):

  1. Vá até o lado direito da linha e clique no botão </> na coluna JSON.

  2. 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
  1. Anote o SKU do produto: Na mensagem do erro, veja qual é o produto e o código SKU faltante.

  2. Cadastre no ERPFlex: Vá até o cadastro de produtos do ERPFlex e crie o produto utilizando exatamente o mesmo código SKU.

  3. 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.

  4. 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.

Integração ERPFlex x Frete Rápido

A integração entre o ERPflex e a Frete Rápido permite gerenciar cotações, contratações de transportadoras, rastreamento de envios e emissão de etiquetas diretamente pelo ERP, seja no módulo de Orçamentos ou no de Faturamento/Vendas.

Para viabilizar as cotações, a empresa pode sincronizar os cadastros de produtos (SKUs) e suas especificações de volumetria em lote ou automaticamente a cada alteração. Além disso, o sistema recebe notificações e atualiza ocorrências de transporte em tempo real via Webhook.

Configuração Inicial da Integração

  1. Acesse o menu Integrações, selecione a opção Configurador de Integrações.
  2. Clique no card Frete Rápido.
  3. Na aba Geral, informe:
    • Token de Integração: Chave de acesso fornecida pelo portal do Frete Rápido.
    • CPF / CNPJ: Documento da empresa cadastrado na plataforma do Frete Rápido.
  4. Clique no botão Verificar Credenciais.

    • Resultado esperado: O sistema apresentará uma mensagem confirmando que as credenciais são válidas e exibindo o saldo disponível da conta.

  5. Marque/ajuste as opções de acordo com a regra de negócio da empresa:

    • Incluir/Atualizar/Deletar SKU no Frete Rápido ao salvar SKU no ERPFlex: Mantém o cadastro de SKUs sincronizado em tempo real à medida que são cadastrados ou alterados no ERP.

    • Valor do frete destacado no valor total (Não faturar e não incidir no produto): Garante que o valor do frete fique apenas para análise no pedido, sem ratear ao faturar.

    • Habilitar contratação antecipada de oferta de frete no Orçamento: Permite que a contratação ocorra logo na aprovação do orçamento. Se estiver desmarcado, a contratação ocorrerá por padrão na emissão da NFe.

    • Notificação de ocorrência por e-mail: Envia e-mails automáticos com atualizações de rastreamento (ex.: coletado, em trânsito, entregue).

    • URL Webhook Ocorrências: Copie a URL gerada pelo ERPFlex e cadastre no painel do Frete Rápido para habilitar o envio automático de status de entrega.

  6. Para evitar digitação manual dos códigos da plataforma parceira, clique na aba Ocorrências e pressione o botão Carregar Padrões. O ERPFlex carregará a lista de códigos de status de transporte e mapeará quais são Finalizadoras (ex.: Entregue, Devolvido).

  7. Clique na aba Tipos de Volumes e pressione Carregar Padrões. Os tipos de volumes podem ser associados ao SKU e sugeridos no momento da cotação.

    • Atenção: Como não existe uma API do Frete Rápido para atualização automática e contínua dos tipos de volume, estas tabelas funcionam por pré-carga. Caso seja necessário cadastrar um novo código de volume, utilize o botão Adicionar Tipo de Volume e insira o código/descrição manualmente.
  8. Clique em Salvar.

Parametrização de Produtos (SKU)

Para calcular o frete corretamente, cada produto precisa de informações volumétricas exigidas pelas transportadoras.

Cadastrando Informações do Frete no SKU
  1. Acesse Produtos e Serviços > SKU e abra o produto desejado.
  2. Com a integração ativa, a seção/aba Frete Rápido – Mais informações estará disponível. Preencha:
    • Tipo de Volume: Categoria do produto (ex.: 18 – Eletrônicos).
    • Pode consolidar?: Sim/Não (Indica se o produto pode ser colocado na mesma caixa com outros itens).
    • Pode sobrepor?: Sim/Não (Indica se outras caixas podem ser empilhadas sobre ele).
    • Pode rotacionar?: Sim/Não (Indica se o pacote pode ser virado no transporte).
    • Tamanho/Peso: Certifique-se de que Comprimento, Altura, Largura, Peso Líquido e Peso Bruto estejam preenchidos.
  3. Clique em Salvar.

Sincronização em Lote de SKUs

  1. Para puxar ou enviar múltiplos produtos de uma só vez, acesse a grid de SKUs, selecione os itens desejados e clique no botão Mais:

    • Frete Rápido -> ERPFlex: Atualiza os SKUs no ERP com base no cadastro existente no Frete Rápido.
    • ERPFlex -> Frete Rápido: Envia os cadastros e atualizações do ERP Flex para a plataforma do Frete Rápido.

Cotação e Contratação de Frete em  Orçamentos

  1. Acesse o menu Lançamentos, Vendas e selecione a opção Orçamentos.
  2. Clique em Incluir Geral para criar novo orçamento ou abra um existente,
  3. Selecione o cliente e insira os produtos desejados.
  4. Quando a integração Frete Rápido está ativa, o botão exclusivo do Frete Rápido estará visível no painel. Clique nele para abrir a janela de cotação.
Aba 1 – Endereços:
  • Destino: Preenchido automaticamente com base nos dados do cliente ou endereço de entrega cadastrado. É possível alterar manualmente caso a entrega seja em outro local.
  • Origem: Define o local de saída dos produtos (endereço da matriz, filial ou CD/Centro de Distribuição).
  • Clique em Próximo.

Aba 2 – Volumes & Origens:
  • Exibe a lista de produtos, quantidades e o Tipo de Volume atribuído no SKU.
  • Se algum produto não possuir Tipo de Volume cadastrado, o sistema exigirá a seleção do volume nesta tela antes de prosseguir.
  • Clique em Cotar.
Aba 3 – Ofertas:
  • O ERPFlex consulta a API do Frete Rápido e exibe as transportadoras e as ofertas de frete disponíveis com seus respectivos valores e prazos estipulados (Preço, Prazo de Entrega e Modal).
  • Clique em Ver Detalhes para conferir a cubagem estimada e data limite de expiração da oferta (geralmente 30 dias).
    Cada cotação possui uma data de expiração (ex: válida até determinado dia/horário). Caso o orçamento seja salvo e aprovado após a expiração, o sistema exigirá uma nova cotação.
  • Selecione a oferta desejada e clique em Confirmar e Avançar.
Aba 4 – Resultado / Resumo:
  • Apresenta a volumetria calculada (Peso cubado, quantidade de volumes e detalhamento da carga).
  • Clique em Concluir.
  • Se desejar trocar a transportadora sem gastar nova chamada de cotação na API, reabra o Frete Rápido e clique em Rever e alterar ofertas.
Frete Cotado
  1. De volta à tela de edição do orçamento, o campo Valor do Frete e a Transportadora serão preenchidos automaticamente.

  2. O status no ERPFlex exibirá “Cotada – Aguardando Salvar”.

    • Regra de Invalidação de Cotação: Se após realizar a cotação você editar o pedido para alterar quantidades, incluir novos produtos ou alterar preços unitários, o ERPFlex desvalidará a cotação anterior e exibirá um alerta. Será necessário recalcular o frete para cobrir a nova volumetria/valor.
  3. Ao salvar o orçamento e aprovar (Aprovação do Cliente), o frete muda seu status para Contratado.
Cancelamento da Cotação / Contratação

Caso o cliente desista ou seja necessário refazer o processo de frete:

  1. Clique no botão do Frete Rápido no orçamento contratado.
  2. Clique no botão Cancelar ou Remover Oferta.
    O Frete Rápido solicitará a inserção do motivo do cancelamento (ex: “Desistência do cliente”, “Erro de digitação”).
  3. Clique em Confirmar.
    Importante – Regra do Botão Salvar: O cancelamento só é efetivado de fato junto ao servidor da Frete Rápido após clicar no botão Salvar  do orçamento no ERPflex. Isso evita cancelamentos acidentais.

Emissão de Notas Fiscais e Acompanhamento

Na tela do Faturamento, ao faturar o orçamento, o botão do Frete Rápido permanece disponível na nota de venda.

Efetivação de Contratação

Quando o frete é vinculado diretamente à venda, a contratação oficial é disparada no momento da transmissão e autorização da Nota Fiscal Eletrônica (NFe).

Rastreamento

Após a contratação, é gerado um código de rastreio que pode ser consultado via modal de rastreamento no ERPflex ou diretamente pelo portal externo da Frete Rápido (ondestameupedido.com.br).

Módulo de Expedição, Geração e Impressão de Etiquetas

A gestão de expedição e impressão de etiquetas ocorre de forma individualizada ou em lote:

  1. Acesse o menu Lançamento, Estoque, opção Expedição.
  2. As vendas/notas fiscais transmitidas integradas ao Frete Rápido exibirão o ícone indicativo do serviço de transporte (ícone de caminhão/etiqueta).
    • Os formatos das etiquetas são fornecidos dinamicamente pela própria API do Frete Rápido (ex: PDF A4, PDF Térmica Zebra, ZPL, DANFE Simplificado, etc.).
  3. Selecione o formato compatível com sua impressora.
Impressão em Lote

Para otimizar a rotina operacional, a expedição permite selecionar múltiplos pedidos simultaneamente através da funcionalidade Etiquetas em Lote – Frete Rápido.

Atenção ao Cálculo de Volumes: As etiquetas são geradas estritamente por volume/caixa consolidado. Caso os produtos não estejam consolidados adequadamente nas caixas cadastradas, o sistema pode emitir um número excessivo ou incorreto de etiquetas (um volume avulso para cada item).

Certifique-se de que os produtos possuem dimensões corretas e estejam devidamente consolidados no cálculo da carga.

Visualizador de Ocorrências

A transportadora realizará a coleta e atualizará o status na plataforma do Frete Rápido. A Frete Rápido notifica o ERPFlex sobre cada mudança de status, via Webhook.

O ERPflex disponibiliza o Visualizador de Ocorrências do Frete Rápido, onde é possível consultar todas as atualizações de status de entrega (Webhooks/Rastreio) ocorridas dentro de um intervalo selecionável (ex: últimas 4 horas ou intervalo personalizado).

O ERPFlex registra o histórico e envia um e-mail de notificação com o código de rastreamento para o destinatário/empresa.

O ciclo se encerra quando uma ocorrência do tipo Finalizadora (ex.: Entregue) é registrada.

Resumo dos Status do Frete

Consulta do Consumo e Tarifador de API

Mais Controle, Transparência e Previsibilidade Financeira para o seu Negócio

Queremos apresentar uma novidade importante no ERPFlex desenvolvida para garantir total transparência e autonomia na gestão técnica e financeira das suas integrações.

Com a nova consulta de Consumo de API, você acompanha o volume de requisições em tempo real, monitora faturamentos, analisa os endpoints mais utilizados, exporta relatórios auditáveis em Excel e programa alertas e travas de segurança!

Benefícios da Ferramenta

✔ Transparência Total: Acompanhamento transparente da formação de custos e do volume de requisições do seu contrato.

✔ Autonomia e Auditoria: Relatórios detalhados e exportáveis para conciliações contábeis e de TI.

✔ Governança e Prevenção: Gatilhos graduais de aviso e bloqueios automáticos para garantir previsibilidade financeira.

Como Acessar?

Para consultar o consumo de chamadas do seu contrato:

    1. Acesse menu Consultas, API  e selecione a opção Tarifador API.
    2. Em Filtros, selecione seu Contrato e o período no campo Mês/Ano para filtrar os dados da tela.
    3. Em seguida, clique no botão Atualizar para processar os dados.

 

O que você encontra na Tela de Consulta?

A interface reúne todas as informações em blocos intuitivos:

Seção Funcionalidade e Benefícios
KPIs em Tempo Real 5 cards essenciais: Faixa Atual (com valor unitário), Requisições Totais, Requisições Cobradas, Saldo p/ Próxima Faixa e Total Cobrado (R$).
Top Endpoints Ranking das rotas e métodos HTTP (GET, POST, PUT) mais acionados para ajudar na otimização do tráfego.
Faixas de Tarifação Visibilidade da regra de franquia/excedentes e da tabela escalonada de preços por faixa de utilização.
Requisições Realizadas Histórico auditável detalhando Data/Hora, Método, URL, Serviço, Status, Duração, APU e Contrato.

Como Configurar Alertas e Trava de Segurança?

Você pode programar gatilhos de notificação e bloqueios automáticos para proteger o orçamento do seu contrato. É possível receber o aviso por email (via servidor SMTP) e pela Central de Notificações do ERPFlex.

A notificação será exibida a usuários do perfil Administrador.

  1. Acessar as Configurações: No canto superior direito da tela, clique no ícone da Engrenagem ⚙️ e selecione “Configurar notificações…”.

  2. Cadastrar E-mail de Destino: No campo Endereço de e-mail, informe o e-mail corporativo que receberá os alertas.

  3. Programar Alertas de Consumo: Na tabela Alertas de consumo, marque a opção Ativo nas metas desejadas (ex: 50.000, 100.000 requisições) e escolha o canal de envio:
    • Coluna ERP: Envia avisos diretamente para a central de notificações interna do sistema.
    • Coluna E-MAIL: Dispara mensagens de alerta diretamente para o e-mail cadastrado.
  1. Ativar Trava de Segurança (Opcional): Na seção Trava de requisições, marque a opção “Bloquear novas requisições ao atingir o limite” e informe o valor no campo Limite mensal (req.). Ao atingir esse limite, a API interrompe novas chamadas temporariamente, resguardando seu orçamento.
  2. Salvar Preferências: Clique no botão Salvar para gravar todas as definições.

Exportando Dados em XLS (Excel)

A exportação permite extrair todos os registros e métricas em uma planilha para auditoria interna ou conciliação financeira:

  1. Acesse a seção de Filtros na parte superior da tela.
  2. Selecione o Contrato desejado e defina o período no campo Mês/Ano.
  3. Clique no botão Atualizar para carregar as informações correspondentes.
  4. Clique no botão Exportar XLS (localizado ao lado do botão Atualizar).
  5. O download da planilha em Excel começará automaticamente com os dados detalhados.

Notas de Redução de Valores, Retorno Parcial e Retorno Total

Algumas notas de crédito exigem referenciamento das notas fiscais originais de saída. São elas:

  • Redução de Quantidade e Valor: Utilizada nos casos em que ocorrem abatimentos comerciais, erros de precificação ou entregas parciais acordadas, permitindo o ajuste do valor final da operação sem invalidar a nota fiscal original.

  • Recusa Parcial: Indicada quando o cliente aceita apenas uma parte da carga ou do serviço, permitindo a regularização do saldo de estoque e do financeiro referente ao item recusado.

  • Recusa Total: Aplicada quando a mercadoria ou serviço é rejeitado integralmente pelo destinatário no momento da entrega, garantindo o estorno fiscal e contábil completo da operação.

Perguntas e Respostas: https://atendimento.receita.rs.gov.br/ajuste-sinief-49-25

Veja a seguir como emiti-las.

Para gerar uma nota de crédito de redução de valores ou quantidades:

  1. Na tela do Faturamento, marque a nota de saída e clique no menu Mais.
  2. Selecione a opção Nota de Crédito – Redução de Valores ou Quantidade.
  3. A tela de Compras é exibida.

    Os CFOPs devem ser o inverso da nota de saída.
  4. Efetue os ajustes de quantidades ou valores, e os CFOPs, se necessário.
  5. Se a nota for somente para redução de valores, lembre-se de marcar a caixa Não Atualizar Estoque.
  6. Grave a nota.
  7. Acesse Lançamentos > Compras > Compras e realize a transmissão da nota.

Para gerar notas de crédito de recusa parcial ou total:

  1. Na tela do Faturamento, marque a nota de saída e clique no menu Mais.
  2. Selecione a opção Nota de Crédito – Retorno por Recusa Total ou Retorno por Recusa Parcial.
  3. A tela de Compras é exibida.

    Os CFOPs devem ser os de devolução.
  4. Efetue os ajustes de quantidades e os CFOPs, se necessário.
  5. Grave a nota.
  6. Acesse Lançamentos > Compras > Compras e realize a transmissão da nota.

Eventos IBS e CBS

Os eventos possuem a finalidade de registrar situações específicas que produzem efeitos diretos na apuração assistida do IBS, seja por complementar ou corrigir informações prestadas nos documentos fiscais eletrônicos.

Como registrar um evento de IBS e CBS sobre as notas:

  1. Na tela de Faturamento e Compras, marque a nota previamente autorizada e clique no botão Mais.
  2. Selecione a opção Eventos.
  3. Selecione o evento a ser registrado.
  4. Conforme o evento selecionado, podem ser listados os itens da nota de origem para ajustes de quantidade e valores. Realizada a edição, clique no botão Transmitir Evento.
  5. Conforme o evento, uma nova tela pode ser aberta para confirmação dos dados. Clique no botão Confirmar a Transmissão.
  6. Quando o evento é autorizado, o status é atualizado no sistema.
  7. Para cancelar um evento, clique no botão Excluir.

Nota de Débito de Multa e Juros

A nota fiscal de débito do tipo “04 – Multa e Juros” deverá ser emitida pelo fornecedor sempre que houver recebimento de acréscimos moratórios relativos a pagamentos efetuados com atraso pelo adquirente, correspondentes a fornecimentos realizados, com o objetivo de complementar a base de cálculo do IBS.

1. Quando emitir

O fornecedor deve emitir a Nota Fiscal de Débito de Multa e Juros (tipo 04) no momento exato do recebimento dos valores de multa e juros decorrentes de pagamentos em atraso, o valor complementar do IBS e CBS será incluído no período de apuração correspondente à data do recebimento.

O ERPFlex executa a criação automática da nota de débito de multa e juros sempre que a baixa a receber ocorrer com acréscimos.

2. Preenchimento da Nota Fiscal

  • Vínculo: Cada item da nota de débito deve referenciar diretamente o item correspondente na nota fiscal original.

  • Tributação: Devem ser mantidas a mesma classificação tributária e a mesma alíquota efetiva aplicadas na venda original.

3. Aproveitamento de Crédito pelo Adquirente

Quando o comprador for contribuinte do regime regular, a quitação desse débito gerará o direito ao crédito de IBS correspondente, respeitadas as regras vigentes do imposto.

4. Inobservância pelo Fornecedor

Caso o fornecedor não cumpra a obrigação de emitir a nota de débito, o adquirente fica autorizado a regularizar a operação por conta própria mediante a emissão de uma Nota Fiscal de Crédito.

Passo a passo para gerar nota de débito:

  1. Acesse Lançamentos > Financeiro > Contas a Receber > Títulos a Receber.
  2. Ao realizar a baixa com valor de acréscimo, a nota de débito será gerada automaticamente.
  3. Para conferir a nota de débito de multas e juros gerada, acesse Lançamentos > Vendas > Faturamento.
  4. O valor do acréscimo será rateado proporcionalmente entre os itens da nota para cálculo do valor do IBS e CBS complementar.
    Valor Rateado para o item: Valor Multa e Juros / Valor total dos itens * Valor do item na nota original
  5. Os valores de IBS e CBS são calculados considerando como base de cálculo o valor do acréscimo.

Consulte também:

https://www.cgibs.gov.br/upload/arquivos/202511/13142212-item-2-3-cartilha-do-ibs-vol-1-formatada-20251110-1506.pdf

Otimização do processo de atualização do custo standard

No ERPFlex, estamos sempre buscando formas de tornar a sua rotina fiscal e de suprimentos mais ágil e com menos cliques. Por isso, implementamos uma melhoria significativa no fluxo de inclusão de Compras (seja manual, via importação de XML ou por Pedido de Compras) quando há variação no Custo Standard dos itens.

Abaixo, explicamos o que mudou, como funciona a nova regra e as opções de controle por caixas de seleção.

O que mudou? 

  • Como era: Ao lançar uma compra de vários produtos com custo de aquisição acima da tolerância em relação do custo standard gravado, o sistema exibia um alerta de confirmação individual para cada item, um por um. Em compras grandes, isso gerava um volume significativo de cliques para o usuário.

  • Como ficou agora: O processo foi otimizado! Os alertas individuais foram removidos da tela de salvamento dos itens. Agora, o sistema realiza a validação global no momento de salvar a compra como um todo.

Importante: Com a adoção desta nova metodologia unificada, o antigo parâmetro “Atualiza automaticamente custo standard ao importar o XML” deixou de existir. E o comportamento para a importação de XML agora segue a mesma regra do lançamento manual descrita a seguir.

Como funciona na prática

A atualização dos custos será acionada pelo botão Salvar na tela principal da Compra e o comportamento do sistema dependerá diretamente do parâmetro Apresentar alerta de confirmação para atualização do custo standard? (Parâmetros > Compras > Compras-Padrões):

  1. Se o parâmetro estiver configurado com Sim (Modo Interativo)

Para dar total autonomia ao comprador sobre quais custos devem ou não ser modificados, o sistema passará a exibir a flag ‘Não Atualizar Custo Standard’ tanto no cabeçalho da tela de Compras quanto no rodapé da tela de itens.

    • No Cabeçalho: Ao marcar ou desmarcar a flag Não Atualizar Custo Standard, o sistema replica a configuração para todos os itens da compra automaticamente:
      • Marcado: nenhum valor de custo será modificado, mesmo que a variação de algum produto exceda a tolerância configurada.

      • Desmarcado: a atualização será processada no momento da gravação da compra se a variação do custo de algum produto exceder a tolerância configurada.

    • Na Inclusão Manual do Item: na tela de edição do item, a caixa Não Atualizar Custo Standard funciona de forma inteligente de acordo com as margens estabelecidas:
      • Se a variação de custo NÃO exceder a tolerância: A caixa virá marcada por padrão, indicando que o custo do item não sofrerá alteração.

      • Se a variação de custo EXCEDER a tolerância: A caixa virá desmarcada, indicando que o sistema se prepara para atualizar o custo.

Independentemente do comportamento padrão sugerido pelo sistema, nessa configuração do parâmetro, o usuário tem a liberdade de alterar a marcação a qualquer momento para forçar ou impedir a atualização do custo daquele produto específico.

 

    • Na gravação da compra: se houver itens com custos diferentes do Custo Standard e habilitados para atualização, o sistema exibirá a seguinte mensagem:

“Confirmação – Custo Standard: Existem itens com preços diferentes do Custo Std. Clique em Sim para prosseguir e atualizar os custos, ou Não para cancelar e retornar à tela para revisão.”

      • Sim: o ERPFlex grava a compra imediatamente e atualiza automaticamente o Custo Standard de todos os itens válidos de uma só vez.

      • Não: a compra não é salva e o sistema devolve o usuário para a tela de edição para revisão minuciosa.

        Na listagem de itens (grid), o usuário poderá conferir as seguintes colunas para decidir a ação item por item.

        • Atu.CustoStd: sinaliza que o item está habilitado para atualização do custo standard.

        • % Var Custo Std: demontra a variação positiva ou negativa do custo da compra em relaçao ao custo standard gravado

        • Caso opte por não atualizar um produto específico, edite o item e marque a caixa Não Atualizar Custo Standard individualmente.

 

2. Se o parâmetro estiver configurado com Não (Modo Silencioso)

    • O sistema não exibirá nenhum alerta de confirmação ao salvar a compra.

    • As flags de controle “Não Atualizar Custo Standard” ficarão ocultas e não serão disponibilizadas na tela para o usuário, impossibilitando alterações manuais.

    • A compra será gravada diretamente e o sistema aplicará a atualização do custo de forma automática e silenciosa para todos os produtos que ultrapassarem a tolerância configurada.

Observação: Note que os custos standard somente são atualizados se concluída a gravação da compra.

Vínculo com Pedidos de Compra

Vale destacar que esta nova inteligência de validação não se limita apenas às compras digitadas do zero. O processo também passou a considerar os lançamentos de compras vinculados a um Pedido de Compra, respeitando a mesma parametrização descrita acima.

Perguntas Frequentes: Nova Regra de Custo Standard

O que acontece se eu importar um XML de compra com divergências de custo e o parâmetro de alerta estiver desativado?

Se o parâmetro “Apresentar alerta de confirmação para atualização do custo standard?” estiver configurado como Não, o sistema não exibirá nenhum aviso em tela e ocultará as caixas de seleção (flags) de controle. O ERPFlex gravará a nota fiscal diretamente e atualizará o Custo Standard de forma automática e silenciosa para todos os produtos que ultrapassarem a margem de tolerância configurada no sistema.

Como posso impedir que a atualização do Custo Standard seja aplicada a um item específico de uma nota grande?

Para controlar um item individualmente, o usuário deve garantir que o parâmetro de alerta esteja ativado. Ao salvar a nota e optar por Não na mensagem centralizada do cabeçalho, o sistema reabrirá a tela de edição. Na listagem de itens (grid), basta acessar o item desejado e marcar a caixa de seleção Não Atualizar Custo Standard. Dessa forma, mesmo que os outros produtos da nota sejam atualizados, aquele item específico manterá o custo antigo.

O antigo parâmetro "Atualiza automaticamente custo standard ao importar o XML" ainda funciona?

Não, esse parâmetro deixou de existir. Com a nova atualização, o processo de importação de XML foi unificado e agora segue exatamente as mesmas regras de validação centralizada e parametrização aplicadas à inclusão manual de notas e aos lançamentos vinculados a Pedidos de Compra.

Consultas de Vendas – novo parâmetro para seleção dos Tipos de Movimentos

Para permitir maior flexibilidade na conferência dos dados de faturamento e receitas, implementamos um parâmetro para seleção dos tipos de movimentos que serão incluídos nas  consultas e relatórios de Vendas. Por padrão,  vêm marcados os tipos de movimentos que já são considerados. 

Além da seleção dos tipos de movimentos, os relatórios passam a exibir um descritivo do seu objetivo, facilitando o entendimento sobre os dados exibidos.

Confira a seguir lista das consultas/relatórios que receberam essas implementações:

Vendas Comissões de Vendas Curva ABC Margem de Contribuição
  • Orçamentos
  • Vendedor Faturamento
  • Curva ABC por Categoria
  • Margem de Contribuição por Vendas
  • Aprovação Orçamento (Status)
  • Vendedor Recebimento
  • Curva ABC por Cliente
  • Margem de Contribuição por Cliente
  • Faturamento
  • Vendedor Consolidado por Cliente
  • Curva ABC por Produto
  • Margem de Contribuição por Orçamento
  • Modelos de Nota Fiscal
  • Curva ABC por Subcategoria
  • Margem de Contribuição por Produto/Serviço
  • Notas Canceladas
  • Curva ABC por Vendedor
  • Margem de Contribuição por Vendedor
  • Vendas por Vendedor
  • Produtos/Serviços Vendidos

Melhorias no Processo de Nota Fiscal de Importação

 

Tratamento do valor da AFRMM na base de cálculo do ICMS /  Reposicionamento da aba Declaração de Importação

A partir de agora, no lançamento manual de uma nota de importação, o valor da AFRMM informado na Declaração de Importação passa ser considerado automaticamente para o cálculo da base do ICMS (até a versão anterior, era necessário somar o valor do AFRMM no campo de Despesas Aduaneiras para que fosse considerado na BC ICMS).

Para facilitar o acompanhamento e a hierarquia dos cálculos, implentamos os seguintes ajustes:

  • A aba Declaração de Importação foi reposicionada para o início do processo de lançamento (antes das abas de tributos).

    • Motivo: Como os dados da DI impactam diretamente o cálculo dos impostos, essa nova ordem evita o “vai e volta” no preenchimento e garante que os cálculos sejam processados corretamente desde o primeiro passo.

  • Na aba Impostos e Taxas de Importação, adicionamos um campo exclusivo para a visualização do valor do AFRMM, permitindo a conferência rápida sem precisar retornar à aba da Declaração de Importação.

 

Novo Parâmetro: Recalcular automaticamente os impostos? 

Criamos o parâmetro “Recalcular automaticamente os impostos?” (Parâmetros > Compras > Compras-Importação)  para dar mais autonomia ao usuário:

  • “Não”: Ideal para importações via XML ou Planilha Excel, onde os valores já estão fechados. Isso trava os valores importados, impedindo que edições em outros campos (como alteração de CFOP) alterem o que foi originalmente carregado.

  • “Sim”: Ideal para lançamentos manuais, onde você deseja que o sistema calcule as bases e impostos em tempo real conforme a digitação.

 

 

Importação do XML de nota de importação com automação do cálculo do Valor Total da Nota (ICMS+PIS+COFINS)

Agora, ao importar o XML enviado pelo despachante, o sistema automatiza a memória de cálculo Valor da Desp. importação para compor o Valor Total da Nota.

  • O sistema soma automaticamente os valores de ICMS, PIS e COFINS de cada item, garantindo que o total da nota coincida com a base de cálculo do ICMS e que o título financeiro seja gerado com o valor exato, eliminando ajustes manuais.

Para isso, deve estar ativo o parâmetro  

Novo Recurso: Painel de Indicadores na Tela Inicial do ERPFlex

Acompanhar a saúde do seu negócio ficou ainda mais simples e direto ao ponto. Agora, você pode adicionar seu Painel de Indicadores diretamente na tela de entrada do ERPFlex! 

Ao abrir o sistema, você já visualiza os gráficos e métricas que mais importam para a sua rotina. Com essa novidade, você transforma a tela de entrada em um dashboard totalmente alinhado com as suas prioridades.

O que você ganha com essa novidade?

  • Decisões mais rápidas: Acompanhe resultados em tempo real (como vendas ou faturamento) assim que fizer login.

  • Segurança e controle: Cada usuário visualiza apenas os painéis que foi autorizado a acessar, respeitando rigorosamente as permissões definidas na criação de cada indicador.

  • Foco no que importa: Organize a visualização de acordo com o seu setor e rotina de trabalho.

  • Rotina mais ágil: Mais dados, menos cliques e total autonomia para personalizar sua área de trabalho.

 

Passo a Passo: Como Adicionar o Widget na Tela Inicial

  1. Inicie a configuração: Na tela principal do ERPFlex, clique no botão Adicionar Widget.

  2. Localize o indicador: Role a barra de opções para a direita até encontrar o widget Painel de Indicadores.

  3. Posicione na tela: Clique no ícone de adição (+) do widget e arraste-o para a posição desejada no seu desktop.

  4. Abra as opções: Clique no ícone de adição (+) exibido dentro do quadro do widget recém-incluído para configurá-lo.

  5. Selecione a visualização: Na janela de Opções, escolha no campo Painel de Indicadores qual visualização deseja exibir (por exemplo: Comercial, Faturamento, etc.) e clique em Salvar.

  6. Ajuste o tamanho: Clique e arraste os cantos do painel para redimensioná-lo e adaptá-lo ao seu layout na tela inicial.