AccountingAccount

HTTP	Operation	Type	Object	DTO Why-DTOs?
POST	Create	Mutation	`createAccountingAccount`	`AccountingAccountCreateGLDtoInput`
POST	Update	Mutation	`updateAccountingAccount`	`AccountingAccountUpdateGLDtoInput`
POST	Delete	Mutation	`deleteAccountingAccount`	`AccountingAccountDeleteGLDtoInput`
POST	Read	Query	`accountingAccounts filtered by id` Why?
POST	List	Query	`accountingAccounts`

Description

Chart of accounts, known as AccountingAccount in the API context and Ledger account in the product interface.
This resource serves as the framework for financial accounts within accounting operations.
It defines both standard and custom accounts, crucial for categorizing transactions.

Unlike the AccountingEntry, which records transactions, this resource focuses on defining various account types.

Please note that the chart of accounts may vary based on specific legal requirements, such as those in France, Spain, or Germany.

Key	Value
`Authorization`	Bearer Current access Token How to find?
`X-TenantId`	Current tenant id How to find?
`X-OrganizationId`	Current organization Id How to find?
`x-api-key`	Primary or secondary subscription key of your app How to find?

accountingAccounts

Fields	Type	Description	Length
idSSystem field that cannot be assigned	UUID	Id
creationDateSSystem field that cannot be assigned	DateTime	Creation Date
modificationDateSSystem field that cannot be assigned	DateTime	Modification Date

code *The value of the field or object is mandatory NThe value of this field cannot be modified after the record is created	String	Code See InfoAdditional information is available in the Info block below	~
name *The value of the field or object is mandatory	String	Name	100
description	String	Code and Name
deactivated	Boolean	Deactivated See InfoAdditional information is available in the Info block below
accountLevel NThe value of this field cannot be modified after the record is created	UNDEFINED GROUP SUB_GROUP ACCOUNT BREAKDOWN SUB_ACCOUNT TOTAL	Level See InfoAdditional information is available in the Info block below
subAccountType	UNDEFINED CUSTOMER PROVIDER BANK CASH CHARGE REVENUE CAPITAL FIXED_ASSET MANAGEMENT_RESULT DEPRECIATION_PROVISION STOCK RESULT_BALANCE_SHEET EMPLOYEE TITLE CURRENT_ASSETS BORROWED_CAPITAL COST REDUCTION_IN_EXPENSES NEUTRAL_REVENUE NEUTRAL_EXPENSES SALES_DEDUCTION EXCHANGE_RATE_INCOME EXCHANGE_RATE_EXPENSE BALANCE_CARRIED_FORWARD AGGREGATE_CARRIED_FORWARD OTHER_BALANCE_SHEET_ACCOUNT STATISTICAL_BALANCE STATISTICAL_CONSUMPTION CURRENT_ASSETS_INPUT_TAX BORROWED_CAPITAL_OUTPUT_TAX CUSTOMER_PREPAYMENT SUPPLIER_PREPAYMENT CUSTOMER_PREPAYMENT_TAX_INCLUDED SUPPLIER_PREPAYMENT_TAX_INCLUDED INPUT_TAX OUTPUT_TAX SUPPLIER_RETURNABLE_PACKAGING CUSTOMER_RETURNABLE_PACKAGING	Nature of account See InfoAdditional information is available in the Info block below
accountType	UNDEFINED BALANCE_SHEET INCOME_STATEMENT SPECIAL ECPN STATISTICAL	Category See InfoAdditional information is available in the Info block below
yearEndClosingAccount DATALOADERUtilize the DATALOADER feature to enrich your query by adding additional resource fields directly in the query.	AccountingAccount	Fields of AccountingAccount
yearEndClosingAccountId	UUID	yearEndClosingAccount See InfoAdditional information is available in the Info block below
taxTreatment DATALOADERUtilize the DATALOADER feature to enrich your query by adding additional resource fields directly in the query.	TaxTreatment (infos related to tax Code)	Fields of TaxTreatment
taxTreatmentId	UUID	Tax Treatment id See InfoAdditional information is available in the Info block below

Info

code: This explanation pertains to accounts where the accountLevel is Subaccount. Refer to accountLevel for the structure of other account types.
- Length: Variable, between 4 and 13 alphanumeric characters
- Initial characters: First 3 must be numeric
- Examples: 4110000, 411DUPONT, 445662000, 445663, 6010
- Length: Is composed of a fixed length between 5 and 13 digits
- Example: 572000000, 606000000
- Length: Exactly 4 digits
- Example: 1530, 3010
deactivated: Deactivating an accounting account means that the account is not available for generate new accounting entries. But it will still be displayed in all the information that has been generated using that account.
accountLevel:
- Group: Unused (For Spain only).
- Subgroup: Unused (For Spain only).
- Account: Unused (For Spain only).
- Breakdown: Unused (For Spain only).
- Subaccount: Accounting account of Detail. See code for account number structure rules.
  Only Subaccount accounts can be used in accounting entries.
- Total: Used for the balance guides. From 1 to 3 digits.
- Group: Accounting account of Total. Only 1 digit is allowed. Represents an element of the organization’s financial statement
- Subgroup: Accounting account of Total. Is composed of 2 digits. It’s a division of the financial statement element.
- Account: Accounting account of Total. Is composed of 3 digits. These are the accounts defined according to each country’s chart of accounts.
- Breakdown: Accounting account of Total. Is composed of 4 digits. It’s a division of the Account.
- Subaccount: Accounting account of Detail. Is composed of a fixed length between 5 and 13 digits.
  Only Subaccount accounts can be used in accounting entries.
- Total: Unused (For France only).
- Group: Unused (For Spain only).
- Subgroup: Unused (For Spain only).
- Account: Unused (For Spain only).
- Breakdown: Unused (For Spain only).
- Subaccount: Accounting account. Is composed of 4 digits.
  Only Subaccount accounts can be used in accounting entries.
- Total: Unused (For France only).
subAccountType : only used if accountLevel is set to SUB_ACCOUNT.
Only these values can be used:
- UNDEFINED
- CUSTOMER
- PROVIDER
- BANK
- CASH
- CHARGE
- REVENUE
- CAPITAL
- FIXED_ASSET
- MANAGEMENT_RESULT
- DEPRECIATION_PROVISION
- STOCK
- RESULT_BALANCE_SHEET
- EMPLOYEE
- TITLE
- CUSTOMER_PREPAYMENT_TAX_INCLUDED
- SUPPLIER_PREPAYMENT_TAX_INCLUDED
- INPUT_TAX
- OUTPUT_TAX
Only these values can be used:
- UNDEFINED
- CUSTOMER
- PROVIDER
- BANK
- CASH
- CHARGE
- REVENUE
- CAPITAL
- FIXED_ASSET
- EMPLOYEE
- CUSTOMER_RETURNABLE_PACKAGING
- SUPPLIER_RETURNABLE_PACKAGING
- INPUT_TAX
- OUTPUT_TAX
Only these values can be used:
- UNDEFINED
- CUSTOMER
- PROVIDER
- BANK
- CASH
- CHARGE
- REVENUE
- CAPITAL
- FIXED_ASSET
- MANAGEMENT_RESULT
- EMPLOYEE
- CURRENT_ASSETS
- BORROWED_CAPITAL
- COST
- REDUCTION_IN_EXPENSES
- NEUTRAL_REVENUE
- NEUTRAL_EXPENSES
- SALES_DEDUCTION
- EXCHANGE_RATE_INCOME
- EXCHANGE_RATE_EXPENSE
- BALANCE_CARRIED_FORWARD
- AGGREGATE_CARRIED_FORWARD
- OTHER_BALANCE_SHEET_ACCOUNT
- STATISTICAL_BALANCE
- STATISTICAL_CONSUMPTION
- CURRENT_ASSETS_INPUT_TAX
- BORROWED_CAPITAL_OUTPUT_TAX
- CUSTOMER_PREPAYMENT
- SUPPLIER_PREPAYMENT
accountType:
- Balance sheet: account classes 1 to 5
- Income statement : account classes 6 and 7
- Special : account classes 8 and 9
- ~~E.C.P.N~~ : Unused (For Spain only).
- ~~Statistical~~ : Unused (For Germany only).
- Balance sheet: account classes 1 to 5
- Income statement : account classes 6 and 7
- ~~Special~~ :Unused (For France only).
- E.C.P.N : Financial statements in net worth classes 8 and 9
- ~~Statistical~~ : Unused (For Germany only).
- Balance sheet: account classes 0, 1, 7, 3970, 3980
- Income statement : account classes 2, 3, 4, 5, 6, 8 (except 3970 & 3980)
- ~~Special~~ :Unused (For France only).
- ~~E.C.P.N~~ : Unused (For Spain only).
- Statistical : account classe 9.
yearEndClosingAccountId:

Unused (For Spain only).

Use only when accountType is E.C.P.N.

Unused (For Spain only).

taxTreatmentId : taxTreatment is named tax Code in the Chart of Accounts Interface

Delete restrictions

For an account to be deleted, you must not:

that accounting entries are using this account
that it is used as the main account of a third
that it is attached to a journal

Description

Header

accountingAccounts

Info

Delete restrictions