Item Conditions

This page is outdated. Please go to our new documentation under https://docs.fulfillmenttools.com/documentation.

Default values for item condition in the backend are not provided; however, it is possible to manage them on the client side. Like we are doing it with our app by setting the default value for item condition to "not damaged". If no additional conditions are specified through the backend, the conditions will not be displayed.

Adding predefined item conditions

You can add localized itemConditions to the returnConfiguration via API. The translation depends on the locale of the user using this endpoint and the tenantLocaleConfiguration as a fallback.

Get the current configuration for returns

get

Responses

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/api/configurations/return'

200

401

403

404

200

{
  "active": true,
  "returnTypeConfiguration": {
    "type": "RETURN"
  },
  "availableItemConditions": [],
  "availableReturnReasons": [
    {
      "reasonLocalized": {
        "de_DE": "Beschädigt",
        "en_US": "Damaged"
      },
      "identifier": "A"
    }
  ],
  "allowTriggerRefund": true,
  "created": "2020-02-03T08:45:51.525Z",
  "lastModified": "2020-02-03T09:45:51.525Z",
  "version": 42
}

Return config found.

Change the tenant wide return configuration

put

Body

activeboolean · default: truerequiredDeprecated

returnTypeConfigurationobjectoptional

availableItemConditionsanyoptional

availableReturnReasonsanyoptional

allowTriggerRefundboolean · default: falseoptional

If true, a refund can be triggered. If false, the endpoints to trigger a refund are disabled.

Responses

application/json

application/json

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url '/api/configurations/return' \
  --header 'Content-Type: application/json' \
  --data '{
    "active": true,
    "returnTypeConfiguration": {
      "type": "RETURN"
    },
    "availableItemConditions": [],
    "availableReturnReasons": [],
    "allowTriggerRefund": true,
    "created": "2020-02-03T08:45:51.525Z",
    "lastModified": "2020-02-03T09:45:51.525Z",
    "version": 42
  }'

200

201

400

401

403

409

200

{
  "active": true,
  "returnTypeConfiguration": {
    "type": "RETURN"
  },
  "availableItemConditions": [],
  "availableReturnReasons": [
    {
      "reasonLocalized": {
        "de_DE": "Beschädigt",
        "en_US": "Damaged"
      },
      "identifier": "A"
    }
  ],
  "allowTriggerRefund": true,
  "created": "2020-02-03T08:45:51.525Z",
  "lastModified": "2020-02-03T09:45:51.525Z",
  "version": 42
}

The return configuration was successfully updated.

Using item conditions in itemReturns

A user of our API can use these predefined conditions or provide their own ones when creating or updating itemReturnLineItem of an ItemReturn. The localized condition can be provided like this example:

itemConditionLocalized = { de_DE: 'gefällt nicht', en_US: 'do not like' }

When getting this ItemReturn via REST oder GQL, you will receive an additional field called itemCondition which contains only the localized value. This translation depends on the users locale.

Getting and setting these values via REST:

Get item returns

get

Authorizations

Path parameters

itemReturnJobIdstringrequired

item return job to read the item return for

Query parameters

startAfterIdstringoptional

entity to start after

sizeinteger · default: 25optional

number of entities to show

Responses

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://%%HOST%%//api/itemreturnjobs/{itemReturnJobId}/itemreturns'

200

401

403

404

200

[]

Get all item returns for a given item return job

Get item return by id

get

Authorizations

Path parameters

itemReturnJobIdstringrequired

item return job to read the item return for

itemReturnIdstringrequired

id of the item return you want to read

Query parameters

startAfterIdstringoptional

entity to start after

sizeinteger · default: 25optional

number of entities to show

Responses

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://%%HOST%%//api/itemreturnjobs/{itemReturnJobId}/itemreturns/{itemReturnId}'

200

401

403

404

200

{
  "id": "text",
  "created": "2020-02-03T08:45:51.525Z",
  "lastModified": "2020-02-03T09:45:51.525Z",
  "returnFacilityRef": "text",
  "status": "ANNOUNCED",
  "tenantOrderId": "text",
  "scannableCodes": [
    "text"
  ],
  "returnedLineItems": [
    {
      "itemConditionLocalized": {
        "de_DE": "Bschädigt",
        "en_US": "Damaged"
      },
      "itemConditionComment": "Upper corner damaged",
      "tenantArticleId": "a69006ba-7100-4b4d-a610-1ca28016a4eb",
      "scannedCodes": [
        "text"
      ],
      "status": "OPEN",
      "reasons": []
    }
  ]
}

Get a specific item return

Actions for a ItemReturn

post

Authorizations

Path parameters

itemReturnJobIdstringrequired

id of the Item Return Job

itemReturnIdstringrequired

id of the Item Return

Body

any ofoptional

Responses

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://%%HOST%%//api/itemreturnjobs/{itemReturnJobId}/itemreturns/{itemReturnId}/actions' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "STATUS_CHANGE",
    "itemReturnJobVersion": 1,
    "status": "ANNOUNCED"
  }'

200

401

403

404

200

{
  "id": "text",
  "processRef": "text",
  "originFacilityRefs": [
    "text"
  ],
  "status": "OPEN",
  "tenantOrderId": "text",
  "consumerAddresses": [
    {
      "additionalAddressInfo": "to care of: Mrs. Müller",
      "city": "Langenfeld",
      "country": "DE",
      "province": "NRW",
      "customAttributes": {},
      "houseNumber": "42a",
      "phoneNumbers": [
        {
          "customAttributes": {},
          "label": "text",
          "type": "MOBILE",
          "value": "text"
        }
      ],
      "postalCode": "40764",
      "street": "Hauptstr."
    }
  ],
  "scannableCodes": [
    "text"
  ],
  "shortId": "AS12",
  "returnableLineItems": [
    {
      "article": {
        "customAttributes": {},
        "imageUrl": "text",
        "tenantArticleId": "4711",
        "title": "Cologne Water",
        "weight": 1,
        "attributes": [
          {
            "category": "descriptive",
            "key": "%%subtitle%%",
            "priority": 100,
            "value": "585er Gold"
          }
        ]
      },
      "delivered": 1,
      "scannableCodes": [
        "text"
      ]
    }
  ],
  "itemReturns": [],
  "anonymized": false,
  "created": "2020-02-03T08:45:51.525Z",
  "lastModified": "2020-02-03T09:45:51.525Z",
  "version": 42
}

Updated entity