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

# Cotações

> Uma cotação é uma oferta de preço para um valor. É apenas preço: não é vinculada a um remetente, não verifica o remetente, não reserva limite, não contrata câmbio e não cria remessa.

## A cotação é apenas preço

* Nenhum remetente é enviado na cotação. O mesmo preço vale para qualquer remetente seu.
* O remetente é informado e validado no [withdrawal](https://developers.javalibridge.com/pt-BR/guides/withdrawal.md). Um remetente não elegível é recusado lá, com `SENDER_NOT_ELIGIBLE` ou `SENDER_LIMIT_EXCEEDED`.
* Para evitar isso, confira o status e os limites do remetente antes de pedir a cotação.

## Valor fixo de origem ou de destino

* You send (USD): a MSB fixa o valor em USD. A cotação calcula quanto o beneficiário recebe em BRL.
* Recipient gets (BRL): a MSB fixa o valor em BRL. A cotação calcula quanto é necessário em USD.
* Só um dos dois pode ser informado. Deve ser maior que zero.

## O que a cotação mostra

Um preço, igual para `PREFUNDED` e `CREDIT`. O valor em BRL que o beneficiário recebe não depende da modalidade de funding.

| Campo | Significado |
| - | - |
| Origem | Valor em USD que você envia |
| Destino | Valor exato em BRL que o beneficiário recebe |
| Taxa de referência | Taxa de mercado usada como base |
| Taxa | Taxa aplicada à remessa, já com o spread |
| Spread de câmbio | Percentual sobre a taxa de referência, e o valor em USD. É a única tarifa da remessa. |

## Validade e uso

* A cotação tem validade curta, exibida como horário de expiração. Cotação expirada não pode ser usada.
* Uma cotação só pode ser usada por um withdrawal. O status passa de `AVAILABLE` para `USED`, ou para `EXPIRED` se não for usada a tempo.
* A modalidade de funding é escolhida no withdrawal. Limite de crédito e saldo em USD são verificados nesse momento. Você pode consultá-los antes em Credit Line e Wallets.
* Validade da cotação: \[A DEFINIR em contrato].

## Uso da cotação

* `usage` indica para que serve a cotação. `REMITTANCE` (padrão): usada por um withdrawal. `INVENTORY`: usada uma única vez para criar um Inventory Lot em `POST /v1/inventories`. Veja [USDC Inventory](https://developers.javalibridge.com/pt-BR/guides/inventory.md).
* Cotações sem `usage` são `REMITTANCE`.
* Usar a cotação na operação errada retorna `QUOTE_USAGE_MISMATCH` (422): cotação `INVENTORY` em withdrawal, ou cotação `REMITTANCE` em `POST /v1/inventories`.
* Cotações `INVENTORY` também trazem `inventoryExpiresAt`, a validade que o lote terá. É diferente de `expiresAt`, a validade da própria cotação.

> [!TIP]
>
> **O que você faz**
>
> * Confira o status do remetente e os limites do remetente e do beneficiário antes da cotação.
> * Peça a cotação com valor fixo em USD ou BRL. Não envie remetente.
> * Crie o withdrawal antes do horário de expiração. Se expirar, peça uma nova cotação.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.