> ## Documentation Index > Fetch the complete documentation index at: https://developers.gojoe.de/llms.txt > Use this file to discover all available pages before exploring further. # Update one article > Real-time change for one article, e.g. stock after a counter sale. Fields you leave out keep their last pushed value (`name` and `available` are needed the first time an article is sent). ## OpenAPI ````yaml /openapi.yaml patch /pharmacies/{pharmacy_id}/inventory/{pharmacy_sku} openapi: 3.1.0 info: title: GO JOE Pharmacy API version: 1.0.0-prototype summary: >- Receive GO JOE orders in your ERP, report back what happens to them, and keep GO JOE's stock and prices current. description: > The GO JOE Pharmacy API lets a pharmacy (or the ERP of a pharmacy group) receive paid, doctor-approved GO JOE orders and report their progress. **How it works** 1. GO JOE sends a short, signed **webhook** (`order.created`) to your endpoint. 2. Your ERP **fetches the full order** with `GET /orders/{id}` and downloads the prescription with `GET /orders/{id}/prescription`. 3. You **accept** the order with your own order number (`POST /orders/{id}/accept`). 4. You **report progress**: `packed`, `ready_for_pickup`, `out_for_delivery`, `completed` (`POST /orders/{id}/status`). 5. Missed a webhook? Everything is also in the **event feed** (`GET /events`), which you can replay from your last cursor. 6. Keep **stock and prices** current with `PUT /pharmacies/{pharmacy_id}/inventory` (whole catalogue or changed rows) and `PATCH …/inventory/{pharmacy_sku}` (one article). **Prescriptions come in two stages.** An order appears as soon as the *Vorab-Rezept* exists (`prescription.stage = vorab`). When the doctor's qualified electronic signature (QES) is done you receive `order.prescription_signed`; download the document again and file the signed version in place of the Vorab-Rezept. **Conventions:** JSON, UTF-8, timestamps in ISO-8601 UTC, money in integer cents (EUR, gross), quantities in g (flower) or ml (extracts). Ignore fields you don't know: new fields can appear at any time without a version change. Errors are `application/problem+json` with a stable `code`. contact: name: GO JOE Integrations email: support@gojoe.de servers: - url: https://gojoe.de/api/pharm/v1 description: Production (live keys, gj_live_…) - url: https://sandbox-api.gojoe.de/api/pharm/v1 description: Sandbox (test keys, gj_test_…; fake orders and MUSTER prescriptions only) security: - apiKey: [] tags: - name: Account - name: Orders - name: Events - name: Inventory - name: Webhooks description: What GO JOE sends to your webhook URL. - name: Sandbox description: >- Simulator endpoints. They exist on the sandbox only and answer 404 on production. paths: /pharmacies/{pharmacy_id}/inventory/{pharmacy_sku}: parameters: - $ref: '#/components/parameters/PharmacyId' - name: pharmacy_sku in: path required: true schema: type: string minLength: 1 maxLength: 64 - $ref: '#/components/parameters/IdempotencyKey' patch: tags: - Inventory summary: Update one article description: | Real-time change for one article, e.g. stock after a counter sale. Fields you leave out keep their last pushed value (`name` and `available` are needed the first time an article is sent). operationId: patchInventoryItem requestBody: required: true content: application/json: schema: type: object properties: name: type: string maxLength: 200 available: type: boolean stock_grams: type: number minimum: 0 price_cents: type: integer minimum: 1 min_order_grams: type: integer minimum: 1 order_increment: type: integer minimum: 1 responses: '200': description: What happened to the article content: application/json: schema: allOf: - $ref: '#/components/schemas/InventoryResultRow' - type: object properties: prices_applied: type: boolean '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/PharmacyNotFound' '422': $ref: '#/components/responses/InvalidItems' '429': $ref: '#/components/responses/RateLimited' components: parameters: PharmacyId: name: pharmacy_id in: path required: true description: A pharmacy your key acts for (see `GET /me`). schema: type: string format: uuid IdempotencyKey: name: Idempotency-Key in: header required: false description: >- Any unique string. Retrying with the same key within 24 h returns the first response without running the request again. schema: type: string maxLength: 255 schemas: InventoryResultRow: type: object required: - pharmacy_sku - status - warnings properties: pharmacy_sku: type: string status: type: string enum: - updated - unmapped - kept_off description: | `updated`: applied. `unmapped`: GO JOE has not mapped this number yet; stored and shown to GO JOE's team. `kept_off`: stock and price applied, but GO JOE's team has the product off sale. product_id: type: - string - 'null' format: uuid warnings: type: array items: type: object properties: code: type: string enum: - price_change_large detail: type: string old_price_cents: type: integer new_price_cents: type: integer Problem: type: object required: - status - code - detail - request_id properties: type: type: string format: uri title: type: string status: type: integer code: type: string example: invalid_transition description: > Stable error code, e.g. `unauthorized`, `wrong_environment`, `insufficient_scope`, `rate_limited`, `order_not_found`, `not_accepted`, `already_accepted`, `invalid_transition`, `courier_managed_by_gojoe`, `order_cancelled`, `order_rejected`, `idempotency_key_reused`. detail: type: string request_id: type: string description: Quote this to GO JOE support. responses: Unauthorized: description: Missing, unknown or revoked key, or a key for the other environment content: application/problem+json: schema: $ref: '#/components/schemas/Problem' Forbidden: description: The key lacks the scope this call needs (`insufficient_scope`) content: application/problem+json: schema: $ref: '#/components/schemas/Problem' PharmacyNotFound: description: No such pharmacy for this key (also for pharmacies of other accounts) content: application/problem+json: schema: $ref: '#/components/schemas/Problem' InvalidItems: description: At least one item is invalid; nothing was applied content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/Problem' - type: object properties: errors: type: array description: Up to 100 problems, each with the item's position. items: type: object properties: index: type: integer pharmacy_sku: type: - string - 'null' field: type: string detail: type: string RateLimited: description: More than the account's limit (default 120) requests per minute headers: Retry-After: schema: type: integer content: application/problem+json: schema: $ref: '#/components/schemas/Problem' securitySchemes: apiKey: type: http scheme: bearer description: '`Authorization: Bearer gj_live_…` (production) or `gj_test_…` (sandbox).' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.