Listings (Core)

Endpoints to create, update, and read facility listings.

List listings

get

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

facilityIdstringRequired

ID of facility you want to get listing for. Also accepts tenantFacilityId in urn format (e.g. urn:fft:facility:tenantFacilityId:{your-tenant-facility-id}).

Query parameters

startAfterIdstringOptional

all entities after given Id

sizeintegerOptional

number of facilities to show

Default: 25

tenantArticleIdsstring[] · max: 500Optional

Array of tenantArticleIds

scannableCodestringOptional

limit results to this scannableCode

Responses

200

Facility was found & you were allowed to access it. The results are in the body.

application/json

StrippedListings

totalintegerOptional

Total number of found entities for this query

Example: 42

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this endpoint

application/json

404

Facility not found

application/json

get/api/facilities/{facilityId}/listings

HTTPcURLJavaScriptPython

GET /api/facilities/{facilityId}/listings HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "listings": [
    {
      "created": "2020-02-03T08:45:51.525Z",
      "lastModified": "2020-02-03T09:45:51.525Z",
      "version": 42,
      "id": "fsfdsf87fsd",
      "status": "ACTIVE",
      "tenantArticleId": "4711"
    }
  ],
  "total": 42
}

Create and update listings per facility

put

Bulk PUT for Listings. Please note: This endpoint has legacy behaviour, i.e. all PUTs fail if a single PUT fails.

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

facilityIdstringRequired

ID of facility you want to put listings for. Also accepts tenantFacilityId in urn format (e.g. urn:fft:facility:tenantFacilityId:{your-tenant-facility-id}).

Body

application/json

ListingsForReplacement

Responses

200

Facility listing was found & you were allowed to access it. The result is in the body.

application/json

ListingBulkOperationResult

statusstring · enumRequired

BulkOperationResultStatus

Possible values:

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this endpoint

application/json

404

Facility listing not found

application/json

put/api/facilities/{facilityId}/listings

HTTPcURLJavaScriptPython

PUT /api/facilities/{facilityId}/listings HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1463

{
  "listings": [
    {
      "titleLocalized": {
        "de_DE": "Wert",
        "en_US": "Value",
        "ru_RU": "значение"
      },
      "attributes": [
        {
          "valueLocalized": {
            "de_DE": "Wert",
            "en_US": "Value",
            "ru_RU": "значение"
          },
          "keyLocalized": {
            "de_DE": "Wert",
            "en_US": "Value",
            "ru_RU": "значение"
          },
          "category": "descriptive",
          "context": {
            "type": "FACILITY_GROUP",
            "value": "text"
          },
          "key": "%%subtitle%%",
          "priority": 100,
          "type": "STRING",
          "value": "585er Gold"
        }
      ],
      "categoryRefs": [
        "text"
      ],
      "customAttributes": {},
      "imageUrl": "text",
      "legal": {
        "hsCode": "text"
      },
      "measurementUnitKey": "liter",
      "outOfStockBehaviour": "NONE",
      "outOfStockBehaviourByContexts": [
        {
          "context": [
            {
              "operator": "NOT",
              "type": "FACILITY_GROUP",
              "values": [
                "uuid-bkrs-0157"
              ]
            }
          ],
          "outOfStockBehaviour": "NONE",
          "outOfStockConfig": {
            "preorder": {
              "availabilityTimeframe": {
                "start": "2020-02-03T08:45:50.525Z"
              }
            },
            "restock": {
              "restockableInDays": 1
            }
          },
          "priority": 100
        }
      ],
      "outOfStockConfig": {
        "preorder": {
          "availabilityTimeframe": {
            "start": "2020-02-03T08:45:50.525Z"
          }
        },
        "restock": {
          "restockableInDays": 1
        }
      },
      "recordableAttributes": [
        {
          "keyLocalized": {
            "de_DE": "Wert",
            "en_US": "Value",
            "ru_RU": "значение"
          },
          "recordingRule": "MANDATORY",
          "value": "Germany"
        }
      ],
      "scannableCodes": [
        "text"
      ],
      "scanningRule": {
        "values": [
          {
            "priority": 1,
            "scanningRuleType": "ARTICLE"
          }
        ]
      },
      "stockAvailableUntil": {
        "calculationBase": "EXPIRY",
        "modifier": "-P30D"
      },
      "stockProperties": {
        "ANY_ADDITIONAL_PROPERTY": {
          "defaultValue": "text",
          "inputType": "DATE",
          "required": true
        }
      },
      "tenantArticleId": "4711",
      "title": "Adidas Superstar",
      "tags": []
    }
  ]
}

[
  {
    "listing": {
      "titleLocalized": {
        "de_DE": "Wert",
        "en_US": "Value",
        "ru_RU": "значение"
      },
      "attributes": [
        {
          "valueLocalized": {
            "de_DE": "Wert",
            "en_US": "Value",
            "ru_RU": "значение"
          },
          "keyLocalized": {
            "de_DE": "Wert",
            "en_US": "Value",
            "ru_RU": "значение"
          },
          "category": "descriptive",
          "context": {
            "type": "FACILITY_GROUP",
            "value": "text"
          },
          "key": "%%subtitle%%",
          "priority": 100,
          "type": "STRING",
          "value": "585er Gold"
        }
      ],
      "categoryRefs": [
        "text"
      ],
      "customAttributes": {},
      "imageUrl": "text",
      "legal": {
        "hsCode": "text"
      },
      "measurementUnitKey": "liter",
      "outOfStockBehaviour": "NONE",
      "outOfStockBehaviourByContexts": [
        {
          "context": [
            {
              "operator": "NOT",
              "type": "FACILITY_GROUP",
              "values": [
                "uuid-bkrs-0157"
              ]
            }
          ],
          "outOfStockBehaviour": "NONE",
          "outOfStockConfig": {
            "preorder": {
              "availabilityTimeframe": {
                "start": "2020-02-03T08:45:50.525Z"
              }
            },
            "restock": {
              "restockableInDays": 1
            }
          },
          "priority": 100
        }
      ],
      "outOfStockConfig": {
        "preorder": {
          "availabilityTimeframe": {
            "start": "2020-02-03T08:45:50.525Z"
          }
        },
        "restock": {
          "restockableInDays": 1
        }
      },
      "recordableAttributes": [
        {
          "keyLocalized": {
            "de_DE": "Wert",
            "en_US": "Value",
            "ru_RU": "значение"
          },
          "key": "Serialnumber",
          "recordingRule": "MANDATORY",
          "value": "Germany"
        }
      ],
      "scannableCodes": [
        "text"
      ],
      "scanningRule": {
        "values": [
          {
            "priority": 1,
            "scanningRuleType": "ARTICLE"
          }
        ]
      },
      "stockAvailableUntil": {
        "calculationBase": "EXPIRY",
        "modifier": "-P30D"
      },
      "stockProperties": {
        "ANY_ADDITIONAL_PROPERTY": {
          "defaultValue": "text",
          "inputType": "DATE",
          "required": true
        }
      },
      "tenantArticleId": "4711",
      "title": "Adidas Superstar",
      "tags": [],
      "created": "2020-02-03T08:45:51.525Z",
      "lastModified": "2020-02-03T09:45:51.525Z",
      "version": 42,
      "facilityId": "4711",
      "id": "fsfdsf87fsd",
      "status": "ACTIVE"
    },
    "status": "UPDATED"
  }
]

Delete listings

delete

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

facilityIdstringRequired

ID of facility you want to delete all listings of. Also accepts tenantFacilityId in urn format (e.g. urn:fft:facility:tenantFacilityId:{your-tenant-facility-id}).

Responses

200

Facility listings were found and successfully deleted

No content

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this endpoint

application/json

404

Facility listing not found

application/json

delete/api/facilities/{facilityId}/listings

HTTPcURLJavaScriptPython

DELETE /api/facilities/{facilityId}/listings HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Get listing

get

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

facilityIdstringRequired

ID of facility you want to get listing. Also accepts tenantFacilityId in urn format (e.g. urn:fft:facility:tenantFacilityId:{your-tenant-facility-id}).

tenantArticleIdstringRequired

tenantArticleId of listing you want to get

Query parameters

localestringOptional

Provide the localized names and descriptions for the listing. If not provided the default locale is used., for example de_DE.

Responses

200

Listing is found & you were allowed to access it. The result is in the body.

application/json

VersionedResource

categoryRefsstring[] · max: 10Optional

References to categories the listing belongs to.

currencystring · enumOptional

The currency code is a three-letter code that represents a currency in the ISO 4217 standard.

Possible values:

customAttributesobject · nullableOptional

Attributes that can be added to the listing. These attributes cannot be used within fulfillment processes, but enable you to attach custom data from your systems to fulfillmenttools entities.

imageUrlstringOptional

A web link to a picture of this article. Please make sure that no authentication is required to fetch the image!

measurementUnitKeystringOptional

Identifier for items unit of measurement.

Example: liter

outOfStockBehaviourstring · enumOptional

The PREORDER and RESTOCK can be only set, when the depending outOfStockConfig is provided. Also PREORDER and RESTOCK values are in Alpha status. For details please check the api-release-life-cycle documentation.

Possible values:

pricenumberOptionalDeprecated

This part of the API is deprecated. For details, see the API release lifecycle documentation.

Use attributes instead (see article attributes: https://docs.fulfillmenttools.com/documentation/developer-docs/api/core-concepts/customization-via-attributes)

Example: 1200

scannableCodesstring[]Optional

Codes, that identify the article

tenantArticleIdstring · min: 1Required

This is a reference to an article Id

Example: 4711

titlestring · min: 1Optional

a title describing the article

Example: Adidas Superstar

weightnumberOptionalDeprecated

This part of the API is deprecated. For details, see the API release lifecycle documentation.

Use attributes instead (see article attributes: https://docs.fulfillmenttools.com/documentation/developer-docs/api/core-concepts/customization-via-attributes)

createdstring · date-timeOptional

The date this entity was created at the platform. This value is generated by the service.

Example: 2020-02-03T08:45:51.525Z

lastModifiedstring · date-timeOptional

The date this entity was modified last. This value is generated by the service.

Example: 2020-02-03T09:45:51.525Z

versioninteger · int64Required

The version of the document to be used in optimistic locking mechanisms.

Example: 42

facilityIdstringRequired

This is a reference to a facility

Example: 4711

idstringRequiredExample: fsfdsf87fsd

statusstring · enumRequiredPossible values:

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this endpoint

application/json

404

Listings not found

application/json

get/api/facilities/{facilityId}/listings/{tenantArticleId}

HTTPcURLJavaScriptPython

GET /api/facilities/{facilityId}/listings/{tenantArticleId} HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "titleLocalized": {
    "de_DE": "Wert",
    "en_US": "Value",
    "ru_RU": "значение"
  },
  "attributes": [
    {
      "valueLocalized": {
        "de_DE": "Wert",
        "en_US": "Value",
        "ru_RU": "значение"
      },
      "keyLocalized": {
        "de_DE": "Wert",
        "en_US": "Value",
        "ru_RU": "значение"
      },
      "category": "descriptive",
      "context": {
        "type": "FACILITY_GROUP",
        "value": "text"
      },
      "key": "%%subtitle%%",
      "priority": 100,
      "type": "STRING",
      "value": "585er Gold"
    }
  ],
  "categoryRefs": [
    "text"
  ],
  "customAttributes": {},
  "imageUrl": "text",
  "legal": {
    "hsCode": "text"
  },
  "measurementUnitKey": "liter",
  "outOfStockBehaviour": "NONE",
  "outOfStockBehaviourByContexts": [
    {
      "context": [
        {
          "operator": "NOT",
          "type": "FACILITY_GROUP",
          "values": [
            "uuid-bkrs-0157"
          ]
        }
      ],
      "outOfStockBehaviour": "NONE",
      "outOfStockConfig": {
        "preorder": {
          "availabilityTimeframe": {
            "start": "2020-02-03T08:45:50.525Z"
          }
        },
        "restock": {
          "restockableInDays": 1
        }
      },
      "priority": 100
    }
  ],
  "outOfStockConfig": {
    "preorder": {
      "availabilityTimeframe": {
        "start": "2020-02-03T08:45:50.525Z"
      }
    },
    "restock": {
      "restockableInDays": 1
    }
  },
  "recordableAttributes": [
    {
      "keyLocalized": {
        "de_DE": "Wert",
        "en_US": "Value",
        "ru_RU": "значение"
      },
      "key": "Serialnumber",
      "recordingRule": "MANDATORY",
      "value": "Germany"
    }
  ],
  "scannableCodes": [
    "text"
  ],
  "scanningRule": {
    "values": [
      {
        "priority": 1,
        "scanningRuleType": "ARTICLE"
      }
    ]
  },
  "stockAvailableUntil": {
    "calculationBase": "EXPIRY",
    "modifier": "-P30D"
  },
  "stockProperties": {
    "ANY_ADDITIONAL_PROPERTY": {
      "defaultValue": "text",
      "inputType": "DATE",
      "required": true
    }
  },
  "tenantArticleId": "4711",
  "title": "Adidas Superstar",
  "tags": [],
  "created": "2020-02-03T08:45:51.525Z",
  "lastModified": "2020-02-03T09:45:51.525Z",
  "version": 42,
  "facilityId": "4711",
  "id": "fsfdsf87fsd",
  "status": "ACTIVE"
}

Delete listing

delete

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

facilityIdstringRequired

ID of facility you want to delete a listing of. Also accepts tenantFacilityId in urn format (e.g. urn:fft:facility:tenantFacilityId:{your-tenant-facility-id}).

tenantArticleIdstringRequired

tenant ID of the articles listing you want to delete

Responses

200

Facility listing was found and successfully deleted

No content

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this endpoint

application/json

404

Facility listing not found

application/json

delete/api/facilities/{facilityId}/listings/{tenantArticleId}

HTTPcURLJavaScriptPython

DELETE /api/facilities/{facilityId}/listings/{tenantArticleId} HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Update listing

patch

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

facilityIdstringRequired

ID of facility you want to patch a listing of. Also accepts tenantFacilityId in urn format (e.g. urn:fft:facility:tenantFacilityId:{your-tenant-facility-id}).

tenantArticleIdstringRequired

tenant ID of the articles listing you want to patch

Body

application/json

ListingPatchActions

versioninteger · int64Required

The version of the document to be used in optimistic locking mechanisms.

Example: 42

Responses

200

Facility listing was found and successfully patched

application/json

VersionedResource

categoryRefsstring[] · max: 10Optional

References to categories the listing belongs to.

currencystring · enumOptional

The currency code is a three-letter code that represents a currency in the ISO 4217 standard.

Possible values:

customAttributesobject · nullableOptional

Attributes that can be added to the listing. These attributes cannot be used within fulfillment processes, but enable you to attach custom data from your systems to fulfillmenttools entities.

imageUrlstringOptional

A web link to a picture of this article. Please make sure that no authentication is required to fetch the image!

measurementUnitKeystringOptional

Identifier for items unit of measurement.

Example: liter

outOfStockBehaviourstring · enumOptional

The PREORDER and RESTOCK can be only set, when the depending outOfStockConfig is provided. Also PREORDER and RESTOCK values are in Alpha status. For details please check the api-release-life-cycle documentation.

Possible values:

pricenumberOptionalDeprecated

This part of the API is deprecated. For details, see the API release lifecycle documentation.

Use attributes instead (see article attributes: https://docs.fulfillmenttools.com/documentation/developer-docs/api/core-concepts/customization-via-attributes)

Example: 1200

scannableCodesstring[]Optional

Codes, that identify the article

tenantArticleIdstring · min: 1Required

This is a reference to an article Id

Example: 4711

titlestring · min: 1Optional

a title describing the article

Example: Adidas Superstar

weightnumberOptionalDeprecated

This part of the API is deprecated. For details, see the API release lifecycle documentation.

Use attributes instead (see article attributes: https://docs.fulfillmenttools.com/documentation/developer-docs/api/core-concepts/customization-via-attributes)

createdstring · date-timeOptional

The date this entity was created at the platform. This value is generated by the service.

Example: 2020-02-03T08:45:51.525Z

lastModifiedstring · date-timeOptional

The date this entity was modified last. This value is generated by the service.

Example: 2020-02-03T09:45:51.525Z

versioninteger · int64Required

The version of the document to be used in optimistic locking mechanisms.

Example: 42

facilityIdstringRequired

This is a reference to a facility

Example: 4711

idstringRequiredExample: fsfdsf87fsd

statusstring · enumRequiredPossible values:

400

Invalid input. See response for details

application/json

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this endpoint

application/json

404

Facility listing not found

application/json

409

Listing version conflict

application/json

patch/api/facilities/{facilityId}/listings/{tenantArticleId}

HTTPcURLJavaScriptPython

PATCH /api/facilities/{facilityId}/listings/{tenantArticleId} HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1218

{
  "actions": [
    {
      "action": "ModifyListing",
      "titleLocalized": {
        "de_DE": "Wert",
        "en_US": "Value",
        "ru_RU": "значение"
      },
      "attributes": [
        {
          "valueLocalized": {
            "de_DE": "Wert",
            "en_US": "Value",
            "ru_RU": "значение"
          },
          "keyLocalized": {
            "de_DE": "Wert",
            "en_US": "Value",
            "ru_RU": "значение"
          },
          "category": "descriptive",
          "context": {
            "type": "FACILITY_GROUP",
            "value": "text"
          },
          "key": "%%subtitle%%",
          "priority": 100,
          "type": "STRING",
          "value": "585er Gold"
        }
      ],
      "categoryRefs": [
        "text"
      ],
      "customAttributes": {},
      "imageUrl": "text",
      "legal": {
        "hsCode": "text"
      },
      "measurementUnitKey": "kg",
      "outOfStockBehaviour": "NONE",
      "outOfStockConfig": {
        "preorder": {
          "availabilityTimeframe": {
            "start": "2020-02-03T08:45:50.525Z"
          }
        },
        "restock": {
          "restockableInDays": 1
        }
      },
      "recordableAttributes": [
        {
          "keyLocalized": {
            "de_DE": "Wert",
            "en_US": "Value",
            "ru_RU": "значение"
          },
          "recordingRule": "MANDATORY",
          "value": "Germany"
        }
      ],
      "scannableCodes": [
        "text"
      ],
      "scanningRule": {
        "values": [
          {
            "priority": 1,
            "scanningRuleType": "ARTICLE"
          }
        ]
      },
      "status": "ACTIVE",
      "stockAvailableUntil": {
        "calculationBase": "EXPIRY",
        "modifier": "-P30D"
      },
      "stockProperties": {
        "ANY_ADDITIONAL_PROPERTY": {
          "defaultValue": "text",
          "inputType": "DATE",
          "required": true
        }
      },
      "subtitle": "44 2/3",
      "title": "Adidas Superstar",
      "tags": []
    }
  ],
  "version": 42
}

[
  {
    "titleLocalized": {
      "de_DE": "Wert",
      "en_US": "Value",
      "ru_RU": "значение"
    },
    "attributes": [
      {
        "valueLocalized": {
          "de_DE": "Wert",
          "en_US": "Value",
          "ru_RU": "значение"
        },
        "keyLocalized": {
          "de_DE": "Wert",
          "en_US": "Value",
          "ru_RU": "значение"
        },
        "category": "descriptive",
        "context": {
          "type": "FACILITY_GROUP",
          "value": "text"
        },
        "key": "%%subtitle%%",
        "priority": 100,
        "type": "STRING",
        "value": "585er Gold"
      }
    ],
    "categoryRefs": [
      "text"
    ],
    "customAttributes": {},
    "imageUrl": "text",
    "legal": {
      "hsCode": "text"
    },
    "measurementUnitKey": "liter",
    "outOfStockBehaviour": "NONE",
    "outOfStockBehaviourByContexts": [
      {
        "context": [
          {
            "operator": "NOT",
            "type": "FACILITY_GROUP",
            "values": [
              "uuid-bkrs-0157"
            ]
          }
        ],
        "outOfStockBehaviour": "NONE",
        "outOfStockConfig": {
          "preorder": {
            "availabilityTimeframe": {
              "start": "2020-02-03T08:45:50.525Z"
            }
          },
          "restock": {
            "restockableInDays": 1
          }
        },
        "priority": 100
      }
    ],
    "outOfStockConfig": {
      "preorder": {
        "availabilityTimeframe": {
          "start": "2020-02-03T08:45:50.525Z"
        }
      },
      "restock": {
        "restockableInDays": 1
      }
    },
    "recordableAttributes": [
      {
        "keyLocalized": {
          "de_DE": "Wert",
          "en_US": "Value",
          "ru_RU": "значение"
        },
        "key": "Serialnumber",
        "recordingRule": "MANDATORY",
        "value": "Germany"
      }
    ],
    "scannableCodes": [
      "text"
    ],
    "scanningRule": {
      "values": [
        {
          "priority": 1,
          "scanningRuleType": "ARTICLE"
        }
      ]
    },
    "stockAvailableUntil": {
      "calculationBase": "EXPIRY",
      "modifier": "-P30D"
    },
    "stockProperties": {
      "ANY_ADDITIONAL_PROPERTY": {
        "defaultValue": "text",
        "inputType": "DATE",
        "required": true
      }
    },
    "tenantArticleId": "4711",
    "title": "Adidas Superstar",
    "tags": [],
    "created": "2020-02-03T08:45:51.525Z",
    "lastModified": "2020-02-03T09:45:51.525Z",
    "version": 42,
    "facilityId": "4711",
    "id": "fsfdsf87fsd",
    "status": "ACTIVE"
  }
]

Deprecated

List listing partial stocks

get

This part of the API is deprecated. For details, see the API release lifecycle documentation. This endpoint is deprecated. Use /api/stocks endpoints instead.

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

facilityIdstringRequired

ID of facility you want to get the partial stocks. Also accepts tenantFacilityId in urn format (e.g. urn:fft:facility:tenantFacilityId:{your-tenant-facility-id}).

tenantArticleIdstringRequired

ID of listing you want to get partial stocks

Responses

200

Facility and listing were found & you are allowed to access it. The result is in the body.

application/json

PartialStock

tenantPartialStockIdstringRequired

The id associated with the partial stock

eventLastModifiedstring · date-timeOptional

The date when the inventory domain comunicated a change in this partial stock

Example: 2020-02-03T08:45:50.525Z

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this endpoint

application/json

404

Facility or Listing not found

application/json

get/api/facilities/{facilityId}/listings/{tenantArticleId}/partialstocks

HTTPcURLJavaScriptPython

GET /api/facilities/{facilityId}/listings/{tenantArticleId}/partialstocks HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "location": {
      "locationRef": "text",
      "scannableCodes": [
        "text"
      ]
    },
    "scores": [
      {
        "scoreName": "ZONE",
        "scoreType": "RATING",
        "scoreValue": 1
      }
    ],
    "tenantPartialStockId": "text"
  }
]

Deprecated

Update listing partial stocks

put

This part of the API is deprecated. For details, see the API release lifecycle documentation. This endpoint is deprecated. Use /api/stocks endpoints instead. Replaces the current partial stock object related to its listing

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

facilityIdstringRequired

ID of facility you want to get listing. Also accepts tenantFacilityId in urn format (e.g. urn:fft:facility:tenantFacilityId:{your-tenant-facility-id}).

tenantArticleIdstringRequired

ID of listing you want to get partial stocks

Body

application/json

PartialStocksForReplacement

versioninteger · int64Required

The version of the listing where we want to put the partialStocks, to be used in optimistic locking mechanisms.

Example: 42

Responses

200

Facility listing was found & you were allowed to update it.

No content

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this endpoint

application/json

404

Facility listing not found

application/json

put/api/facilities/{facilityId}/listings/{tenantArticleId}/partialstocks

HTTPcURLJavaScriptPython

PUT /api/facilities/{facilityId}/listings/{tenantArticleId}/partialstocks HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 192

{
  "partialStocks": [
    {
      "location": {
        "locationRef": "text",
        "scannableCodes": [
          "text"
        ]
      },
      "scores": [
        {
          "scoreName": "ZONE",
          "scoreType": "RATING",
          "scoreValue": 1
        }
      ],
      "tenantPartialStockId": "text"
    }
  ],
  "version": 42
}

No content

Deprecated

Delete listing partial stocks

delete

This part of the API is deprecated. For details, see the API release lifecycle documentation. This endpoint is deprecated. Use /api/stocks endpoints instead.

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

facilityIdstringRequired

ID of facility from whom you want to delete the partial stock. Also accepts tenantFacilityId in urn format (e.g. urn:fft:facility:tenantFacilityId:{your-tenant-facility-id}).

tenantArticleIdstringRequired

ID of listing you want to get partial stocks

Responses

200

Facility listing was found & you were allowed to delete the partial stock.

No content

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this endpoint

application/json

404

Facility listing not found

application/json

delete/api/facilities/{facilityId}/listings/{tenantArticleId}/partialstocks

HTTPcURLJavaScriptPython

DELETE /api/facilities/{facilityId}/listings/{tenantArticleId}/partialstocks HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Deprecated

Update listing partial stocks

patch

This part of the API is deprecated. For details, see the API release lifecycle documentation. This endpoint is deprecated. Use /api/stocks endpoints instead. Adds new partial stocks, updates existing partial stocks and keeps stocks that are previously present in the database.

1. If a stock exists in the patch action but not in the database it is added.

2. If a stock exists both in the patch action and in the database it is updated and the contents are merged.

3. If a stock exists only in the database, it is left untouched.

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

facilityIdstringRequired

ID of facility you want to patch the partial stocks. Also accepts tenantFacilityId in urn format (e.g. urn:fft:facility:tenantFacilityId:{your-tenant-facility-id}).

tenantArticleIdstringRequired

ID of listing you want to get partial stocks

Body

application/json

PartialStockPatchActions

versioninteger · int64Required

The version of the listing where we want to patch the partialStocks, to be used in optimistic locking mechanisms.

Example: 42

Responses

200

Facility listing was found & you were allowed to update it.

No content

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this endpoint

application/json

404

Facility listing not found

application/json

patch/api/facilities/{facilityId}/listings/{tenantArticleId}/partialstocks

HTTPcURLJavaScriptPython

PATCH /api/facilities/{facilityId}/listings/{tenantArticleId}/partialstocks HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 236

{
  "actions": [
    {
      "action": "ModifyPartialStock",
      "partialStocks": [
        {
          "location": {
            "locationRef": "text",
            "scannableCodes": [
              "text"
            ]
          },
          "scores": [
            {
              "scoreName": "ZONE",
              "scoreType": "RATING",
              "scoreValue": 1
            }
          ],
          "tenantPartialStockId": "text"
        }
      ]
    }
  ],
  "version": 42
}

No content

Create and update listings

put

Bulk upsert listings independently of their facility

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

ListingBulkUpsertPayload

Responses

200

Result of the bulk upsert operation

application/json

ListingBulkUpsertResponse

400

Invalid input. See response for details.

application/json

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this endpoint

application/json

404

The requested entity was not found

application/json

409

A version conflict occurred.

application/json

put/api/listings

HTTPcURLJavaScriptPython

PUT /api/listings HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1572

{
  "listings": [
    {
      "titleLocalized": {
        "de_DE": "Wert",
        "en_US": "Value",
        "ru_RU": "значение"
      },
      "attributes": [
        {
          "valueLocalized": {
            "de_DE": "Wert",
            "en_US": "Value",
            "ru_RU": "значение"
          },
          "keyLocalized": {
            "de_DE": "Wert",
            "en_US": "Value",
            "ru_RU": "значение"
          },
          "category": "descriptive",
          "context": {
            "type": "FACILITY_GROUP",
            "value": "text"
          },
          "key": "%%subtitle%%",
          "priority": 100,
          "type": "STRING",
          "value": "585er Gold"
        }
      ],
      "categoryRefs": [
        "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
        "0190d6e8-9a1b-7c2d-8e3f-5a7b9c1d3e5f"
      ],
      "customAttributes": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "imageUrl": "https://example.com/resource",
      "legal": {
        "hsCode": "text"
      },
      "measurementUnitKey": "liter",
      "outOfStockBehaviour": "NONE",
      "outOfStockBehaviourByContexts": [
        {
          "context": [
            {
              "operator": "NOT",
              "type": "FACILITY_GROUP",
              "values": [
                "uuid-bkrs-0157"
              ]
            }
          ],
          "outOfStockBehaviour": "NONE",
          "outOfStockConfig": {
            "preorder": {
              "availabilityTimeframe": "2026-06-17T12:00:00.000Z"
            },
            "restock": {
              "restockableInDays": 1
            }
          },
          "priority": 1
        }
      ],
      "outOfStockConfig": {
        "preorder": {
          "availabilityTimeframe": "2026-06-17T12:00:00.000Z"
        },
        "restock": {
          "restockableInDays": 1
        }
      },
      "scannableCodes": [
        "text"
      ],
      "scanningRule": {
        "values": [
          {
            "priority": 1,
            "scanningRuleType": "ARTICLE"
          }
        ]
      },
      "selector": [
        {
          "facility": {
            "facilityRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f"
          },
          "version": 1
        }
      ],
      "status": "ACTIVE",
      "stockAvailableUntil": {
        "calculationBase": "EXPIRY",
        "modifier": "-P30D"
      },
      "stockProperties": {
        "ANY_ADDITIONAL_PROPERTY": {
          "defaultValue": "text",
          "inputType": "DATE",
          "required": true
        }
      },
      "targetingStrategy": "MULTI_SELECTOR",
      "tenantArticleId": "4711",
      "title": "Adidas Superstar",
      "tags": []
    }
  ]
}

{
  "listings": [
    {
      "result": {
        "titleLocalized": {
          "de_DE": "Wert",
          "en_US": "Value",
          "ru_RU": "значение"
        },
        "attributes": [
          {
            "valueLocalized": {
              "de_DE": "Wert",
              "en_US": "Value",
              "ru_RU": "значение"
            },
            "keyLocalized": {
              "de_DE": "Wert",
              "en_US": "Value",
              "ru_RU": "значение"
            },
            "category": "descriptive",
            "context": {
              "type": "FACILITY_GROUP",
              "value": "text"
            },
            "key": "%%subtitle%%",
            "priority": 100,
            "type": "STRING",
            "value": "585er Gold"
          }
        ],
        "categoryRefs": [
          "text"
        ],
        "customAttributes": {},
        "imageUrl": "text",
        "legal": {
          "hsCode": "text"
        },
        "measurementUnitKey": "liter",
        "outOfStockBehaviour": "NONE",
        "outOfStockBehaviourByContexts": [
          {
            "context": [
              {
                "operator": "NOT",
                "type": "FACILITY_GROUP",
                "values": [
                  "uuid-bkrs-0157"
                ]
              }
            ],
            "outOfStockBehaviour": "NONE",
            "outOfStockConfig": {
              "preorder": {
                "availabilityTimeframe": {
                  "start": "2020-02-03T08:45:50.525Z"
                }
              },
              "restock": {
                "restockableInDays": 1
              }
            },
            "priority": 100
          }
        ],
        "outOfStockConfig": {
          "preorder": {
            "availabilityTimeframe": {
              "start": "2020-02-03T08:45:50.525Z"
            }
          },
          "restock": {
            "restockableInDays": 1
          }
        },
        "recordableAttributes": [
          {
            "keyLocalized": {
              "de_DE": "Wert",
              "en_US": "Value",
              "ru_RU": "значение"
            },
            "key": "Serialnumber",
            "recordingRule": "MANDATORY",
            "value": "Germany"
          }
        ],
        "scannableCodes": [
          "text"
        ],
        "scanningRule": {
          "values": [
            {
              "priority": 1,
              "scanningRuleType": "ARTICLE"
            }
          ]
        },
        "stockAvailableUntil": {
          "calculationBase": "EXPIRY",
          "modifier": "-P30D"
        },
        "stockProperties": {
          "ANY_ADDITIONAL_PROPERTY": {
            "defaultValue": "text",
            "inputType": "DATE",
            "required": true
          }
        },
        "tenantArticleId": "4711",
        "title": "Adidas Superstar",
        "tags": [],
        "created": "2020-02-03T08:45:51.525Z",
        "lastModified": "2020-02-03T09:45:51.525Z",
        "version": 42,
        "facilityId": "4711",
        "id": "fsfdsf87fsd",
        "status": "ACTIVE"
      },
      "status": "CREATED"
    }
  ],
  "summary": {
    "created": 1,
    "unchanged": 1,
    "updated": "2026-06-17T12:00:00.000Z"
  }
}

List listings (search)

post

Search for Listing

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

ListingSearchPayload

afterstringOptional

The cursor to start after for forward pagination. The value is provided in the pageInfo.endCursor field of the response. Cannot be used with before or last.

beforestringOptional

The cursor to start before for backward pagination. The value is provided in the pageInfo.startCursor field of the response. Cannot be used with after or size (first).

lastnumber · min: 1 · max: 250Optional

Number of items to return for backward pagination. Cannot be used with 'size' (first). Default: 20.

sizenumber · min: 1 · max: 250Optional

Number of items to return for forward pagination. Cannot be used with 'last'. Default: 20.

Example: 10

startAfterIdstringOptionalDeprecated

The ID to start after. Deprecated, use after with the value provided in pageInfo.endCursor instead.

Responses

200

Your search result

application/json

ListingPaginatedResult

totalnumberOptional

The total number of items matching the search criteria. Only filled, if withTotal is set to true in the search options.

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this endpoint

application/json

post/api/listings/search

HTTPcURLJavaScriptPython

POST /api/listings/search HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 5833

{
  "after": "text",
  "before": "text",
  "last": 1,
  "options": {
    "withTotal": true
  },
  "query": {
    "and": [
      {
        "and": [
          {
            "and": "[Circular Reference]",
            "availabilityTimeframe": "2026-06-17T12:00:00.000Z",
            "categoryRefs": [
              "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
              "0190d6e8-9a1b-7c2d-8e3f-5a7b9c1d3e5f"
            ],
            "created": {
              "after": "text",
              "before": "text",
              "eq": "2026-07-22T16:08:05.302Z",
              "gt": "2026-07-22T16:08:05.302Z",
              "gte": "2026-07-22T16:08:05.302Z",
              "lt": "2026-07-22T16:08:05.302Z",
              "lte": "2026-07-22T16:08:05.302Z",
              "notEq": "2026-07-22T16:08:05.302Z"
            },
            "customAttributes": {
              "ANY_ADDITIONAL_PROPERTY": {
                "eq": true,
                "notEq": true
              }
            },
            "facilityRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
            "id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
            "measurementUnitKey": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            },
            "or": "[Circular Reference]",
            "outOfStockBehaviour": {
              "eq": "NONE",
              "in": [
                "NONE"
              ],
              "notEq": "NONE"
            },
            "price": {
              "eq": 1,
              "gt": 1,
              "gte": 1,
              "in": [
                1
              ],
              "lt": 1,
              "lte": 1,
              "notEq": 1,
              "notIn": [
                1
              ]
            },
            "status": {
              "eq": "ACTIVE",
              "in": [
                "ACTIVE"
              ],
              "notEq": "ACTIVE"
            },
            "tenantArticleId": "MY_ARTICLE_ID",
            "weight": {
              "eq": 1,
              "gt": 1,
              "gte": 1,
              "in": [
                1
              ],
              "lt": 1,
              "lte": 1,
              "notEq": 1,
              "notIn": [
                1
              ]
            },
            "tags": {
              "contains": {
                "id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
                "value": {
                  "eq": "text",
                  "in": [
                    "text"
                  ],
                  "notEq": "text",
                  "notIn": [
                    "text"
                  ]
                }
              }
            }
          }
        ],
        "availabilityTimeframe": "2026-06-17T12:00:00.000Z",
        "categoryRefs": [
          "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
          "0190d6e8-9a1b-7c2d-8e3f-5a7b9c1d3e5f"
        ],
        "created": {
          "after": "text",
          "before": "text",
          "eq": "2026-07-22T16:08:05.302Z",
          "gt": "2026-07-22T16:08:05.302Z",
          "gte": "2026-07-22T16:08:05.302Z",
          "lt": "2026-07-22T16:08:05.302Z",
          "lte": "2026-07-22T16:08:05.302Z",
          "notEq": "2026-07-22T16:08:05.302Z"
        },
        "customAttributes": {
          "ANY_ADDITIONAL_PROPERTY": {
            "eq": true,
            "notEq": true
          }
        },
        "facilityRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
        "id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
        "measurementUnitKey": {
          "eq": "text",
          "in": [
            "text"
          ],
          "notEq": "text",
          "notIn": [
            "text"
          ]
        },
        "or": [
          {
            "and": "[Circular Reference]",
            "availabilityTimeframe": "2026-06-17T12:00:00.000Z",
            "categoryRefs": [
              "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
              "0190d6e8-9a1b-7c2d-8e3f-5a7b9c1d3e5f"
            ],
            "created": {
              "after": "text",
              "before": "text",
              "eq": "2026-07-22T16:08:05.302Z",
              "gt": "2026-07-22T16:08:05.302Z",
              "gte": "2026-07-22T16:08:05.302Z",
              "lt": "2026-07-22T16:08:05.302Z",
              "lte": "2026-07-22T16:08:05.302Z",
              "notEq": "2026-07-22T16:08:05.302Z"
            },
            "customAttributes": {
              "ANY_ADDITIONAL_PROPERTY": {
                "eq": true,
                "notEq": true
              }
            },
            "facilityRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
            "id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
            "measurementUnitKey": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            },
            "or": "[Circular Reference]",
            "outOfStockBehaviour": {
              "eq": "NONE",
              "in": [
                "NONE"
              ],
              "notEq": "NONE"
            },
            "price": {
              "eq": 1,
              "gt": 1,
              "gte": 1,
              "in": [
                1
              ],
              "lt": 1,
              "lte": 1,
              "notEq": 1,
              "notIn": [
                1
              ]
            },
            "status": {
              "eq": "ACTIVE",
              "in": [
                "ACTIVE"
              ],
              "notEq": "ACTIVE"
            },
            "tenantArticleId": "MY_ARTICLE_ID",
            "weight": {
              "eq": 1,
              "gt": 1,
              "gte": 1,
              "in": [
                1
              ],
              "lt": 1,
              "lte": 1,
              "notEq": 1,
              "notIn": [
                1
              ]
            },
            "tags": {
              "contains": {
                "id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
                "value": {
                  "eq": "text",
                  "in": [
                    "text"
                  ],
                  "notEq": "text",
                  "notIn": [
                    "text"
                  ]
                }
              }
            }
          }
        ],
        "outOfStockBehaviour": {
          "eq": "NONE",
          "in": [
            "NONE"
          ],
          "notEq": "NONE"
        },
        "price": {
          "eq": 1,
          "gt": 1,
          "gte": 1,
          "in": [
            1
          ],
          "lt": 1,
          "lte": 1,
          "notEq": 1,
          "notIn": [
            1
          ]
        },
        "status": {
          "eq": "ACTIVE",
          "in": [
            "ACTIVE"
          ],
          "notEq": "ACTIVE"
        },
        "tenantArticleId": "MY_ARTICLE_ID",
        "weight": {
          "eq": 1,
          "gt": 1,
          "gte": 1,
          "in": [
            1
          ],
          "lt": 1,
          "lte": 1,
          "notEq": 1,
          "notIn": [
            1
          ]
        },
        "tags": {
          "contains": {
            "id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
            "value": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            }
          }
        }
      }
    ],
    "availabilityTimeframe": "2026-06-17T12:00:00.000Z",
    "categoryRefs": [
      "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
      "0190d6e8-9a1b-7c2d-8e3f-5a7b9c1d3e5f"
    ],
    "created": {
      "after": "text",
      "before": "text",
      "eq": "2026-07-22T16:08:05.302Z",
      "gt": "2026-07-22T16:08:05.302Z",
      "gte": "2026-07-22T16:08:05.302Z",
      "lt": "2026-07-22T16:08:05.302Z",
      "lte": "2026-07-22T16:08:05.302Z",
      "notEq": "2026-07-22T16:08:05.302Z"
    },
    "customAttributes": {
      "ANY_ADDITIONAL_PROPERTY": {
        "eq": true,
        "notEq": true
      }
    },
    "facilityRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
    "id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
    "measurementUnitKey": {
      "eq": "text",
      "in": [
        "text"
      ],
      "notEq": "text",
      "notIn": [
        "text"
      ]
    },
    "or": [
      {
        "and": "[Circular Reference]",
        "availabilityTimeframe": "2026-06-17T12:00:00.000Z",
        "categoryRefs": [
          "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
          "0190d6e8-9a1b-7c2d-8e3f-5a7b9c1d3e5f"
        ],
        "created": {
          "after": "text",
          "before": "text",
          "eq": "2026-07-22T16:08:05.302Z",
          "gt": "2026-07-22T16:08:05.302Z",
          "gte": "2026-07-22T16:08:05.302Z",
          "lt": "2026-07-22T16:08:05.302Z",
          "lte": "2026-07-22T16:08:05.302Z",
          "notEq": "2026-07-22T16:08:05.302Z"
        },
        "customAttributes": {
          "ANY_ADDITIONAL_PROPERTY": {
            "eq": true,
            "notEq": true
          }
        },
        "facilityRef": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
        "id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
        "measurementUnitKey": {
          "eq": "text",
          "in": [
            "text"
          ],
          "notEq": "text",
          "notIn": [
            "text"
          ]
        },
        "or": "[Circular Reference]",
        "outOfStockBehaviour": {
          "eq": "NONE",
          "in": [
            "NONE"
          ],
          "notEq": "NONE"
        },
        "price": {
          "eq": 1,
          "gt": 1,
          "gte": 1,
          "in": [
            1
          ],
          "lt": 1,
          "lte": 1,
          "notEq": 1,
          "notIn": [
            1
          ]
        },
        "status": {
          "eq": "ACTIVE",
          "in": [
            "ACTIVE"
          ],
          "notEq": "ACTIVE"
        },
        "tenantArticleId": "MY_ARTICLE_ID",
        "weight": {
          "eq": 1,
          "gt": 1,
          "gte": 1,
          "in": [
            1
          ],
          "lt": 1,
          "lte": 1,
          "notEq": 1,
          "notIn": [
            1
          ]
        },
        "tags": {
          "contains": {
            "id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
            "value": {
              "eq": "text",
              "in": [
                "text"
              ],
              "notEq": "text",
              "notIn": [
                "text"
              ]
            }
          }
        }
      }
    ],
    "outOfStockBehaviour": {
      "eq": "NONE",
      "in": [
        "NONE"
      ],
      "notEq": "NONE"
    },
    "price": {
      "eq": 1,
      "gt": 1,
      "gte": 1,
      "in": [
        1
      ],
      "lt": 1,
      "lte": 1,
      "notEq": 1,
      "notIn": [
        1
      ]
    },
    "status": {
      "eq": "ACTIVE",
      "in": [
        "ACTIVE"
      ],
      "notEq": "ACTIVE"
    },
    "tenantArticleId": "MY_ARTICLE_ID",
    "weight": {
      "eq": 1,
      "gt": 1,
      "gte": 1,
      "in": [
        1
      ],
      "lt": 1,
      "lte": 1,
      "notEq": 1,
      "notIn": [
        1
      ]
    },
    "tags": {
      "contains": {
        "id": "0190d6e8-8c3a-7f1b-9d2e-4a6b8c0d1e2f",
        "value": {
          "eq": "text",
          "in": [
            "text"
          ],
          "notEq": "text",
          "notIn": [
            "text"
          ]
        }
      }
    }
  },
  "size": 10,
  "sort": [
    {
      "customAttributes": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "lastModified": "ASC",
      "tenantArticleId": "ASC"
    }
  ]
}

{
  "listings": [
    {
      "titleLocalized": {
        "de_DE": "Wert",
        "en_US": "Value",
        "ru_RU": "значение"
      },
      "attributes": [
        {
          "valueLocalized": {
            "de_DE": "Wert",
            "en_US": "Value",
            "ru_RU": "значение"
          },
          "keyLocalized": {
            "de_DE": "Wert",
            "en_US": "Value",
            "ru_RU": "значение"
          },
          "category": "descriptive",
          "context": {
            "type": "FACILITY_GROUP",
            "value": "text"
          },
          "key": "%%subtitle%%",
          "priority": 100,
          "type": "STRING",
          "value": "585er Gold"
        }
      ],
      "categoryRefs": [
        "text"
      ],
      "customAttributes": {},
      "imageUrl": "text",
      "legal": {
        "hsCode": "text"
      },
      "measurementUnitKey": "liter",
      "outOfStockBehaviour": "NONE",
      "outOfStockBehaviourByContexts": [
        {
          "context": [
            {
              "operator": "NOT",
              "type": "FACILITY_GROUP",
              "values": [
                "uuid-bkrs-0157"
              ]
            }
          ],
          "outOfStockBehaviour": "NONE",
          "outOfStockConfig": {
            "preorder": {
              "availabilityTimeframe": {
                "start": "2020-02-03T08:45:50.525Z"
              }
            },
            "restock": {
              "restockableInDays": 1
            }
          },
          "priority": 100
        }
      ],
      "outOfStockConfig": {
        "preorder": {
          "availabilityTimeframe": {
            "start": "2020-02-03T08:45:50.525Z"
          }
        },
        "restock": {
          "restockableInDays": 1
        }
      },
      "recordableAttributes": [
        {
          "keyLocalized": {
            "de_DE": "Wert",
            "en_US": "Value",
            "ru_RU": "значение"
          },
          "key": "Serialnumber",
          "recordingRule": "MANDATORY",
          "value": "Germany"
        }
      ],
      "scannableCodes": [
        "text"
      ],
      "scanningRule": {
        "values": [
          {
            "priority": 1,
            "scanningRuleType": "ARTICLE"
          }
        ]
      },
      "stockAvailableUntil": {
        "calculationBase": "EXPIRY",
        "modifier": "-P30D"
      },
      "stockProperties": {
        "ANY_ADDITIONAL_PROPERTY": {
          "defaultValue": "text",
          "inputType": "DATE",
          "required": true
        }
      },
      "tenantArticleId": "4711",
      "title": "Adidas Superstar",
      "tags": [],
      "created": "2020-02-03T08:45:51.525Z",
      "lastModified": "2020-02-03T09:45:51.525Z",
      "version": 42,
      "facilityId": "4711",
      "id": "fsfdsf87fsd",
      "status": "ACTIVE"
    }
  ],
  "pageInfo": {
    "endCursor": "text",
    "hasNextPage": true,
    "hasPreviousPage": true,
    "startCursor": "text"
  },
  "total": 1
}