Skip to content

modelo_transaction.md

Latest commit

 

History

History
89 lines (81 loc) · 3.03 KB

modelo_transaction.md

File metadata and controls

89 lines (81 loc) · 3.03 KB
Raw

Especificação técnica: Modelo de Transações (Transaction)

Este documento descreve as propriedades brutas que o motor de cálculo espera receber ao importar movimentos financeiros.

Campo Tipo Descrição Obrigatório
id String Identificador único da transação. Sim
date String Data da transação no formato ISO 8601. Sim
type String Tipo de transação: "deposit", "withdrawal", "trade". Sim
fromAssetSymbol String Símbolo do ativo de origem (para withdrawal e trade). Não
fromAmount Number Quantidade do ativo de origem. Não
fromWalletId String ID da carteira de origem. Não
toAssetSymbol String Símbolo do ativo de destino (para deposit e trade). Não
toAmount Number Quantidade do ativo de destino. Não
toWalletId String ID da carteira de destino. Não
feeAmount Number Quantidade da taxa paga. Não
feeAssetSymbol String Símbolo do ativo em que a taxa foi paga (ex: "EUR", "BNB"). Não
feeFiatValue Number Valor de mercado em euros da taxa de transação no exato momento da operação. Utilizado para deduzir o encargo de forma direta quando a comissão é paga em criptoativos. Não
fiatValue Number Valor total em FIAT da transação (para deposit/withdrawal). Não
tag String Chave fixa em inglês que categoriza a transação ("buy", "sell", "staking", etc.). Não
notes String Notas adicionais do utilizador. Não

Exemplos de Transaction:

  • Compra (Depósito Fiat):

    {
  "id": "tx_compra_01",
  "date": "2024-01-20T10:30:00Z",
  "type": "deposit",
  "toAssetSymbol": "BTC",
  "toAmount": 0.2,
  "toWalletId": "wallet-main-001",
  "fiatValue": 7000.00,
  "feeAmount": 14.00,
  "feeAssetSymbol": "EUR",
  "tag": "buy"
}

  • Venda (Levantamento Fiat):

    {
  "id": "tx_venda_01",
  "date": "2024-05-22T09:00:00Z",
  "type": "withdrawal",
  "fromAssetSymbol": "BTC",
  "fromAmount": 0.1,
  "fromWalletId": "wallet-main-001",
  "fiatValue": 4500.00,
  "feeAmount": 9.00,
  "feeAssetSymbol": "EUR",
  "tag": "sell"
}

  • Recompensa de Staking:

    {
  "id": "tx_stake_01",
  "date": "2024-09-25T13:00:00Z",
  "type": "deposit",
  "toAssetSymbol": "ADA",
  "toAmount": 28.5,
  "toWalletId": "wallet-main-001",
  "tag": "staking",
  "notes": "Recompensa mensal de staking"
}

  • Trade (Cripto para Cripto):

    {
  "id": "tx_trade_01",
  "date": "2024-04-10T14:20:00Z",
  "type": "trade",
  "fromAssetSymbol": "BTC",
  "fromAmount": 0.05,
  "fromWalletId": "wallet-main-001",
  "toAssetSymbol": "ETH",
  "toAmount": 1.0,
  "toWalletId": "wallet-main-001",
  "feeAmount": 0.001,
  "feeAssetSymbol": "ETH",
  "tag": "trade"
}

Voltar