> For the complete documentation index, see [llms.txt](https://manual.kartado.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manual.kartado.com.br/recursos/aditivos.md).

# Aditivos

{% hint style="danger" %} <mark style="color:red;">**ATENÇÃO!**</mark>

1. Esta funcionalidade requer parametrização de perfil para **visualizar e criar aditivos**. Entre em contato com o time de suporte.
2. Após adicionar o aditivo, a ação não pode ser desfeita. Para reverter o valor aplicado, será necessário realizar a edição manual dos recursos e corrigir os valores. Para mais detalhes sobre a edição dos itens, consulte o artigo [**Editar Objeto**](/recursos/editar-objeto.md#editar-e-apagar-itens).
   {% endhint %}

Imagine que você precisa aplicar um reajuste de IPCA em um contrato sem editar item por item. Com a funcionalidade de aditivos, você atualiza de uma vez os valores de recursos P.U, ADM e Performance do contrato, ganhando agilidade, mantendo o histórico e garantindo mais confiabilidade no fechamento.

O aditivo será aplicado somente aos recursos que:

* **Não inclusos na aba Medição do Objeto**
* **Não estão inseridos em boletins**

Recursos usados e inseridos em boletins mantêm o valor contratado antes da adição do aditivo.

{% hint style="success" %} <mark style="color:green;">**DICA:**</mark> Para os passos a seguir, consulte o artigo [**Listar e Visualizar Objeto**](/recursos/listar-e-visualizar-objeto.md).
{% endhint %}

## O que você vai precisar

* Permissão de perfil para visualizar e criar aditivos
* Contrato com seções cadastradas e valor contratado diferente de 0
* Descrição clara do reajuste e, se aplicável, referência do índice/contrato
* Data de aplicação do reajuste (imediato, retroativo ou agendado)

***

## **Dicas Importantes**

* **Cálculo do reajuste agendado**: incide sobre o valor do item no dia da vigência do agendamento, respeitando edições manuais feitas antes dessa data.
  * **Exemplo:** se você agendar um reajuste de 20% para daqui 3 meses e, antes da vigência, editar o item de R$ 100 para R$ 150, no dia agendado o reajuste é calculado sobre R$ 150 (resultando em R$ 180).
* **Histórico de alterações do recurso**: um aditivo só entra no histórico permanente quando é aplicado com sucesso.
* **Falha no agendamento**: se a aplicação falhar na data agendada, o sistema remove o aditivo agendado da lista e envia notificação de falha. Será necessário adicionar o reajuste novamente; não há nova tentativa automática.

***

## Aba Aditivos

Para acessar a **aba** '**Aditivos**', localize e acesse o contrato ao qual deseja aplicar o reajuste.

<figure><img src="/files/Q7I0DVzzHvba8F79585B" alt=""><figcaption></figcaption></figure>

Em seguida, clique na **aba** '**Aditivos**'.

<figure><img src="/files/iiDxCQhQ2PCyUptU1kYw" alt=""><figcaption></figcaption></figure>

### **Colunas do Aditivo**

{% hint style="success" %} <mark style="color:green;">**DICA:**</mark> Para localizar os aditivos, utilize as colunas ordenáveis: '**Serial**', '**Data**' e '**Descrição**'.

A seta indica a posição atual da ordenação da coluna. Por padrão, os aditivos são ordenados pela coluna '**Data**' em ordem decrescente.
{% endhint %}

Colunas da lista de aditivos:&#x20;

* **Serial**: código do aditivo gerado pelo sistema.
* **Criador**: usuário que adicionou o aditivo.
* **Status**: informa se o ajuste foi aplicado (hoje ou retroativa) ou se está agendado (datas futuras).
* **Início do reajuste**: data de aplicação do aditivo.
* **Descrição**: nome ou código interno do aditivo.
* **Reajuste (%)**: percentual de reajuste.
* **Contratado anterior (R$)**: valor contratado anterior à adição do aditivo.&#x20;
* **Contratado atualizado (R$)**: valor contratado atualizado com o aditivo.

<figure><img src="/files/18BdzsGIzaJyq3vFdsLi" alt=""><figcaption></figcaption></figure>

### Detalhes do Aditivo

Para visualizar os detalhes do aditivo, clique no botão **VER**. Para fechar a janela, clique em **FECHAR**.

<figure><img src="/files/rF6KycZdhaplusgX1K6d" alt=""><figcaption></figcaption></figure>

***

## Adicionar Aditivo

{% hint style="info" %} <mark style="color:blue;">**IMPORTANTE!**</mark>

1. Faça a conferência do valor total contratado antes de confirmar o aditivo.
2. Use descrições claras (ex.: “Reajuste IPCA jan/2026”) para facilitar auditorias futuras.
3. Se necessário, salve as observações com a referência do índice/contrato que motivou o reajuste.
   {% endhint %}

Na lista de aditivos, clique no botão **+ADICIONAR ADITIVO** (canto superior direito).

<figure><img src="/files/COiMCW0FUqYKJFiulgy0" alt=""><figcaption></figcaption></figure>

Caso o botão esteja desabilitado, verifique se o contrato possui seções cadastradas e se o valor contratado é diferente de 0.

<figure><img src="/files/rnMjPehwz5pKw9c3k97W" alt=""><figcaption></figcaption></figure>

Na janela de configuração do aditivo são exibidos os campos:

* **Criador**: nome do usuário que está adicionando o aditivo.
* **Descrição**: insira um ou nome ou detalhes do aditivo. Preenchimento obrigatório.
* **Aplicar reajuste a partir de**: selecione a data de aplicação. Preenchimento obrigatório.
  * Selecione **entre 365 dias para trás e 365 dias para frente** (a partir de hoje). Datas fora do intervalo ficam bloqueadas.
  * Para datas futuras, é exibida a mensagem “**Reajuste agendado para esta data**”.
  * **Hoje ou retroativa**: o reajuste é aplicado imediatamente.
* **Valor contratado atual (R$)**: valor contratado atual.
* **Reajuste (%)**: insira a porcentagem do reajuste. **Digite um valor entre 0,01 e 100**. Preenchimento obrigatório.
* **Valor contratado reajustado (R$)**: exibe o valor atualizado após o preenchimento do campo **Reajuste (%)**.
* **Observações**: insira informações adicionais sobre o reajuste. Preenchimento opcional.

<figure><img src="/files/a0xOXo72Y1zxBaeV0dZb" alt=""><figcaption></figcaption></figure>

***Exemplo de reajuste:***

<table data-full-width="false"><thead><tr><th align="center">Valor contratado atual (R$</th><th align="center">Reajuste (%)</th><th align="center">Valor contratado reajustado (R$)</th></tr></thead><tbody><tr><td align="center">1000</td><td align="center">10</td><td align="center">1100</td></tr></tbody></table>

<figure><img src="/files/gsp95P1MiA590HbM2apm" alt=""><figcaption></figcaption></figure>

Após preencher os campos, revise as informações e clique em **CONTINUAR**.

<figure><img src="/files/cMXVx8YIvqV8OD4Uxkpr" alt=""><figcaption></figcaption></figure>

Leia a mensagem de confirmação com atenção. Marque a caixa "**Entendo que esta ação não pode ser desfeita.**" e clique em **CONFIRMAR**.

{% hint style="danger" %} <mark style="color:red;">**ATENÇÃO!**</mark>

1. A aplicação do aditivo não altera recursos já utilizados ou inseridos em boletins. Esses itens permanecerão com o valor contratado anterior.
2. Após adicionar o aditivo, a ação não pode ser desfeita. Para alterar o valor do recurso, será necessário editar manualmente o item e ajustar o valor. Para mais detalhes de edição dos itens, consulte o artigo [**Editar Objeto**](/recursos/editar-objeto.md#editar-e-apagar-itens).
   {% endhint %}

<figure><img src="/files/kiQxdAm2EIAePlPtstRu" alt=""><figcaption></figcaption></figure>

Para reajustes agendados será exibido o alerta:

{% hint style="info" %}
**Agendado para XX/XX/XXXX.** Nenhum valor será alterado até essa data. O reajuste será calculado sobre o valor dos itens vigentes no dia da aplicação, portanto alterações feitas nos itens até lá serão consideradas e o valor final pode diferir do estimado. Você receberá uma notificação no sistema Kartado quando o reajuste for aplicado.
{% endhint %}

<figure><img src="/files/B36UzaITDgMc0hE1MFt0" alt=""><figcaption></figcaption></figure>

Após a confirmação, você será direcionado para a lista de aditivos.

<figure><img src="/files/G5mIvtc62Ck7a8la6xvP" alt=""><figcaption></figcaption></figure>

#### Conforme a data escolhida:

* **Hoje ou retroativa (aplicação imediata):** o reajuste é aplicado aos itens de forma assíncrona. Logo após confirmar, o aditivo pode aparecer brevemente com o status **'Agendado'**; após concluir o processamento, o status passa para **'Aplicado'** e o usuário é notificado.

<figure><img src="/files/D8ZTXqcjvOgTjBcNMthS" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/OeMOyDZVIoNpij7Rlth4" alt=""><figcaption></figcaption></figure>

* **Data futura (agendado):** o aditivo é salvo com status **'Agendado'**. Até a vigência do reajuste, **os itens e o valor contratado não mudam**; a coluna **'Contratado atualizado'** mostra apenas a **projeção** do reajuste. No dia agendado, o sistema atualiza os valores, muda o status para **'Aplicado'** e notifica o usuário.

<figure><img src="/files/vxImPdpg0gkhAn5evj1J" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Ai0UL9yrBRIKbJTGAIoR" alt=""><figcaption></figcaption></figure>

***

## Visualizar Reajuste

Para visualizar o reajuste, acesse a aba '**Dados**', campo '**Contratado**'.

**Valor contratado antes do aditivo**

<figure><img src="/files/kJSVLHpqh6SI0M2aoRTA" alt=""><figcaption></figcaption></figure>

**Valor contratado depois do aditivo**

<figure><img src="/files/3BXAfCmVSJGFfjQT3JRW" alt=""><figcaption></figcaption></figure>

***

## Histórico de alterações do recurso

{% hint style="success" %} <mark style="color:green;">**DICA:**</mark> Para os passos a seguir, consulte o artigo [**Editar Objeto > aba Itens**](/recursos/editar-objeto.md#aba-itens).
{% endhint %}

Para visualizar o histórico de alterações dos recursos, acesse a tela de edição do recurso. Na aba '**Itens**', identifique a seção e o recurso e clique no ícone do lápis para editar.

<figure><img src="/files/RPrmByTTO9WrsntX3Tre" alt=""><figcaption></figcaption></figure>

No canto superior direito, será exibido o histórico de alterações do recurso.

Informações do histórico:

* **Data**: data e hora da alteração.
* **Usuário**: usuário que realizou a alteração.
* **Histórico**: descrição do que foi alterado.

<figure><img src="/files/NqIf5kS5M5HQP2YgUMTy" alt=""><figcaption></figcaption></figure>

***

## Solução de Problemas

**O botão +ADICIONAR ADITIVO está desabilitado**

* Verifique se o contrato possui seções cadastradas e se o valor contratado é diferente de 0.
* Confirme com o administrador do sistema da sua empresa se o seu perfil tem permissão para criar aditivos.

**Não consigo selecionar a data desejada**

* Somente datas dentro do intervalo de 365 dias para trás e 365 dias para frente (a partir de hoje) podem ser escolhidas. Ajuste a data para dentro do intervalo.

**O status ficou em 'Agendado' após confirmar um reajuste imediato**

* O processamento é assíncrono. Aguarde alguns instantes; ao concluir, o status muda para **'Aplicado'** e você receberá uma notificação.

**O valor aplicado diferiu da projeção**

* Para reajustes agendados, o cálculo ocorre sobre o valor vigente no dia da aplicação. Se houve edições manuais antes da data, a projeção pode diferir do valor final.

**A aplicação do agendamento falhou**

* O aditivo agendado é removido e uma notificação de falha é enviada. Adicione o reajuste novamente; não há reprocessamento automático.

***

### Dúvidas frequentes

#### O aditivo altera recursos já usados ou inseridos em boletins?

* Não. Esses itens permanecem com o valor contratado anterior.

#### Posso desfazer um aditivo?

* Não. A ação é irreversível. Para ajustes, edite manualmente os recursos.

#### Quando o aditivo aparece no histórico?

* Quando é aplicado com sucesso. Aditivos agendados só entram no histórico após a aplicação.

#### Como adicionar reajustes retroativos para anos anteriores (2024 e 2025) ?

* Para reajustes retroativos, adicione primeiro o mais antigo (2024) e, em seguida, o mais recente (2025).
* Caso a ordem seja invertida, ocorrerá divergência na aplicação dos reajustes.
* Para evitar duplicidade de reajustes, confira previamente a lista de **'Aditivos'**.

***

## Artigos Relacionados

{% content-ref url="/pages/ba8tRqXoS7nougYd9ZtR" %}
[Listar e Visualizar Objeto](/recursos/listar-e-visualizar-objeto.md)
{% endcontent-ref %}

{% content-ref url="/pages/NJ5GpOPAbYB6a4G58L1K" %}
[Editar Objeto](/recursos/editar-objeto.md)
{% endcontent-ref %}

{% content-ref url="/pages/loV0EeI1ztOTlc1g8ZGJ" %}
[Reajustes contratuais - Reajuste de valores, quantidades e peso dos recursos e avaliações](/recursos/reajustes-contratuais-reajuste-de-valores-quantidades-e-peso-dos-recursos-e-avaliacoes.md)
{% endcontent-ref %}

<figure><img src="/files/13kYpRKCRbKvZsa1F68d" alt="" width="375"><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://manual.kartado.com.br/recursos/aditivos.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
