Caminho da Funcionalidade no Sistema:

  • Compras > Conta Comercial do Fornecedor > Gestão da Apuração da Performance

Permissões:

  • 5 – Acordo Comercial Consultar
  • 4326 – Excluir apuração de performance do fornecedor
  • 4366 – Editar apuração da performance do fornecedor

Esta funcionalidade permite administrar o contrato de fornecimento e avaliar a rentabilidade das entradas e saídas dos produtos do fornecedor de forma eficiente.

Dessa forma é possível avaliar o crescimento das compras deduzindo as devoluções realizadas para o fornecedor, comparando um período de referência com um período realizado.

Com isso é obtido um retorno dos valores das compras para gerar um acordo comercial ou financeiro para o fornecedor.

Performance do Fornecedor no Contrato de Fornecimento

Para que a apuração de performance funcione corretamente, é necessário configurar as regras de negócio diretamente no módulo Condições Comerciais do Contrato de Fornecimento. Esta etapa define como o sistema calculará o crescimento do fornecedor e qual será o retorno esperado. Sendo possível cadastrar múltiplas configurações de performance para um contrato específico do fornecedor.

1. Consulta de Performances

Ao acessar a tela teremos os seguintes filtros para busca de performances que já foram cadastradas:

  • Fornecedor/Divisão: Filtro de seleção da divisão do fornecedor para listagem dos contratos disponíveis no filtro Nº do Contrato. Campo de preenchimento obrigatório.
  • Nº do Contrato: Filtro de seleção de um contrato específico da divisão do fornecedor selecionado no filtro Fornecedor/Divisão. Serão listados apenas contratos ativos e com performance cadastrada.
  • Vigência: Filtro de seleção para exibir apenas contratos vigentes, não vigentes ou todos.
  • Período de Vigência: Filtro de seleção do período de vigência desejado. Retorna performances que tem a vigência dentro do período selecionado.
  • Nº da Performance: Filtro de digitação do número de uma performance específica. Ao preencher esse filtro, os outros serão ignorados.

2. Parâmetros Gerais

Ao clicar em + Adicionar condição comercial serão exibidos os campos que definem a estrutura base da configuração:

  • Fornecedor/Divisão: Seleção da divisão do fornecedor para listagem dos contratos disponíveis no filtro Nº do Contrato.
  • Nº do Contrato: Campo para seleção de um contrato específico da divisão do fornecedor selecionado no filtro Fornecedor/Divisão. Serão listados apenas contratos vigentes e ativos. Campo de preenchimento obrigatório.
  • Base de Cálculo: Selecione qual valor será considerado na apuração (ex: Valor total da nota fiscal, Valor total das mercadorias, Valor total da nota – ST, etc.). Campo de preenchimento obrigatório.
  • Data de Lançamento: Define a data da nota fiscal que será utilizada como referência (Emissão, Recebimento ou Confirmação). Campo de preenchimento obrigatório.
  • Performance: Selecione o tipo de operação (ex: Compras). Campo de preenchimento obrigatório.
  • Periodicidade: Define o intervalo padrão da apuração (Eventual, Mensal, Trimestral, Quadrimestral, Semestral ou Anual). Campo de preenchimento obrigatório.
  • Data Vigência Inicial: Campo para preencher a data inicial da vigência da performance. Campo de preenchimento obrigatório.
  • Data Vigência Final: Campo para preencher a data final da vigência da performance. Campo de preenchimento obrigatório.
  • Lojas Participantes: Selecione as lojas que farão parte deste contrato de performance. Campo de preenchimento obrigatório.

3. Definição de Crescimento e Retorno

Neste bloco, você configura as faixas e retornos.

  • Crescimento por: Escolha a métrica para medir o desempenho do fornecedor:
    • Percentual: Mede o crescimento relativo (%) entre o período base e o realizado (Segue o valor exibido na coluna “Crescimento” da apuração para obter a faixa).
    • Valor: Mede o crescimento em valores absolutos (R$). (Segue o valor exibido na coluna “Variação” da apuração para obter a faixa)
    • Quantidade: Mede o crescimento em volume de itens/unidades. (Segue o valor exibido na coluna “Variação” da apuração para obter a faixa)
    • Peso Bruto: Mede o crescimento em peso (Kg) de acordo com o peso bruto unitário do cadastro do produto. (Segue o valor exibido na coluna “Variação” da apuração para obter a faixa)
    • Peso Líquido: Mede o crescimento em peso (Kg) de acordo com o peso líquido unitário do cadastro do produto. (Segue o valor exibido na coluna “Variação” da apuração para obter a faixa)
  • Retorno por: Define como o valor a pagar será calculado:
    • Percentual: O sistema aplica uma alíquota (%) sobre o valor realizado.
    • Valor Fixo: O sistema paga um valor monetário fixo (R$) ao atingir a meta.
    • Use o botão lápis para definir porcentagens de retorno por subdivisão.

4. Faixas de Performance

Configure as faixas de atingimento de meta. Para cada nível de crescimento alcançado, você pode definir um retorno diferente.

  • Mínimo e Máximo: Defina o intervalo de crescimento para esta faixa.
  • Retorno: Informe o percentual ou valor que será pago se o crescimento ficar dentro deste intervalo.
  • Botões de Ação:
    • Use o botão + Adicionar para adicionar novas faixas de crescimento.
    • Use o botão ícone de lixeira para remover faixas existentes.

Ao clicar no ícone de lápis é possível verificar as subdivisões cadastradas do fornecedor e aplicar o retorno desejado:

Para saber mais sobre as Condições Comerciais do Contrato de Fornecimento, clique aqui.

Busca das Apurações

Ao acessar a funcionalidade, você será direcionado para a tela de Gestão da Apuração da Performance. Aqui é possível consultar o histórico de apurações, verificar o status de processamento e visualizar os resultados.

Para facilitar a localização das apurações, utilize os filtros disponíveis:

  • Nº da Apuração: Permite buscar pelo número identificador único da apuração.
  • Fornecedor/Divisão: Filtra as apurações de um fornecedor específico.
  • Contrato de Fornecimento: Exibe os contratos que possuem configuração de performance para o fornecedor selecionado.
  • Loja: Permite selecionar uma ou múltiplas lojas. A opção padrão é “Todas” as lojas que o usuário possui acesso. Se ao menos uma das lojas selecionadas participar de uma apuração, essa apuração será retornada no resultado da busca.
  • Subdivisão: Filtra apurações que foram geradas para uma subdivisão específica.
  • Período de Criação(*): Define o intervalo de datas para busca de performances cadastradas no período.
  • Status da Apuração: Filtra pelo estado atual do processamento (ex: Em processamento, Concluída, Falha, Finalizada, Estornada).

Após clicar em Buscar, o sistema exibirá as apurações encontradas. O resultado da busca apresenta informações consolidadas, mas permite detalhamento através da expansão da linha.

As colunas disponíveis são:

  • Checkbox: Habilitado apenas para apurações com status “Concluída” e valor a pagar maior que zero, permitindo a geração de acordos.
  • Fornecedor/Divisão e Contrato: Identificação do parceiro e do contrato utilizado.
  • Nº da Apuração: Exibe o número da apuração incluída.
  • Contrato: Exibe o número do contrato da apuração exibida no resultado da busca.
  • Performance: Exibe o número da performance utilizada na inclusão da apuração.
  • Loja: Exibe as lojas participantes. Caso sejam múltiplas lojas, o sistema exibirá de forma resumida (ex: “101, 201…”).
  • Subdivisão: Exibe a subdivisão, caso a apuração tenha sido restrita a uma.
  • Períodos: Datas de referência e do período realizado.
  • Valores (Base, Realizado, A Pagar): Exibe os totais financeiros calculados consolidados.
  • Indicadores (Variação, Crescimento, % Retorno): Exibe os percentuais e diferenças calculadas.
  • Nº Acordo: Exibe o(s) número(s) do(s) acordo(s) gerado(s). Se houver múltiplos, exibe um link para visualização.
  • Status: Indica a etapa atual (Em processamento, Concluída, Falha, Finalizada, Estornada).
  • Ações: Permite visualizar ocorrências (logs de histórico), excluir e reprocessar a apuração (mediante permissão e status).

Ao clicar no ícone de expansão (+) na linha de uma apuração, o sistema expandirá a visão, detalhando os valores (Base, Realizado, A Pagar) individualmente por loja participante daquela apuração.

Incluindo uma Nova Apuração

Para iniciar um novo cálculo, clique no botão + Apuração de performance. Uma janela será aberta para a definição dos parâmetros.

Campos para preenchimento:

  • Fornecedor/Divisão (*): Selecione o fornecedor desejado.
  • Contrato de Fornecimento (*): Selecione o contrato ativo que possui as regras de performance configuradas. Este campo é carregado com base no fornecedor selecionado e são exibidos apenas contratos que possuem a configuração.
  • Performance (*): Selecione a performance desejada que foi cadastrada previamente no módulo Condições Comerciais do Contrato de Fornecimento.
  • Loja (*): O sistema pré-seleciona todas as lojas configuradas no contrato. Você pode remover ou adicionar lojas individualmente.
  • Subdivisão: (Opcional) Restringe a apuração a uma subdivisão específica do fornecedor.
  • Produto: (Opcional) Restringe a apuração a um produto específico. Se uma Subdivisão for selecionada no campo anterior, a busca de produtos retornará apenas itens pertencentes àquela subdivisão específica.
  • Exibir apenas compras deste contrato?: (Checkbox) Marcado por padrão. Se desmarcado, o cálculo considerará todas as compras do fornecedor, independente do contrato vinculado na nota.
  • Periodicidade: (Informativo) Campo apenas para leitura. Exibe a periodicidade definida no contrato (ex: Mensal, Trimestral, Eventual) para orientar o preenchimento das datas.
  • Tipo de Data: (Informativo) Campo apenas para leitura. Exibe qual data da nota fiscal será considerada no cálculo (ex: Data de Emissão, Data de Recebimento, Data de Confirmação).
  • Período de Referência (*): Defina a data inicial e final do período base para comparação. O sistema validará se o intervalo selecionado corresponde à periodicidade do contrato (ex: se é Mensal, deve-se selecionar um mês completo).
  • Período Realizado (*): Defina a data inicial e final do período que será apurado. O sistema validará se o intervalo selecionado corresponde à periodicidade do contrato (ex: se é Mensal, deve-se selecionar um mês completo).

Caso possua alguma apuração já criada que utiliza a mesma combinação de Loja, Fornecedor, Performance, Subdivisão e Período o usuário será impedido de prosseguir com a inclusão:

Observação: Caso o usuário inicie a apuração de um período selecionando uma subdivisão específica, e depois realize uma nova apuração para a mesma combinação (Loja, Fornecedor, Performance e Período) deixando o campo de subdivisão em branco, o sistema exibirá a mesma mensagem de validação. Isso ocorre porque o sistema considera todas as subdivisões quando nada é selecionado, ou seja, considera também a subdivisão apurada anteriormente. Para prosseguir sem bloqueios, o usuário deverá selecionar as demais subdivisões desejadas para completar a apuração do período.

Após clicar em Adicionar o processo será executado em segundo plano e quando estiver concluída a apuração o usuário receberá uma notificação via Central de Notificações:

Usuários com e-mail comercial cadastrados receberão um e-mail com a mesma mensagem de confirmação da finalização da apuração.

Observação importante: O consumo das notas é a nível de produto, ou seja é possível realizar as apurações abrangendo tudo, subdivisão por subdivisão ou produto a produto.

Regras de Cálculo e Faixas de Retorno

O sistema realiza o confronto entre o Valor Base (período de referência) e o Valor Realizado (período atual) para determinar o Crescimento e, consequentemente, o % de Retorno a ser pago pelo fornecedor, conforme as faixas cadastradas no contrato.

Existem regras específicas para cenários atípicos de crescimento:

1. Base Zerada com Realizado Positivo:

Se o Crescimento for por Percentual e no Período de Referência for R$ 0,00 e houver valor no Período Realizado (o que matematicamente geraria um crescimento infinito), o sistema aplicará a maior faixa de retorno configurada no contrato.

  • Exemplo: Base R$ 0,00 | Realizado R$ 150.000,00 | Retorno Aplicado: 20% (Maior faixa do contrato), a coluna Crescimento exibirá o valor contido no campo Máximo da última faixa.
  • Se o Crescimento for por Valor, Quantidade, Peso Bruto ou Peso Líquido, também será aplicado o retorno da maior faixa, porém na coluna Crescimento será exibido um hífen (-).

2. Crescimento superior a maior faixa:

Se o Crescimento for por percentual e o calculado ultrapassar a maior faixa cadastrada (limite de crescimento em percentual para o cadastro é 1000%), o sistema aplicará a maior faixa de retorno configurada no contrato.

  • Exemplo: Base R$ 10,00 | Realizado R$ 150.000,00 | Crescimento: >1000% | Retorno Aplicado: 20% (Maior faixa do contrato), a coluna Crescimento exibirá o valor contido no campo Máximo da última faixa.
  • Se o Crescimento for por Valor, Quantidade, Peso Bruto ou Peso Líquido, também será aplicado o retorno da maior faixa, porém na coluna Crescimento será exibido o próprio crescimento em porcentagem (mesmo que ultrapasse 1000%).

Geração de Acordos (Financeiro ou Comercial)

Quando uma apuração estiver com status Concluída e possuir um Valor a Pagar maior que zero, ela estará elegível para gerar um acordo e efetivar a cobrança.

  1. Selecione a apuração na grid através do checkbox na primeira coluna.
  2. Clique no botão Prosseguir com geração do acordo (rodapé da página)
  3. Selecione o tipo desejado no modal: Acordo Financeiro ou Acordo Comercial.

Detalhamento e Agrupamento:

Ao prosseguir com a geração, preencha as informações padrões de inclusão de acordo comercial/financeiro:

  • Gerar Acordo Agrupado: Se o parâmetro “Permitir gerar acordo comercial/financeiro de forma agrupada” estiver ativo nas configurações de compras, você poderá optar por:
    • Sim: Gera um único número de acordo consolidando todas as lojas da apuração.
    • Não: Gera um acordo individual para cada loja participante da apuração.

Após preencher os dados do acordo e prosseguir com o lançamento do acordo, o sistema exibirá os valores detalhados por loja na seção de valore:

Após a geração do acordo será possível realizar a impressão, enviar por e-mail ou incluir um outro acordo:

O status da apuração mudará para Finalizada e o(s) número(s) do(s) acordo(s) gerado(s) será(ão) exibido(s) na grid:

Será possível visualizar os logs de auditoria clicando no ícone Ocorrências da coluna Ações:

Caso haja falha na geração do acordo a apuração poderá ser reprocessada através do ícone Reprocessar na coluna Ações.

Estorno da Apuração

Para realizar o estorno da apuração, acesse os acordos gerados através da coluna Nº Acordo do resultado da busca:

Realizar apuração automática de acordos comerciais originados do contrato de fornecimento

Será aberta a janela da Consulta de Acordos Comerciais com o acordo de Tipo de Lançamento de APURAÇÃO PERFORMANCE DO FORNECEDOR gerado pela apuração exibido no resultado da busca. Faça o estorno de todos os acordos:

Após o estorno de todos os acordos o status da apuração será alterado para Estornada:

Com a apuração estornada o gestor poderá realizar uma nova apuração nos respectivos períodos (Referência e Realizado) em que a apuração anterior estava realizada.

Observações Importantes:

Os acordos gerados a partir da apuração da performance do fornecedor não serão exibidos no menu de Apuração de Lançamento na Conta Comercial.
Não será possível incluir um acordo comercial ou acordo financeiro com o Tipo de Lançamento “APURAÇÃO PERFORMANCE DO FORNECEDOR” através dos menus específicos para inclusão de acordo.
Os valores de notas fiscais utilizadas em geração de acordos através da performance do fornecedor não serão mais exibidas no resultado da busca da apuração da performance do fornecedor nos períodos selecionados, mesmo que tenham sido gerados a partir da seleção de um só produto ou subdivisão, a menos que os acordos gerados sejam estornados.

Visão Analítica e Edição das Notas Participantes da Apuração

Detalhamento dos Valores

Na grid principal de resultados da apuração, os valores das colunas Base e Realizado são links clicáveis (exibidos na cor azul).

Ao clicar sobre um desses valores, o sistema abrirá a janela Notas Fiscais da Apuração, listando todos os documentos que foram considerados para chegar ao montante exibido.

Ao clicar na coluna Base, será exibido o período de referência e o número do contrato de fornecimento da apuração:

No cabeçalho para a coluna Realizado, será exibido o período de realizado e o número do contrato de fornecimento da apuração:

Os dois links terão as seguintes informações:

  • Data: Exibe a data da nota fiscal. Esta data corresponde à data de emissão, recebimento ou confirmação, dependendo da configuração definida na performance do contrato.
  • Loja: Indica a loja de origem onde a operação foi realizada.
  • Fornecedor/Divisão: Apresenta a descrição do fornecedor e sua divisão correspondente.
  • Tipo de Operação: Identifica se o lançamento se refere a uma Compra ou a uma Devolução.
  • Status da Nota Fiscal: Informa se a nota está “Não Cancelada” ou “Cancelada”. Embora o sistema apure apenas notas não canceladas, esta coluna permite rastrear cancelamentos que tenham ocorrido após a geração do acordo.
  • Nº da Nota Fiscal: Exibe o número da nota fiscal. Este campo funciona como um link; ao clicar nele, o usuário é redirecionado para a tela de detalhes da respectiva nota.
  • Valor NF: Mostra o valor total da nota fiscal e possui um totalizador ao final da coluna.
  • Base de Cálculo: Apresenta o valor efetivamente utilizado para o cálculo da performance, respeitando a regra configurada no contrato de fornecimento. Nota: As devoluções são exibidas nesta coluna subtraindo o valor (valores negativos) e a coluna também conta com um totalizador.

Edição da Apuração (Exclusão de Notas)

Caso identifique alguma divergência ou necessidade de ajuste, usuários com a permissão “Editar apuração da performance do fornecedor (4366)” podem excluir notas fiscais do cálculo, desde que a apuração esteja com status Concluída.

Para realizar a exclusão selecione as notas desejadas através do checkbox na primeira coluna (é possível selecionar todas de uma vez) e clique no botão Excluir lançamentos selecionados, a nota será movida para a aba Notas Fiscais Excluídas:

Ao confirmar a exclusão, o sistema irá recalcular imediatamente os valores da grid principal (Valor Base, Realizado, Crescimento e Valor a Pagar) subtraindo os montantes das notas removidas.

Essa alteração gera um registro automático no histórico de ocorrências da apuração:

Recuperação de Notas Excluídas

Notas fiscais removidas não são apagadas definitivamente da apuração, apenas desconsideradas do cálculo atual. Conforme dito anteriormente elas ficam armazenadas na aba Notas Fiscais Excluídas dentro do mesmo modal:

Nesta aba, é possível visualizar as notas removidas (nesta visão, a coluna ‘Base de Cálculo’ não é exibida).

Caso seja necessário reverter a exclusão acesse a aba Notas Fiscais Excluídas, selecione as notas que deseja reintegrar e clique no botão Adicionar lançamentos selecionados.

O sistema fará o recálculo automático somando os valores novamente à apuração e atualizará a grid principal:

Essa alteração gera um registro automático no histórico de ocorrências da apuração:

Também é possível exportar os dados em arquivo .xlsx e .pdf através do ícone Exportar na grid da aba:

Regras Importantes

  • A visualização está disponível para apurações em todos os status. A edição é restrita ao status Concluída.
  • Valor a Pagar Zerado: Se após a edição (exclusão de notas) o Valor a Pagar resultar em zero ou valor negativo, a apuração não poderá ser utilizada para gerar acordos. O checkbox de seleção na grid principal ficará desabilitado e será exibida a mensagem: “A apuração não cumpre os requisitos necessários, pois não possui o valor a pagar maior que zero ou não está com status concluído” ao passar o mouse sob a linha principal da apuração:

Apuração Automática da Performance do Fornecedor

Além do processo manual, a gestão apuração também pode ser realizada de forma automática. Para isso, basta ativar o parâmetro Habilitar Apuração Automática de Performance no Parâmetros do Módulo Compras e definir as regras de negócio diretamente no módulo Condições Comerciais do Contrato de Fornecimento. Esta etapa determina como o sistema calculará o crescimento do fornecedor e qual será o retorno esperado, permitindo o cadastro de múltiplas configurações de performance para um mesmo contrato.

Assim que o parâmetro for habilitado, as condições foram cadastradas e as notas de recebimento de mercadorias forem recebidas, é processado o job que força a apuração automática todos os dias as 05:00 horas da manhã.

Performance Elegível para Apuração (Regra de Negócio)

Esta regra verifica se uma performance está elegível para a apuração automática em uma data de referência. Para que a apuração aconteça, as 3 condições abaixo precisam ser verdadeiras ao mesmo mesmo tempo:

Condição 1 — Flag habilitada

A flag Utiliza apuração automática deve estar habilitada no cadastro da performance.

Condição 2 — O dia de corte foi atingido

O dia atual deve ser igual ou maior ao dia de corte configurado.

Exemplo: Se o dia de corte = 20 e hoje é dia 15
Resultado: Não apura.

Condição 3 — O período de realizado está dentro da vigência

O sistema calcula o período de realizado (retroativo) com base no que foi cadastrado no campo Periodicidade do cadastro da performance e valida se ele está 100% dentro do período de vigência do contrato.

Exemplo:
Mensal – 1 mês anterior completo
Trimestral – 3 meses anteriores completos
Quadrimestral – 4 meses anteriores completos
Semestral – 6 meses anteriores completos
Anual – 12 meses anteriores completos
Eventual – Nunca apura automaticamente

Se o período calculado cair qualquer dia fora da vigência não ocorrerá apuração da performance cadastrada.

Condição 4 — O período calculado deve contemplar um ciclo completo da periodicidade

O início do período de realizado deve coincidir exatamente com o início de um ciclo contado a partir do começo da vigência. Isso evita que ocorram apurações no meio de um ciclo.

Exemplo Válido
Configuração da Performance
Periodicidade: Trimestral
Data de Vigência Inicial: 01/02/2026. 
Dia de corte: 01/05/2026

O período realizado calculado seria fev–abr. Como a distância entre o início do período (fevereiro) e o início da vigência (fevereiro) é de 0 meses (múltiplo de 3) -> Ciclo válido.

Exemplo Inválido
Configuração da Performance
Periodicidade: Trimestral
Data de Vigência Inicial: 01/02/2026. 
Dia de corte: 01/06/2026.

Em junho/2026, o período seria mar–mai. A distância de março para o início da vigência (fevereiro) é de 1 mês (não é divisível por 3) com isso não seria realizada a apuração da performance.

Criação da Apuração 

Se a performance for elegível, o sistema monta os dados da apuração automática calculando dois períodos distintos. Entenda abaixo como cada um funciona.

Período de Realizado

É o primeiro a ser calculado, usando o dia de hoje e o dia de corte. Representa o período onde as compras efetivamente aconteceram (o que o fornecedor vendeu para a empresa neste ciclo).

Período de Referência

É a base de comparação (o passado) contra qual o crescimento do período de realizado será medido. Ele é calculado a partir do início do período de realizado, retroagindo mais um ciclo.

Tipo de Período de Referência: Período Anterior

Exemplo 1
Configuração da Performance
Periodicidade – Mensal.
Data Vigência Inicial: 01/01/2026 (O período bate com um ciclo completo da periodicidade para calcular o período realizado, ou seja, a partir da data inicial é possível identificar os ciclos completos de 1 mês até a data atual).
Data de Vigência Final: 31/12/2026.
Tipo de Período de Referência – Período Anterior (compara o período atual com o ciclo imediatamente anterior).
Data atual – 20/05/2026 e o dia de corte no parâmetro Habilitar Apuração Automática de Performance é 20.

Períodos que serão acatados:
Período de Referência: 01/03/2026 a 31/03/2026 (1 mês para trás a partir do início do período realizado pois a periodicidade é mensal).
Período Realizado: 01/04/2026 a 30/04/2026 (não contamos os dias de maio pois o dia de corte é dia 20 e não contempla um mês completo).

Exemplo 2
Configuração da Performance
Periodicidade – Quadrimestral.
Data Vigência Inicial: 01/01/2026 (O período bate com um ciclo completo da periodicidade para calcular o período realizado, ou seja, a partir da data inicial é possível identificar os ciclos completos de 4 meses até a data atual).
Data de Vigência Final: 31/12/2026 .
Tipo de Período de Referência – Período Anterior (compara o período atual com o ciclo imediatamente anterior).
Data atual – 20/05/2026 e o dia de corte no parâmetro Habilitar Apuração Automática de Performance é 20.

Períodos que serão acatados:
Período de Referência: 01/09/2025 a 31/12/2025(4 meses para trás a partir do início do período realizado pois a periodicidade é mensal).
Período Realizado: 01/01/2026 a 30/04/2026.(não contamos os dias de maio pois o dia de corte é dia 20 e não contempla um mês completo).

Tipo de Período de Referência: Período Ano Anterior

Exemplo 1
Configuração da Performance
Periodicidade – Mensal.
Data Vigência Inicial: 01/01/2026 (O período bate com um ciclo completo da periodicidade para calcular o período realizado, ou seja, a partir da data inicial é possível identificar os ciclos completos de 1 mês até a data atual).
Data de Vigência Final: 31/12/2026.
Tipo de Período de Referência – Período Ano Anterior (compara o período atual com o mesmo ciclo do ano anterior).
Data atual – 20/05/2026 e o dia de corte no parâmetro Habilitar Apuração Automática de Performance é 20.

Períodos que serão acatados:
Período de Referência: 01/04/2025 a 30/04/2025 (mesmo ciclo do ano anterior em comparação com o período realizado).
Período Realizado: 01/04/2026 a 30/04/2026 (não contamos os dias de maio pois o dia de corte é dia 20 e não contempla um mês completo).

Exemplo 2
Configuração da Performance
Periodicidade – Quadrimestral.
Data Vigência Inicial: 01/01/2026 (O período bate com um ciclo completo da periodicidade para calcular o período realizado, ou seja, a partir da data inicial é possível identificar os ciclos completos de 4 meses até a data atual).
Data de Vigência Final: 31/12/2026.
Tipo de Período de Referência – Período Ano Anterior (compara o período atual com o mesmo ciclo do ano anterior).
Data atual – 20/05/2026 e o dia de corte no parâmetro Habilitar Apuração Automática de Performance é 20.

Períodos que serão acatados:
Período de Referência: 01/01/2025 a 30/04/2025 (mesmo ciclo do ano anterior em comparação com o período realizado).
Período Realizado: 01/01/2026 a 30/04/2026 (não contamos os dias de maio pois o dia de corte é dia 20 e não contempla um mês completo).

Geração Automática de Acordos da Performance do Fornecedor

Esta nova funcionalidade permite parametrizar o sistema para processar e gerar automaticamente os acordos (comerciais ou financeiros) baseados na apuração de performance dos fornecedores. O principal objetivo é otimizar o tempo operacional da equipe, evitar falhas humanas na digitação e garantir que as cobranças e ressarcimentos sejam registrados corretamente de forma automatizada na conta comercial.

Pré-requisitos para a Geração Automática

Para que a rotina automática (Job) execute a geração dos acordos corretamente, as seguintes condições devem ser atendidas:

  • Parâmetro “Realizar apuração automática de acordos comerciais originados do contrato de fornecimento” deve estar habilitado.
  • Devem existir contratos de fornecimento previamente cadastrados com regras de performance ativas e vigentes.
  • As apurações de performance devem estar calculadas e geradas automaticamente pelo sistema através do parâmetro “Habilitar Apuração Automática de Performance”
  • É obrigatório que as apurações de performance estejam com o status ‘Concluída’. Apurações com status intermediários ou revogados (como ‘Em processamento’, ‘Falha’ ou ‘Estornada’) serão ignoradas pela rotina automática.

Configurando os Parâmetros da Rotina

A parametrização do processo automático é realizada na aba ‘Acordos de Produtos Comerciais’ dentro de ‘Parâmetros do módulo Compras’ (@1395).Para ativar a rotina, você deve habilitar o parâmetro ‘Realizar apuração automática de acordos da performance do fornecedor’.

Regras de Agrupamento dos Acordos

Para que o sistema unifique ou separe os movimentos na geração do acordo, você precisará configurar dois parâmetros, dependendo do tipo de acordo desejado:

Para gerar de forma AGRUPADA:

  1. O parâmetro principal ‘Gerar de forma agrupada os acordos comerciais originados do contrato de fornecimento ou da Performance do fornecedor?’ deve estar configurado como ‘Sim’.
  2. O parâmetro específico do tipo de documento deve estar como ‘Sim’: ‘Permitir gerar acordo comercial de forma agrupada’ (para acordos comerciais) OU ‘Permitir gerar pré acordo financeiro e acordo financeiro de forma agrupada’ (para acordos financeiros).
  • Resultado: O sistema consolida o total dos movimentos elegíveis e gera um único número de acordo para aquela performance.

Para gerar de forma NÃO AGRUPADA:

  1. O parâmetro principal ‘Gerar de forma agrupada os acordos comerciais originados do contrato de fornecimento ou da Performance do fornecedor?’ deve estar configurado como ‘Não’.
  • Resultado: O sistema gera um acordo individual por movimento, exibindo múltiplos números de acordos separados por vírgula na coluna ‘Nº Acordo’.

Parâmetro geral

Parâmetro específico

Tipos de Acordo e Conta Bancária

No parâmetro compartilhado ‘Tipo de acordo apuração a ser gerado’, você define a modalidade do documento:

  • Comercial: O sistema gera o acordo e o valor representará um movimento diretamente na conta comercial do fornecedor, sem gerar duplicata de cobrança.
  • Financeiro: O sistema gera o acordo e, em segundo plano, gera uma duplicata de cobrança vinculada a este acordo.
  • Nota Importante: Quando utilizada a opção ‘Financeiro’ no tipo de acordo e a opção ‘BANCO’ no parâmetro ‘Tipo de cobrança’, o sistema irá buscar uma conta bancária marcada como padrão no seu cadastro e priorizará a mesma na geração automática do acordo financeiro.

Origem do Vencimento

A data de vencimento (Vencimento Comercial) do acordo gerado pode ser calculada de duas formas, dependendo de como o parâmetro ‘Origem do vencimento da duplicata para acordos financeiro ou vencimento do acordo comercial originado do contrato de fornecimento’ for configurado:

  • Dias: O vencimento será calculado somando a data de emissão mais a quantidade de dias preenchida no parâmetro auxiliar.
  • Contrato de fornecimento: O sistema calculará a data de vencimento baseada nos Dados de Prazo de Recebimento preenchido dentro do contrato de fornecimento vinculado.

Setor de compra e Modelo de Acordo

Também é possível definir o Setor de Compra e o Modelo de acordo:

Exceções e Regras de Negócio Importantes

  • Bloqueio da regra “Único acordo na matriz”: Diferente dos contratos de fornecimento padrão, ao rodar a rotina automática para a Performance do Fornecedor, o sistema ignora a unificação dos valores na matriz se a opção estiver marcada. Sendo assim, ele sempre garantirá a geração de um acordo individual por loja participante.
  • Ocorrências e Autoria: Todos os acordos gerados automaticamente registram logs detalhados. Na tela de apuração, ao clicar em ‘Ocorrências’, a coluna ‘Usuário’ constará com o valor ‘Sistema’, confirmando a autoria da operação automática. A mensagem registrará a alteração do status para ‘Finalizada’, o nome da rotina automática e os parâmetros utilizados.

Visualizando os Acordos Gerados

Após o processamento bem-sucedido da rotina automática (job):

  1. Acesse a ‘Gestão da Apuração de Performance’ (@2256).
  2. Ao buscar pelas apurações processadas, elas estarão com o status ‘Finalizada’.
  3. Na mesma grid, a coluna ‘Nº Acordo’ será populada com o(s) número(s) do(s) acordo(s) criado(s).

Para consultar os dados detalhados (como os valores ou os vencimentos), basta copiar o número exibido e colá-lo na aba ‘Buscar acordos’ dentro da funcionalidade ‘Conta Comercial do Fornecedor’ (@2140).

Disponível a partir da versão r369.01.

Para mais informações contate o Suporte Bluesoft.