AccountingConfigs

AccountingConfigs

List accounting configs entries

get
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs

Lists all accounting configs entries belonging to the supplied store

Authorizations
AuthorizationstringRequired

Token received from the auth service

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
Query parameters
pageNumberintegerOptional

Reference to a specific page in a result set.

pageSizeintegerOptional

The number of items per page in a result set.

sortBystringOptional

Defines which field the resource list is sorted by.

sortDirectionstring · enumOptional
ENUM Description
ASC Sort in ascending order
DESC Sort in descending order
Possible values:
Responses
chevron-right
200

Response containing a list of accounting configs entries

application/json
get
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs
200

Response containing a list of accounting configs entries

Create a new accounting configs entry

post
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs

This endpoint is mostly legacy, and for internal use. We recommend to use the other endpoints to manage accounting information

Creates a new accounting config entry for the supplied store

For configType ACCOUNTNUMBER is the following keys valid:

Key
Description

CUSTOMER

Account for customer

CUSTOMERDUMMY

Dummy customer account

ERROR

Error account, if no valid account is found

PARTYLYPAIDINVOICE

Account for partyly paid invoices

VATCODE

Account for a specific tax type

CASHFLOAT_DEPOSIT

Deposit cash float into the cash register

CASHFLOAT_WITHDRAWAL

Withdraw cash float from the cash register

CASHFLOAT_TO_BANK

Withdraw cash float and transfer it to the bank

CASHFLOAT_EXPENSE_WITHDRAWAL

Withdraw cash float for expenses throughout the day.

For configType TREATCODE is the following keys valid:

Key
Description

CREDITLEDGER

Used to credit notes

GENERALLEDGER

Used for general ledger

LEDGE

Used for invoices and other ledger

PAYMENT

Used for payment of invoices

For configType VAT_TYPE_ID is the following keys valid:

Key
Description

BALANCE

VATCODE

Should have a vatCodeUid filled together with the TypeID for the specific VAT code

"

Required permissions: ACCOUNTING_CONFIG

Authorizations
AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
Body

Accounting configs model

vatCodeUid should always be filled when key is of type VATCODE

accountingConfigUidstringOptionalPattern: ^[A-Za-z0-9-_]+
configTypestring · enumRequiredPossible values:
keystring · enumRequiredPossible values:
valuestringRequired
vatCodeUidstringOptionalPattern: ^[A-Za-z0-9-_]+
Responses
post
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs
201Success

Get accounting configs entry

get
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/{accountingConfigUid}

Get accounting configs entry for the supplied accountingConfigsUid

Authorizations
AuthorizationstringRequired

Token received from the auth service

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
accountingConfigUidstringRequired

Reference to a Accounting Configs entry.

Pattern: ^[A-Za-z0-9-_]+
Responses
chevron-right
200

Response body containing a accounting config entry

get
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/{accountingConfigUid}
200

Response body containing a accounting config entry

Update accounting config entry

put
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/{accountingConfigUid}

Updates the accounting configs entry belonging to the supplied accountingConfigsUid

Required permissions: ACCOUNTING_CONFIG

Authorizations
AuthorizationstringRequired

Token received from the auth service

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
accountingConfigUidstringRequired

Reference to a Accounting Configs entry.

Pattern: ^[A-Za-z0-9-_]+
Body
valuestringRequired
Responses
chevron-right
200

Response body containing a accounting config entry

put
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/{accountingConfigUid}
200

Response body containing a accounting config entry

Delete accounting config entry

delete
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/{accountingConfigUid}

Deletes the accounting configs entry belonging the supplied accountingConfigsUid

Required permissions: ACCOUNTING_CONFIG

Authorizations
AuthorizationstringRequired

Token received from the auth service

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
accountingConfigUidstringRequired

Reference to a Accounting Configs entry.

Pattern: ^[A-Za-z0-9-_]+
Responses
delete
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/{accountingConfigUid}
204Success

No content

Deprecated

Create a new productgroup account mapping

post
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/productGroup

DEPRECATED use /tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/productGroups instead

Add a account number to a specific product group. This account number will be used for all products with the specified vatcode in the specific product group and all children

Required permissions: ACCOUNTING_CONFIG

Authorizations
AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
Body

Create a new account mapping to a product group

accountingConfigUidstringOptionalPattern: ^[A-Za-z0-9-_]+
valuestringRequired

accountNumber

vatCodeUidstringRequiredPattern: ^[A-Za-z0-9-_]+
productGroupUidstringRequiredPattern: ^[A-Za-z0-9-_]+
Responses
post
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/productGroup
201

Response body containing a accounting config entry

List all productgroups with accounting information

get
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/productGroups

List all product groups with account number specified

Required permissions: ACCOUNTING_CONFIG

Authorizations
AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
Query parameters
pageSizeintegerOptional

The number of items per page in a result set.

pageNumberintegerOptional

Reference to a specific page in a result set.

Responses
chevron-right
200

Example response

application/json
get
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/productGroups
200

Example response

Create a new productgroup account mapping

post
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/productGroups

Add a account number to a specific product group. This account number will be used for all products with the specified vatcode in the specific product group and all children

Required permissions: ACCOUNTING_CONFIG

Authorizations
AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
Body

Create a new account mapping to a product group

accountingConfigUidstringOptionalPattern: ^[A-Za-z0-9-_]+
accountstringRequired

accountNumber

vatCodeUidstringRequiredPattern: ^[A-Za-z0-9-_]+
productGroupUidstringRequiredPattern: ^[A-Za-z0-9-_]+
Responses
post
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/productGroups
201Success

Get all account number information

get
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/accountnumbers

Get all account number information

Authorizations
AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
Responses
chevron-right
200

Example response

application/json
get
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/accountnumbers
200

Example response

Update account number information

put
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/accountnumbers

Update account number information for a store

Required permissions: ACCOUNTING_CONFIG

Authorizations
AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
Body

Accounting configs model

customerstringOptional

Account for customers

customerDummystringOptional
errorstringOptional

Error account, used if no valid account is found

partlyPaidInvoicestringOptional

Interim account for partly paid invoices.

cashfloatDepositstringOptional

Deposit cash float into the cash register

cashfloatWithdrawalstringOptional

Withdraw cash float from the cash register

cashfloatToBankstringOptional

Withdraw cash float and transfer it to the bank

cashfloatExpenseWithdrawalstringOptional

Withdraw cash float for expenses throughout the day

Responses
chevron-right
200

Example response

application/json
put
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/accountnumbers
200

Example response

Get all treat codes

get
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/treatcodes

Get all treat codes

Authorizations
AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
Responses
chevron-right
200

Example response

application/json
get
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/treatcodes
200

Example response

Update treat codes

put
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/treatcodes

Update accounting treat codes for a store

Required permissions: ACCOUNTING_CONFIG

Authorizations
AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
Body

Treat codes

creditLedgerstringOptional

Used for credit notes

generalLedgerstringOptional

Used for general ledger

ledgerstringOptional

Used for invoices and other ledgers

paymentstringOptional

Used for payment of invoices

Responses
chevron-right
200

Example response

application/json
put
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/treatcodes
200

Example response

Get all VAT types

get
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/vatTypes

Get all VAT type

Authorizations
AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
Responses
chevron-right
200

Example response

application/json
get
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/vatTypes
200

Example response

Update VAT types

put
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/vatTypes

Update accounting VAT type for a store

Required permissions: ACCOUNTING_CONFIG

Authorizations
AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
Body

Treat codes

balancestringOptional

VAT type used for balance transactions

Responses
chevron-right
200

Example response

application/json
put
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/vatTypes
200

Example response

Customer information with accounting settings

get
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/customers/{customerUid}

Get customer information including store specific accounting information

Authorizations
AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
customerUidstringRequired

Reference to a Customer.

Pattern: ^[A-Za-z0-9-_]+
Responses
chevron-right
200Success
application/json
get
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/customers/{customerUid}
200Success

Update customer ledger information

put
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/customers/{customerUid}

Update customer with store specific accounting information.

Required permissions: ACCOUNTING_CONFIG

Authorizations
AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
customerUidstringRequired

Reference to a Customer.

Pattern: ^[A-Za-z0-9-_]+
Body
ledgerNumberstringRequired

Ledger number for the customer on the specific store

Responses
chevron-right
200Success
application/json
put
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/customers/{customerUid}
200Success

Customer information with accounting settings

get
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/customers/{customerUid}/full

Get full customer information including store specific accounting information

Authorizations
AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
customerUidstringRequired

Reference to a Customer.

Pattern: ^[A-Za-z0-9-_]+
Responses
chevron-right
200

Example response

application/json
get
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/customers/{customerUid}/full
200

Example response

Last updated