ConnectCloud Developers

Get a goods receipt (tenant:trade:purchasing:read)

GET /api/trade/v1/goods-receipts/{id}

Module: Trade · operationId: getGoodsReceipt · Tag: Procurement · Auth: access token (Authorization: Bearer <accessToken>)

Parameters

Name In Type Required Description
id path string (uuid) yes

Responses

  • 200 Goods receipt (application/json)
  • 401 No valid session or bearer token (no body).
  • 404 Not found in the tenant. (application/json)

Fields of the 200 answer:

  • createdAt (string (date-time)): When the goods receipt was created.
  • grNumber (string): Number of the goods receipt.
  • id (string (uuid)): Id of the goods receipt.
  • lines (array of object): Empty in lists.
    • description (string): Description of the line.
    • id (string (uuid)): Id of the line.
    • poLineId (string (uuid)): Id of the purchase order line.
    • position (integer): Position of the line.
    • receivedQty (number): Quantity received.
  • note (string): Free-text note.
  • poId (string (uuid)): Purchase order the goods were received for.
  • poNumber (string): Number of the purchase order.
  • receivedAt (string (date-time)): When the goods were received.
  • status (string): Status of the goods receipt (posted). (one of posted)

Example 200 answer:

{
  "createdAt": "2026-11-18T10:15:00Z",
  "grNumber": "WE-2026-00052",
  "id": "3d6e7f8a-9b0c-4d1e-8f2a-4b5c6d7e8f52",
  "lines": [
    {
      "description": "Netzwerkschrank 19 Zoll 12 HE",
      "id": "5f8a9b0c-1d2e-4f3a-8b4c-6d7e8f9a0b01",
      "poLineId": "2c5d6e7f-8a9b-4c0d-9e1f-3a4b5c6d7e01",
      "position": 1,
      "receivedQty": 1
    },
    {
      "description": "Verlegekabel Cat.7 Simplex, 100 m",
      "id": "5f8a9b0c-1d2e-4f3a-8b4c-6d7e8f9a0b02",
      "poLineId": "2c5d6e7f-8a9b-4c0d-9e1f-3a4b5c6d7e02",
      "position": 2,
      "receivedQty": 3
    }
  ],
  "note": "Lieferschein LS-778812 (Kabelwerk Süd GmbH), vollständig und unbeschädigt.",
  "poId": "1b4c5d6e-7f8a-4b9c-8d0e-2f3a4b5c6d68",
  "poNumber": "BE-2026-00068",
  "receivedAt": "2026-11-18T10:15:00Z",
  "status": "posted"
}

Example request

curl -X GET 'https://api.mbcom.cloud/api/trade/v1/goods-receipts/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

View as Markdown · Interactive reference · OpenAPI