Transações de Investimento

Cada investimento contém uma lista de transações correspondentes a Aplicações ou Saques. O esquema da transação contém um conjunto de detalhes dessa operação.

Transação de Investimento #

Propriedade	Tipo	Opcional	Descrição
id	string	Não	Identificador principal da transação de investimento.
tradeDate	Date	Sim	A data em que a transação foi liquidada.
date	Date	Não	A data em que a transação foi realizada.
quantity	number	Sim	Quantidade de cotas investidas.
value	number	Sim	Valor pelo qual foi adquirida.
amount	number	Sim	O valor bruto da operação.
type	InvestmentTransactionType	Não	Tipo de movimento da transação.
movementType	string	Sim	Direção do fluxo de caixa da transação na perspectiva do titular: `CREDIT` quando o dinheiro entra na posição (padrão para `BUY`), `DEBIT` quando sai (padrão para todos os outros tipos).
description	string	Sim	Descrição da transação.
brokerageNumber	string	Sim	Número da nota de corretagem correspondente.
netAmount	number	Sim	Valor incluindo despesas.
agreedRate	number	Sim	Taxa acordada disponível apenas para aplicações de TESOURARIA.
indexerPercentage	number	Sim	Percentual máximo do indexador acordado na contratação (por exemplo, 110% do CDI).
priceFactor	number	Sim	Fator de conversão de lote/preço da B3, para transações de renda variável.
expenses	Expenses	Sim	Impostos e taxas descritos nas notas de corretagem. Retornado para conexões de Open Finance e Meu Pluggy; `null` para outras conexões.

Tipo de Transação de Investimento #

Valor	Descrição
BUY	Aplicação.
SELL	Saque.
TAX	Impostos que diminuem o tamanho do investimento.
TRANSFER	Transferência entre investimentos.
INTEREST	Distribuições de renda: dividendos, renda de aluguel (FIIs), juros sobre capital (JCP), pagamentos de cupons.
AMORTIZATION	Retorno parcial do principal (amortização de cotas, amortização de títulos).

Quando compramos um ativo negociado em uma bolsa de valores, geralmente através de uma corretora, a corretora emite uma nota comercial chamada nota de corretagem. A nota contém o valor total da transação, os ativos comprados e vendidos, as taxas relacionadas à bolsa de valores, o valor cobrado pelo corretor (taxa de corretagem) e a soma total. A nota de corretagem representa o status diário das operações de um investidor no mercado financeiro. Todos os impostos cobrados em cada operação são agrupados no objeto Despesas.

Disponibilidade

Quando listado através de GET /investments/{id}/transactionsAPI, expenses é retornado para transações de investimento de conexões de Open Finance e de conexões de Meu Pluggy. Para outras conexões, o campo é null. Uma transação sem taxas relatadas pela instituição também retorna null.

Propriedade	Tipo	Opcional	Descrição
serviceTax	number	Sim	O imposto sobre serviços varia de acordo com o estado (ISS).
brokerageFee	number	Sim	Comissão cobrada pela corretora para realizar transações no mercado de ações.
incomeTax	number	Sim	Imposto de Renda Retido na Fonte é o valor pago à Receita Federal (IRRF).
other	number	Sim	Soma de outras despesas não definidas.
tradingAssetsNoticeFee	number	Sim	Uma taxa de Aviso de Negociação em Ativos (ANA).
maintenanceFee	number	Sim	Taxas cobradas pela BM&F Bovespa nas negociações.
settlementFee	number	Sim	Taxa de liquidação para a liquidação de uma posição na data de vencimento ou a liquidação financeira da entrega física.
clearingFee	number	Sim	Taxa de compensação cobrada pela câmara de compensação.
stockExchangeFee	number	Sim	Taxas cobradas pela BM&F Bovespa como fonte de receita operacional.
custodyFee	number	Sim	Taxa cobrada pelos corretores para manter registros em seus sistemas de corretagem ou na mesa de operações.
operatingFee	number	Sim	Valor pago ao Operador pelo serviço de intermediação.
iof	number	Sim	Imposto sobre operações financeiras (IOF) cobrado na transação.
iofProvision	number	Sim	IOF provisionado: acumulado para a transação, mas ainda não pago.

Em conexões de Open Finance, a discriminação vem da nota de corretagem regulamentada, que relata o imposto de renda retido (IRRF) por conta própria. Ele chega como incomeTax; todos os outros impostos cobrados na operação — incluindo o imposto de renda de day-trade — são somados em other. Os dois nunca se sobrepõem, então somá-los dá o custo total do imposto da operação.

Quais taxas são preenchidas nas conexões de Open Finance depende do que a instituição relata para cada operação:

incomeTax e iof são os que mais frequentemente são preenchidos.
As taxas da nota de corretagem — brokerageFee, settlementFee, stockExchangeFee, clearingFee, custodyFee, tradingAssetsNoticeFee e other — são preenchidas apenas quando a instituição relata uma nota de corretagem para a operação.
serviceTax, maintenanceFee, operatingFee e iofProvision não são preenchidos nas conexões de Open Finance.

Exemplo de uma Transação:

{
  "total": 1,
  "totalPages": 1,
  "page": 1,
  "results": [
    {
      "id": "0f4e3a57-6b1d-4c8e-9a2f-3d5b7c9e1a24",
      "type": "BUY",
      "movementType": "CREDIT",
      "description": "Aplicação Fundo de Investimento Premium",
      "quantity": 1.25,
      "value": 2,
      "amount": 5,
      "netAmount": 5.31,
      "date": "2022-03-24T03:00:00.000Z",
      "tradeDate": "2022-03-24T03:00:00.000Z",
      "brokerageNumber": "47078992",
      "agreedRate": null,
      "indexerPercentage": null,
      "priceFactor": null,
      "expenses": {
        "serviceTax": 0.05,
        "brokerageFee": 0.1,
        "incomeTax": 0.01,
        "other": 0.01,
        "tradingAssetsNoticeFee": 0,
        "maintenanceFee": 0,
        "settlementFee": 0.09,
        "clearingFee": 0,
        "stockExchangeFee": 0.05,
        "custodyFee": 0,
        "operatingFee": 0,
        "iof": 0,
        "iofProvision": 0
      }
    }
  ]
}

Veja Transações de InvestimentoAPI em nossa referência da API para mais informações.

Transação de Investimento#

Tipo de Transação de Investimento#

Despesas#

Transação de Investimento #

Tipo de Transação de Investimento #

Despesas #