Skip to Content
Metadata Format

Metadata Data Format

Overview

Reeve uses a specific on-chain format for publishing financial data to the Cardano blockchain, identified by the metadata label 1447. This label was chosen in reference to 1447, the death year of Luca Pacioli , the renowned accountant widely regarded as the father of modern accounting and bookkeeping.

General Structure

All on-chain transactions follow a base structure that includes organization information and metadata:

{
  "1447": {
    "org": {
      "id": "string",
      "name": "string",
      "currency_id": "string",
      "country_code": "string",
      "tax_id_number": "string"
    },
    "metadata": {
      "creation_slot": "u64",
      "timestamp": "timestamp string (ISO-8601)",
      "version": "1.1"
    },
    "type": "<Identifier of type>"
  }
}

Supported Transaction Types

The format currently supports two main types of on-chain data:

1. Individual Transactions (INDIVIDUAL_TRANSACTIONS)

This type contains detailed accounting transaction data including:

  • Transaction Information: ID, number, batch ID, type, date, and accounting period
  • Transaction Items: Individual line items with amounts, accounts, and references
  • Business Context: Optional fields for events, projects, cost centers
  • Document Details: Currency, VAT information, counterparty data
  • Foreign Exchange: Exchange rates for multi-currency transactions

Example structure:

{
  "1447": {
    "org": { ... },
    "metadata": { ... },
    "type": "INDIVIDUAL_TRANSACTIONS",
    "data": [
      {
        "id": "string",
        "number": "string",
        "batch_id": "string",
        "type": "TransactionType enum",
        "date": "date string",
        "accounting_period": "string",
        "items": [
          {
            "id": "string",
            "amount": "string",
            "event": { "code": "string", "name": "string" },
            "project": { "cust_code": "string", "name": "string" },
            "cost_center": { "cust_code": "string", "name": "string" },
            "fx_rate": "string",
            "document": {
              "number": "string",
              "currency": { "id": "string", "cust_code": "string" },
              "vat": { "cust_code": "string", "rate": "string" },
              "counterparty": { "cust_code": "string", "type": "string" }
            }
          }
        ]
      }
    ]
  }
}

2. Financial Reports (REPORT)

This type publishes formal financial statements including Balance Sheets and Income Statements.

Report structure:

{
  "1447": {
    "org": { ... },
    "metadata": { ... },
    "type": "REPORT",
    "interval": "string",
    "year": "string",
    "mode": "string",
    "ver": "string",
    "period": "string",
    "subType": "BALANCE_SHEET | INCOME_STATEMENT",
    "data": { ... }
  }
}

Balance Sheet

Balance Sheet includes:

  • Assets:
    • Non-current assets: property, plant & equipment, intangible assets, financial assets
    • Current assets: prepayments and other short-term assets, receivables, crypto assets, cash and cash equivalents
  • Liabilities:
    • Non-current liabilities: provisions
    • Current liabilities: trade accounts payables, other current liabilities, accruals and short-term provisions
  • Capital: Equity, results carried forward, and profit for the year

Income Statement

Income Statement includes:

  • Revenues: Other income, build of long-term provision
  • Cost of Goods and Services: Cost of providing services
  • Operating Expenses: Personnel expenses, general and administrative expenses, depreciation and impairment losses, amortization, rent expenses
  • Financial Income/Expenses: Financial expenses and revenues, staking rewards income, net income from options sale, realized gain on sale of cryptocurrencies
  • Tax Expenses: Income tax expenses
  • Profit for the Year: Final net result
  • Extraordinary Income/Expenses: Extraordinary items

Complete Specification

For the complete and detailed specification of the on-chain format including all fields, data types, and optional properties, please refer to the official documentation:

On-Chain Format Specification 

Last updated on
IndexerBusiness Rules