# 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](#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). |

## Despesas

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**.

<Callout variant="info" title="Disponibilidade">
Quando listado através de [`GET /investments/{id}/transactions`](/reference/investment-transactions-list), `expenses` é retornado para transações de investimento de conexões de [Open Finance](/docs/open-finance/institutions-coverage) e de conexões de [Meu Pluggy](/docs/guides/meu-pluggy-personal-use). Para outras conexões, o campo é `null`. Uma transação sem taxas relatadas pela instituição também retorna `null`.
</Callout>

| 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:

```json
{
  "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 Investimento](/reference/investment-transactions-list) em nossa referência da API para mais informações.