Skip to main content

How Ledgers Work

Nautical's ledger system is based on double-entry accounting, which tracks a chart of ledgers debited and credited through transactions in your marketplace. This page outlines the key components for understanding the ledger system.

Data model

The following data model ensures that each financial event is recorded and balanced for precise financial records:

  • Ledger: A specific account where transactions are recorded. For example, the "Sales Tax" account records all transactions related to sales tax charged on an order.
  • Ledger entry: The individual record within a ledger indicating a single debit or credit transaction. For example, if $100 of sales tax applies to an order, a ledger entry would credit the "Sales Tax" ledger with $100.
  • Journal entry: A grouping of ledger entries that form a single balanced transaction, documenting the entire financial event. Developers can retrieve journal entries using Nautical's API. For example, for an order totaling $1,100, a journal entry would include a debit to "Customer Receivable" and credits to the "Deferred Revenue" and "Sales Tax" ledgers, respectively.

Ledger accounts

The following accounts track transactions in the ledger system:

AccountTypeNormal BalanceDescription
Customer ReceivableAssetDebitTracks the amount that buyers owe to the marketplace for orders with uncaptured payments.
Deferred DiscountsContra revenueDebitTracks discounts applied to product sales that have not accrued yet.
Deferred Sales RevenueRevenueCreditTracks revenue from product sales that have not accrued yet.
Deferred Shipping RevenueRevenueCreditTracks revenue from shipping fees that have not accrued yet.
Foreign Currency GainRevenueCreditTracks earnings or losses resulting from the exchange of foreign currencies in multi-currency transactions.
Funds - PaymentsAssetDebitTracks funds received from captured sales transactions, increasing the marketplace's assets.
Marketplace CommissionRevenueCreditTracks revenue earned by the marketplace as a commission on product sales.
Marketplace DiscountsContra revenueDebitTracks reductions in marketplace revenue due to promotional discounts offered by the marketplace to buyers.
Marketplace FeesRevenueCreditTracks fees collected by the marketplace, including order and shipping fees when the marketplace accrues shipping.
RefundsContra revenueDebitTracks reductions in revenue due to refunds.
Sales TaxLiabilityCreditTracks sales tax as a liability the marketplace must remit to the tax authority.
Seller PayableLiabilityCreditTracks the cumulative amount the marketplace owes sellers for completed transactions.
Seller Payout DisbursementContra assetCreditTracks payments that the marketplace has made to sellers against their payout balance.

Account types

The account types used in our ledger system are based on standard account types used in accounting, specifically:

TypeDescription
AssetAsset accounts track the financial value of resources a company owns, such as the funds captured with a payment processor like Stripe.
LiabilityLiability accounts track the debts a company has incurred, detailing what it owes to other parties.
RevenueRevenue accounts track the income a company earns from its business operations.
Contra

Contra accounts are used to decrease the value of their corresponding main accounts, and their balances are netted against these main accounts.

Unlike the normal balance of their associated accounts, contra accounts have the opposite balance type. For instance, if a revenue account typically has a credit balance, a contra revenue account like "Discounts" would normally have a debit balance.

Was this page helpful?