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": "unrepairable",
  "actorId": "user-associate-1",
  "createdAt": "2030-07-10T14:05:00.000Z",
  "updatedAt": "2030-07-15T09:20: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
  }
}

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

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

Repairs

Declare a repair order unrepairable

TERMINAL, IRREVERSIBLE AND MONEY-BEARING — do not reach for this on your own judgement; call it only when a human has decided the article cannot be fixed. It flips the order to unrepairable from ANY non-terminal state, including ready, so a mistargeted call can write off a job that was already repaired and waiting at the counter, with no way back. Send no body. Declaring an order unrepairable OBLIGES the store to refund the whole acompte (depositAmountCents) — but this endpoint does NOT refund it and no other endpoint in this API does either; the refund is a separate till/terminal action a human must perform, so surface the amount rather than assuming it is handled. It also says nothing about what happens to the article itself. 422 only when the order is already terminal (collected or unrepairable); 404 for an unknown id. NOT IDEMPOTENT — there is no dedup key. A SEQUENTIAL replay cannot write the order off twice (the terminal-status guard rejects it), but that guard is an unsynchronised read-then-write with no row lock (solya-pos#956), so do not fan concurrent calls at one order. If your call times out RE-READ with getRepairOrder before retrying: an unrepairable status means the first attempt already committed, so do NOT refund the acompte a second time.

POST

repairs

{orderId}

unrepairable

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": "unrepairable",
  "actorId": "user-associate-1",
  "createdAt": "2030-07-10T14:05:00.000Z",
  "updatedAt": "2030-07-15T09:20: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
  }
}

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

orderId

string

required

Minimum string length: 1

Response

The written-off order: unrepairable, updatedAt re-stamped. The full 3600-cent acompte is now owed back to the customer.

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

Send a repair order to the workshop Resolve the authenticated actor's effective POS scopes (MCP gateway alias)

Ventes & encaissement

Catalogue & stock

Finance

Clients & fidélité

Marketing & promotions

Services

Système

Other

Declare a repair order unrepairable

Authorizations

Path Parameters

Response