calc
educacao

Conversão de Moedas (BRL/USD/EUR) com IOF

Converte valor entre moedas considerando IOF (Decreto 11.998/24 cronograma 2024-2029) + spread cambial. Mostra valor recebido líquido.

post/api/v1/calc/conversao-moedas-iof

Request

  • Base URL: https://api.calculas.com.br
  • URL: https://api.calculas.com.br/api/v1/calc/conversao-moedas-iof
  • Auth: HTTP bearer

Request body

valorOrigemCentsinteger required

Valor em centavos a ser convertido. Ex: R$ 100,00 → 10000. Mínimo R$ 1,00; máximo R$ 1.000.000,00.

moedaOrigem'BRL' | 'USD' | 'EUR'

Moeda do valor que você quer converter. BRL = Real brasileiro, USD = Dólar americano, EUR = Euro. Padrão: BRL.

moedaDestino'BRL' | 'USD' | 'EUR'

Moeda para a qual deseja converter o valor. BRL = Real brasileiro, USD = Dólar americano, EUR = Euro. Padrão: USD.

cambioBrlPorMoedaOrigemnumber

Cotação em reais (BRL) por uma unidade da moeda de origem. Exemplo: se o dólar está a R$ 5,10, informe 5.10. Ignorado quando a moeda de origem é BRL. Faixa: 0,50 a 50,00.

cambioBrlPorMoedaDestinonumber

Cotação em reais (BRL) por uma unidade da moeda de destino. Exemplo: se o euro está a R$ 5,50, informe 5.50. Ignorado quando a moeda de destino é BRL. Faixa: 0,50 a 50,00.

cambioBrlPorMoedanumber

Cotação em reais (BRL) por uma unidade da outra moeda (simplificado). Use quando apenas uma das moedas é BRL. Para conversão entre moedas estrangeiras (USD↔EUR), informe os dois câmbios separados. Faixa: 0,50 a 50,00.

metodoConversao'pix_transferencia' | 'cartao_credito' | 'papel_moeda'

Método utilizado na conversão, que define a alíquota de IOF aplicada. pix_transferencia = PIX ou transferência cambial (IOF 1,1%); cartao_credito = pagamento com cartão de crédito no exterior (IOF com cronograma de redução 2024-2029); papel_moeda = compra de moeda física em corretora (IOF 1,1%). Padrão: pix_transferencia.

spreadCorretoraPercentnumber

Percentual de spread cobrado pela corretora ou banco sobre o câmbio PTAX. Em porcentagem (%). Exemplo: 2 significa 2% de spread. Típico: 1-3% (fintechs), 4-7% (casas físicas). Padrão: 2.

currentDatestring date-time

ISO-8601 com offset. Default: tempo do servidor. Use pra reprodutibilidade / cache semantico.

Response

OK

oktrue required
dataobject required

Resultado dependente da calc — ver schema individual

metaobject

Changes

No recorded changes to this operation across all 1 revision of this API.