> 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/atributos-de-cessao.md).

# Atributos de Elegibilidade para Cessão

Bloco `eligibilityAttributes` da criação de contrato, com dados do **empregador**, do **trabalhador** e da **operação**. O GTPayroll não usa esses dados: repassa ao Fundo que compra o recebível, que os usa para avaliar o crédito.

{% hint style="warning" %}
**Não confunda com** [**Elegibilidade**](https://docs.giro.tech/desenvolvedores/api-gtpayroll/guias/elegibilidade.md), que trata das regras que decidem **se o trabalhador pode contratar**.
{% endhint %}

***

## Quando usar

O bloco é **opcional para a API e necessário para o fluxo de cessão**. Sem ele, o contrato é criado e cedido normalmente, mas chega ao Fundo sem as informações complementares.

***

## Onde entra

Dentro do payload de criação de contrato:

```json
{
  "contractAmount": 5000,
  "contractDate": "2026-09-01",
  "firstInstallmentDueDate": "2026-10-25",
  "lastInstallmentDueDate": "2028-09-25",

  "eligibilityAttributes": {
    "employer": {
      "taxId": "11222333000181"
    },
    "worker": {
      "birthDate": "1979-11-03"
    },
    "operation": {
      "deductibleType": "PAYROLL_LOAN"
    }
  }
}
```

`eligibilityAttributes` fica no primeiro nível do payload de [Criar contrato](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/contratos/criar-contrato.md). Os campos de cada grupo estão nas tabelas abaixo. Todos são opcionais: o Fundo recebe o que foi informado e o restante como `null`.

***

## `employer` — dados do empregador

| Campo               | Tipo    | Descrição                                         |
| ------------------- | ------- | ------------------------------------------------- |
| `taxId`             | string  | CPF ou CNPJ do empregador, somente dígitos        |
| `name`              | string  | Razão social ou nome do empregador                |
| `legalNature`       | enum    | Natureza jurídica — ver [valores](#legalnature)   |
| `activityStartDate` | date    | Data de início da atividade, formato `AAAA-MM-DD` |
| `cnae`              | string  | Código CNAE principal                             |
| `companySize`       | enum    | Porte da empresa — ver [valores](#companysize)    |
| `employeeCount`     | integer | Quantidade de funcionários                        |
| `annualRevenue`     | number  | Faturamento anual, com centavos                   |

## `worker` — dados do trabalhador

| Campo           | Tipo   | Descrição                                              |
| --------------- | ------ | ------------------------------------------------------ |
| `birthDate`     | date   | Data de nascimento, formato `AAAA-MM-DD`               |
| `gender`        | enum   | Gênero — ver [valores](#gender)                        |
| `grossSalary`   | number | Salário bruto, com centavos                            |
| `netSalary`     | number | Salário líquido, com centavos                          |
| `admissionDate` | date   | Data de admissão, formato `AAAA-MM-DD`                 |
| `cboCode`       | string | Código CBO da ocupação                                 |
| `maritalStatus` | enum   | Estado civil — ver [valores](#maritalstatus)           |
| `workerStatus`  | enum   | Situação do trabalhador — ver [valores](#workerstatus) |

## `operation` — dados da operação

| Campo                     | Tipo    | Descrição                                                                   |
| ------------------------- | ------- | --------------------------------------------------------------------------- |
| `payrollMarginPercentage` | number  | Margem consignável, em percentual sobre o salário                           |
| `maxDeductibleAmount`     | number  | Valor máximo consignável, com centavos                                      |
| `hasCreditInsurance`      | boolean | `true` quando a operação tem seguro prestamista. Ausente equivale a `false` |
| `deductibleType`          | enum    | Tipo consignável — ver [valores](#deductibletype)                           |

***

## Valores aceitos nos enums

Envie como **string**, exatamente como listado. Valor fora da lista é descartado e chega ao Fundo como `null`, sem falhar a criação do contrato.

### legalNature

| Valor  | Significado                   |
| ------ | ----------------------------- |
| `EI`   | Empresário Individual         |
| `LTDA` | Sociedade Limitada            |
| `MEI`  | Microempreendedor Individual  |
| `SA`   | Sociedade Anônima             |
| `SLU`  | Sociedade Limitada Unipessoal |

{% hint style="info" %}
**EPP não é natureza jurídica**, é porte. Uma Sociedade Limitada EPP vai como `legalNature` = `LTDA` e `companySize` = `SMALL`.
{% endhint %}

### companySize

| Valor    | Significado   |
| -------- | ------------- |
| `MICRO`  | Microempresa  |
| `SMALL`  | Pequeno porte |
| `MEDIUM` | Médio porte   |
| `LARGE`  | Grande porte  |

### gender

Mesmos valores do `gender` usado no restante da API.

| Valor          | Significado   |
| -------------- | ------------- |
| `MALE`         | Masculino     |
| `FEMALE`       | Feminino      |
| `NOT_INFORMED` | Não informado |

### maritalStatus

| Valor          | Significado   |
| -------------- | ------------- |
| `MARRIED`      | Casado(a)     |
| `DIVORCED`     | Divorciado(a) |
| `SEPARATED`    | Separado(a)   |
| `SINGLE`       | Solteiro(a)   |
| `STABLE_UNION` | União estável |
| `WIDOWED`      | Viúvo(a)      |

### workerStatus

| Valor            | Significado          |
| ---------------- | -------------------- |
| `RETIRED`        | Aposentado           |
| `EMPLOYEE_CLT`   | Assalariado (CLT)    |
| `DISMISSED`      | Demitido / Exonerado |
| `PENSIONER`      | Pensionista          |
| `PUBLIC_SERVANT` | Servidor público     |

### deductibleType

| Valor                        | Significado                          |
| ---------------------------- | ------------------------------------ |
| `FGTS_ANTICIPATION`          | Antecipação FGTS (saque-aniversário) |
| `BENEFIT_CARD`               | Cartão benefício consignado          |
| `PAYROLL_CREDIT_CARD`        | Cartão de crédito consignado         |
| `PAYROLL_LOAN`               | Empréstimo consignado tradicional    |
| `REFINANCING_OR_PORTABILITY` | Refinanciamento / Portabilidade      |
| `PAYROLL_CARD_WITHDRAWAL`    | Saque no cartão consignado           |

***

## Formatos

| Tipo            | Formato                            | Exemplo        |
| --------------- | ---------------------------------- | -------------- |
| Data            | ISO `AAAA-MM-DD`                   | `"2015-03-10"` |
| Valor monetário | Número com centavos, **sem aspas** | `4500.00`      |
| Percentual      | Número                             | `30.00`        |
| Enum            | String, exatamente como na tabela  | `"LTDA"`       |
| Booleano        | `true` ou `false`, **sem aspas**   | `false`        |

Valores monetários vão como número, não texto; os centavos são preservados (`4500.00` chega como `4500.00`).

***

## Exemplo completo

```json
{
  "eligibilityAttributes": {
    "employer": {
      "taxId": "11222333000181",
      "name": "PADARIA DO JOAO LTDA",
      "legalNature": "LTDA",
      "activityStartDate": "2011-05-20",
      "cnae": "1091101",
      "companySize": "MICRO",
      "employeeCount": 8,
      "annualRevenue": 480000.00
    },
    "worker": {
      "birthDate": "1979-11-03",
      "gender": "FEMALE",
      "grossSalary": 3200.00,
      "netSalary": 2740.55,
      "admissionDate": "2016-08-15",
      "cboCode": "848505",
      "maritalStatus": "MARRIED",
      "workerStatus": "EMPLOYEE_CLT"
    },
    "operation": {
      "payrollMarginPercentage": 35.00,
      "maxDeductibleAmount": 959.19,
      "hasCreditInsurance": false,
      "deductibleType": "PAYROLL_LOAN"
    }
  }
}
```

***

## Correção depois da criação

Os atributos são gravados na criação do contrato. Para corrigir, fale com a Giro.Tech.
