Error

A valid request URL is required to generate request examples

{
  "storeId": "store-rivoli",
  "legalEntityId": "le-solya",
  "establishmentNumber": "00074"
}

{
  "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
  }
}

Network

Attach a store to a company and set its establishment number

Sets which société a store trades under and its per-establishment number (FR: the NIC, the 5-digit half the SIRET is composed from). A store ALWAYS has a société — the column is NOT NULL and defaults to the « Société à compléter » placeholder — so this operation MOVES an attachment, it never creates one from nothing. establishmentNumber may be null, which is the explicit not-yet-known state; it is never invented. A non-null number is validated against the société’s registration number through the composed identifier’s check digit (FR: the SIRET’s Luhn), so a NIC that does not belong to that SIREN is a 400 with a field error. The body’s storeId is IGNORED — the path wins. 404s for an unknown société or an unprovisioned store.

PUT

companies

stores

{storeId}

Error

A valid request URL is required to generate request examples

{
  "storeId": "store-rivoli",
  "legalEntityId": "le-solya",
  "establishmentNumber": "00074"
}

{
  "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
  }
}

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

Body

application/json

storeId

string

required

Minimum string length: 1

legalEntityId

string

required

Minimum string length: 1

establishmentNumber

string | null

required

Minimum string length: 1

Response

The stored attachment.

storeId

string

required

Minimum string length: 1

legalEntityId

string

required

Minimum string length: 1

establishmentNumber

string | null

required

Minimum string length: 1

Create a company (société)Get a company with its identity history

Ventes & encaissement

Catalogue & stock

Finance

Clients & fidélité

Marketing & promotions

Services

Assistant

Intégrations & données

Système

Attach a store to a company and set its establishment number

Authorizations

Path Parameters

Body

Response