> For the complete documentation index, see [llms.txt](https://docs.giro.tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.giro.tech/desenvolvedores/api-gtpayroll/guias/cobertura-de-garantias.md).

# Cobertura de Garantias (FGTS)

Operação com garantia (saldo FGTS, multa rescisória do FGTS e/ou verbas rescisórias) precisa atender à **regra de cobertura** da Dataprev, que depende do canal de originação. Quem não atende é rejeitado com **`FI`** ou **`FJ`**. Operação sem garantia não passa por esta validação.

***

## Canais e cobertura exigida

| Canal                     | Quando se aplica                                                                                                                                                       | Cobertura exigida               |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- |
| **Leilão (CTPS Digital)** | Oferta paralela com garantia no [leilão de propostas](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/leilao/submeter-ofertas.md) (`warrantyOffer`) | **100%** do valor do empréstimo |
| **Canal próprio da IF**   | Operação averbada **fora do leilão** (originação direta) com garantia                                                                                                  | **50%** do valor do empréstimo  |

***

## Como a cobertura é calculada

Em **reais**, valor **oferecido** contra valor **exigido**:

```
oferecido = saldo FGTS + multa rescisória FGTS + verbas rescisórias
exigido   = valor do empréstimo × percentual do canal   (100% leilão / 50% canal próprio)
```

Tolerância de **R$ 0,01**. No leilão, os campos da garantia são `fgtsBalance`, `fgtsPenalty` e `severancePercentage` (objeto `warranty` da [oferta](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/leilao/submeter-ofertas.md)).

{% hint style="warning" %}
**Verba rescisória entra pelo valor cheio da margem.** Com `severancePercentage > 0`, entra na cobertura a **margem disponível integral** no momento da operação, **não** `margem × percentual`. O percentual (máximo **35%**) só **constitui** a garantia. Com `severancePercentage = 0`, o termo é zero.
{% endhint %}

***

## Exato vs. mínimo

| Composição da garantia                               | Regra                                        | Resultado                                         |
| ---------------------------------------------------- | -------------------------------------------- | ------------------------------------------------- |
| **Somente verbas rescisórias**                       | Cobertura **mínima** (`oferecido ≥ exigido`) | Sobre-cobertura é **aceita**                      |
| **Inclui saldo e/ou multa FGTS** (com ou sem verbas) | Cobertura **exata** (`oferecido = exigido`)  | Acima ou abaixo do exigido é **rejeitado** (`FI`) |

***

## Momentos de validação

| Canal                     | Onde a cobertura é validada                                         |
| ------------------------- | ------------------------------------------------------------------- |
| **Leilão (CTPS Digital)** | No **cadastramento da proposta** na Dataprev **e** na **averbação** |
| **Canal próprio**         | Na **averbação**                                                    |

***

## Exemplos

Empréstimo de **R$ 3.000,00**: exigido **R$ 3.000,00** no leilão e **R$ 1.500,00** no canal próprio.

| Canal               | Garantia                             | Oferecido | Exigido       | Cobertura | Resultado                                  |
| ------------------- | ------------------------------------ | --------- | ------------- | --------- | ------------------------------------------ |
| Ambos               | verbas rescisórias (margem R$ 1.000) | R$ 1.000  | 3.000 / 1.500 | 33,33%    | ❌ `FI` (abaixo do mínimo)                  |
| Ambos               | verbas rescisórias (margem R$ 6.000) | R$ 6.000  | 3.000 / 1.500 | 200%      | ✅ aprovado (mínimo aceita sobre-cobertura) |
| Canal próprio (50%) | verba + R$ 500 saldo                 | R$ 1.500  | R$ 1.500      | 50%       | ✅ aprovado (exato)                         |
| Canal próprio (50%) | verba + R$ 1.000 saldo               | R$ 2.000  | R$ 1.500      | 66,67%    | ❌ `FI` (excede o exato)                    |
| Leilão (100%)       | verba + R$ 2.000 saldo               | R$ 3.000  | R$ 3.000      | 100%      | ✅ aprovado (exato)                         |
| Leilão (100%)       | verba + R$ 3.000 saldo               | R$ 4.000  | R$ 3.000      | 133,33%   | ❌ `FI` (excede o exato)                    |

***

## Erros

| errorCode | Origem                                      | Significado                                                                                                                                                                                                     |
| --------- | ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `FI`      | API (na submissão de oferta) **e** Dataprev | Garantia inválida. Na submissão de oferta, a API recusa campos ausentes, `severancePercentage > 35` e valores acima dos limites da solicitação. A cobertura por canal (100% / 50%) é validada só pela Dataprev. |
| `FJ`      | Dataprev (leilão)                           | Proposta ou regra de garantia inválida. Ex.: oferta com garantia para solicitação sem garantia, ou taxa da oferta com garantia maior ou igual à da oferta padrão.                                               |

Ver também [Erros da API](https://docs.giro.tech/desenvolvedores/api-gtpayroll/guias/erros.md).

{% embed url="<https://giro.tech/central-de-atendimento/>" %}
