ContractPlus | Cancelamento automático de pedidos ao encerrar contratos
13 min
Criado por Eduardo Martins Dos Santos em 30/07/2026 17:20
Atualizado por Eduardo Martins Dos Santos em 13/11/2026 12:08

Objetivo

A funcionalidade permite fechar automaticamente os pedidos de venda ou pedidos de compra vinculados a um contrato quando o contrato for encerrado pelo ContractPlus.

O comportamento é controlado por parâmetros gerais específicos para contratos de cliente e de fornecedor:

  • Contratos de cliente: fechamento automático de pedidos de venda;
  • Contratos de fornecedor: fechamento automático de pedidos de compra.

Com o parâmetro habilitado, o ContractPlus verifica os documentos vinculados antes de concluir o encerramento. Os pedidos elegíveis são fechados automaticamente no SAP Business One, evitando que permaneçam abertos após o encerramento do contrato. 

Informação Importante:
A partir da versão ContractPlus 26.11.12.502 o processo passa a cancelar os pedidos de compra/venda ao acionar o encerramento do contrato; O processo também passa a aceitar ambientes configurados como DI-API.

Aplicação da funcionalidade

A funcionalidade se aplica a:

  • Contratos de cliente com pedidos de venda vinculados;
  • Contratos de fornecedor com pedidos de compra vinculados;
  • Pedidos gerados a partir dos processos do ContractPlus;
  • Encerramentos realizados pela opção Encerrar da tela de Gestão de Contratos;
  • Ambientes configurados para utilização da Service Layer.

O fechamento automático não exclui os documentos do SAP Business One. O pedido permanece disponível para consulta, porém com o status Fechado.


Pré-requisitos

Antes de utilizar a funcionalidade, verifique:

  • Se a Service Layer está habilitada e configurada;
  • Se o usuário possui permissão para encerrar contratos;
  • Se os pedidos vinculados estão disponíveis para fechamento no SAP Business One;
  • Se o parâmetro correspondente ao tipo do contrato está habilitado.

Como configurar

Acesse:

ContractPlus → Configuração → Parâmetros Gerais

Contratos de cliente

Na aba Cliente, localize o parâmetro:

Fechar automaticamente pedidos de venda ao encerrar o contrato

Quando habilitado, os pedidos de venda vinculados ao contrato serão fechados automaticamente durante o encerramento, desde que estejam aptos para fechamento.

Contratos de fornecedor

Na aba Fornecedor, localize o parâmetro:

Fechar automaticamente pedidos de compra ao encerrar o contrato

Quando habilitado, os pedidos de compra vinculados ao contrato serão fechados automaticamente durante o encerramento, desde que estejam aptos para fechamento.

Depois de alterar a configuração, clique em Atualizar para salvar os parâmetros.


Integração com o parâmetro de integridade

Ao habilitar o fechamento automático, o ContractPlus também habilita automaticamente o parâmetro:

Não encerrar contrato com pendência de documento vinculado

Essa configuração impede que o contrato seja encerrado quando algum documento vinculado não puder ser processado corretamente.

Caso o parâmetro de fechamento automático seja desabilitado posteriormente, o parâmetro de integridade permanecerá habilitado. Ele deverá ser alterado manualmente quando necessário.

Esse comportamento protege o processo contra encerramentos parciais, nos quais o contrato seria encerrado, mas algum pedido permaneceria indevidamente aberto.


Como utilizar

1. Verifique os documentos vinculados

Antes de encerrar o contrato:

  1. Abra a tela Gestão de Contratos.
  2. Localize o contrato de cliente ou fornecedor.
  3. Consulte as medições, parcelas, rateios ou registros que originaram os pedidos.
  4. Verifique os números dos pedidos vinculados.
  5. Confirme se os documentos ainda estão abertos no SAP Business One.
  6. Verifique se existe Nota Fiscal vinculada aos pedidos.

2. Encerre o contrato

Na tela Gestão de Contratos:

  1. Selecione o contrato desejado.
  2. Clique na opção Encerrar.
  3. Confirme a operação na mensagem apresentada.
  4. Aguarde a conclusão do processamento.

Durante o encerramento, o ContractPlus verificará os pedidos vinculados e aplicará o comportamento correspondente à configuração dos parâmetros.


Como funciona para contratos de cliente

Contrato sem pedido de venda vinculado

Quando o contrato não possui pedido de venda em aberto vinculado, o encerramento ocorre normalmente.

Como não existe documento elegível para fechamento, nenhum pedido do SAP Business One é alterado.


Contrato com pedido de venda aberto

Quando o contrato possui um pedido de venda aberto e o parâmetro está habilitado:

  1. O ContractPlus identifica o pedido vinculado;
  2. Solicita o fechamento do documento por meio da Service Layer;
  3. O pedido permanece existente no SAP Business One;
  4. O status do pedido passa para Fechado;
  5. O vínculo com o rateio ou registro do ContractPlus é preservado;
  6. O contrato é encerrado após a conclusão do processamento.

O número interno do pedido continua disponível para consulta no ContractPlus.


Contrato com múltiplos pedidos de venda

Quando existem vários pedidos de venda abertos vinculados ao mesmo contrato, todos são processados durante o encerramento.

O contrato somente será encerrado quando todos os pedidos elegíveis forem fechados com sucesso.

Após o processamento:

  • Todos os pedidos permanecem existentes no SAP;
  • Os pedidos apresentam o status Fechado;
  • Os vínculos com os rateios são preservados;
  • Os números internos dos documentos continuam disponíveis no ContractPlus.

Pedido de venda com Nota Fiscal vinculada

Quando o pedido de venda possui uma Nota Fiscal vinculada:

O sistema apresenta uma mensagem informando que o documento fiscal precisa ser cancelado fora do ContractPlus.

  • O pedido de compra mantém seu status original "Fechado";
  • O contrato deve ser encerrado;
  • O documento fiscal permanecerá com o status "Aberto";

Parâmetro desabilitado

Quando o parâmetro Fechar automaticamente pedidos de venda ao encerrar o contrato estiver desabilitado:

  • O contrato poderá seguir com o encerramento conforme as demais validações existentes;
  • Os pedidos de venda vinculados não serão fechados pelo ContractPlus;
  • Os pedidos permanecerão com o status original no SAP Business One.

Como funciona para contratos de fornecedor

Contrato sem pedido de compra vinculado

Quando o contrato não possui pedido de compra em aberto vinculado, o encerramento ocorre normalmente.

Nenhum pedido do SAP Business One é alterado.


Contrato com pedido de compra aberto

Quando o contrato possui um pedido de compra aberto e o parâmetro está habilitado:

  1. O ContractPlus identifica o pedido vinculado;
  2. Solicita o fechamento do documento por meio da Service Layer;
  3. O pedido permanece existente no SAP Business One;
  4. O status do pedido passa para Fechado;
  5. O vínculo com a medição ou registro do ContractPlus é preservado;
  6. O contrato é encerrado após a conclusão do processamento.

Contrato com múltiplos pedidos de compra

Quando existem vários pedidos de compra abertos vinculados ao contrato, todos são processados durante o encerramento.

Após a operação:

  • Todos os pedidos elegíveis ficam com o status Fechado;
  • Os documentos permanecem disponíveis para consulta no SAP;
  • As medições continuam vinculadas aos respectivos pedidos;
  • Os números internos dos documentos são preservados no ContractPlus.

O contrato somente será encerrado se o conjunto completo de pedidos for processado com sucesso.


Pedido de compra com Nota Fiscal de Entrada vinculada

Quando o pedido de compra possui uma Nota Fiscal de Entrada vinculada:

O sistema informa que o documento fiscal precisa ser cancelado fora do ContractPlus.

  • O pedido de compra mantém seu status original "Fechado";
  • O contrato deve ser encerrado;
  • O documento fiscal permanecerá com o status "Aberto";

Parâmetro desabilitado

Quando o parâmetro Fechar automaticamente pedidos de compra ao encerrar o contrato estiver desabilitado:

  • O encerramento do contrato seguirá as demais validações existentes;
  • Os pedidos de compra vinculados não serão fechados automaticamente;
  • Os documentos permanecerão com seu status original no SAP Business One.

Integridade do encerramento

O encerramento é tratado como uma única operação.

Quando um contrato possui vários pedidos vinculados e pelo menos um deles não pode ser fechado, o sistema não deve concluir parcialmente o processo.

Nesse caso:

  • O contrato permanece sem encerramento;
  • Os demais pedidos não devem ser deixados em uma situação inconsistente;
  • O usuário recebe a mensagem referente ao documento que impediu o processamento;
  • A pendência deve ser corrigida antes de uma nova tentativa.

Essa regra evita que apenas parte dos pedidos seja fechada enquanto o contrato ou os demais documentos permanecem em outro estado.


Como consultar os pedidos após o encerramento

Pedido de venda

No SAP Business One:

  1. Acesse Vendas C/R.
  2. Abra Pedido de Venda.
  3. Localize o pedido vinculado ao contrato.
  4. Confirme que o documento permanece existente.
  5. Consulte o campo de status.
  6. Quando o fechamento tiver sido realizado, o status deverá ser Fechado.

Pedido de compra

No SAP Business One:

  1. Acesse Compras C/P.
  2. Abra Pedido de Compra.
  3. Localize o pedido vinculado ao contrato.
  4. Confirme que o documento permanece existente.
  5. Consulte o campo de status.
  6. Quando o fechamento tiver sido realizado, o status deverá ser Fechado.

Consulta no ContractPlus

Na tela Gestão de Contratos:

  1. Acesse os registros vinculados ao pedido;
  2. Confirme que o número interno do documento foi preservado;
  3. Verifique o status apresentado no registro;
  4. Utilize a seta de navegação para abrir o documento no SAP Business One, quando disponível.

Comportamento esperado

Situação
Comportamento
Contrato sem pedido vinculado
O contrato é encerrado sem alterar outros pedidos
Pedido aberto e parâmetro habilitado
O pedido é fechado e o contrato é encerrado
Múltiplos pedidos abertos e elegíveis
Todos são fechados antes do encerramento
Pedido com Nota Fiscal vinculada
O contrato é encerrado e o status do pedido vinculado permanece inalterado
Um dos pedidos não pode ser fechado
A operação não deve ser concluída parcialmente
Parâmetro de fechamento desabilitado
O contrato não solicita o fechamento automático dos pedidos
Pedido fechado com sucesso
O documento permanece no SAP com status Fechado
Documento vinculado no ContractPlus
O número interno e o vínculo são preservados

Processos não afetados

A funcionalidade é acionada durante o encerramento do contrato pela opção Encerrar da tela de Gestão de Contratos.

Ela não altera automaticamente outros processos de mudança de status que possuam regras próprias.

O fluxo de distrato total, por exemplo, mantém as validações e o comportamento já existentes. O novo fechamento automático não deve substituir nem ignorar as regras aplicáveis ao distrato.

Quando houver medições vinculadas que impeçam o distrato, o sistema continuará apresentando a validação correspondente.


Pontos de atenção

  • A Service Layer deve estar ativa e acessível.
  • O parâmetro correto deve ser habilitado conforme o tipo do contrato.
  • Habilitar o fechamento automático também habilita o parâmetro de integridade.
  • Desabilitar o fechamento automático não desabilita automaticamente o parâmetro de integridade.
  • O fechamento não exclui o pedido; apenas altera seu status para Fechado.
  • Os vínculos e números internos dos documentos são preservados.
  • Quando houver múltiplos pedidos, todos precisam estar aptos para fechamento.
  • Uma falha em qualquer pedido impede a conclusão parcial do encerramento.
  • Com o parâmetro desabilitado, os pedidos permanecem com o status original.
  • O processo não modifica as regras existentes para distratos.
  • A funcionalidade foi validada para pedidos de venda e de compra, incluindo contratos com um ou vários documentos vinculados. 

Exemplo prático

Um contrato de cliente possui três pedidos de venda abertos, todos vinculados a rateios de medição.

O parâmetro Fechar automaticamente pedidos de venda ao encerrar o contrato está habilitado.

Ao executar a opção Encerrar:

  1. O ContractPlus identifica os três pedidos;
  2. Verifica se estão aptos para fechamento;
  3. Fecha os documentos no SAP Business One;
  4. Preserva os vínculos com os rateios;
  5. Atualiza o status dos pedidos para Fechado;
  6. Conclui o encerramento do contrato.
Este artigo foi útil para você?
Últimos artigos visitados