> 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/api-reference/leilao.md).

# Leilão de Propostas (CTPS)

No leilão do Crédito do Trabalhador (CTPS), a Dataprev publica **solicitações de proposta** de trabalhadores e os originadores **respondem com ofertas**. O trabalhador escolhe a oferta no aplicativo da Carteira de Trabalho Digital, e o originador vencedor materializa a proposta e averba o contrato.

* O **originador sempre monta a oferta** (taxa, parcela, prazo, validade e, opcionalmente, garantia FGTS). A Giro repassa a oferta à Dataprev de forma assíncrona e nunca calcula nem altera os termos.
* **`solicitationId`** é o identificador Dataprev da solicitação e o único usado em toda a API de leilão: aparece nas listagens, é informado para [submeter ofertas](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/leilao/submeter-ofertas.md), volta no [redirect de aceite](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/leilao/aceite-da-oferta.md) e pode ser enviado em `solicitationId` ao [criar a proposta](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/propostas/criar-proposta.md).
* **`proposalNumber`** é o número da sua oferta e é o que classifica a operação como leilão. Informe-o sempre ao [criar a proposta](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/propostas/criar-proposta.md) que materializa uma oferta aceita: sem ele, a operação é tratada como originação ativa e formalizada no programa da originação ativa. Detalhes em [Aceite da Oferta](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/leilao/aceite-da-oferta.md#depois-do-aceite-materializar-a-proposta).
* A participação no leilão depende de habilitação pela Giro. Sem ela, a listagem de solicitações, a submissão de ofertas, a proposta e o contrato de uma oferta retornam `403` `AUCTION_PARTICIPATION_DISABLED`.
* A plataforma descobre as solicitações automaticamente e avisa pelo webhook `AUCTION_SOLICITATIONS_REFRESHED`. Reaja a ele consultando [Listar Solicitações](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/leilao/listar-solicitacoes.md).

***

## O fluxo ponta a ponta

```mermaid
sequenceDiagram
    autonumber
    participant DP as Dataprev (CTPS)
    participant API as GTPayroll API
    actor O as Originador
    actor T as Trabalhador

    DP-->>API: publica solicitações de proposta
    API-)O: webhook AUCTION_SOLICITATIONS_REFRESHED
    O->>API: GET .../auction/solicitations
    API-->>O: solicitações OPEN_FOR_OFFERS

    O->>API: POST .../solicitations/{solicitationId}/offers
    API-->>O: 201 { offers: [PENDING_SUBMISSION] }
    API->>DP: repassa as ofertas (assíncrono)
    Note over API,DP: oferta vira SUBMITTED<br/>solicitação vira OFFERED

    T->>DP: vê as ofertas e escolhe a sua
    T->>API: GET /api/v1/public/auction/acceptances/{token}
    API-)O: webhook AUCTION_OFFER_ACCEPTED
    API-->>T: 302 redirect (redirectUrl + status) ou página HTML

    O->>API: POST .../employees/{publicId}/proposals (materializa)
    O->>API: averba o contrato
    Note over API: na averbação OK → oferta CONVERTED + solicitação WON
```

***

## CPF com oferta vigente <a href="#cpf-com-oferta-vigente" id="cpf-com-oferta-vigente"></a>

Enquanto um CPF tem oferta de leilão vigente na Dataprev, a Dataprev só averba contrato desse CPF que referencie a oferta. A plataforma faz esse vínculo sozinha, para **toda** CCB do CPF — inclusive de outro originador e inclusive de originação ativa (sem `proposalNumber`):

* **Na criação da proposta**, a taxa mensal precisa ser menor ou igual à menor taxa entre as ofertas vigentes do CPF. Acima disso: `422` `AUCTION_ACTIVE_OFFER_RATE_EXCEEDED`, com o teto em `properties.maxMonthlyInterestRate`. Nada da oferta (número, originador, prazo) é exposto além do teto.
* **Na averbação**, a CCB é amarrada à oferta compatível (taxa e garantia). Sem oferta compatível, a averbação falha antes de chegar à Dataprev, com `errorCode` `*_PRE_ENDORSEMENT` em `ENDORSEMENT_FAILED` — ver [Erros da API](https://docs.giro.tech/desenvolvedores/api-gtpayroll/guias/erros.md#async).
* **Oferta de outro originador consumida pela sua CCB** fica `CONVERTED` e a solicitação `WON`; o dono da oferta vê isso na listagem, sem webhook. Ao tentar materializar essa oferta depois, a proposta dele retorna `422` `AUCTION_OFFER_NOT_FOUND`, e o aceite do trabalhador nela responde indisponível.
* **Duas operações simultâneas sobre a mesma oferta**: a segunda recebe `409` `AUCTION_OFFER_BUSY` na criação da proposta, ou `ENDORSEMENT_RETRYING` com `AUCTION_OFFER_CLAIM_CONTENTION` na averbação. As duas são retentáveis.
* Oferta vencida (`offerValidUntil` no passado) não vincula: a CCB averba como antes.
* Para checar o teto de taxa **antes** de criar a proposta, em vez de descobri-lo de forma reativa pelo `422`, use [Consultar Oferta Vigente](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/leilao/consultar-oferta-vigente.md).

***

## Estados

### Estados da oferta

| Status               | Significado                                                                                                                                                            |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `PENDING_SUBMISSION` | Oferta registrada na Giro, aguardando o repasse à Dataprev.                                                                                                            |
| `SUBMITTED`          | Oferta repassada à Dataprev e visível ao trabalhador.                                                                                                                  |
| `CHOSEN_BY_WORKER`   | Trabalhador aceitou esta oferta (via link de aceite). Dispara `AUCTION_OFFER_ACCEPTED`.                                                                                |
| `CONVERTED`          | Oferta virou contrato (averbação concluída) — pela sua CCB ou pela CCB de outro originador averbada sobre ela (ver [CPF com oferta vigente](#cpf-com-oferta-vigente)). |
| `LOST`               | Oferta não foi a escolhida, ou a averbação falhou em definitivo na Dataprev. Recusa da plataforma antes de enviar à Dataprev não marca `LOST`: a oferta segue aberta.  |
| `EXPIRED`            | `offerValidUntil` ultrapassado sem aceite.                                                                                                                             |
| `REJECTED`           | Repasse recusado pela Dataprev (erro de negócio).                                                                                                                      |

### Estados da solicitação

| Status            | Significado                                                                                               |
| ----------------- | --------------------------------------------------------------------------------------------------------- |
| `DISCOVERED`      | Recém-descoberta, em avaliação de elegibilidade.                                                          |
| `OPEN_FOR_OFFERS` | Aberta para ofertas — único estado em que é possível submeter; em outro estado a submissão retorna `409`. |
| `AWARDED`         | Ofertas registradas pelo originador, repasse pendente.                                                    |
| `OFFERED`         | Ofertas repassadas à Dataprev.                                                                            |
| `WON`             | Convertida em contrato.                                                                                   |
| `LOST`            | Encerrada sem conversão.                                                                                  |
| `SKIPPED`         | Ignorada (não elegível pela regra do leilão).                                                             |
| `EXPIRED`         | Prazo da solicitação encerrado.                                                                           |

***

## Oferta com garantia FGTS

Além da oferta padrão, você pode enviar uma **oferta paralela com garantia FGTS** (`warrantyOffer`), geralmente com taxa menor. No leilão, a garantia precisa cobrir **exatamente 100%** do empréstimo; regras e erros em [Submeter Ofertas](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/leilao/submeter-ofertas.md#objeto-warranty).

***

## Operações disponíveis

| Operação                                                                                                                                                         | Método | Endpoint                                                           |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------------------ |
| [Listar Solicitações](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/leilao/listar-solicitacoes.md)                                          | `GET`  | `/api/v1/originator/auction/solicitations`                         |
| [Submeter Ofertas](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/leilao/submeter-ofertas.md)                                                | `POST` | `/api/v1/originator/auction/solicitations/{solicitationId}/offers` |
| [Listar Ofertas](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/leilao/listar-ofertas.md)                                                    | `GET`  | `/api/v1/originator/auction/offers`                                |
| [Obter Oferta por `proposalNumber`](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/leilao/listar-ofertas.md#obter-oferta-por-proposalnumber) | `GET`  | `/api/v1/originator/auction/offers/{proposalNumber}`               |
| [Consultar Oferta Vigente](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/leilao/consultar-oferta-vigente.md)                                | `POST` | `/api/v1/originator/auction/offers/active-query`                   |
| [Aceite da Oferta (link público)](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/leilao/aceite-da-oferta.md)                                 | `GET`  | `/api/v1/public/auction/acceptances/{token}`                       |

Webhooks do leilão (`AUCTION_OFFER_ACCEPTED`, `AUCTION_SOLICITATIONS_REFRESHED`): [Eventos e Payloads](https://docs.giro.tech/desenvolvedores/api-gtpayroll/webhooks/eventos-e-payloads.md#leilao-de-propostas).

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