Store Data InitialState API (0.2.0)

Download OpenAPI specification:Download

Initial State

initialstate

Request for initial state data for the specified store. It will request initial state from all services and send out the data. The normal flow is to delete all data and then re-add all the data collected from the API:s

Note: some of the subset entities does not do delete before adding data due to deep dependency contrains that would require a delete of many more entities. These subset can be seen as an update when you and update or add but NOT remove entities. The subset that do not do delete: item-categories, tax-groups and plulists

path Parameters
businessUnitGroupId
required
string
Example: store-42

The ID of the store or business unit group

query Parameters
application
string
Enum: "ERPOS" "CHECKOUT_ENGINE" "EDGE_CHECKOUT_ENGINE" "EXTERNAL_SYSTEM"
Example: application=/initialstate/{businessUnitGroupId}?application=ERPOS

The application that is requesting the initial state. If only one application is configured for the store, that application will be the default if this parameter is omitted. If several applications are configured for the store and this parameter is omitted, the response will be 400, Bad Request since the application cannot be determined.

externalSystemVendor
string [ 1 .. 60 ] characters
Example: externalSystemVendor=/initialstate/store-1?application=EXTERNAL_SYSTEM&externalSystemVendor=PRICER

The vendor ID for the external system. Currently, these values are supported: PRICER, EWQ, BIZERBA, DIGI, LTG, HDB

subset
string
Enum: "cashier-messages" "currencies" "items" "refresh-items" "item-categories" "massload-start-end" "non-items" "tax-groups" "tenders" "plulists" "promotions" "reason-codes"
Example: subset=/initialstate/{businessUnitGroupId}?subset=currencies

The subset of entities to include in the Initial state, all if left out. You may only provide one subset entity (multiple not allowed) Some subset contain multiple entities due to dependency and those are,

  • currencies - currencies, exchange rates and tenders.
  • items - item categories, items, price specifications, PLU lists
  • refresh-items - items, price specifications (no delete)
  • non-items - receipt layouts, cashier messages, currencies, exchange rates, reason codes, roles, operators, tax groups, tenders, item categories.
header Parameters
Correlation-Id
string [ 1 .. 255 ] characters
Example: f6261f22-fbf0-4c1c-88cd-619d2e8abf84

Provide a Correlation-Id to track the request and to be able to query the status endpoint with a known value.

Tenant-Id
string
Example: CI47AFC674711

Provide the Tenant-Id if it is not in the JWT (e.g. Workload Identity)

X-Proto-Version
string
Example: 1.0.0

The version of the schema

Responses

Response samples

Content type
application/json
{
  • "Tenant-Id": "CI47AFC674711",
  • "Correlation-Id": "ed9f25a2-d7b1-4d90-a6f0-9e32fc56aa81",
  • "businessUnitGroupId": "store-42",
  • "progress": "DONE",
  • "contributors": [
    ]
}

status

Returns the status of an initial state run that is finished or in progress.

path Parameters
correlationId
required
string

The Id of an Initial state run

Responses

Response samples

Content type
application/json
{
  • "Tenant-Id": "CI47AFC674711",
  • "Correlation-Id": "ed9f25a2-d7b1-4d90-a6f0-9e32fc56aa81",
  • "businessUnitGroupId": "store-42",
  • "progress": "DONE",
  • "contributors": [
    ]
}

Refresh

refresh-image-urls

Trigger refresh for a list of Image URL

path Parameters
businessUnitGroupId
required
string
Example: SWE4711

The destination of the messages

Request Body schema: application/json
Array
string [ 1 .. 256 ] characters

An image url

Responses

Request samples

Content type
application/json

Internal

health

Provides health information about the service

Responses

Response samples

Content type
application/json
"{\n \"dependencies\": [\n {\n \"id\": \"Google Datastore\",\n \"status\": \"Up\"\n }\n ],\n \"outcome\": \"Up\"\n}\n"