Error

A valid request URL is required to generate request examples

[
  {
    "id": "rep-2030-000471",
    "article": {
      "label": "Smartphone screen",
      "skuId": "d4c81e5b0f7a396248ce15b7d0a83f62915ce4d7b0863af251d94c7e08b3f6a1",
      "purchasedAt": "2029-01-16T09:00:00.000Z"
    },
    "issueDescription": "Cracked screen after a drop",
    "quoteAmountCents": 12000,
    "depositAmountCents": 3600,
    "expectedPickupDate": "2030-07-20T18:00:00.000Z",
    "customerId": "cust-1",
    "storeId": "shop-1",
    "status": "intake",
    "actorId": "user-associate-1",
    "createdAt": "2030-07-10T14:05:00.000Z",
    "updatedAt": "2030-07-10T14:05:00.000Z"
  }
]

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

Repairs

List repair orders

Returns the repair board as a flat array, NEWEST-CREATED FIRST, with no pagination — every matching order is in one reply. Reach for this to answer ‘what is in the workshop’, ‘what is waiting to be collected’ or to FIND an order id; when you already hold an id use getRepairOrder. Narrow with status — intake (taken in, not yet sent through), in_workshop (being worked on), ready (repaired, awaiting pickup), collected (terminal, handed back) or unrepairable (terminal, written off) — and with store (the store the article was dropped at). WARNING: omitting store returns orders from EVERY store, not just the caller’s; pass it unless you really want the estate-wide board. expectedPickupDate is a PROMISE, not a status: an order past its date is still ready/in_workshop, so compare it yourself to find late jobs. No match is an empty array (200), never a 404.

GET

repairs

Error

A valid request URL is required to generate request examples

[
  {
    "id": "rep-2030-000471",
    "article": {
      "label": "Smartphone screen",
      "skuId": "d4c81e5b0f7a396248ce15b7d0a83f62915ce4d7b0863af251d94c7e08b3f6a1",
      "purchasedAt": "2029-01-16T09:00:00.000Z"
    },
    "issueDescription": "Cracked screen after a drop",
    "quoteAmountCents": 12000,
    "depositAmountCents": 3600,
    "expectedPickupDate": "2030-07-20T18:00:00.000Z",
    "customerId": "cust-1",
    "storeId": "shop-1",
    "status": "intake",
    "actorId": "user-associate-1",
    "createdAt": "2030-07-10T14:05:00.000Z",
    "updatedAt": "2030-07-10T14:05:00.000Z"
  }
]

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

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.

Query Parameters

store

string

Minimum string length: 1

status

enum<string>

Available options:

intake,

in_workshop,

ready,

collected,

unrepairable

Response

The matching repair orders, newest-created first (empty array when none).

string

required

article

object

required

Show child attributes

issueDescription

string

required

quoteAmountCents

integer

required

Required range: -9007199254740991 <= x <= 9007199254740991

depositAmountCents

integer

required

Required range: -9007199254740991 <= x <= 9007199254740991

expectedPickupDate

string

required

customerId

string

required

storeId

string

required

status

enum<string>

required

Available options:

intake,

in_workshop,

ready,

collected,

unrepairable

actorId

string

required

createdAt

string

required

updatedAt

string

required

Example:

[
  {
    "id": "rep-2030-000471",
    "article": {
      "label": "Smartphone screen",
      "skuId": "d4c81e5b0f7a396248ce15b7d0a83f62915ce4d7b0863af251d94c7e08b3f6a1",
      "purchasedAt": "2029-01-16T09:00:00.000Z"
    },
    "issueDescription": "Cracked screen after a drop",
    "quoteAmountCents": 12000,
    "depositAmountCents": 3600,
    "expectedPickupDate": "2030-07-20T18:00:00.000Z",
    "customerId": "cust-1",
    "storeId": "shop-1",
    "status": "intake",
    "actorId": "user-associate-1",
    "createdAt": "2030-07-10T14:05:00.000Z",
    "updatedAt": "2030-07-10T14:05:00.000Z"
  }
]

Return a rental and settle the caution Take an article in for repair

Ventes & encaissement

Catalogue & stock

Finance

Clients & fidélité

Marketing & promotions

Services

Système

Other

List repair orders

Authorizations

Query Parameters

Response