Error

A valid request URL is required to generate request examples

{
  "job_id": "b3f1c2a4-0e5d-4c7a-9b2e-1f6a8d3c5e70",
  "status": "queued",
  "status_url": "/jobs/b3f1c2a4-0e5d-4c7a-9b2e-1f6a8d3c5e70"
}

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

Catalog

Upload a supplier PDF catalogue for extraction

Uploads a supplier catalogue PDF and proxies it to the enrichment extraction service, returning the accepted job (202) — poll GET /catalog/imports/{jobId} for the proposed products. The request body is either the raw PDF bytes with Content-Type: application/pdf (max 10 MiB; the file’s filename and an optional supplierHint ride as query params), OR multipart/form-data with a file part plus an optional context field (the centrale’s taxonomy / brands / catalogue index, driving reconcile + classify) and a supplier_hint field. This extracts + proposes products for HUMAN REVIEW in the centrale; nothing is written to the catalogue by this call. WHY avoid for an agent: it needs a binary file upload a human performs from the back-office.

POST

catalog

imports

Error

A valid request URL is required to generate request examples

{
  "job_id": "b3f1c2a4-0e5d-4c7a-9b2e-1f6a8d3c5e70",
  "status": "queued",
  "status_url": "/jobs/b3f1c2a4-0e5d-4c7a-9b2e-1f6a8d3c5e70"
}

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

Query Parameters

filename

string

supplierHint

string

Response

The PDF was accepted and enqueued; poll the returned job id.

job_id

string

required

Minimum string length: 1

status

enum<string>

required

Available options:

queued,

running,

succeeded,

failed

status_url

string

required

Minimum string length: 1

Enrich a single brand or product synchronously Poll a catalogue-import job's status and proposed products

Ventes & encaissement

Catalogue & stock

Finance

Clients & fidélité

Marketing & promotions

Services

Système

Other

Upload a supplier PDF catalogue for extraction

Authorizations

Query Parameters

Response