Returns API Edit the file on GitHub
Returns API allows Skroutz Merchants to retrieve and manage their returns.
Returns API is currently under development.
Table of Contents
Setup
Obtaining an API token
In order to be able to use the API, you need to generate an API token from within Smart Cart settings page in merchant's panel (Merchants > Services > Skroutz Marketplace).
There can only be one active API key per shop at a certain time. Creating a new API key will expire any previous one.
The same API token used for the Orders API is used here.
Authorization
Pass in a valid API token in the Authorization header, prefixed with Bearer
as in the following curl example.
A specific Accept header is also required.
curl -X GET https://api.skroutz.gr/merchants/ecommerce/returns/R-111111-1111111 \ -H 'Accept: application/vnd.skroutz+json; version=3.0' \ -H 'Authorization: Bearer your_access_token_here'
Endpoints
Retrieve a single return
Fetch the details of a single return, identified by its return_code.
GET /merchants/ecommerce/returns/:return_code
Example
curl -X GET https://api.skroutz.gr/merchants/ecommerce/returns/R-111111-1111111 \ -H 'Accept: application/vnd.skroutz+json; version=3.0' \ -H 'Authorization: Bearer your_access_token_here'
Response
{
"return": {
"return_code": "R-111111-1111111",
"state": "returning",
"order_code": "DEMO-OPEN",
"created_at": "2026-01-01T10:00:00Z",
"courier_tracking_ids": ["DEMO-RET-TRACK-1", "DEMO-RET-TRACK-2"],
"courier": "ACS",
"returning_address": {
"street_name": "Demo Street",
"street_number": "1",
"zip": "11111",
"city": "Demo City",
"region": "Demo Region",
"country_code": "GR"
},
"return_line_items": [
{
"id": "DEMO-ITEM-1",
"ean": "1234567890123",
"product_name": "Demo Product",
"returning_quantity": 1,
"return_reason": "damaged_product",
"user_comment": "This is a demo comment explaining the return.",
"user_photos": [
"https://a.scdn.gr/demo/return_photo_1.jpg"
]
}
]
}
}Handle a return waiting for review
Some returns wait for the merchant's review before Skroutz schedules them: a faulty product, a
missing part, or a withdrawal or wrong size outside the return policy. Such a return is in state
pending_merchant_review and carries a review with its deadline and the
handle_options it accepts.
Send one of the handle_options as option, with the params it takes. The response is the
updated return.
POST /merchants/ecommerce/returns/:return_code/handle
| Option | Params |
|---|---|
approve |
None |
A rejection reason, e.g. not_faulty |
comment, required when the option's comment_required is true, up to 1000 characters. proposed_part_url, optional and only when the option's supports_proposed_part_url is true: a link on Skroutz to the part, e.g. when it is sold separately |
send_missing_part |
See Send the missing part |
Every option resolves the review, so the return leaves pending_merchant_review (e.g. to rejected
after a rejection) and Skroutz sends a return updated webhook.
Example: approve
curl -X POST https://api.skroutz.gr/merchants/ecommerce/returns/R-111111-1111111/handle \
-H 'Accept: application/vnd.skroutz+json; version=3.0' \
-H 'Content-Type: application/json; charset=utf-8' \
-H 'Authorization: Bearer your_access_token_here' \
-d '{ "option": "approve" }'
Example: reject
curl -X POST https://api.skroutz.gr/merchants/ecommerce/returns/R-111111-1111111/handle \
-H 'Accept: application/vnd.skroutz+json; version=3.0' \
-H 'Content-Type: application/json; charset=utf-8' \
-H 'Authorization: Bearer your_access_token_here' \
-d '{ "option": "not_faulty", "comment": "The product works according to its specifications." }'
POST https://api.skroutz.gr/merchants/ecommerce/returns/DEMO-RETURN-REVIEW/handle
View Response Params{
"option": "not_faulty",
"comment": "The product works according to its specifications."
}Status: 200
{
"return": {
"return_code": "DEMO-RETURN-REVIEW",
"state": "pending_merchant_review",
"order_code": "DEMO-OPEN",
"created_at": "2026-01-01T10:00:00Z",
"courier_tracking_ids": [
"DEMO-RET-TRACK-1",
"DEMO-RET-TRACK-2"
],
"courier": "ACS",
"returning_address": {
"street_name": "Demo Shop",
"street_number": "7",
"zip": "18531",
"city": "Piraeus",
"region": "Attica",
"country_code": "GR"
},
"return_line_items": [
{
"id": "demo-rli-1",
"ean": "1234567890123",
"product_name": "Demo return item",
"returning_quantity": 1,
"return_reason": "faulty",
"user_comment": "Demo customer comment about the return",
"user_photos": [
"https://demo.scdn.gr/ds/ecommerce/return_request_line_item_images/demo-img-1.jpeg",
"https://demo.scdn.gr/ds/ecommerce/return_request_line_item_images/demo-img-2.jpeg"
]
}
],
"review": {
"review_type": "faulty",
"expires_at": "2026-01-01T21:00:00+02:00",
"holiday_auto_approval": false,
"customer_conversation_open": false
},
"handle_options": [
{
"option": "approve"
},
{
"option": "contact_manufacturer",
"comment_required": true
},
{
"option": "usability_suggestions",
"comment_required": true
},
{
"option": "not_faulty",
"comment_required": true
},
{
"option": "resolved_via_customer_communication",
"comment_required": false
}
]
}
}Send the missing part
For a missing_part review, the merchant can send the missing part to the customer instead of
receiving the product back. Skroutz creates an additional delivery of the part, at the shop's
cost, and the return moves to resolved_without_return: the product is not returned.
Pick the values from the option's delivery, as when
accepting an order. All params are required.
| Param | Type | Description |
|---|---|---|
pickup_location |
String | The id of one of the delivery.pickup_location |
cargo |
Boolean | true to book the cargo carrier, using the location's cargo_pickup_window. false otherwise, using its pickup_window |
pickup_window |
String | The id of one of the chosen list's windows. The window books its own courier |
weight |
Integer | Kilos, within delivery.weight |
number_of_parcels |
Integer | One of delivery.number_of_parcels |
items_description |
String | What is being sent, up to 250 characters |
delivery_reason |
String | Why it is being sent, up to 250 characters |
A window that is no longer available is rejected, never replaced with another one. Fetch the return again for the current windows: the windows in a webhook payload are those available when it was sent.
curl -X POST https://api.skroutz.gr/merchants/ecommerce/returns/R-111111-1111111/handle \
-H 'Accept: application/vnd.skroutz+json; version=3.0' \
-H 'Content-Type: application/json; charset=utf-8' \
-H 'Authorization: Bearer your_access_token_here' \
-d '{
"option": "send_missing_part",
"pickup_location": "YlpD0KROym",
"cargo": false,
"pickup_window": "20261029T1000-20261029T1400",
"weight": 2,
"number_of_parcels": 1,
"items_description": "Mounting accessories",
"delivery_reason": "Sending the missing part"
}'
Handle errors
| Status | Code | When |
|---|---|---|
400 |
ParameterMissing |
option is missing |
404 |
return_error |
The return does not exist or does not belong to your shop |
422 |
review_state |
The return is not waiting for your review: it was already handled, its deadline passed, or it never needed one |
422 |
option |
The return does not offer this option, e.g. contact_customer |
422 |
The param's name, e.g. comment, pickup_window |
The param is missing or invalid |
{
"errors": [
{
"code": "pickup_window",
"messages": [
"is not an available pickup window"
]
}
]
}Confirm that a return arrived
Once a return's products are back at your shop, confirm that they arrived, as Set as returned to
shop does in the merchant's panel. The return is in state returning. The request takes no body,
and the response is the updated return.
POST /merchants/ecommerce/returns/:return_code/set_delivered
When the return travels with a courier Skroutz booked, you can confirm it once the courier has picked it up from the customer, and confirming it marks its shipment delivered. A return of an order you ship without Skroutz tracking can be confirmed as soon as it is on its way back.
The return then leaves returning: to returned, or to pending_physical_review or
pending_service_inspection when its products wait for your review or inspection. Skroutz sends a
return updated webhook.
Example
curl -X POST https://api.skroutz.gr/merchants/ecommerce/returns/R-111111-1111111/set_delivered \ -H 'Accept: application/vnd.skroutz+json; version=3.0' \ -H 'Authorization: Bearer your_access_token_here'
Confirmation errors
| Status | Code | When |
|---|---|---|
404 |
return_error |
The return does not exist or does not belong to your shop |
422 |
return_state |
The return is not on its way back to you: it is still waiting for your review, it was resolved without sending anything back, or it is a demo return |
422 |
return_state |
The return has not been picked up from the customer yet |
422 |
return_state |
The return is already delivered |
422 |
return_state |
The return cannot be marked as delivered: for any other reason, e.g. it goes to a Fulfilled by Skroutz warehouse |
422 |
return_error |
The return could not be marked as delivered: an unexpected error. Try again later |
{
"errors": [
{
"code": "return_state",
"messages": [
"The return has not been picked up from the customer yet"
]
}
]
}Submit the service inspection of an item
A faulty product the customer sent back for a technical inspection waits for the merchant's report.
The return is in state pending_service_inspection, and each line item waiting for a report carries
an inspection with its deadline and the options it accepts.
A return with several faulty items is inspected item by item.
Send the item's id as item and one of its inspection.options as option, with what the option
requires. Send it as multipart/form-data, since it carries files. The response is the updated return.
POST /merchants/ecommerce/returns/:return_code/service_inspection
| Param | Type | Description |
|---|---|---|
item |
String | The id of the line item |
option |
String | One of the item's inspection.options |
service_report_file |
File | The service report, required when the option's service_report_file_required is true. PNG, JPEG, JPG or PDF, up to 7 MB |
in_stock |
Boolean | true or false: whether you can send the customer a replacement. Required when the option's in_stock_required is true |
comment |
String | Optional, a comment to the customer, up to 400 characters |
additional_attachments[] |
File | Optional, up to 5 files for the customer, each PNG, JPEG, JPG or PDF, up to 7 MB. Send the param once per file, with [] |
The request answers 200 with the updated return once the result is applied. Once submitted, the
item no longer carries an inspection. When no item waits for an inspection, the return leaves
pending_service_inspection (e.g. to returned) and Skroutz sends a
return updated webhook.
While the item's inspection carries a report_check, the service report is checked
before the result is applied, and the request may answer 202 instead: see
When the service report is checked.
Example: free repair under warranty
curl -X POST https://api.skroutz.gr/merchants/ecommerce/returns/R-111111-1111111/service_inspection \ -H 'Accept: application/vnd.skroutz+json; version=3.0' \ -H 'Authorization: Bearer your_access_token_here' \ -F 'item=gY6oNzr8jp' \ -F 'option=under_warranty_repairable' \ -F 'service_report_file=@service_report.pdf' \ -F 'comment=The charging port was replaced and the tablet tested for 2 hours.' \ -F 'additional_attachments[]=@photo_1.jpg' \ -F 'additional_attachments[]=@photo_2.jpg'
Example: replacement under warranty, out of stock
curl -X POST https://api.skroutz.gr/merchants/ecommerce/returns/R-111111-1111111/service_inspection \ -H 'Accept: application/vnd.skroutz+json; version=3.0' \ -H 'Authorization: Bearer your_access_token_here' \ -F 'item=gY6oNzr8jp' \ -F 'option=under_warranty_unrepairable' \ -F 'in_stock=false' \ -F 'service_report_file=@service_report.pdf'
Response
{
"return": {
"return_code": "R-111111-1111111",
"state": "returned",
"order_code": "48213907",
"created_at": "2026-08-18T09:12:03Z",
"return_line_items": [
{
"id": "gY6oNzr8jp",
"ean": "1234567890123",
"product_name": "Apple iPad 10.9 64GB",
"returning_quantity": 1,
"return_reason": "faulty",
"requested_compensation": "repair",
"user_comment": "The tablet does not charge."
}
]
}
}When the service report is checked
While the item's inspection carries a report_check, Skroutz checks the service
report before it applies the result sent with it. The request stays the same, with two differences:
service_report_fileis required on every request, whatever the option.- A report that has to be checked is checked after the request answers. The request answers
202with the return, its item'sreport_check.statenowchecking, and the result is applied once the check ends.
What the request does depends on the report sent and on the item's report_check.state:
| The report sent | Answer |
|---|---|
Any report, while checking |
422 inspection_state |
The report the item already holds, when invalid |
422 service_report_file. It is not checked again |
The report the item already holds, when valid or skipped |
200: the result is applied with it, without a new check |
| Another report | 202: the report is checked first. If the item takes no other report, 422 service_report_file: send the item's last report again |
The report the item already holds is recognised by its content, not by its file name. Reports uploaded from the merchant panel count too: a report checked there can be sent here with the result.
After a 202, the outcome reaches you with a
return updated webhook, or by retrieving the return:
| The check | What happens |
|---|---|
| The report is valid | The result is applied, as after a 200 |
| The report is invalid | Nothing is applied. The webhook's changes.inspection_report_check goes from checking to invalid, and the item's report_check says what the report lacks. Send another report with the result |
Whenever the result was not applied, the webhook's changes.inspection_report_check carries the item's
new report_check.state, and the report check says what to send next.
Requests that send a report are limited to 30 per 10 minutes, and answer 429 past that.
Response when the report is checked first
Status: 202 Accepted
{
"return": {
"return_code": "R-111111-1111111",
"state": "pending_service_inspection",
"order_code": "48213907",
"created_at": "2026-08-18T09:12:03Z",
"return_line_items": [
{
"id": "gY6oNzr8jp",
"ean": "1234567890123",
"product_name": "Apple iPad 10.9 64GB",
"returning_quantity": 1,
"return_reason": "faulty",
"requested_compensation": "repair",
"user_comment": "The tablet does not charge.",
"inspection": {
"expires_at": "2026-09-04T23:59:59+03:00",
"options": [
{ "option": "under_warranty_repairable", "service_report_file_required": true, "in_stock_required": false },
{ "option": "under_warranty_unrepairable", "service_report_file_required": true, "in_stock_required": true },
{ "option": "no_warranty_repairable", "service_report_file_required": true, "in_stock_required": false },
{ "option": "no_warranty_unrepairable", "service_report_file_required": true, "in_stock_required": false },
{ "option": "unconfirmed", "service_report_file_required": true, "in_stock_required": false }
],
"report_check": { "state": "checking" }
}
}
]
}
}Inspection errors
| Status | Code | When |
|---|---|---|
400 |
ParameterMissing |
item or option is missing |
404 |
return_error |
The return does not exist or does not belong to your shop |
422 |
item |
The return has no such item |
422 |
inspection_state |
The item is not waiting for your inspection: it has none, it was already submitted, or Skroutz handles it |
422 |
inspection_state |
A report of the item is being checked |
422 |
option |
The item does not offer this option |
422 |
service_report_file |
While the report is checked: no report was sent, the report sent was already found invalid, or the item takes no other report |
422 |
The param's name, e.g. in_stock, service_report_file, additional_attachments |
The param is missing or invalid |
429 |
More than 30 requests with a report in 10 minutes |
{
"errors": [
{
"code": "in_stock",
"messages": [
"must be answered for the selected service outcome"
]
}
]
}Watch a customer video
The url and thumbnail_url of a line item's user_videos point to the
following endpoints. Each takes your API token and redirects to the video's player page or its
thumbnail image, on a link signed for a short time. Request them when you need to show the video,
rather than storing the link they redirect to.
GET /merchants/ecommerce/returns/:return_code/videos/:id GET /merchants/ecommerce/returns/:return_code/videos/:id/thumbnail
| Status | When |
|---|---|
302 |
Redirects to the player page or the thumbnail |
404 |
The video does not exist, is not yet uploaded, or does not belong to your return |
429 |
More than 60 video requests in a minute |
503 |
The video could not be signed. Try again later |
Error handling
In case of errors, the response will have a representative HTTP status code
in the 4xx range. The body would contain an array of errors.
For example, if the requested return code does not exist (or does not belong to your shop),
you will get a 404 HTTP status code (Not Found):
{
"errors": [
{
"code": "not_found",
"messages": [
"Return not found"
]
}
]
}Test requests (sandbox)
The following demo return code is available on production for testing reasons.
It is safe to issue requests for the following demo return code multiple times for testing, since it does not reference any real data.
DEMO-RETURN
A demo return with a single returning line item, courier tracking ids and a returning address.
GET /merchants/ecommerce/returns/DEMO-RETURN
GET https://api.skroutz.gr/merchants/ecommerce/returns/DEMO-RETURN
View ResponseStatus: 200
{
"return": {
"return_code": "DEMO-RETURN",
"state": "returning",
"order_code": "DEMO-OPEN",
"created_at": "2026-01-01T10:00:00Z",
"courier_tracking_ids": [
"DEMO-RET-TRACK-1",
"DEMO-RET-TRACK-2"
],
"courier": "ACS",
"returning_address": {
"street_name": "Demo Shop",
"street_number": "7",
"zip": "18531",
"city": "Piraeus",
"region": "Attica",
"country_code": "GR"
},
"return_line_items": [
{
"id": "demo-rli-1",
"ean": "1234567890123",
"product_name": "Demo return item",
"returning_quantity": 1,
"return_reason": "damaged_product",
"user_comment": "Demo customer comment about the return",
"user_photos": [
"https://demo.scdn.gr/ds/ecommerce/return_request_line_item_images/demo-img-1.jpeg",
"https://demo.scdn.gr/ds/ecommerce/return_request_line_item_images/demo-img-2.jpeg"
]
}
]
}
}DEMO-RETURN-REVIEW
A demo return of a faulty product, waiting for the merchant's review, with its review and
handle_options.
GET /merchants/ecommerce/returns/DEMO-RETURN-REVIEW POST /merchants/ecommerce/returns/DEMO-RETURN-REVIEW/handle
Handling it with any of its handle_options answers with the same return, unchanged.
GET https://api.skroutz.gr/merchants/ecommerce/returns/DEMO-RETURN-REVIEW
View ResponseStatus: 200
{
"return": {
"return_code": "DEMO-RETURN-REVIEW",
"state": "pending_merchant_review",
"order_code": "DEMO-OPEN",
"created_at": "2026-01-01T10:00:00Z",
"courier_tracking_ids": [
"DEMO-RET-TRACK-1",
"DEMO-RET-TRACK-2"
],
"courier": "ACS",
"returning_address": {
"street_name": "Demo Shop",
"street_number": "7",
"zip": "18531",
"city": "Piraeus",
"region": "Attica",
"country_code": "GR"
},
"return_line_items": [
{
"id": "demo-rli-1",
"ean": "1234567890123",
"product_name": "Demo return item",
"returning_quantity": 1,
"return_reason": "faulty",
"user_comment": "Demo customer comment about the return",
"user_photos": [
"https://demo.scdn.gr/ds/ecommerce/return_request_line_item_images/demo-img-1.jpeg",
"https://demo.scdn.gr/ds/ecommerce/return_request_line_item_images/demo-img-2.jpeg"
]
}
],
"review": {
"review_type": "faulty",
"expires_at": "2026-01-01T21:00:00+02:00",
"holiday_auto_approval": false,
"customer_conversation_open": false
},
"handle_options": [
{
"option": "approve"
},
{
"option": "contact_manufacturer",
"comment_required": true
},
{
"option": "usability_suggestions",
"comment_required": true
},
{
"option": "not_faulty",
"comment_required": true
},
{
"option": "resolved_via_customer_communication",
"comment_required": false
}
]
}
}DEMO-RETURN-INSPECTION
A demo return of a faulty product, waiting for the merchant's inspection. Its item, demo-rli-1,
carries an inspection.
GET /merchants/ecommerce/returns/DEMO-RETURN-INSPECTION POST /merchants/ecommerce/returns/DEMO-RETURN-INSPECTION/service_inspection
Submitting any of its item's inspection.options answers 200 with the same return, unchanged. The
files are not stored, and its inspection has no report_check.
GET https://api.skroutz.gr/merchants/ecommerce/returns/DEMO-RETURN-INSPECTION
View ResponseStatus: 200
{
"return": {
"return_code": "DEMO-RETURN-INSPECTION",
"state": "pending_service_inspection",
"order_code": "DEMO-OPEN",
"created_at": "2026-01-01T10:00:00Z",
"courier_tracking_ids": [
"DEMO-RET-TRACK-1",
"DEMO-RET-TRACK-2"
],
"courier": "ACS",
"returning_address": {
"street_name": "Demo Shop",
"street_number": "7",
"zip": "18531",
"city": "Piraeus",
"region": "Attica",
"country_code": "GR"
},
"return_line_items": [
{
"id": "demo-rli-1",
"ean": "1234567890123",
"product_name": "Demo return item",
"returning_quantity": 1,
"return_reason": "faulty",
"user_comment": "Demo customer comment about the return",
"user_photos": [
"https://demo.scdn.gr/ds/ecommerce/return_request_line_item_images/demo-img-1.jpeg",
"https://demo.scdn.gr/ds/ecommerce/return_request_line_item_images/demo-img-2.jpeg"
],
"inspection": {
"expires_at": "2026-01-11T12:00:00+02:00",
"options": [
{
"option": "under_warranty_repairable",
"service_report_file_required": true,
"in_stock_required": false
},
{
"option": "under_warranty_unrepairable",
"service_report_file_required": true,
"in_stock_required": true
},
{
"option": "no_warranty_repairable",
"service_report_file_required": true,
"in_stock_required": false
},
{
"option": "no_warranty_unrepairable",
"service_report_file_required": true,
"in_stock_required": false
},
{
"option": "unconfirmed",
"service_report_file_required": true,
"in_stock_required": false
}
]
}
}
]
}
}Return object attributes appendix
Return object
| Name | Type | Values | Description |
|---|---|---|---|
return_code |
String | Return Code | |
state |
String | pending_merchant_review, returning, pending_physical_review, pending_service_inspection, returned, rejected, expired, cancelled, resolved_without_return |
Current lifecycle state of the return. One of the return states. |
order_code |
String | The code of the order this return belongs to | |
created_at |
Date String in formatYYYY-MM-DDTHH:MM:SSZ |
Return creation date | |
courier_tracking_ids |
Array of Strings | (Optional) | Deduplicated tracking IDs across current shipments |
courier |
String | (Optional) | Human-readable name of the courier (e.g. ACS) |
returning_address |
Object | (Optional) | Returning address — the address the merchant should receive the return at |
return_line_items |
Array | Return line items — the products being returned | |
review |
Object | (Optional) | Review — the review waiting for the merchant |
handle_options |
Array | (Optional) | Handle options — the ways the merchant can handle the review |
courier_tracking_ids, courier and returning_address are omitted entirely (not sent as null)
when not applicable — e.g. virtual returns with no shipment.
review and handle_options are present only while the return is in state pending_merchant_review
and waits for the merchant's review. They are omitted once the review is handled or its deadline passes.
Return states
The state field is one of the following string values:
| State | Description |
|---|---|
pending_merchant_review |
The customer submitted a return request and the merchant needs to review it. |
returning |
The package is in transit back to the merchant. |
pending_physical_review |
The package arrived at the merchant and must perform physical inspection. |
returned |
The package was delivered back to the merchant. |
rejected |
The return was rejected. |
expired |
The merchant never responded to the return request within the deadline. |
cancelled |
The return was cancelled. |
pending_service_inspection |
A technician or an authorised service is to inspect the product. Each item waiting for the merchant's report carries an inspection. |
resolved_without_return |
The merchant sent the customer the missing part, so the product is not returned. |
Returning address
Present only when the return has a shipment.
| Name | Type | Description |
|---|---|---|
returning_address.street_name |
String | Street/road name |
returning_address.street_number |
String | Building number |
returning_address.zip |
String | Postal code |
returning_address.city |
String | City |
returning_address.region |
String | Region/state |
returning_address.country_code |
String | Country code (e.g. GR) |
Return line items
Each element of the return_line_items array represents one product line being returned.
| Name | Type | Values | Description |
|---|---|---|---|
id |
String | ID of the order line item being returned | |
ean |
String | EAN code of the product being returned | |
product_name |
String | Product display name | |
returning_quantity |
Integer | How many units of this product the customer is returning | |
return_reason |
String | faulty, wrong_product, withdrawal, damaged_product, expired_product, authenticity_doubt, delivery_issues, other (Optional) |
Reason the customer selected |
sub_reason |
String | different_product, missing_line_item, missing_part, wrong_delivered_size, content_mistake, damaged_courier_fault, damaged_merchant_fault (Optional) |
A more specific reason, e.g. missing_part for a wrong_product return |
requested_compensation |
String | refund, replace, repair, gift_card, none, consolation_coupon (Optional) |
What the customer asked for |
user_comment |
String | (Optional) | Free-text comment left by the customer explaining the return |
user_photos |
Array of Strings | (Optional) | Full URLs of photos uploaded by the customer as evidence |
user_videos |
Array | (Optional) | Videos uploaded by the customer as evidence |
inspection |
Object | (Optional) | Inspection — the technical inspection of this item, waiting for the merchant's report |
User videos
| Name | Type | Description |
|---|---|---|
id |
String | The video ID |
url |
String | Watch the video (requires your API token) |
thumbnail_url |
String | The video's thumbnail (requires your API token) |
Inspection
Present on each line item whose technical inspection waits for the merchant's report, while the
return is in state pending_service_inspection. A return with several faulty items carries one per
item. It is omitted once the item's report is submitted.
| Name | Type | Description |
|---|---|---|
inspection.expires_at |
Date String in ISO 8601 format | Until when the merchant can submit the inspection |
inspection.options |
Array | The inspection options the merchant can submit for this item |
inspection.report_check |
Object | (Optional) The report check: where the check of the item's service report stands. Present while Skroutz checks the service reports of this item |
Inspection options
| Name | Type | Description |
|---|---|---|
option |
String | The value to send as option |
service_report_file_required |
Boolean | Whether service_report_file is required with this option |
in_stock_required |
Boolean | Whether in_stock is required with this option |
| Option | Meaning |
|---|---|
under_warranty_repairable |
Under warranty: the product is repaired for free |
under_warranty_unrepairable |
Under warranty: the product cannot be repaired, so it is replaced, or refunded when the merchant has no stock (in_stock: false) |
under_warranty_refund |
Under warranty: the customer is refunded. Offered instead of the two options above when the customer returned the product early and asked for a refund |
no_warranty_repairable |
Out of warranty: the customer can pay for the repair |
no_warranty_unrepairable |
Out of warranty: the product cannot be repaired, and a paid repair is not available |
unconfirmed |
The product has no defect |
Report check
Skroutz may check the service report before it applies the result sent with it: that the file is a
service report, and that it shows the inspection date, the technician's name and signature, and the
service's stamp. While it does, the item's inspection carries report_check, and
submitting the inspection works as
described there.
| Name | Type | Values | Description |
|---|---|---|---|
state |
String | not_started, checking, invalid, valid, skipped |
Where the check stands |
reason |
String | (Optional) missing_fields, not_a_service_report |
Only when invalid: the report lacks required elements, or the file is not a service report |
missing_fields |
Array of Strings | (Optional) inspection_date, technician_name, technician_signature, service_stamp |
Only when invalid: the elements the report lacks |
| State | Description |
|---|---|
not_started |
No report of this item has been checked yet. |
checking |
A report of this item is being checked. A submission is refused until the check ends. |
invalid |
The item's report was found invalid; reason and missing_fields say why. Send another report. |
valid |
The item's report passed the check. Send it again with the result to submit it. |
skipped |
The item's report is not checked. Send the item's last report again with the result to submit it. |
Review
Present while the return waits for the merchant's review.
| Name | Type | Values | Description |
|---|---|---|---|
review_type |
String | faulty, missing_part, out_of_policy_withdrawal, unopened_category_withdrawal, out_of_policy_wrong_size, unopened_category_wrong_size |
Why the return needs the merchant's review |
expires_at |
Date String in ISO 8601 format | Until when the merchant can handle the review. Afterwards Skroutz handles it, and the merchant may lose their right to compensation | |
holiday_auto_approval |
Boolean | Whether the withdrawal is out of policy only because of the holiday period, so Skroutz approves it when the deadline passes | |
customer_conversation_open |
Boolean | Whether a conversation with the customer about the product is open in the merchant panel |
Handle options
The options to send to handle the return:
approve, then send_missing_part, then the rejection reasons. Each option resolves the review. Contacting the customer,
which only extends the deadline, is available in the merchant panel only.
| Name | Type | Description |
|---|---|---|
option |
String | The value to send as option: approve, send_missing_part or a rejection reason |
comment_required |
Boolean | Rejection reasons only: whether comment is required |
supports_proposed_part_url |
Boolean | Rejection reasons only, present only when true: whether proposed_part_url can be sent |
delivery |
Object | send_missing_part only: the delivery options |
Rejection reasons
| Review type | Rejection reasons |
|---|---|
faulty |
contact_manufacturer (not offered while the product is within the dead on arrival period), usability_suggestions, not_faulty, resolved_via_customer_communication |
missing_part |
part_not_included, not_missing_part, resolved_via_customer_communication |
out_of_policy_withdrawal, unopened_category_withdrawal, out_of_policy_wrong_size, unopened_category_wrong_size |
out_of_policy_withdrawal |
| Option | Meaning |
|---|---|
approve |
The merchant accepts the return |
send_missing_part |
The merchant sends the missing part to the customer with an additional delivery, at the shop's cost, and the product is not returned. Offered for missing_part reviews when the order can get an additional delivery, but not for a product the merchant delivered with their own cargo carrier |
contact_manufacturer |
The customer needs to contact the manufacturer or the authorised service provider |
usability_suggestions |
The product has been used in a way that affects how it works |
not_faulty |
The product is not faulty: it works according to its specifications |
part_not_included |
The product was delivered complete as described: no part is missing. The merchant can point the customer to the part on Skroutz, e.g. when it is sold separately, with proposed_part_url |
not_missing_part |
The product page on Skroutz has wrong content that needs a correction |
resolved_via_customer_communication |
The merchant already contacted the customer and the issue has been resolved |
out_of_policy_withdrawal |
The withdrawal is outside the return policy |
Delivery options
The choices for the missing part's delivery, named after the params of
send_missing_part, as in an order's
accept options.
| Name | Type | Example | Description |
|---|---|---|---|
delivery.pickup_location |
Array | Pickup locations, the order's own first | |
delivery.weight |
Object | { "min": 1, "max": 50 } |
Valid weight range, in whole kilos |
delivery.number_of_parcels |
Array | [1, 2, 3] |
Valid values for number_of_parcels |
Delivery option: Pickup location
| Name | Type | Description |
|---|---|---|
pickup_location.id |
String | The location ID to send as pickup_location. The same IDs as in an order's accept options |
pickup_location.label |
String | A human readable address |
pickup_location.pickup_window |
Array | Pickup windows to send with cargo: false |
pickup_location.cargo_pickup_window |
Array | Pickup windows to send with cargo: true. Present only for an order shipped as a cargo item |
Delivery option: Pickup window
| Name | Type | Example | Description |
|---|---|---|---|
pickup_window.id |
String | "20261029T1000-20261029T1400" |
The pickup window ID to send as pickup_window |
pickup_window.label |
String | "10:00 - 14:00, Πέμ 29/10/26" |
A human readable time range |
As in an order's accept options, the id identifies the window by its start and end time
(YYYYMMDDTHHMM-YYYYMMDDTHHMM, local Greek time). Each window books its own courier, so there is
no courier to choose. The same id can appear in both lists of a location, so cargo tells which
one you picked.