SalesChannelCancellationRequests

Reject a cancellation request

post

Reject an existing cancellation request

Authorizations
AuthorizationstringRequired
Path parameters
channel_idintegerRequired

The channel ID of the resource.

Example: 5
idintegerRequired

Unique identifier of the resource

Example: 1
Responses
200

Cancellation request rejected successfully

application/json
post
/api/channel/{channel_id}/cancellation_requests/{id}/reject/

Retrieve a cancellation request

get

Get detailed information about a specific cancellation request

Authorizations
AuthorizationstringRequired
Path parameters
channel_idintegerRequired

The channel ID of the resource.

Example: 5
idintegerRequired

Unique identifier of the resource

Example: 1
Responses
200

Cancellation request for given ID

application/json
get
/api/channel/{channel_id}/cancellation_requests/{id}/

Update a cancellation request

put

Update an existing cancellation request

Authorizations
AuthorizationstringRequired
Path parameters
channel_idintegerRequired

The channel ID of the resource.

Example: 5
idintegerRequired

Unique identifier of the resource

Example: 1
Body
statusstring · enumOptional

Status of the cancellation request.

Example: waitingPossible values:
descriptionstring | nullableOptional

Description of the cancellation request

ibanstring | nullableOptional

IBAN for refund

holder_namestring | nullableOptional

Name of the account holder

cancellation_typestring · enumOptional

Type of cancellation

Example: cancelPossible values:
quantityinteger | nullableOptional

Quantity of items to be cancelled

fully_refund_as_loyalty_moneybooleanOptional

Flag to indicate if the refund should be processed as loyalty money

Default: false
reasonintegerOptional

Related cancellation reason ID

Example: 1
order_itemintegerOptional

Related order item ID

Example: 1
Responses
200

Cancellation request updated successfully

application/json
put
/api/channel/{channel_id}/cancellation_requests/{id}/

Delete a cancellation request

delete

Delete an existing cancellation request

Authorizations
AuthorizationstringRequired
Path parameters
channel_idintegerRequired

The channel ID of the resource.

Example: 5
idintegerRequired

Unique identifier of the resource

Example: 1
Responses
delete
/api/channel/{channel_id}/cancellation_requests/{id}/

No content

Partial update a cancellation request

patch

Partial update an existing cancellation request

Authorizations
AuthorizationstringRequired
Path parameters
channel_idintegerRequired

The channel ID of the resource.

Example: 5
idintegerRequired

Unique identifier of the resource

Example: 1
Body
statusstring · enumOptional

Status of the cancellation request.

Example: waitingPossible values:
descriptionstring | nullableOptional

Description of the cancellation request

ibanstring | nullableOptional

IBAN for refund

holder_namestring | nullableOptional

Name of the account holder

cancellation_typestring · enumOptional

Type of cancellation

Example: cancelPossible values:
quantityinteger | nullableOptional

Quantity of items to be cancelled

fully_refund_as_loyalty_moneybooleanOptional

Flag to indicate if the refund should be processed as loyalty money

Default: false
reasonintegerOptional

Related cancellation reason ID

Example: 1
order_itemintegerOptional

Related order item ID

Example: 1
Responses
200

Cancellation request updated successfully

application/json
patch
/api/channel/{channel_id}/cancellation_requests/{id}/

Retrieve a cancellation request

get

Get detailed information about a specific cancellation request

Authorizations
AuthorizationstringRequired
Path parameters
channel_idintegerRequired

The channel ID of the resource.

Example: 5
idintegerRequired

Unique identifier of the resource

Example: 1
Responses
200

Cancellation request for given ID

application/json
get
/api/channel/{channel_id}/cancellation_requests/{id}/detailed/

List cancellation requests

get

Get a list of cancellation requests for a sales channel

Authorizations
AuthorizationstringRequired
Path parameters
channel_idintegerRequired

The channel ID of the resource.

Example: 5
Query parameters
limitinteger · min: 1Optional

Indicates the number of rows on the current page.

Default: 10
pageinteger · min: 1Optional

Specifies the page number of the current dataset

Default: 1
pk__ininteger[]Optional

Filter by multiple primary key values (comma-separated list of integers)

statusstring · enumOptional

Status of the cancellation request.

Example: rejectedPossible values:
numberstringOptional

Order number (case-insensitive)

date_placedstring · date-timeOptional

Order number (case-insensitive)

date_placed__gtestring · date-timeOptional
date_placed__gtstring · date-timeOptional

Order placed after this date

date_placed__ltstring · date-timeOptional
date_placed__ltestring · date-timeOptional
date_placed__date__gtstring · dateOptional
date_placed__date__gtestring · dateOptional
date_placed__date__ltstring · dateOptional
date_placed__date__ltestring · dateOptional
skustringOptional

Product SKU (case-insensitive)

channelintegerOptional

ID of the channel the customer belongs to

Example: 5
customer_first_namestringOptional

Customer's first name (case-insensitive)

customer_last_namestringOptional

Customer's last name (case-insensitive)

customer_emailstring · emailOptional

Customer's email (case-insensitive)

order_idintegerOptional

Order ID

cancellation_plan_statusstring · enumOptional

Status of the cancellation plan

Example: waitingPossible values:
easy_return_codestringOptional

Easy return code (case-insensitive)

tracking_numberstringOptional

Tracking number (case-insensitive)

Responses
200

List of cancellation requests

application/json
get
/api/channel/{channel_id}/cancellation_requests/

Create a cancellation request

post

Create a new cancellation request for a sales channel

Authorizations
AuthorizationstringRequired
Path parameters
channel_idintegerRequired

The channel ID of the resource.

Example: 5
Body
order_itemintegerRequired

Related order item ID

Example: 1
reasonintegerRequired

Related cancellation reason ID

Example: 1
descriptionstring | nullableOptional

Description of the cancellation request

cancellation_typestring · enumRequired

Type of cancellation

Example: cancelPossible values:
ibanstring | nullableOptional

IBAN for refund

holder_namestring | nullableOptional

Name of the account holder

quantityinteger | nullableOptional

Quantity of items to be cancelled

Responses
post
/api/channel/{channel_id}/cancellation_requests/

List cancellation requests with detailed information

get

Get a list of cancellation requests for a sales channel with detailed information

Authorizations
AuthorizationstringRequired
Path parameters
channel_idintegerRequired

The channel ID of the resource.

Example: 5
Query parameters
limitinteger · min: 1Optional

Indicates the number of rows on the current page.

Default: 10
pageinteger · min: 1Optional

Specifies the page number of the current dataset

Default: 1
pk__ininteger[]Optional

Filter by multiple primary key values (comma-separated list of integers)

statusstring · enumOptional

Status of the cancellation request.

Example: rejectedPossible values:
numberstringOptional

Order number (case-insensitive)

date_placed__gtestring · date-timeOptional
date_placed__gtstring · date-timeOptional

Order placed after this date

date_placed__ltstring · date-timeOptional
date_placed__ltestring · date-timeOptional
date_placed__date__gtstring · dateOptional
date_placed__date__gtestring · dateOptional
date_placed__date__ltstring · dateOptional
date_placed__date__ltestring · dateOptional
skustringOptional

Product SKU (case-insensitive)

channelintegerOptional

ID of the channel the customer belongs to

Example: 5
customer_first_namestringOptional

Customer's first name (case-insensitive)

customer_last_namestringOptional

Customer's last name (case-insensitive)

customer_emailstring · emailOptional

Customer's email (case-insensitive)

order_idintegerOptional

Order ID

cancellation_plan_statusstring · enumOptional

Status of the cancellation plan

Example: waitingPossible values:
easy_return_codestringOptional

Easy return code (case-insensitive)

tracking_numberstringOptional

Tracking number (case-insensitive)

Responses
200

List of cancellation requests

application/json
get
/api/channel/{channel_id}/cancellation_requests/detailed

Was this helpful?