Notas de Devolução: mais agilidade na emissão

Para otimizar o seu tempo e facilitar a rotina fiscal e operacional, o ERPFlex conta com uma melhoria no processo de devolução.

Agora, ao gerar uma nota de devolução, você pode selecionar diretamente os itens que foram devolvidos em uma janela de seleção rápida.

O que mudou?

  • Antes: O sistema carregava automaticamente todos os itens da nota de venda ou de compra original, exigindo que você marcasse e excluísse manualmente um por um os produtos que não faziam parte da devolução.
  • Como é agora: Uma nova tela exibe a lista completa de itens da nota de origem, permitindo que você marque apenas o que precisa devolver antes de carregar a tela final.

 

Passo a Passo para utilizar

  1. Na tela de Faturamento ou Compras, localize e posicione a nota desejada.
  2. Acesse o menu Mais e selecione a opção Nota de Devolução.
  3. Na janela Importação de itens para devolução que se abrirá na tela, marque os checkboxes correspondentes aos itens que serão devolvidos.
  4. Clique no botão OK.
  5. Pronto! A tela da nota será preenchida automaticamente apenas com os produtos selecionados, pronta para finalização.

 Aproveite essa atualização para agilizar o dia a dia da sua operação! Em caso de dúvidas, consulte nossa equipe pelo Suporte Online.

Como emitir Nota de Débito de Perda em Estoque na Reforma Tributária

Com a entrada em vigor da Reforma Tributária, caso uma mercadoria no seu armazém sofra avaria, dano ou perca a validade, o tratamento fiscal para essas ocorrências deve a seguir um padrão fiscal nacional rígido.

Nos termos do art. 47, § 6º da LC nº 214/2025, sempre que ocorrer perda de bens materiais no estoque, a empresa é obrigada a estornar da sua apuração os créditos de IBS e CBS apropriados na entrada dessa mercadoria — incluindo também os créditos dos serviços vinculados a ela (como o frete da compra).

Essa operação deve ser registrada formalmente por meio de uma Nota Fiscal de Débito do tipo “07 – Perda em Estoque”. Caso o bem tenha sido adquirido de terceiros, a norma exige que o documento fiscal referencie:

  • O documento fiscal referente à aquisição do bem;

  • O documento fiscal referente aos serviços vinculados à aquisição do bem.

 

Observação Importante: Este procedimento não se aplica às perdas ou roubos ocorridos durante o transporte de bens, situações em que devem ser observadas as regras específicas para perecimento/perda em trânsito.

Solução ERPFlex

Para facilitar essa exigência legal, o ERPFlex criou um recurso que, ao selecionar a finalidade de Nota de Débito de Perda em Estoque, permite escolher diretamente a respectiva nota de compra do produto.

Ao utilizar esse recurso:

  • São carregados automaticamente os dados da própria empresa como cliente;

  • O sistema vincula automaticamente a chave de acesso do documento de origem no XML (<NFref>);

  • O valor unitário do item assume automaticamente o Custo Médio no preço;

  • Já é carregado o CFOP 5927 (Perda, deterioração ou extravio).

 

Passo a Passo para Emissão no Sistema

1. Preenchimento do Cabeçalho e Seleção da Nota de Origem
  • Acesse a tela de faturamento em Vendas > Faturamento.

  • No Cabeçalho – Venda, preencha:

    • Modelo da NF: 55 - DANFE.

    • Finalidade: Nota de débito (<finNFe>6</finNFe>).

    • Tipo de Nota de Débito: Perda em estoque (<tpNFDebito>07</tpNFDebito>).

  • O ERPFlex trará automaticamente os dados da sua própria empresa no campo Cliente.

 

2. Inclusão do Item e Vínculo da Nota de Compra
  • Ao incluir o item de produto, acesse a seção de documento referenciado e clique em Compras.

  • Na janela de consulta, selecione a nota fiscal de compra de onde o produto é originário e confirme.

  • O sistema fará a amarração automática da chave de acesso na tag de documentos referenciados (<NFref>).

 

3. Validação dos Dados do Item e CFOP

Com o vínculo realizado, verifique o preenchimento automático dos campos do item:

  • Quantidade: ajuste a quantidade perdida em estoque
  • Preço Unitário: O valor é preenchido automaticamente com o Custo Médio do produto no estoque.

  • CFOP: O código 5927 é inserido automaticamente.

  • Financeiro e Estoque: Mantenha marcada a opção Não gerar título a receber.

  • Tipo de Movimento: o sistema atribui automaticamente o tipo V30-Nota de débito de Perda em Estoque.

4. Configuração dos tributos IPI, ICMS, PIS e Cofins
  • Preencha os CSTs dos tributos de IPI, ICMS, PIS e Cofins pertinentes à operação de perda do estoque.
5. Configuração do Estorno de Crédito (IBS e CBS)
  • Na aba IBS e CBS, preencha o CST e cClassTrib de estorno aplicável (ex.: 410;410030).
  • Na aba Estorno de Crédito, informe os valores de IBS e CBS apropriados na compra que devem ser estornados:

 

6. Salvar e Transmitir a Nota Fiscal
  • Clique em Salvar para confirmar os dados do item.

  • No Pre-Danfe é possível conferir as chaves referenciadas no quadro de Dados Adicionais.
  • Transmita o documento. No XML gerado, o ERPFlex enviará:

    • A finalidade <finNFe>6</finNFe> e o tipo <tpNFDebito>07</tpNFDebito>;

    • As chaves referenciadas na tag <NFref>;

Cadastro de Chave PIX para agilizar pagamentos no Sispag

Agora ficou muito mais rápido e prático instruir pagamentos e depósitos para os seus fornecedores!

Adicionamos os campos de Dados PIX diretamente no cadastro de fornecedores. Essa melhoria automatiza o preenchimento das informações necessárias no momento da geração do arquivo bancário eletrônico Sispag.

O que mudou?

  • No Cadastro de Fornecedores: Na aba Financeiro, está disponível o bloco Dados PIX para definir o Tipo de chave e a Chave Pix do fornecedor.

  • Na Alteração de Pagamentos (SisPag): Ao selecionar a forma de pagamento PIX TRANSFERÊNCIA ou QRCode, o sistema preenche automaticamente os campos Chave PIX e Tipo Chave PIX com as informações cadastradas previamente.

 

Principais Benefícios:

  • Agilidade na geração do Sispag: Os dados do Pix são vinculados automaticamente ao título de pagamento, evitando retrabalho.

  • Redução de Erros Digitados: Menos digitação manual significa menos rejeições do arquivo de pagamento pelo banco.

  • Flexibilidade na Operação: Se necessário, os dados da chave Pix podem ser conferidos ou ajustados diretamente no título de pagamento antes da exportação.

  • Liquidação Garantida: Facilita a transferência direta e rápida para a conta do fornecedor.

 

Como utilizar:

Passo 1: Cadastrar a Chave PIX do Fornecedor
  1. Acesse Cadastros > Cadastros Básicos > Fornecedores e clique em Alterar Registro no fornecedor.
  2. Acesse a aba Financeiro.
  3. No quadro Dados PIX, preencha:
    • Tipo de chave: Selecione o tipo (CPF/CNPJ, E-mail, Telefone ou Chave Aleatória/EVP).
    • Chave Pix: Insira a chave PIX correspondente.
  4. Clique em Salvar no canto superior direito.

 

Passo 2: Instrução do pagamento no Sispag
  1. Acesse Lançamentos > Financeiro > Contas a Pagar > Títulos a Pagar e selecione o título que será enviado via arquivo bancário.

  2. Conforme a sua operação, edite o Histórico do título ou proceda a baixa para incluir as instruções do Sispag.

  3. Selecione o banco Itaú e clique na aba SisPag.

  4. Em Forma de Pagamento, selecione a opção PIX TRANSFERÊNCIA ou PIX QR Code.

  5. Observe que os campos Chave PIX e Tipo Chave PIX serão preenchidos automaticamente com base no cadastro do fornecedor. (Caso necessário, é possível ajustar ou validar as informações diretamente nessa tela antes do envio).

  6. Clique em Salvar no canto superior direito.

Pronto! Ao gerar o arquivo Sispag, a instrução de depósito via Pix será exportada com todas as informações necessárias para liquidação no banco.

Portaria SRE 34/2026: Fim do ICMS-ST para 174 Mercadorias em SP a partir de 01/10/2026

O Governo do Estado de São Paulo deu mais um passo na reestruturação do seu sistema tributário. A publicação da Portaria SRE nº 34/2026 no Diário Oficial oficializou a retirada de 174 mercadorias do regime de Substituição Tributária (ICMS-ST) a partir de 1º de outubro de 2026.

Esta rodada consolida mais uma fase do programa São Paulo na Direção Certa, que já retirou quase dois terços das mercadorias da sistemática de arrecadação concentrada. A medida antecipa a convergência do estado com o modelo de tributação no destino previsto na Reforma Tributária nacional.

Quais setores deixam o ICMS-ST?

A partir de 01/10/2026, a cobrança antecipada do ICMS em operações internas paulistas encerra-se para os seguintes grupos de produtos e posições NCM:

  • Autopeças e Acumuladores: Componentes automotivos em geral e baterias de arranque para motores.
    • NCMs: Posições do Capítulo 87 (peças e acessórios para veículos), posições 8507.10 (acumuladores elétricos de chumbo para arranque de motores de pistão), 4016 (obras de borracha vulcanizada) e 7007 (vidros de segurança para veículos).
  • Pneumáticos e Borracharia: Pneus novos, câmaras de ar e protetores de borracha.
    • NCMs: Posições 4011 (pneumáticos novos de borracha), 4012 (pneumáticos recauchutados/usados e protetores) e 4013 (câmaras de ar de borracha).
  • Tintas, Vernizes e Indústria Química: Tintas, vernizes, solventes e insumos derivados da indústria química.
    • NCMs: Posições do Capítulo 32 (especialmente 3208, 3209, 3210, 3213 e 3214), além de posições 2710.12 e 3814.00 (preparações e solventes orgânicos).
  • Materiais Elétricos e Ferramentas: Materiais para instalações elétricas, ferramentas manuais e equipamentos congêneres.
    • NCMs: Posições do Capítulo 82 (ferramentas manuais, facas e lâminas: 8201 a 8208) e posições do Capítulo 85 (fios, cabos, interruptores, disjuntores e condutores elétricos: 8535, 8536, 8537 e 8544).
  • Eletrodomésticos e Eletrônicos (Linha Branca Selecionada): Equipamentos de refrigeração, lavagem e partes.
    • NCMs: Posições 8418.10, 8418.21, 8418.29, 8418.30 e 8418.40 (refrigeradores, congeladores e freezers), 8422.11 (máquinas de lavar louça do tipo doméstico), 8450.11, 8450.12 e 8450.19 (máquinas de lavar roupa domésticas), além de partes e peças ligadas a esses NCMs.

Atenção: O ICMS-ST não acabou para todos os produtos em SP. Bebidas, cimento, combustíveis, medicamentos, cosméticos e alimentos continuam no regime de ST.

Impacto no Caixa e na Precificação

A transição para o Regime Comum de Tributação (débito e crédito) altera diretamente a gestão financeira das empresas:
  • Alívio no Capital de Giro: O imposto deixa de ser pago antecipadamente na nota de aquisição do fornecedor. O recolhimento passa a ser feito apenas após a venda efetiva da mercadoria, liberando caixa para a operação.
  • Flexibilidade Comercial: Com notas de entrada com valor total menor (sem a soma do ICMS-ST/MVA), o custo de aquisição diminui no primeiro momento. Por outro lado, o faturamento gerará débito próprio de ICMS na saída, exigindo revisão das tabelas de preço para preservar margens.

 

Regras de Transição e Inventário do Estoque Antigo

As mercadorias que foram adquiridas com ICMS-ST retido e continuarem no estoque em 30/09/2026 darão direito ao crédito do imposto pago a mais, seguindo a Portaria CAT nº 28/2020:

  • Levantamento Físico: Realize a contagem do estoque dessas 174 mercadorias no encerramento do dia 30/09.
  • Escrituração Fiscal: Declare o inventário no Bloco H (Motivo 02 – Mudança da Forma de Tributação) do SPED Fiscal.
Recuperação dos Valores:
  • RPA – Regime Periódico de Apuração: Apropriação do crédito em 12 parcelas mensais, iguais e consecutivas a partir da apuração de outubro/2026.
  • Simples Nacional: Abatimento do valor apurado diretamente nas apurações mensais do PGDAS-D.

 

Passo a passo: Como editar o NCM e remover a configuração de MVA (São Paulo)

Preparamos este guia prático para te orientar na remoção das exceções de MVA e na atualização das regras de ICMS no cadastro de NCM.

Vale lembrar que, dependendo da particularidade das suas operações, apenas o ajuste no cadastro do NCM pode não ser suficiente para refletir o lançamento automático correto na tela de Faturamento. Nesses cenários, a ERPFlex conta com uma consultoria especializada para realizar os ajustes finos necessários nas regras fiscais do seu sistema.

Confira abaixo o passo a passo para realizar a alteração:

Etapa 1: Acessar a tela do cadastro do NCM
  1. Acesse menu Cadastros, Configurações Fiscais, selecione a opção NCM.
  2. Localize o NCM e clique em Alterar Registro.
Etapa 2: Remover a Exceção do MVA para o Estado de São Paulo (SP)
  1. Clique na aba MVA por Estado (exceções) / Carga Líquida.
  2. Na tabela que exibe as regras por estado, localize a linha correspondente ao estado SP.
  3. Na linha do estado SP, clique no ícone da Lixeira / Excluir (localizado à esquerda do estado, ao lado do ícone de lápis de edição).

Nota: Ao excluir, a linha ficará riscada, indicando que a exceção do MVA para São Paulo será removida assim que o registro for salvo.

 

Etapa 3: Alterar a Situação Tributária (CST/CSOSN) do ICMS
  1. Clique agora na aba Valores Padrões – Faturamento.

  2. Na sub-aba ICMS, selecione o campo Sit. Trib. ICMS:

    • Altere o CST 10 / 60 / 70 (ou outra Situação Tributária de ST) para 00 – Tributada integralmente ou para a CST correspondente à nova operação da empresa.

    • Se aplicável ao regime da sua empresa (Simples Nacional), ajuste apenas o campo Sit. Trib. Simples para um CSOSN 102 ou 101 – Tributada com/sem perm. crédito ou correspondente à nova operação da empresa.

  3. Após remover a exceção de SP e ajustar a situação tributária do ICMS, clique em Salvar.

Fique atento:

Caso o lançamento de faturamento não mude após essa alteração, vale a pena dar uma olhada nas regras fiscais específicas da sua operação. Fale com nosso time comercial para combinar uma consultoria com nossos analistas e deixar tudo rodando perfeitamente!

Perguntas Frequentes

A NF-e poderá ser rejeitada pela SEFAZ de São Paulo ou gerar pagamentos indevidos por falha no destaque do ICMS próprio exigido pela nova regra.

Não. A Portaria SRE 34/2026 altera as regras internas do estado de São Paulo. Operações interestaduais continuam dependendo de convênios/protocolos e da legislação da unidade federativa de destino.

A comprovação é feita através dos XMLs das últimas notas fiscais de entrada dos produtos, resgatando a base e o valor do ICMS-ST retido pelo fornecedor.

Orçamento Geral: Recálculo do Preço Unitário com base nos Juros do recebimento

Agora ficou muito mais fácil precificar e apresentar propostas comerciais considerando os juros das condições de parcelamento. Lançamos o recurso de recálculo e incorporação automática dos juros diretamente no preço unitário do produto dentro do orçamento geral.

Principais Benefícios

  • Precificação Transparente: Exiba o valor final por unidade considerando exatamente o custo financeiro do produto negociado.
  • Agilidade no Negócio: Esqueça cálculos manuais de acréscimo em propostas parceladas.
  • Flexibilidade Comercial: Alinhe facilmente o preço do item às condições de crédito oferecidas ao cliente.

 

Como Funciona na Prática?

  1. Ative o Parâmetro no Sistema:
    Nos parâmetros gerais de orçamentos, marque a opção “Calcula/soma juros no preço unitário do produto” como Sim.

  2. Defina a Forma de Recebimento:
    No orçamento geral, ao incluir a condição de pagamento com taxa de juros (ex: 0,17% de juros diário), o sistema calcula o acréscimo conforme o prazo total do recebimento.

  3. Preço Unitário Atualizado Automatizado:
    O sistema atualiza o Preço Unitário Comercial do item (ex: ajustando de R$ 100,00 para R$ 105,23, considerando um prazo de 30 dias) para refletir os juros diretamente no valor do produto.

Atenções e Regras de Cálculo:

  • Base de Cálculo Exclusiva: O juro embutido no preço unitário é calculado apenas sobre o valor base do produto (Quantidade x Preço Unitário). Valores agregados ao total da nota — como Frete, Despesas Acessórias, IPI, ICMS ST e FCP ST — não entram na base de cálculo do juro do produto.
  • Comportamento ao Faturar: Ao gerar o faturamento a partir do orçamento, o sistema leva e considera o novo preço unitário recalculado para os itens na nota.
  • Exclusividade do Orçamento Geral: Esta funcionalidade é exclusiva da tela de Orçamento Geral. Na tela de Faturamento, o cálculo de juros permanece sendo destinado ao campo de Despesas Acessórias, sem alterar o preço unitário dos itens.

Novidade na Ordem de Serviço: Vínculo de Produto e Lote/Série

A gestão dos atendimentos de assistência técnica ficou muito mais simples e precisa. Agora, você não precisa mais recorrer a controles no Flexcel para registrar qual item está sob manutenção: lançamos a aba Assistência Técnica na tela de Ordem de Serviço (OS)!

O que mudou na prática?

Aba dedicada “Assistência Técnica” na OS

Ao abrir ou editar uma Ordem de Serviço, você conta com uma nova aba para informar com exatidão o equipamento atendido:

  • Produto e Armazém: Seleção direta do item recebido para manutenção.
  • Lote/Série: Campo dedicado para vincular o número de série ou lote do equipamento.
  • Campos de apoio: Informações de quantidade e observações do atendimento.

Observação: Este registro serve exclusivamente como referência de atendimento e não gera movimentação de estoque física ou fiscal.

Integração total com o Flexprint

Todas as informações cadastradas na aba de assistência técnica estão disponíveis como variáveis no Flexprint (Registro: Produto Assistencia, Registro: Lote/Serie Assistencia, etc.). Assim, você pode personalizar e imprimir comprovantes de entrada ou ordens de bancada completas.

 

Rastreabilidade Aprimorada

Ao consultar o histórico do lote em ERP > Consultas > Produtos > Rastreabilidade, o sistema exibirá automaticamente o vínculo da OS (ex: Vinculado a OS de serviço XXXXX como item de Assistência Técnica), garantindo o histórico completo de reparos do equipamento.

 

Como utilizar?

  1. Acesse a rotina de Ordem de Serviço e crie ou altere um registro.
  2. Acesse a aba Assistência Técnica.
  3. Selecione o Produto em assistência, informe o Lote/Série correspondente e preencha as observações necessárias.
  4. Salve o registro. O item fica vinculado à OS de forma nativa e rastreável!

Novo Recurso: Formação de Preço por Margem de Lucro ou Markup por SKU / Variante

Agora, empresas que utilizam a precificação por Margem de Lucro ou Markup contam com mais flexibilidade e precisão na gestão de preços.

Com a nova funcionalidade, é possível definir critérios e margens de precificação por margem de lucro ou markup específicos por item de variante (SKU).

Atenção: A margem/markup definida no SKU somente será aplicada ao preço de venda caso não haja uma tabela de preço vinculada e definida para a variante.

Como funcionava antes?

Anteriormente, a margem de lucro ou markup era definida exclusivamente no cadastro geral do Produto. O cálculo do preço seguia os critérios globais definidos em Parâmetros > Produtos > Parâmetros Gerais:

  • Formação do Preço de venda do Produto/Serviço: Margem de Lucro ou Markup.
  • Custo a ser considerado: Custo Médio ou Custo Standard.

 

O que mudou?

Por padrão, o sistema continua herdando os parâmetros gerais e a configuração do cadastro pai do produto para suas variantes. No entanto, caso haja necessidade de atribuir custos, margens ou critérios de precificação diferenciados por SKU (ex: uma cor ou tamanho específico com custos de produção ou margens distintas), basta ativar a nova opção no cadastro da variante.

Como Configurar a Formação de Preço no SKU (Manual)

  1. Acesse o menu de Produtos e localize o SKU / Variante desejado.
  2. Na aba Dados Gerais, localize o bloco Formação de Preço no canto inferior direito.
  3. Marque a caixa de seleção: Usar formação de Preço diferenciada no SKU?
  4. Com a opção ativada, os novos campos ficarão disponíveis para edição:
    • Critério de Custo: Escolha entre Custo Médio ou Custo Standard.
    • Tipo de Formação: Selecione Margem de Lucro ou Markup.
    • Valor / %: Insira a porcentagem de margem ou markup desejada.
  5. O sistema calculará automaticamente o Preço Venda Final com base nas regras inseridas (lembrando que esta margem só será aplicada se a variante não possuir tabela de preço definida).
  6. Clique em Salvar.

Importação em Massa via Planilha (Carga / Saldos)

Para otimizar o tempo de cadastramento em bases com grande volume de itens, é possível importar essas regras em massa utilizando a Planilha de Saldos de Produtos.

Na planilha de importação de Saldos, foram disponibilizadas novas colunas dedicadas à Formação de Preço por Margem no SKU:

Nome da Coluna Descrição / Valores Aceitos
Usar formação de Preço diferenciada no SKU (S/N) S = Sim (ativa regra por SKU)

N = Não (herda regra geral)

Custo Formacao M = Custo Médio

S = Custo Standard

Formar Preco Venda L = Margem de Lucro

K = Markup

Margem % Percentual de Margem de Lucro desejado (ex: 30)
Markup % Percentual de Markup desejado (ex: 50)

 

 

 

API v2 do CRM: Mais facilidade para as suas integrações

Conectar o setor comercial às ferramentas certas é o segredo para vender mais e melhor. A API v2 do CRM ERPFlex foi desenvolvida exatamente para isso: permitir que seus formulários de site, automações de marketing, chatbots de atendimento ou painéis de BI conversem diretamente com o ERPFlex sem complicações.

Neste post, você aprenderá desde as configurações básicas de conexão até o detalhamento de cada requisição.

Configurações Gerais de Conectividade

  • Base URL Oficial: https://api.erpflex.com.br/api_v2
  • Formato dos Dados: JSON (envio e resposta)
  • Tipo de Autenticação: HTTP Basic Auth
  • Usuário: Usuário APU cadastrado no ERPFlex.
  • Senha: Senha do usuário APU.
  • Cabeçalho Obrigatório (POST e PUT): Content-Type: application/json

 

Padronização das Respostas da API

Para facilitar o desenvolvimento, a API v2 sempre responde com a mesma estrutura organizada de JSON:

Quando a requisição dá certo (Sucesso):

JSON

{
  “status”: true,
  “message”: “Operação realizada com sucesso.”,
  “total”: 1,
  “data”: [ … ]
}

Quando acontece algum problema (Erro):

JSON

{
  “status”: false,
  “message”: “Descrição amigável do motivo do erro”,
  “total”: 0,
  “data”: []
}

 

Passo a Passo Recomendado para Integrar

Fluxo sugerido para testes:
  1. GET /funil: anotar CRM_FUNNEL_ID
  2. GET /etapas?funnel=ID:  anotar “id” da etapa (UUID para CRM_OP_STEP)
  3. GET /prospects: anotar CRM_EMP_ID
  4. POST /oportunidades: usar funil, prospect e owner
  5. GET /contatos: listar contatos do prospect
Substitua nos exemplos:
  • {FUNNEL_ID} = ID numerico do funil
  • {PROSPECT_ID} = CRM_EMP_ID
  • {OPORTUNIDADE_ID} = CRM_OP_ID
  • {CONTATO_ID} = CRM_EMP_CT_ID
  • {STEP_ID} = UUID da etapa (campo “id” retornado em GET /etapas)
  • {EA2_OWNER} = EA2_ID do responsavel (ex.: 7039 para usuario API)

Endpoints Disponíveis

GET – Listar todos os funis
Metodo: GET
URL: https://api.erpflex.com.br/api_v2/funil
Body: (nenhum)

Exemplo de resposta (sucesso):
{
“status”: true,
“message”: “Funis consultados com sucesso.”,
“total”: 2,
“data”: [
{
“CRM_FUNNEL_ID”: 1,
“CRM_FUNNEL_NAME”: “Vendas”,
“CRM_FUNNEL_IDEA1”: 10
}
]
}

GET – Consultar funil por ID
Metodo: GET
URL: https://api.erpflex.com.br/api_v2/funil/1
Body: (nenhum)

Substitua “1” pelo {FUNNEL_ID} desejado.

GET – Listar etapas por query string
Metodo: GET
URL: https://api.erpflex.com.br/api_v2/etapas?funnel=1
Body: (nenhum)

Parametro obrigatorio:
funnel = ID numerico do funil

GET – Listar etapas por path
Metodo: GET
URL:
https://api.erpflex.com.br/api_v2/etapas/1
Body: (nenhum)

O ID no path é o ID do funil (nao e ID de etapa).

Exemplo de item em “data”:
{
“id”: “a1b2c3d4-e5f6-7890-abcd-ef1234567890”,
“title”: “Qualificacao”,
“order”: 0
}

Use o campo “id” (UUID) no campo CRM_OP_STEP ao mudar etapa da oportunidade.

GET – Listar prospects

Metodo:  GET
URL https://api.erpflex.com.br/api_v2/prospects?limit=50&offset=0

Parametros opcionais:
limit = quantidade por pagina (padrao 50, maximo 500)
offset = deslocamento para paginacao (padrao 0)

GET – Buscar prospect por ID

Metodo: GET
URL https://api.erpflex.com.br/api_v2/prospects/15

POST – Criar prospect

Metodo:  POST
URL https://api.erpflex.com.br/api_v2/prospects
Header Content-Type: application/json

Body (exemplo minimo):
{
“CRM_EMP_RAZAO”: “Empresa Exemplo LTDA”
}

Body (exemplo completo):
{
“CRM_EMP_RAZAO”: “Empresa Exemplo LTDA”,
“CRM_EMP_FANTASIA”: “Exemplo”,
“CRM_EMP_CNPJ”: “12345678000199”,
“CRM_EMP_CEP”: “01310100”,
“CRM_EMP_END”: “Av. Paulista”,
“CRM_EMP_NUM”: “1000”,
“CRM_EMP_COMPL”: “Sala 10”,
“CRM_EMP_BAIRRO”: “Bela Vista”,
“CRM_EMP_MUN”: 3550308,
“CRM_EMP_EST”: 35,
“CRM_EMP_PAIS”: 1,
“CRM_EMP_IDSA1”: null,
“CRM_EMP_RG”: “”
}

Regras:
  • Obrigatorio informar CRM_EMP_RAZAO ou CRM_EMP_FANTASIA (ao menos um nao vazio)

Exemplo de resposta (201):
{
“status”: true,
“message”: “Prospect criado com sucesso.”,
“total”: 1,
“data”: [
{
“CRM_EMP_ID”: 25,
“CRM_EMP_RAZAO”: “Empresa Exemplo LTDA”,
…
}
]
}

PUT – Atualizar prospect

Metodo:  PUT
URL https://api.erpflex.com.br/api_v2/prospects/15
Header Content-Type: application/json

Body (exemplo – envie apenas os campos que deseja alterar):
{
“CRM_EMP_FANTASIA”: “Nome fantasia atualizado”,
“CRM_EMP_CNPJ”: “12345678000199”
}

DELETE – Excluir prospect

Metodo:  DELETE
URL https://api.erpflex.com.br/api_v2/prospects/15
Body (nenhum)

GET – Listar contatos

Metodo:  GET
URL: https://api.erpflex.com.br/api_v2/contatos?limit=50&offset=0

Filtro opcional por prospect:
https://api.erpflex.com.br/api_v2/contatos?limit=50&offset=0&emp=15

Parametro emp = CRM_EMP_ID (prospect dono do contato)

GET – Buscar contato por ID

Metodo:  GET
URL: https://api.erpflex.com.br/api_v2/contatos/8

POST – Criar contato

Metodo:  POST
URL: https://api.erpflex.com.br/api_v2/contatos
Header: Content-Type: application/json

Body (exemplo):
{
“CRM_EMP_CT_EMP”: 15,
“CRM_EMP_CT_NOME”: “Maria Silva”,
“CRM_EMP_CT_EMAIL”: “maria.silva@exemplo.com”,
“CRM_EMP_CT_FONE”: “11999998888”,
“CRM_EMP_CT_CARGO”: “Gerente Comercial”,
“CRM_EMP_CT_PRINCIPAL”: 0
}

Regras:
– CRM_EMP_CT_EMP obrigatorio (ID do prospect existente no mesmo tenant)
– CRM_EMP_CT_NOME ou CRM_EMP_CT_EMAIL obrigatorio (ao menos um)
– CRM_EMP_CT_PRINCIPAL: 0 ou 1 (padrao 0 se omitido)

PUT – Atualizar contato

Metodo:  PUT
URL: https://api.erpflex.com.br/api_v2/contatos/8
Header: Content-Type: application/json

Body (exemplo):
{
“CRM_EMP_CT_CARGO”: “Coordenadora”,
“CRM_EMP_CT_FONE”: “1133334444”
}

DELETE – Excluir contato

Metodo:  DELETE
URL: https://api.erpflex.com.br/api_v2/contatos/8
Body: (nenhum)

GET – Listar oportunidades

Metodo: GET
URL: https://api.erpflex.com.br/api_v2/oportunidades?limit=50&offset=0

Parametros opcionais:
limit = padrao 50, maximo 500

GET – Buscar oportunidade por ID

Metodo: GET
URL: https://api.erpflex.com.br/api_v2/oportunidades/42

Campos úteis na resposta para os PUTs:
CRM_OP_OWNER -> EA2_ID do responsavel
CRM_OP_FUNNEL -> ID do funil
CRM_OP_STEP -> UUID da etapa atual
CRM_OP_STATUS -> 0=aberta, 1=ganha, 2=congelada, 3=perdida, 4=lixeira

POST – Criar oportunidade (prospect existente)

Metodo: POST
URL: https://api.erpflex.com.br/api_v2/oportunidades
Header: Content-Type: application/json

Body (exemplo):
{
“CRM_OP_DESC”: “Oportunidade de venda via API”,
“CRM_OP_FUNNEL”: 1,
“CRM_OP_IDEMP”: 15,
“CRM_OP_OWNER”: 7039,
“CRM_OP_VALOR”: 15000.00,
“CRM_OP_MRR”: 0
}

Campos obrigatorios:
CRM_OP_DESC = descricao da oportunidade
CRM_OP_FUNNEL = ID do funil (> 0)
CRM_OP_IDEMP = CRM_EMP_ID do prospect (ou -1 para prospect novo)
CRM_OP_OWNER = EA2_ID do responsavel (> 0)

POST – Criar oportunidade com prospect novo (CRM_OP_IDEMP = -1)

Metodo: POST
URL: https://api.erpflex.com.br/api_v2/oportunidades
Header: Content-Type: application/json

Body (exemplo):

{
“CRM_OP_DESC”: “NOVA OPORTUNIDADE COM PROSPECT NOVO”,
“CRM_OP_FUNNEL”: 497,
“CRM_OP_STEP”: “89e02f82-9038-49c4-8b51-fbe4ec7ac42a”,
“CRM_OP_IDEMP”: -1,
“CRM_OP_OWNER”: 12966,
“CRM_OP_VALOR”: 8500,
“CRM_OP_MRR”: 0,
“CRM_OP_IDORIGEM”: 0,
“CRM_EMP_RAZAO”: “NOVA EMPRESA LTDA TESTE1”,
“CRM_EMP_FANTASIA”: “FANTASIA TESTE1”,
“CRM_EMP_CNPJ”: “12345678000199”,
“CRM_EMP_CT_NOME”: “Maria Silva”,
“CRM_EMP_CT_EMAIL”: “maria@exemplo.com”,
“CRM_EMP_CT_FONE”: “11999999999”,
“CRM_EMP_CT_CARGO”: “Compras”
}

Regra adicional:
– Com CRM_OP_IDEMP = -1, CRM_EMP_RAZAO e obrigatoria

PUT – Mudar apenas a etapa da oportunidade

Metodo: PUT
URL: https://api.erpflex.com.br/api_v2/oportunidades/42
Header: Content-Type: application/json

Body (exemplo – envie SOMENTE estes dois campos para troca de etapa):
{
“CRM_OP_OWNER”: 7039,
“CRM_OP_STEP”: “a1b2c3d4-e5f6-7890-abcd-ef1234567890”
}

Condicoes:
– Oportunidade deve estar aberta (CRM_OP_STATUS = 0)
– CRM_OP_STEP deve ser o UUID retornado em GET /etapas
– CRM_OP_STEP deve ser diferente da etapa atual

PUT – Atualizacao completa da oportunidade

Metodo: PUT
URL: https://api.erpflex.com.br/api_v2/oportunidades/42
Header: Content-Type: application/json

Body (exemplo):
{
“CRM_OP_OWNER”: 7039,
“CRM_OP_DESC”: “Descricao atualizada via API”,
“CRM_OP_FUNNEL”: 1,
“CRM_OP_VALOR”: 20000,
“CRM_OP_MRR”: 500,
“CRM_OP_IDORIGEM”: 0
}

CRM_OP_OWNER e sempre obrigatorio no PUT.

PUT – Marcar oportunidade como ganha

Metodo: PUT
URL: https://api.erpflex.com.br/api_v2/oportunidades/42
Header: Content-Type: application/json

Body (exemplo):
{
“CRM_OP_OWNER”: 7039,
“CRM_OP_STATUS”: 1
}

Valores de CRM_OP_STATUS:
0 = aberta
1 = ganha
2 = congelada
3 = perdida
4 = lixeira

Para status perdida (3), pode incluir:
“CRM_LOST_REASON_DESC”: “Preco”,
“CRM_LOST_OBS”: “Cliente escolheu concorrente”

Para status congelada (2), pode incluir:
“CRM_FREEZE_OBS”: “Aguardando retorno do cliente”,
“CRM_FREEZE_UNTIL”: “2026-08-01”

Resolução Rápida de Erros Frequentes

Código Mensagem de Erro Motivo / Solução
401 User not found Usuário ou senha APU incorretos ou não cadastrados.
400 Content Type invalido Esqueceu de adicionar o header Content-Type: application/json.
400 Parametro “funnel” obrigatorio A rota GET /etapas precisa do parâmetro ?funnel=ID.
404 Recurso não encontrado O ID informado não existe na sua conta ou tenant.
500 Internal Server Error Regra de negócio violada. Leia o campo message da resposta para identificar a causa.

Compras – novo parâmetro para baixar vários pedidos de compras para um mesmo item do XML

Desenvolvido recurso para otimizar o controle de recebimento de materiais e insumos no ERPFlex. A partir de agora, é possível vincular e realizar a baixa parcial/total de múltiplos pedidos de compras para um único item recebido na importação do arquivo XML da Nota Fiscal Eletrônica.

Para isso, criamos o novo parâmetro Agrupa mesmo item de pedido de compras em importação de XML? (Parâmetros > Compras > Compras-Padrões) (padrão Não).

  • Opção “NÃO” — Comportamento Legado (Padrão):
    Na importação do XML, mesmo que existam múltiplos pedidos de compra para um mesmo item recebido, será permitido selecionar apenas um único pedido para cada item. A quantidade total recebida do produto será baixada integralmente sobre o pedido selecionado. Caso a quantidade do XML seja superior à do pedido, a diferença ficará registrada com divergência.
  • Opção “SIM” — Novo Comportamento (Agrupamento Permitido)
    Permite selecionar vários pedidos de compra para um mesmo item do XML e especificar manualmente a quantidade exata a ser baixada de cada pedido. A única regra necessária é que a soma das quantidades distribuídas seja igual à quantidade total informada no XML.

 

Passo a passo da baixa de vários pedidos de compras:

  • Após configurar o parâmetro com Sim, acesse a tela de Compras.
  • Realize a importação do XML da NF-e normalmente.
  • Na janela de associação de Pedidos de Compras, selecione os pedidos desejados para o item correspondente.
  • Ajuste a coluna “Quantidade a baixar” para cada pedido recebido até totalizar a quantidade do XML.

 

  • Confirme o recebimento e salve a compra.
    As atualizações de saldo e divergências serão refletidas imediatamente na tela de Pedidos de Compras.

 

Exemplo Prático de Recebimento com Divergências

Estágio 1: Pedidos de Compra em Aberto

Considerando a emissão de 3 Pedidos de Compras para o fornecedor  (Industria…) para o produto MP003 – Banco antes de qualquer recebimento de XML:

Estágio 2: Importação do XML com a baixa dos pedidos de compras

No momento da importação de uma NF-e contendo 1.000 unidades do item MP003 (Preço Unitário no XML: R$ 2,40), a janela de associação permite distribuir as 1.000 unidades entre os pedidos em aberto:

Regra de Validação: A soma da coluna “Quantidade a baixar” (24 + 28 + 948 = 1.000) obrigatoriamente deve bater com a quantidade total do item no XML.

Impacto nos Saldos e Divergências

Após a gravação da compra, a tela de Pedidos de Compra registra a baixa física (quantidade) e financeira (calculada com base no preço praticado no XML: R$ 2,40/unidade).

 

Como Interpretar os Tipos de Divergências

A. Divergência de Valor (Preço Unitário Divergente):

Ocorre quando a quantidade do pedido é integralmente atendida, mas o preço unitário da nota fiscal (XML) foi inferior ou superior ao preço negociado no pedido.

  • Nos pedidos 0000000003 e 0000000004: Pedidos tinham preço unitário de R$ 100,00, mas a nota veio a R$ 2,40/unid. A quantidade zerou (Qtd Saldo = 0), porém restou um saldo financeiro credor no pedido (R$ 2.342,40 e R$ 2.732,80).

 

B. Divergência de Quantidade (Excesso de Recebimento):

Ocorre quando a quantidade baixada no pedido é maior do que a quantidade originalmente pedida.

  • No pedido 0000000005: Haviam 24 unidades pedidas, mas foram baixadas 948 unidades para absorver o lote do XML. O saldo de quantidade ficou negativo (Qtd Saldo = -924,000), caracterizando recebimento em excesso.

 

C. Divergência Combinada (Quantidade e Valor):

Quando o pedido recebe quantidade em excesso e o valor total acumulado da baixa ultrapassa o valor original do pedido.

  •  No pedido 0000000005: O valor baixado (R$ 2.275,20) superou o valor negociado (R$ 57,60), resultando num saldo financeiro negativo (Valor Saldo = -R$ 2.217,60).

Reforma Tributária: Eventos, Nota de Débito de Multa e Juros, Notas de Crédito (Redução e Recusa)

Para garantir que a sua empresa permaneça em total conformidade com as exigências da Reforma Tributária, o ERPFlex disponibilizou um novo conjunto de recursos.

  • Nota de Débito de 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, com o objetivo de complementar a base de cálculo do IBS e CBS.
    Conheça o passo a passo: Nota de Débito de Multa e Juros
  • Notas de Crédito: finalidade reduzir o débito de IBS e CBS na apuração do contribuinte emitente e, quando aplicável, gerar o correspondente lançamento a crédito
    na apuração do contribuinte destinatário.
    Conheça o passo a passo: Notas de Crédito de Redução de Valores, Recusa Parcial e Recusa Total
  • Novos eventos fiscais: registram 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.
    Conheça o passo a passo: Eventos de IBS e CBS

 

Fontes:

Cartilha IBS – Comitê Gestor

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