OfficeGest
Stocks/Articles/{article}/Suppliers

List article suppliers

Returns suppliers associated with this article. Shows supplier codes, prices, lead times, and other purchasing information. An article can have multiple suppliers with different pricing and conditions.

GET
/stocks/articles/{article}/suppliers
AuthorizationBearer <token>

In: header

Path Parameters

articlestring

Query Parameters

supplier_id?stringDeprecated

Filter by supplier ID (supports operators: eq, like, sw, ew)

supplier_name?stringDeprecated

Filter by supplier name (supports operators: eq, like, sw, ew)

supplier_number_id?stringDeprecated

Filter by supplier number ID (supports operators: eq, like, sw, ew)

price?numberDeprecated

Filter by price (supports operators: eq, gte, lte)

discount1?numberDeprecated

Filter by discount level 1 (supports operators: eq, gte, lte)

discount2?numberDeprecated

Filter by discount level 2 (supports operators: eq, gte, lte)

discount3?numberDeprecated

Filter by discount level 3 (supports operators: eq, gte, lte)

discount4?numberDeprecated

Filter by discount level 4 (supports operators: eq, gte, lte)

discount5?numberDeprecated

Filter by discount level 5 (supports operators: eq, gte, lte)

preferential?boolean

Filter by preferential supplier flag

filter[supplier_id][operator]?string

Operators: eq, like, sw, ew. Example: filter[supplier_id][eq]=value

filter[supplier_name][operator]?string

Operators: eq, like, sw, ew. Example: filter[supplier_name][eq]=value

filter[supplier_number_id][operator]?string

Operators: eq, like, sw, ew. Example: filter[supplier_number_id][eq]=value

filter[price][operator]?number

Operators: eq, gte, lte. Example: filter[price][eq]=value

filter[discount1][operator]?number

Operators: eq, gte, lte. Example: filter[discount1][eq]=value

filter[discount2][operator]?number

Operators: eq, gte, lte. Example: filter[discount2][eq]=value

filter[discount3][operator]?number

Operators: eq, gte, lte. Example: filter[discount3][eq]=value

filter[discount4][operator]?number

Operators: eq, gte, lte. Example: filter[discount4][eq]=value

filter[discount5][operator]?number

Operators: eq, gte, lte. Example: filter[discount5][eq]=value

filter?object

Advanced filter as JSON object with field => operator => value

Empty Object

page?integer

Page number. Default 1; a value below 1 counts as 1.

Default1
Range1 <= value
limit?integer

Items per page. Default 50, maximum 250; a larger value is truncated to 250.

Default50
Range1 <= value <= 250

Response Body

curl -X GET "https://og-tenant1.test:8003/api/v2/stocks/articles/string/suppliers?supplier_id=string&supplier_name=string&supplier_number_id=string&price=0&discount1=0&discount2=0&discount3=0&discount4=0&discount5=0&preferential=true&filter%5Bsupplier_id%5D%5Boperator%5D=string&filter%5Bsupplier_name%5D%5Boperator%5D=string&filter%5Bsupplier_number_id%5D%5Boperator%5D=string&filter%5Bprice%5D%5Boperator%5D=0&filter%5Bdiscount1%5D%5Boperator%5D=0&filter%5Bdiscount2%5D%5Boperator%5D=0&filter%5Bdiscount3%5D%5Boperator%5D=0&filter%5Bdiscount4%5D%5Boperator%5D=0&filter%5Bdiscount5%5D%5Boperator%5D=0&page=1&limit=50"
{
  "data": [
    {
      "supplier_id": 0,
      "supplier_name": "string",
      "preferential": true,
      "supplier_number_id": "string",
      "price": 0,
      "discount1": 0,
      "discount2": 0,
      "discount3": 0,
      "discount4": 0,
      "discount5": 0
    }
  ],
  "meta": {
    "per_page": 50,
    "current_page": 1,
    "has_more": true,
    "total": 120,
    "last_page": 3,
    "from": 1,
    "to": 50
  }
}
{
  "data": {
    "code": "VALIDATION_FAILED",
    "message": "The given data was invalid.",
    "errors": {
      "email": [
        "The email field is required."
      ]
    }
  },
  "meta": {
    "trace_id": "9f86d081884c7d659a2feaa0c55ad01568f3a1c2b4d5e"
  }
}
{
  "data": {
    "code": "VALIDATION_FAILED",
    "message": "The given data was invalid.",
    "errors": {
      "email": [
        "The email field is required."
      ]
    }
  },
  "meta": {
    "trace_id": "9f86d081884c7d659a2feaa0c55ad01568f3a1c2b4d5e"
  }
}
{
  "data": {
    "code": "VALIDATION_FAILED",
    "message": "The given data was invalid.",
    "errors": {
      "email": [
        "The email field is required."
      ]
    }
  },
  "meta": {
    "trace_id": "9f86d081884c7d659a2feaa0c55ad01568f3a1c2b4d5e"
  }
}
{
  "data": {
    "code": "VALIDATION_FAILED",
    "message": "The given data was invalid.",
    "errors": {
      "email": [
        "The email field is required."
      ]
    }
  },
  "meta": {
    "trace_id": "9f86d081884c7d659a2feaa0c55ad01568f3a1c2b4d5e"
  }
}