> 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/aceite-da-oferta.md).

# Aceite da Oferta (link público)

Link público que registra o aceite quando o trabalhador escolhe a oferta no aplicativo da Carteira de Trabalho Digital. Quem o acessa é o navegador do trabalhador; você não o chama.

Do seu lado: informe um `redirectUrl` https na [submissão](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/leilao/submeter-ofertas.md) (que devolve o `acceptanceUrl` de cada oferta) e reaja ao webhook `AUCTION_OFFER_ACCEPTED`.

## Request

`GET /api/v1/public/auction/acceptances/{token}`

| Parâmetro | Local | Tipo     | Obrigatório | Descrição                                         |
| --------- | ----- | -------- | ----------- | ------------------------------------------------- |
| `token`   | path  | `string` | Sim         | Token opaco de aceite (parte do `acceptanceUrl`). |

Sem autenticação. Rate limit por IP.

## Comportamento

```mermaid
sequenceDiagram
    autonumber
    actor T as Trabalhador
    participant API as GTPayroll API
    actor O as Originador

    T->>API: GET /api/v1/public/auction/acceptances/{token}
    alt oferta disponível
        API->>API: marca oferta CHOSEN_BY_WORKER
        API-)O: webhook AUCTION_OFFER_ACCEPTED
    end
    alt redirectUrl https informado
        API-->>T: 302 redirect (redirectUrl + numeroProposta + solicitationId + status)
    else sem redirectUrl
        API-->>T: página HTML
    end
```

* Com `redirectUrl` **https**: `302` para essa URL, com os query params `numeroProposta`, `solicitationId` e `status`. O redirect acontece **também quando a oferta não pode mais ser aceita**: trate o `status` na sua página.
* Sem `redirectUrl`, ou não https: a Giro exibe uma página HTML.
* **Idempotente**: novo acesso a uma oferta já escolhida só repete o redirect com `status=ACCEPTED`, sem reenviar webhook — inclusive depois que o prazo de aceite terminou.

### Valores de `status` no redirect

| `status`      | Significado                                                              | Webhook `AUCTION_OFFER_ACCEPTED` |
| ------------- | ------------------------------------------------------------------------ | -------------------------------- |
| `ACCEPTED`    | Oferta aceita agora, ou aceita antes e o link tocado de novo.            | Enviado só no primeiro aceite.   |
| `EXPIRED`     | O prazo de aceite da oferta terminou.                                    | Não.                             |
| `UNAVAILABLE` | A oferta não está mais disponível (rejeitada, perdida ou já convertida). | Não.                             |

Só materialize a proposta com `status=ACCEPTED`. Nos outros casos, mostre ao trabalhador que a oferta não pode mais ser aceita.

### Códigos de status

Nenhuma resposta é JSON, exceto o `429`: quem recebe é o navegador do trabalhador.

| Código | Significado                                                         |
| ------ | ------------------------------------------------------------------- |
| `302`  | Redirecionamento para o `redirectUrl` (https), com `status`.        |
| `200`  | Página HTML de oferta aceita (sem `redirectUrl`).                   |
| `404`  | Página HTML de link inválido (token não encontrado).                |
| `410`  | Página HTML de oferta expirada ou indisponível (sem `redirectUrl`). |
| `429`  | Rate limit por IP excedido (header `Retry-After`).                  |

## Depois do aceite: materializar a proposta

Com o webhook `AUCTION_OFFER_ACCEPTED` (traz `proposalNumber` e `solicitationId`):

1. Crie a proposta em [`POST /api/v1/originator/employees/{publicId}/proposals`](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/propostas/criar-proposta.md) com os campos de leilão, que amarram a averbação à oferta:
   * `proposalNumber` — o da submissão/webhook. **Obrigatório na prática**: é ele que classifica a operação como leilão;
   * `solicitationId` — o do redirect/webhook. Opcional: quando omitido, a Giro grava o da oferta;
   * na oferta com garantia: `hasWarranty: true` + `warrantyFgtsBalance`, `warrantyFgtsPenalty`, `warrantySeverancePercentage`.
2. Averbe o contrato normalmente. Na averbação bem-sucedida, a oferta passa a `CONVERTED` e a solicitação a `WON`.

{% hint style="warning" %}
**Sem `proposalNumber`, a operação não é de leilão.** A proposta criada sem ele é tratada como originação ativa, mesmo que traga `solicitationId` (que é ignorado), e a CCB é formalizada no programa da originação ativa. A operação não é reclassificada depois.
{% endhint %}

A proposta e o contrato de uma oferta de leilão exigem o originador habilitado no leilão; sem a habilitação, as duas chamadas retornam `403` `AUCTION_PARTICIPATION_DISABLED`, inclusive para oferta aceita antes de a habilitação ser retirada.

Fora do leilão, esses campos da proposta ficam ausentes.
