> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zipdin.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar oferta

> Envia uma oferta de condições para competir no leilão de uma solicitação

Envia a oferta de condições do parceiro para uma solicitação — é ela que compete no leilão. Use este fluxo
direto quando você já tem os valores calculados (parcela, CET, IOF). Para simular condições antes, veja
[Calcular oferta](/docs/marketplace/calcular-oferta).

<Info>
  Todos os endpoints requerem autenticação via **Bearer token** no header `Authorization`.
  Consulte o [guia de autenticação](/docs/primeiros-passos/authentication) para obter suas credenciais e gerar um token.
</Info>

## Parâmetros

<ParamField body="idRequest" type="integer" required>
  ID da solicitação sendo respondida
</ParamField>

<ParamField body="creator" type="string" required>
  CNPJ do parceiro criador da oferta — exatamente 14 caracteres
</ParamField>

<ParamField body="offerNoGuarantee" type="object" required>
  Condições da oferta sem garantia

  <Expandable>
    <ParamField body="offerNoGuarantee.installmentsNumber" type="integer" required>Número de parcelas (inteiro positivo)</ParamField>
    <ParamField body="offerNoGuarantee.installmentValue" type="number" required>Valor da parcela (≥ 0)</ParamField>
    <ParamField body="offerNoGuarantee.monthlyRate" type="number" required>Taxa mensal (≥ 0)</ParamField>
    <ParamField body="offerNoGuarantee.yearlyRate" type="number" required>Taxa anual</ParamField>
    <ParamField body="offerNoGuarantee.iofValue" type="number" required>Valor do IOF</ParamField>
    <ParamField body="offerNoGuarantee.monthlyCet" type="number" required>CET mensal</ParamField>
    <ParamField body="offerNoGuarantee.yearlyCet" type="number" required>CET anual</ParamField>
    <ParamField body="offerNoGuarantee.fundedValue" type="number" required>Valor financiado (> 0)</ParamField>
    <ParamField body="offerNoGuarantee.loanValue" type="number" required>Valor do empréstimo (> 0)</ParamField>

    <ParamField body="offerNoGuarantee.creatorContacts" type="array">
      Opcional — array de `{tipo, contato}`, onde `tipo` é `0` (URL), `1` (WhatsApp), `2` (Telefone), `3`
      (Email) ou `4` (Outro)
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="offerGuarantee" type="object">
  Condições da oferta com garantia (opcional). Mesmos campos de `offerNoGuarantee`, mais:

  <Expandable>
    <ParamField body="offerGuarantee.severancePayPercentage" type="number">Opcional</ParamField>
    <ParamField body="offerGuarantee.severanceFineFgtsValue" type="number">Opcional</ParamField>
    <ParamField body="offerGuarantee.availableBalanceFgtsValue" type="number">Opcional</ParamField>
  </Expandable>
</ParamField>

<ParamField body="creatorContext" type="array">
  Opcional — array de `{key, value}` com contexto adicional do criador
</ParamField>

<Warning>
  Regras de negócio validadas no envio: quando `offerGuarantee` é informado, pelo menos um dos campos de
  garantia FGTS é obrigatório, e a `monthlyRate` da oferta com garantia deve ser **menor** que a da oferta
  sem garantia.
</Warning>

## Exemplo

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://hml.zipdin.com.br/zipconsig-marketplace/offers \
    -H "Authorization: Bearer SEU_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "idRequest": 123,
      "creator": "12345678000190",
      "offerNoGuarantee": {
        "installmentsNumber": 36,
        "installmentValue": 398.50,
        "monthlyRate": 2.49,
        "yearlyRate": 34.82,
        "iofValue": 120.00,
        "monthlyCet": 2.70,
        "yearlyCet": 37.90,
        "fundedValue": 9250.00,
        "loanValue": 10000.00,
        "creatorContacts": [{ "tipo": 1, "contato": "5511999999999" }]
      },
      "creatorContext": [{ "key": "origem", "value": "app" }]
    }'
  ```
</CodeGroup>

<ResponseExample>
  ```json 200 - Oferta criada theme={null}
  {
    "_embedded": { "id": 4521 },
    "_links": { "self": { "href": "/zipconsig-marketplace/offers/4521" } },
    "message": "Oferta criada com sucesso!"
  }
  ```
</ResponseExample>