Heads up, our devs are blazing ahead—docs are catching up, so some features might not be fully documented yet.

AccountingConfigs

AccountingConfigs

List accounting configs entries

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

Lists all accounting configs entries belonging to the supplied store

Authorizations
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
200

Response containing a list of accounting configs entries

application/json
get
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs
GET /v2/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

Response containing a list of accounting configs entries

{
  "items": [
    {
      "accountingConfigsUid": "text",
      "configType": "ACCOUNTNUMBER",
      "key": "CUSTOMER",
      "value": "text",
      "vatCodeUid": "text",
      "productGroupUid": "text"
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

Create a new accounting configs entry

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

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

For configType TREATCODE is the following keys valid:

Key
Description

CREDITLEDGER

GENERALLEDGER

LEDGE

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

Authorizations
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
201Success
application/json
post
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs
POST /v2/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 111

{
  "accountingConfigUid": "text",
  "configType": "ACCOUNTNUMBER",
  "key": "CUSTOMER",
  "value": "text",
  "vatCodeUid": "text"
}
201Success
{
  "accountingConfigsUid": "text",
  "configType": "ACCOUNTNUMBER",
  "key": "CUSTOMER",
  "vatCodeUid": "text",
  "value": "text"
}

Get accounting configs entry

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

Get accounting configs entry for the supplied accountingConfigsUid

Authorizations
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
200

Response body containing a accounting config entry

get
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/{accountingConfigUid}
GET /v2/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/{accountingConfigUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

Response body containing a accounting config entry

{
  "accountingConfigsUid": "text",
  "configType": "ACCOUNTNUMBER",
  "key": "CUSTOMER",
  "value": "text",
  "vatCodeUid": "text",
  "productGroupUid": "text"
}

Update accounting config entry

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

Updates the accounting configs entry belonging to the supplied accountingConfigsUid

Authorizations
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
200

Response body containing a accounting config entry

put
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/{accountingConfigUid}
PUT /v2/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/{accountingConfigUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "value": "text"
}
200

Response body containing a accounting config entry

{
  "accountingConfigsUid": "text",
  "configType": "ACCOUNTNUMBER",
  "key": "CUSTOMER",
  "value": "text",
  "vatCodeUid": "text",
  "productGroupUid": "text"
}

Delete accounting config entry

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

Deletes the accounting configs entry belonging the supplied accountingConfigsUid

Authorizations
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
204Success

No content

delete
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/{accountingConfigUid}
DELETE /v2/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/{accountingConfigUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
204Success

No content

Create a new productgroup account mapping

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

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

Authorizations
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
201

Response body containing a accounting config entry

post
/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/productGroup
POST /v2/tenants/{tenantUid}/stores/{storeUid}/accountingConfigs/productGroup HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 90

{
  "accountingConfigUid": "text",
  "value": "text",
  "vatCodeUid": "text",
  "productGroupUid": "text"
}
201

Response body containing a accounting config entry

{
  "accountingConfigsUid": "text",
  "configType": "ACCOUNTNUMBER",
  "key": "CUSTOMER",
  "value": "text",
  "vatCodeUid": "text",
  "productGroupUid": "text"
}

Was this helpful?