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": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}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 is reopened with POST /stores/{storeId}/reactivate. Reopening is NOT possible through PUT /stores/{storeId}: the update payload no longer carries active, so closing and reopening travel through this guarded, separately audited pair alone. 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.
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": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}Authorizations
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
1Response
The closed store directory record (active: false).