Accounts

Accounts define the chart of accounts used for financial reporting and integration with accounting systems. Accounts map sales and payment transactions to ledger account numbers.

Storage Location

{customer_id}-account.json

Fields

Field	Type	Required	Description
id	string	Yes	Unique account identifier.
customer_id	integer	Yes	Reference to Customer.
num	integer	Yes	Account number in chart of accounts.
description	string	Yes	Account description.
external_references	array	No	External system mappings for ERP integration.
saft	object	No	v1.2. SAF-T revenue classification of the account: { basic_id, basic_type, description }. Absent when the account is untagged; for revenue rollups treat absent/null as code 04999 "Other".

External References Structure

The external_references array contains mappings to external accounting systems:

[
  {"key": "posting_template_number", "value": "string"},
  {"key": "product_number", "value": "string"},
  {"key": "periodisation_debit_number", "value": "string"},
  {"key": "periodisation_credit_number", "value": "string"}
]

Account Number Ranges

Typical Norwegian chart of accounts structure:

Range	Category	Description
1500-1999	Assets	Receivables, prepayments
2900-2999	Liabilities	Gift cards, deposits
3000-3999	Revenue	Sales by tax category

Example

{
  "id": "35071",
  "customer_id": 10352,
  "num": 3009,
  "description": "Salg mat 15%",
  "external_references": []
}

Example - Account with SAF-T classification

{
  "id": "35071",
  "customer_id": 10352,
  "num": 3009,
  "description": "Salg mat 15%",
  "external_references": [],
  "saft": { "basic_id": "04006", "basic_type": "04", "description": "Food" }
}

Example - Multiple Accounts

[
  {
    "id": "35063",
    "customer_id": 10352,
    "num": 1500,
    "description": "Faktura",
    "external_references": []
  },
  {
    "id": "35067",
    "customer_id": 10352,
    "num": 1901,
    "description": "Kontant",
    "external_references": []
  },
  {
    "id": "35064",
    "customer_id": 10352,
    "num": 1921,
    "description": "Kreditkort",
    "external_references": []
  },
  {
    "id": "35068",
    "customer_id": 10352,
    "num": 1923,
    "description": "Bankkort",
    "external_references": []
  },
  {
    "id": "35066",
    "customer_id": 10352,
    "num": 1953,
    "description": "Vipps",
    "external_references": []
  },
  {
    "id": "35069",
    "customer_id": 10352,
    "num": 2900,
    "description": "Gavekort",
    "external_references": []
  },
  {
    "id": "35117",
    "customer_id": 10352,
    "num": 3000,
    "description": "Salg 25%",
    "external_references": []
  },
  {
    "id": "35071",
    "customer_id": 10352,
    "num": 3009,
    "description": "Salg mat 15%",
    "external_references": []
  },
  {
    "id": "35070",
    "customer_id": 10352,
    "num": 3010,
    "description": "Salg mat 25%",
    "external_references": []
  },
  {
    "id": "35072",
    "customer_id": 10352,
    "num": 7740,
    "description": "Øresavrunding",
    "external_references": []
  }
]

Common Account Types

Payment Accounts (1500-1999)

Account	Description
1500	Invoice receivables
1901	Cash
1921	Credit card
1923	Debit card (BankAxept)
1953	Vipps

Revenue Accounts (3000-3999)

Account	Description
3000	Sales 25% VAT
3009	Food sales 15% VAT
3010	Food sales 25% VAT
3013	Soft drinks 25% VAT
3015	Coffee/tea 25% VAT

Other Accounts

Account	Description
2900	Gift card liability
7740	Rounding adjustment
3990	Invoice admin fee

Related Entities

• Customers - Parent customer/tenant
• Lines - Order lines reference accounts via account_id
• Payments - Payments reference accounts via account_id