Error

A valid request URL is required to generate request examples

{
  "id": "store-rivoli",
  "name": "Boutique Rivoli",
  "city": "Paris 1er",
  "region": "Île-de-France",
  "active": false
}

{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "<string>",
    "statusCode": 123,
    "fieldErrors": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

Network

Deactivate (close) a store

Soft-closes a store by flipping its active flag to false — never a physical delete (historic sales, transfers and fiscal reports still reference it), so the store still reads back as inactive and can be reopened with an update. This is the safe way to take a location out of the trading network: a closed store must not be routed sales or transfers, and tills, transfers and reporting all read the flag. Idempotent: deactivating an already-closed store is a no-op that returns it unchanged. 404s for an unknown store. PERMISSION TRAP (see solya-pos#950): the route guard accepts pos.settings.manage, but the use-case additionally asserts the kernel config:manage permission and NO pos.settings.* scope maps to it, so a principal authenticated by scopes alone clears the guard and then 403s inside the use-case.

POST

stores

{storeId}

deactivate

Error

A valid request URL is required to generate request examples

{
  "id": "store-rivoli",
  "name": "Boutique Rivoli",
  "city": "Paris 1er",
  "region": "Île-de-France",
  "active": false
}

{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "<string>",
    "statusCode": 123,
    "fieldErrors": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

Authorizations

Authorization

string

header

required

Authorization: Bearer <token>. Accepts EITHER a Keycloak access token (scopes-in-token) OR an opaque POS session token; both resolve to the same pos.* scope vocabulary the route guards enforce.

Path Parameters

storeId

string

required

Minimum string length: 1

Response

The closed store directory record (active: false).

string

required

Minimum string length: 1

name

string

required

Minimum string length: 1

city

string

required

Minimum string length: 1

region

string

required

Minimum string length: 1

active

boolean

required

Update a store List finance entries

Ventes & encaissement

Catalogue & stock

Finance

Clients & fidélité

Marketing & promotions

Services

Système

Other

Deactivate (close) a store

Authorizations

Path Parameters

Response