Care

Declare a problem on a Care Folder

Changed on

Declare a problem on a Care Folder.

The problem_type field specifies the type of problem. If omitted, it defaults to OTHER.

Attachments are mandatory for the following problem types: DAMAGED_PACKAGE, ITEM_NOT_RECEIVED, OOW_ITEM.

For Care Folders with ID below 100,000,000, only OTHER is accepted and no message or attachments can be provided.

Rate limiting

This endpoint is rate limited to 750 requests per minute and 1000 requests per day. If you exceed this limit, you will receive a 429 status code.

post/ws/sav/{careFolderId}/problem

Request

Path parameters

careFolderIdinteger required

ID of the Care Folder on which the problem is declared

Request body multipart/form-data

problem_type'ACCOUNT_LOCKED' | 'CODE_LOCKED' | 'DAMAGED_PACKAGE' | 'ITEM_NOT_RECEIVED' | 'MISSING_PART' | 'OOW_ITEM' | 'PROBLEM_NOT_IDENTIFIED' | 'WRONG_ITEM' | 'OTHER'

The type of problem to declare on the Care Folder.

If not provided, defaults to OTHER.

Attachment requirements:

  • DAMAGED_PACKAGE, ITEM_NOT_RECEIVED, and OOW_ITEM require at least one attachment.
  • All other problem types have optional attachments.
messagestring

Optional message to include with the problem declaration.

attachmentstring[]

The local file(s) to be uploaded with the problem declaration.

Mandatory for problem types DAMAGED_PACKAGE, ITEM_NOT_RECEIVED, and OOW_ITEM.

Limits:

  • Maximum file size: 3 MB per file
  • Maximum number of files: 10 files

Example request

{
  "problem_type": "OTHER",
  "message": "The package arrived damaged",
  "attachment": []
}

Response

Declared

Changes