# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
This site has an agentic ask interface you may use to query the documentation dynamically by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.partner.aboutyou.com/index.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

---

# Overview

## Welcome to the Seller Center

Here, you’ll find everything you need to list your products on About You, handle orders, and manage shipment workflows. Each section provides step-by-step guidance—from setting up your products and editing stock or prices to fulfilling customer orders and processing returns. Additionally, you can read about the mode of operation and About You's service and logistic requirements.&#x20;

For those who want deeper integration, there’s also an API documentation.

Whether you’re just getting started or exploring advanced features, this documentation will help you leverage the Seller Center for your business.

{% embed url="<https://drive.google.com/file/d/1DUV1uKBLvsIwgkt6A64bs6o-19BbQVr5/view?usp=sharing>" %}

***

## Upload and Manage Products

• Add products via the UI, Excel import or API.

• Update stock and pricing in a few clicks.

• Publish products to go live on About You.

*You can find more information about this in the "User Guide" section.*

***

## Handle Orders and Shipments

• Monitor all incoming orders.

• Ship items individually or in batches, track cancellations, and manage returns.

*You can find more information about this in the "User Guide" section.*

***

## Use the API (Optional)

* Integrate your existing systems to automate product uploads, stock updates, and order processing.

*You can find more information about this in the "API" section.*


# Onboarding Guide

## Step 1: Registration

[<mark style="color:$primary;">Join our ABOUT YOU Marketplace</mark>](https://partner.aboutyou.com/merchants/apply-now) via a simplified onboarding process with our Seller Center platform.

## Step 2: Provide Information

Complete the onboarding questionnaire.

Once your initial application is approved, you will gain access to the Seller Center. There, you will find detailed information on the terms and conditions, along with our onboarding documentation. You will also be asked to fill out the onboarding questionnaire required to move forward in the process.

This form helps us to collect necessary information such as company, logistics and invoicing details, contact persons as well as brands you will bring live.

{% hint style="success" %}

## What You’ll Need to Complete the Questionnaire

**Company & Contact Details**

* [ ] Address & Phone Number

**Legal information**

* [ ] Register Number
* [ ] Tax ID Number
* [ ] VAT ID&#x20;

**Bank Details**

* [ ] IBAN & BIC/SWIFT

**Fulfillment**

* [ ] Shipping & Return warehouse address
* [ ] Carrier Information (per country)
* [ ] DE, CZ, SK & PL VAT ID’s (Required only for FbAY)
* [ ] LUCID (Required only for Germany Go Live’s)

**Brands**

* [ ] Manufacturer Name & Address (Only if you are not the manufacturer)
  {% endhint %}

The questionnaire consists of 4 parts:

<details>

<summary><strong>Your Data</strong></summary>

1. Select Your Type of Business: If you are a sole proprietorship choose ‘Natural Person’.
2. Company Data: Remember to include the legal entity suffix in the company name.

</details>

<details>

<summary><strong>Fulfillment</strong></summary>

You can choose between **Fulfilment by Seller** or **Fulfillment by About You**

Here you will be asked to enter the countries where you would like to sell your products. You are free to choose the countries you want to onboard from the currently available ones.

| Requirements                                                                                              |                          |
| --------------------------------------------------------------------------------------------------------- | ------------------------ |
| Fulfillment by Seller (You)                                                                               | Fulfillment by ABOUT YOU |
| <ul class="contains-task-list"><li><input type="checkbox">Self-adhesive return label in each shipping box |                          |

</li><li><input type="checkbox">LUCID Number (Required to sell in Germany)</li><li><input type="checkbox">Dispatch within 24h; delivery within 72–96h.</li><li><input type="checkbox">Use one of our approved Last Mile Carriers (LMC) per country</li></ul> | <ul class="contains-task-list"><li><input type="checkbox">VAT Compliance: DE &#x26; CZ IDs are mandatory (plus SK &#x26; PL for international warehousing). </li><li><input type="checkbox">For all other markets, provide either a local VAT ID or confirm your OSS (One Stop Shop) registration.</li></ul> |

{% hint style="info" %}
Please note that at the moment **only the listed shipping service providers may be used as the 'Last Mile Carriers'** for shipping and returns in the respective country.
{% endhint %}

</details>

<details>

<summary><strong>Brands</strong></summary>

The brands you would like to onboard.

{% hint style="info" %}
Please note, you can always add more brands after your initial go-live
{% endhint %}

You can select from already existing brands on ABOUT YOU or add a new one.

Adding new brands:

1. Select if you’re the Trademark owner or not: If not, please provide the Trademark owner name.
2. **Your manufacturer needs to be located within the EU** (Name of the EU manufacturer (Art. 3 (8) Regulation (EU) 2023/988) or, for non-EU suppliers, name of the importer/ authorized representative (Art. 3 (10) and (9) Regulation EU 2023/988)).

</details>

<details>

<summary><strong>Legal</strong></summary>

Here you find the **Marketplace Terms of Use** and the **Fulfillment Annex** documentation.&#x20;

{% hint style="info" %}
Please ensure you **indicate correctly** if your company is publicly traded.&#x20;
{% endhint %}

</details>

## Step 3: Verify Business

Submit the KYC form to confirm your company details.&#x20;

As part of the onboarding process, every partner needs to complete the Know Your Customer (KYC) process. This is a standard compliance requirement designed by the European Legislation for the purpose of combating financial crime.

{% hint style="success" %}

## What You’ll Need to Complete the Questionnaire (non-exhaustive)

* [ ] Recent Commercial Register Excerpt (legal entity) / Business Registration (sole proprietorship) / Partnership Agreement
* [ ] Bank statement (≤ 3 months old, showing company name, IBAN, BIC)
* [ ] VAT Certificate
* [ ] Valid Passport or e-ID (owners & representatives)
  {% endhint %}

### KYC Process

{% stepper %}
{% step %}

#### Identification

Provide information about your company and the people involved, and upload supporting documents (e.g. bank account confirmation, business registration certificate for sole traders, ID documents).

{% hint style="info" %}
The data you submit for the KYC Process should be related to the same legal entity you submitted your onboarding data for.&#x20;
{% endhint %}
{% endstep %}

{% step %}

#### Verification

The person signing the contract with SCAYLE Payments GmbH will receive a link to complete the video identification after submitting the KYC questionnaire.
{% endstep %}

{% step %}

#### Sign-Off

Once the review is complete, you’ll receive a KYC summary and the Payment Services Framework Agreement via DocuSign.
{% endstep %}
{% endstepper %}

## Step 4: Upload Products

Choose your preferred product integration method to list products.

Once you complete your KYC Questionnaire, while your data is being reviewed, you will be able to start uploading your products in the Seller Center.

{% hint style="success" %}

## What You’ll Need to Upload Products (non-exhaustive)

* [ ] Valid EAN *(Every product listed on the platform must have a valid EAN code for unique identification. Official codes can be acquired via GS1).*
* [ ] Product photo in 3:4 format
* [ ] Bust view photo
* [ ] Intrastat data: country of origin, custom tariffs code and weight of the product
  {% endhint %}

We offer **5 different types of product integration** to fit everyone’s needs.

{% tabs %}
{% tab title="Shopify Plugin" %}

#### Shopify Plugin

The easiest way to get started. Seamlessly sync your products, inventory, and orders directly from your Shopify store with just a few clicks. Once connected, you can handle everything related to orders - including fulfillment, cancellations, and returns - directly within your Shopify admin panel.&#x20;

{% hint style="info" %}
You need to have the Shopify Grow Plan to use this plugin.
{% endhint %}
{% endtab %}

{% tab title="API Integration" %}

#### API Integrators

The most powerful and automated solution. Ideal for brands with custom e-commerce systems, our API allows you to integrate your existing systems to fully automate product uploads, stock and price updates, and order processing for real-time control.
{% endtab %}

{% tab title="Integrators" %}

#### Integrators

The most streamlined option for brands already using a compatible middleware or e-commerce aggregator. This method is great for partners with an existing integration, as it allows you to use your current product data setup to connect with About You. We already offer integrations with Tradebyte, Baselinker and Sello and are actively expanding our range of integrator partnerships.
{% endtab %}

{% tab title="Excel Upload" %}

#### Excel Upload

Simple and accessible. Perfect for managing your catalog without needing any technical expertise. Just fill out our template and upload.
{% endtab %}

{% tab title="Manual " %}

#### Manual Product Upload

The fastest option for smaller assortments. Add your products directly into our Seller Center to get them ready for review instantly.
{% endtab %}
{% endtabs %}

## Step 5: Go Live

Activate your products and start growing your sales.

Once your questionnaire is approved, your products are uploaded and your KYC verification is complete, you're ready for the final step. We'll activate your account, and you can start selling to millions of fashion lovers across Europe!


# Mode of Operation

What is the Marketplace model about?

As one of the four cooperation models, ABOUT YOU offers Partners to work in a marketplace model. Our marketplace partners benefit in particular from:

* International growth with access to several Western European countries&#x20;
* Full control over product range as well as warehousing and logistic processes
* High efficiency and limited assortment risk
* High customer satisfaction through first class customer service by ABOUT YOU

***

### Model Overview

The ABOUT YOU Marketplace offers fashion brands and retailers the opportunity to sell their products directly to customers across multiple European countries via ABOUT YOU’s online shop. The model enables Merchants to expand their international reach while ABOUT YOU manages customer orders and payment processing through SCAYLE Payments.

The technical flow is based on a seamless integration: Merchants connect their product catalog to ABOUT YOU through the Seller Center, transmitting all necessary product data. When a customer places an order, ABOUT YOU processes the transaction and forwards the order details to the Merchant via the same interface. The Merchant is responsible for warehousing, fulfillment, and shipping the goods directly to the customer. Customer returns are sent back to the Merchant.

Payments are collected by ABOUT YOU and processed through SCAYLE Payments, with monthly settlements to the Merchant. This setup ensures a smooth and efficient collaboration, allowing Merchants to focus on their assortment while ABOUT YOU handles the technical infrastructure and payment processes.

<br>


# Key Services and Logistics Requirements

Below are the key services and logistics requirements for a successful integration and efficient live business. By fulfilling these requirements, you help ensure a smooth, reliable experience for both customers and partners. All details regarding shipment, returns, packaging, and communication have been carefully designed to uphold About You’s service quality and brand promise.

***

### Shipment

Orders must be dispatched within 24 hours of order creation and delivered with one of the specified Last Mile Carriers (LMC) below within 72 to 96 hours of order creation.&#x20;

Please find below an overview of all available LMCs for the respective countries, as well as the required delivery options (home delivery vs. PUDO).

### Grow Your Business Through Country Expansion

Expanding into new countries is one of the fastest ways to grow your business on the ABOUT YOU Marketplace. Each new market creates additional revenue opportunities with your existing assortment. Country expansion can also improve profitability, as many markets have significantly lower return rates than Germany (56.4%), including Greece (19.2%), Croatia (23.6%) and Romania (25.1%).

### Available Shop Countries

All **25 countries** are available for both fulfilment models: Fulfillment by Merchant and Fulfillment by ABOUT YOU. Below, you'll find an overview of the available countries and their respective last-mile carrier requirements.

<table><thead><tr><th width="153">Shop Country</th><th width="165.79998779296875">Last Mile Carrier (for both delivery and return)</th><th width="190.00006103515625">Mandatory Delivery Options</th><th>Optional Delivery Options</th></tr></thead><tbody><tr><td>Germany</td><td>DHL, HERMES</td><td>Home Delivery</td><td>PUDO (DHL, Hermes) </td></tr><tr><td>Austria</td><td>POST AT (preferred), DHL</td><td>Home Delivery</td><td>PUDO (Post AT)</td></tr><tr><td>Belgium</td><td>BPOST (preferred), DHL</td><td>Home Delivery/PUDO (BPOST)</td><td>-</td></tr><tr><td>Luxembourg</td><td>LU POST</td><td>Home Delivery</td><td>-</td></tr><tr><td>The Netherlands</td><td>POST NL (preferred), DHL NL</td><td>Home Delivery</td><td>PUDO (Post NL)</td></tr><tr><td>France</td><td>COLISSIMO</td><td>Home Delivery/PUDO</td><td>-</td></tr><tr><td>Poland</td><td>Inpost</td><td>Home Delivery/PUDO</td><td>-</td></tr><tr><td>Italy</td><td>POSTEITALIANE (preferred), DHL</td><td>Home Delivery</td><td>PUDO (POSTEITALIANE)</td></tr><tr><td>Denmark</td><td>GLS</td><td>Home Delivery/PUDO</td><td>-</td></tr><tr><td>Sweden</td><td>DHL SE</td><td>PUDO</td><td>-</td></tr><tr><td>Finland</td><td>POSTI</td><td>PUDO</td><td>-</td></tr><tr><td>Spain</td><td>SEUR (preferred), DHL, CORREOS</td><td>Home Delivery</td><td>PUDO (SEUR)</td></tr><tr><td>Czech Republic</td><td>Zásilkovna (preferred), PPL</td><td>Home Delivery/PUDO</td><td>-</td></tr><tr><td>Lithuania</td><td>Omniva</td><td>Home Delivery/PUDO</td><td>-</td></tr><tr><td>Latvia</td><td>Omniva</td><td>Home Delivery/PUDO</td><td>-</td></tr><tr><td>Estonia</td><td>Omniva</td><td>Home Delivery/PUDO</td><td>-</td></tr><tr><td>Slovakia</td><td>SK Post</td><td>Home Delivery/PUDO</td><td>-</td></tr><tr><td>Slovenia</td><td>SI Post</td><td>Home Delivery</td><td>PUDO</td></tr><tr><td>Croatia</td><td>HR Post</td><td>Home Delivery</td><td>PUDO</td></tr><tr><td>Romania</td><td>FAN RO</td><td>Home Delivery</td><td>PUDO</td></tr><tr><td>Hungary</td><td>GLS (preferred), HU Post</td><td>Home Delivery/PUDO</td><td>-</td></tr><tr><td>Bulgaria</td><td>Ekont</td><td>Home Delivery/PUDO</td><td>-</td></tr><tr><td>Greece</td><td>ACS </td><td>Home Delivery</td><td>PUDO</td></tr><tr><td>Portugal</td><td>CTT </td><td>Home Delivery</td><td>PUDO</td></tr><tr><td>Cyprus</td><td>ACS </td><td>Home Delivery</td><td>PUDO</td></tr></tbody></table>

***

### Delivery Documents

All delivery documents should use the About You layout and include the merchant’s company information wherever applicable.\
\
Please download the ABOUT YOU Delivery Note Templates below:

{% file src="/files/kLPXzxy5zEhsvKJCInau" %}

***

### Packaging

Merchants have three distinct packaging options available. Please note that the chosen packaging type directly influences your commission rate:\\

\
1\. Own Branded Packaging: \
Using your existing, branded packaging (e.g. with branded logo, stickers).

\
2\. Neutral Packaging:\\

Using unbranded, generic packaging with no stickers or logos attached.

\
3\. About You Branded Packaging:\
Using official About You branded materials.\\

\\

\
**Important Note on About You Packaging:**\\

\\

Merchants are recommended to use the About You packaging (only in case of absence of your own package material) to ensure a consistent and cohesive presentation of products to the end customer. Please be advised that if you select this option, the merchant is responsible for ordering the packages directly from ABOUT YOU and covering all associated costs.

***

### Return Label

Each package must contain a self-adhesive return label valid for 30 days, allowing customers to return items easily if needed.

***

### Tracking Code

Tracking information for each shipment must be transferred to About You in dispatch messages, enabling customers to follow their orders.

***

### Return Notification

Returned items should be processed and acknowledged (including any technical feedback) within 24 hours of arrival at the merchant’s facility.

***

### Misdirected Returns

ABOUT YOU asks Customers to return Goods in the very box they have received the Goods in\
directly to the Merchant. Nevertheless, Customers sometimes return either Merchant Goods to\
ABOUT YOU’s warehouse or the other way around. For this reason, an exchange process needs\
to be set up.

If the Customer returns Goods to the Merchant’s warehouse without the Merchant being able to\
identify the Goods as its own, the Merchant needs to send such Customers returns back to the\
ABOUT YOU warehouse:

**Hermes Fulfilment CZ s.r.o.**\
**Komenského 598**\
**332 03 Šťáhlavy**\
**Czech Republic**

ABOUT YOU will send misdirected Customer returns to Merchant’s warehouse accordingly. Based on volumes, this exchange of misdirected returns should take place in regular intervals.

In addition, the following label will be applied to misdirected items before they are returned to the partner.&#x20;

Please find an example below:

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FNmGhNdcf4MAYgdcwWm0z%2Fimage%20(26).png?alt=media&amp;token=aef77855-e1cb-4cb5-9393-db96c0e594b2" alt=""><figcaption></figcaption></figure>

* The EAN can be scanned via the barcode
* The order ID can be scanned via the Data Matrix code
* The QR code is for internal use only and is not relevant for partners

***

### Customer Service

All customer service inquiries—whether received directly or via About You—must be answered within 24 hours.

***

### Availability

Only products with sufficient stock should be made available for sale, reducing the likelihood of cancellations or delivery issues.

***

### Cancellation Rate

The weekly cancellation rate for items that cannot be shipped should remain below 1.0% to maintain a positive customer experience.


# Know Your Customer (KYC) FAQs

KYC (Know Your Customer) refers to the due diligence process employed by obligated entities within the meaning of domestic and European AML laws and regulations.

## What is a KYC process?

A due diligence process which requires obligated entities within the meaning of anti-money laundering laws and regulations to verify the identities of their clients and assess potential risks associated with financial crimes such as money laundering and terrorist financing. This process is mandated by regulatory bodies and serves as a critical component of a robust compliance framework.

## Why do I have to undergo a KYC process when selling on the AboutYou marketplace?

Selling your products on the AboutYou marketplace prerequisites entering a payment services framework agreement with SCAYLE Payments GmbH which sets out the terms for the accounting and payment of revenues. SCAYLE Payments GmbH is a licensed payments service provider pursuant to Section 1 (1) sentence 2 no. 5, 2nd alternative of the German Payment Services Supervision Act (Zahlungsdiensteaufsichtsgesetz - ZAG). As such SCAYLE Payments GmbH is an obligated entity according to Sec. 2 Para. 1 no. 3 of the Money Laundering Act (Geldwäschegesetz - GwG) and thus obligated to adhere to Customer Due Diligence (CDD) requirements set therein.

## How long does the KYC process take?

The onboarding timeframe depends on the partner's responsiveness in providing requested information and evidence. Prompt submission of complete documentation allows SCAYLE Payments to expedite the process, often concluding the review within a few business days. Incomplete submissions or documents that do not meet the outlined requirements (e.g., regarding recency or certification) necessitate follow-up communication, which can significantly extend the processing time. Therefore, timely and accurate completion of the KYC questionnaire and follow-up requests is strongly encouraged.

## What is the general KYC process flow from a partner perspective?

Upon receiving an email notification requesting submission of the KYC questionnaire and supporting documentation, the designated KYC contact person is required to complete and submit the questionnaire to SCAYLE Payments within 10 business days. The SCAYLE Payments KYC team will review the submitted documentation and contact the designated KYC contact person if any further clarification or additional supporting evidence is required.

Individuals listed in the questionnaire as acting on behalf of the contracting party will subsequently undergo a verification process, such as video identification. A seperate email including the link required to start the verification will be sent directly to the designated individuals. Completion of this verification is a prerequisite for KYC approval.&#x20;

Upon completion of the review and verification process, the finalized KYC questionnaire will be sent via DocuSign to the designated individual(s) acting on behalf of the contracting party for signature. This step confirms the accuracy and completeness of the provided information and serves as an agreement to notify SCAYLE Payments of any subsequent changes to the data. Once the KYC process is completed, the KYC contact person receives a written confirmation on the completion.

## Which occasions trigger a KYC process?

At SCAYLE Payments GmbH, KYC process are triggered upon three instances:&#x20;

* Prior to entering the business relationship&#x20;
* On regular basis (regular reviews)&#x20;
* On an event driven basis (in cases where KYC data changes, e.g. change of company address, change of ownership situation, change of bank account, etc.)

## Whom should I appoint as a contact person for KYC?

The KYC contact person is responsible for completing and submitting the KYC questionnaire, and serves as the primary point of contact for any subsequent information requests. Given the sensitive nature of the required information regarding the contracting party's ownership and beneficial owners, this individual should possess comprehensive knowledge and access to all necessary documentation.&#x20;

To ensure a smooth and efficient process, please promptly notify SCAYLE Payments of any changes to the designated KYC contact person. Maintaining accurate contact information is crucial to avoid delays in regular reviews. To update your KYC contact person, please reach out to the SCAYLE Payments KYC team at <kyc@scayle-payments.com>.

## Which individuals are subject to identification?

**The beneficial owner(s) (BO)**

A beneficial owner is an individual who ultimately owns or controls (directly or indirectly exercises significant control) a legal entity, other company or legal arrangement or at whose instigation a transaction is ultimately carried out or a business relationship is ultimately established. &#x20;

Types of significant control (non exhaustive):&#x20;

* Direct or indirect ownership of more than 25.00% of capital shares or voting rights (cf. Sec. 3, Para. 2 GwG)
* Exercise of control in a manner comparable to the above by other means such as the right to appoint or dismiss a majority of members of the board of directors or ownership of veto rights (cf. Sec. 3, Para. 2 GwG)&#x20;
* Control of any legal entity or legal arrangement by other means or above that in return exercises more than 50% control on the previous legal entity or legal arrangement in the ownership structure of the contractual merchant (cf. Interpretation and Application Guidance of the Money Laundering Act (Auslegungs- und Anwendungshinweise zum Geldwäschegesetz - AuA, Nr. 5.2.2.1.)
* Position as legal representative or beneficiary of a foundation (cf. Sec. 3, Para. 3 GwG)&#x20;
* Position as settlor, trustee, protector or beneficiary of a trust (cf. Sec. 3, Para. 3 GwG)&#x20;
* Owner of a sole proprietorship

## Who is identified if there is no beneficial owner?

Legal representatives or managing directors of the contracting party are considered notional beneficial owners (NBO) if thorough examination by the obligated entity have revealed that a beneficial owner as per Sec. 3 GwG does not exist.

## Are there circumstances where identification of a BO or NBO is not required?

Yes. Beneficial owner (or notional beneficial owner) identification is not required if the contracting party, or a legal owner with at least a 75% interest in the contracting party, is listed on a public stock exchange within the EU, Iceland, Norway, Australia, Canada, Japan, Singapore, or the United States of America.

## The person acting on behalf of the contracting party (PAOB)

The Person Acting on Behalf (PAOB) reviews and signs-off the final KYC investigation results. Their signature confirms the accuracy and completeness of the KYC information gathered and signifies their responsibility for addressing any discrepancies as well as future changes to said information. The PAOB must be authorized to act on behalf of the merchant, either as a legal representative or through a power of attorney (general or limited).

With regards to the PAOB, Section 13 of the German Money Laundering Act mandates data verification, which SCAYLE Payments conducts via video identification per internal policy.

## Which documentation will I have to provide?

This section details typical documentation requirements for the KYC process. Please note that this list is not exhaustive, and the specific documents requested may vary based on factors such as your entity's legal structure and ownership. Additional documentation may be required.

**Identification documents**

* For legal entities: Current commercial register excerpt (not older than three months)
* For sole proprietorships: Certificate of business registration (not older than three months)
* For civil partnerships: The most recent version of the partnership agreement
* For natural persons: Valid e-ID or passport

## What is a register excerpt?

A current commercial register excerpt provides up-to-date information on a registered entity. The excerpt originates from the registration court or office where the entity was initially incorporated or is currently registered (if different from the initial location). It normally contains the following:

* Registration court/office
* Commercial registration number
* Entity name
* Legal Form
* Registered head office/principle place of business address
* Nature of business
* Names of the legal represnetative(s)
* Total amount of share capital&#x20;

## Proof of address

A proof of address is required for (notional) beneficial owners and persons acting on behalf of the contracting party when the respective individual has a fixed abode within the EU. Accepted documents are, for example, electricity or landline bills. The date of issue of either document must not exceed six months at the date of submission of the KYC questionnaire.

**Bank account confirmation**

For all designated payout bank accounts, we require verification in the form of a recent bank statement or a written confirmation from the account-holding bank. This documentation must include the account holder's name (matching the contracting party), the bank's name, the IBAN, the BIC, and the issue date. The document must be dated within the last three months at the time of KYC submission.

## Why must the payout bank account holder match the contracting party?

In accordance with Section 10 (1) No. 3 of the German Money Laundering Act (GWG), we are legally obligated to ascertain and verify the purpose of the business relationship. Given our business model, this necessitates confirming that marketplace sales proceeds are disbursed solely to the identified and verified contracting party, preventing payments to unauthorized third parties.

## Evidence concerning the ownership situation

The determination of a contractual partner’s ownership situation in accordance with the requirement set out in Sec. 10 GwG requires the provision of additional supporting evidence in cases where the ownership interest and respective holders are not evident from the register excerpt or partnership agreement. Examples of such evidence are:

## Shareholder list or shareholder’s register

A shareholder register (or list) is a document disclosing all legal and natural person shareholders of the contracting party or its legal owners (where applicable), including their ownership type and degree of control. It (or supporting documentation) must identify any share classes and, where distribution between capital shares and voting rights is not 1:1, respectively allocated voting rights. The register/list requires certification by an independent third party (e.g., notary, (syndic) lawyer, auditor) and must be less than two years old at the time of KYC questionnaire submission. If the aforementioned information is disclosed in the company’s statutes, submission of these is equally sufficient. Where the date of issue or certification of the statutes exceeds two years, a separate confirmation of continued validity is required.

## Ownership and control structure

An ownership and control structure diagrammatically represents the control relationships between the contracting entity, its legal owners, and beneficial owners. This document may replace shareholder lists if accompanied by certification from an independent and reliable source, such as a notary, lawyer, or auditor. The certification date must be within six months of the KYC questionnaire submission date.

## VAT-ID registration certificate

A VAT-ID registration certificate (also known as a VAT certificate or certificate of VAT registration) is an official document issued by a tax authority confirming that a business is registered for Value Added Tax (VAT) purposes. It typically includes the business's name, address, and VAT identification number. This certificate serves as proof of VAT registration and may be required for various business transactions, particularly those involving cross-border trade within the European Union. The specific format and information included on the certificate can vary slightly between countries.

## Why are there restrictions concerning document issue dates?

Our internal AML policies and procedures mandate obtaining and maintaining up-to-date information at all times.

## Can exceptions be made with regards to the regular requirements?

This is not possible. SCAYLE Payments GmbH, just as banks and further obligated institutions under GwG, is bound by the minimum requirements of the Money Laundering Act (GwG) and its Interpretation and Application Guidance (AuA), which form the foundation of our internal Anti-Money Laundering policies and procedures. Furthermore, the Federal Financial Supervisory Authority (BaFin) mandates external audits to assess not only legal and regulatory compliance but also adherence to our internal policies and processes. This rigorous approach ensures robust AML practices.

## What happens if I can not meet a provision deadline?

We might be able to grant an extension to the applicable deadline. This decision is made on a case by case basis and prerequisites provision of the expected date of provision and the reason for the delay.

## What happens if I refuse to provide requested information or evidence?

Adherence to the GwG, specifically Section 10 Paragraph 9, prohibits entering or maintenance of business relationships where Due Diligence Requirements, including KYC, are not fulfilled. Therefore, activation on the AboutYou marketplace is contingent upon successful KYC review. For existing partners, failure to conclude recurring KYCs will result in deactivation on the AboutYou marketplace.

## Who is my contact person for questions throughout the KYC process?

Please direct all KYC process-related inquiries to the KYC department directly by addressing them in the corresponding email thread. This will expedite the handling of your questions and submissions.

## How can I report changes concerning KYC data?

Please direct all corresponding notifications to the SCAYLE Payments KYC team at <kyc@scayle-payments.com>. Kindly ensure to include the registered name of the contractual party in your email subject in order to allow quick allocation of your request to the responsible processing instance.

## Should I report upcoming changes?

Please refrain from notifying us about changes to KYC relevant information prior to said changes coming into force as this prevents us from obtaining and verifying corresponding evidence which thus hinders proceeding your case. Please make sure to notify us about changes after implementation, only, however, without due delay.

## How do you ensure confidentiality and privacy of data?

SCAYLE Payments GmbH's Anti-Money Laundering (AML) program complies with the requirements of the German Anti-Money Laundering Act (GwG) by restricting information access to the AML team as well as internal and external auditors.

To expedite KYC request processing, SCAYLE payments GmbH engages with a third-party provider. We will ensure that the provider complies with all applicable laws, regulations, and our internal data privacy and protection standards. In accordance with legal requirements, provided information may be disclosed to federal authorities upon request.

## How long is KYC data stored?

The retention period is five years, unless other legal provisions regarding recording and retention obligations provide for a longer period.


# Invoicing & Payout Process Guide

This guide provides a comprehensive overview of SCAYLE Payments settlement processes, document breakdowns, reserve mechanisms, and accounting reconciliation procedures for merchants.

## Overview & Payment Documentation

At the beginning of each month, digital documents corresponding to the previous month's settled transactions are generated and sent via automated email.&#x20;

### Key Payment Documents

* **The Settlement File (.CSV):** An itemized breakdown of all individual order transactions (sales, refunds, commissions, fees, reserve holds, and VAT). The sum of Column AJ (payoutAmount) plus the net payout amount in the bottom Reserve Management section equals your exact monthly bank payout. The payment reference on your bank statement matches the file name of your settlement CSV.&#x20;
* **Payout Details Report (.PDF):** An aggregated summary document summarizing the core financial components used to calculate your monthly payout.

The settlement file and payout details report are shared via email **<no-reply@scayle-payments.com>**.

### Informational Invoices:

* **Marketplace Commission Invoice:** A detailed breakdown of the commission charges on your sales. Relevant commissions are deducted automatically from your monthly payout. No further action is required. This invoice is issued and shared by ABOUT YOU.
* **SCAYLE Payments Fee Invoice:** A breakdown of the payment processing fees (also referred to as "SPAY fee"). Relevant fees are deducted automatically from your monthly payout. No further action is required.
* **Voucher Compensation Invoice:** An invoice detailing the compensation for any vouchers or coupons applied to your products (e.g., 10% or 15% discounts). No further action is required.This invoice is issued and shared by ABOUT YOU.
* **Fulfilment by ABOUT YOU:** This is the amount ABOUT YOU charges for storage, and fulfilment of delivery and returns. Please find a breakdown of these fees at the end of the page.\*

*\*Please refer to the contract for details.*

All amounts stated in these invoices can also be tracked within your Settlement File.

**Accounting Note on Invoices:** SCAYLE Payments does not issue separate sales or revenue invoices, as sales occur directly between your business and the end customer. The monthly Settlement File (.CSV) serves as your official breakdown for tax and revenue accounting.

***

Retail Media Invoicing Process

<details>

<summary>The following guide explains how Retail Media invoices are created, how campaign costs are calculated, and what you can expect throughout the Retail Media invoicing process.</summary>

### How Retail Media Invoicing Works

Retail Media invoices are handled separately from all other ABOUT YOU invoices. Therefore, they are created independently and cannot be offset against other invoices.

Invoices are generated at the start of each month retrospectively for the previous month and sent automatically to your invoice email address.

Discounts will be applied automatically to your invoice. No additional action is required from your side.&#x20;

***

### How Campaign Costs Are Calculated

Your invoice is always based on your campaign's actual delivery. The pricing model depends on the campaign type.&#x20;

* Sponsored Products: Cost per Click (CPC)&#x20;
* Sponsored Content: Cost per 1,000 Impressions (CPM)

This means you are only charged for the clicks or impressions your campaigns actually generated.

Within the Sponsored Products and Sponsored Content tools, you can view the current performance data and costs of your campaigns.

* Ad Spend corresponds to the amount that will be invoiced. Any applicable discounts have already been applied.
* Gross Media Value represents the total cost of the marketing activities before discounts are applied.
* Over-delivery represents any amount by which the system may exceed the defined Campaign Limit or Monthly Limit. This amount will not be invoiced and will be covered by ABOUT YOU.

***

### Minimum Campaign Budgets

The minimum campaign budgets are:

* Sponsored Products: €1,000
* Sponsored Content: €2,000

These are minimum campaign budgets required to create a campaign. They do not represent the amount you will automatically spend or be invoiced for. Your invoice is always based on your campaign's actual performance.

***

### Campaign and Monthly Limit

To help you manage your advertising spend, you can define either a Campaign Limit or a Monthly Limit when creating a campaign.&#x20;

* A Campaign Limit defines the maximum budget for the entire campaign.
* A Monthly Limit defines the maximum budget that can be spent within a calendar month. If a campaign reaches its Monthly Limit, it will automatically pause for the remainder of the month and automatically resume at the beginning of the next calendar month.&#x20;

Please note that campaign delivery is based on auctions. Because of this, the system cannot always stop campaign delivery at the exact euro amount specified. If your campaign spends less than your defined limit, you will only be invoiced for the actual campaign costs.

In some cases, campaign delivery may exceed your defined limit. Any costs exceeding your Campaign Limit or Monthly Limit will be covered by ABOUT YOU and will not be charged to you.

***

### Monitoring Your Campaign Costs.

You do not have to wait until the end of the month to understand your campaign costs. Within the Seller Center, both Sponsored Products and Sponsored Content provide daily reporting, giving you full transparency throughout the month. In addition, you can view your Daily Ad Spend, allowing you to closely track your campaign costs and estimate your upcoming invoice at any time.

***

### Payment Information

Please make sure to pay your Retail Media invoices in time. Late payments may result in reminder notices and, if necessary, the transfer of outstanding invoices to our external debt collection partner. To avoid fees resulting from this, please pay within the 14 days payment deadline.

***

### Need Help?

If you have any questions regarding Retail Media invoice, please don't hesitate to contact the Retail Media team at <service-retailmedia@aboutyou.com>. We're always happy to help.

</details>

***

## Payout Timing & Included Transactions

### Payout Schedule

* **Monthly Payouts:** Fully settled transactions from the previous month are transmitted to your registered bank account within the **first 5 business days** of the new month. Bank processing times may add 1–2 business days for funds to reflect.

Please note that when transactions occur near the end of a calendar month, especially before weekends or public holidays, there is a standard operational delay in receiving cash settlement from Payment Service Providers (PSPs).&#x20;

Please be assured that these funds and transactions are completely secure. These end-of-month "tail" transactions automatically roll over into the following billing cycle, fully visible in the next settlement file. Over time, these balances equalize.

* **Voucher Compensation:** Paid separately by ABOUT YOU toward the end of the month.

***

## How to Configure the CSV File&#x20;

<details>

<summary>The settlement files (itemized statements) are sent every month in the form of a CSV file. The following steps should be applied to format the file:</summary>

**1. Open the CSV file with Excel**

**2. Mark the entire column A, then go to Data on the top menu and click Text to Columns**

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FYiiwYDMwDb3VLXGpLqVI%2Funknown.png?alt=media&amp;token=433bbb81-0bec-4973-80d1-9e858d398ad2" alt="" width="563"><figcaption></figcaption></figure>

3. **Select Delimited → Click Next**

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2F2hN3l7bS03LGQuovqHjA%2Funknown.png?alt=media&amp;token=628204bc-be4a-41c1-839a-fdc9e99d32ea" alt="" width="529"><figcaption></figcaption></figure>

**4. Delimiters: „Tab“ and „Comma “ → Click Next**

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2Fdk38UzMwNU6ol1HYxc0f%2Funknown.png?alt=media&amp;token=e5280474-2e14-48fb-b2a5-a608834a019c" alt=""><figcaption></figcaption></figure>

5. **Select advanced and Replace information so the decimal separator is: ‘’ .’’ and thousands separator ‘’,’’ → Click Ok and then click Finish.**

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FXo7wZuOpner6WILToDrr%2Funknown.png?alt=media&amp;token=2f1f7ba1-6733-4747-8baa-33f48b8ebce6" alt=""><figcaption></figcaption></figure>

**6. Afterwards, desired filters can be set and the file can be saved in ".xlsx” format**

</details>

***

## How Payouts Are Calculated

Your monthly payout is derived using the following core formula:

Sales (Capture) Amount - Marketplace Commission (on Captures) - Payment Processing Fee - Refund Reserve Withhold - Chargeback Reserve Withhold + Chargeback Reserve Release/Top-Up + Refund Reserve Release/Top-Up

In your settlement file, the calculation would be as follows:&#x20;

SUM column E - SUM column (V+X) - SUM column (Z+AB) - SUM column AE - SUM column AG + SUM column G in the reserve management section (very bottom of your settlement file)

### Component Breakdown

* **Marketplace Commission:** This is the commission amount charged by the ABOUT YOU Marketplace. It is deducted directly from your payout amount. Marketplace commissions are agreed on between the marketplace and the merchant.&#x20;
* **SCAYLE Payments (SPAY) Payment Processing Fee:** This is the amount that SCAYLE Payments charges per order item for payment processing. It is deducted directly from your payment. Fee rate is disclosed in your Payment Services Framework Agreement.&#x20;
* **Refund reserve withhold:** This is the % withheld from the capture amount and kept in a separate bucket which forms your refund reserves. All refunds are deducted from this reserve bucket. Amounts are kept here for 60 days, and if there’s an amount which is not used after 60 days it will be released to you automatically with the next payout cycle. By default, the withhold rate is 63.48% minimum.
* Chargeback reserve withhold: Similar to refund reserve withhold, a chargeback reserve rate of 0.3% is withheld from the capture amount in order to be able to process incoming charge

#### SPAY Processing Fee Policy

The SCAYLE Payments Fee is due immediately upon the technical payment capture of an order. Because the payment execution service is completed at capture, SPAY fees are non-refundable if an item is later returned or canceled by the customer. (Note: If an order is canceled prior to payment capture, no SPAY fee is charged.)

### Understanding Reserves, Releases & Top-Ups

#### Why Reserves Exist

A payment reserve is a temporary hold on a percentage of sales to safeguard against potential customer refunds and chargebacks, ensuring funds are available to meet mandatory 14-day consumer protection refund requirements. Please note that the customer return policy is 30 days and our reserve withhold period is maintained at 60 days. This extended window ensures adequate coverage for transit and logistical delays, inspection processing, and late claims before unused funds are automatically released back to your payout balance.

* Reserved funds remain strictly **your property** held in a safeguarded account.
* Holding Periods: Unused refund reserves automatically release back to your available balance after **60 days**. Chargeback reserves release after **180 days** (in accordance with payment card network dispute windows).

#### Centralized Reserve Bucket & Automated Top-Ups

Withheld funds do not track on a per-order basis; they compile into a single aggregate reserve pool from which all incoming customer refunds and chargebacks are drawn.

* **Reserve Consumption:** When a customer returns an item, the refund is paid directly out of this aggregate reserve pool.
* **Automated Top-Ups:** If your return volume exceeds the available balance in your reserve pool (e.g., if your actual return rate is 80% while your withhold rate is 63.48%), the system automatically directs a portion of incoming new sales volume to top up the reserve pool.
* **Impact on Payouts:** Low or zero monthly payouts are primarily driven by high actual refund volumes consuming reserve balances, not by funds being arbitrarily held as extra fees.

### Settlement File (.CSV) Column & Structure Guide

The Settlement File is divided into two distinct parts:

1. **Transaction Table (Top Section):** Itemized order-level entries.
2. **Reserve Management Section (Bottom Section):** Non-transactional aggregate reserve entries identified by codes RH, RR, and RC in Column A.

#### Transaction Table

* **payoutAmount (Column AJ):** This column shows the final debit or credit amount for a specific transaction. The SUM of this column will give you the total transaction amount you will be receiving for your sales. If you have received a reserve release or had a top-up amount, these will also be accounted for in the final payout calculation. You will find reserves related numbers in the reserve management section of your settlement file (at the very bottom).
* **operationTimestamp, operationType:** These two columns identify the type of transaction. For example, 'captures' are sales that were successful and reconciled. 'Refunds' and 'chargebacks' can also be found clearly in this column.
* **discountCompensation:** This column shows whether a discount voucher was applied to the operation amount. You will be compensated for this discount amount by the ABOUT YOU Marketplace separately.
* **commissionRate, commissionAmount, commissionVatRate, commissionVatAmount:** These columns display the marketplace commission-related charges per transaction. The marketplace commission is charged per capture.

How to calculate the commission fee (with VAT): (Initial amount \* rate\_percentage/100) + (Initial amount \* rate\_percentage/100 \* VAT)

The SUM of columns V and X will also give you the total commissions charged for the month.

* **paymentFeeRate, paymentFeeAmount, paymentFeeVatRate, paymentFeeVatAmount:** These columns show the SCAYLE Payments processing fee per item. How to calculate the SPAY fee (with VAT): (Captured amount \* paymentFeeRate) + (Captured amount \* paymentFeeRate \* VAT)&#x20;

The SUM of columns Z and AB will also give you the total SPAY Fee amount charged for the month.

* **refundsReserveWithhold, chargebacksReserveWithhold:** These columns show how much SCAYLE Payments withholds from a transaction to cover for future chargebacks and refunds. A minimum of 63.48% of the capture amount is withheld for refunds, and 0.3% is withheld for chargebacks. SCAYLE Payments determines the amount of the respective Security Retention based on the anticipated Transaction Volume and possible Refunds. Unused refund reserves are released to you after 60 days, and unused chargeback reserves are released after 180 days.
* **refundsReserveUsage, chargebacksReserveUsage:** These columns show how much of the previously withheld reserves are being used to cover refunds and chargebacks.

#### Reserve Management Section (Bottom of CSV)

***ClosingBalance= OpeningBalance + WithholdAmount - ConsumptionAmount +/- PayoutAmount***

* **Opening Balance:** Carry-over balance from the previous statement cycle.
* **Withhold Amount:** Total sum set aside from current period sales (equals sum of Columns AE & AG).
* **Consumption Amount:** Reserved funds actively used to pay out returns/disputes during the period (equals sum of Columns AF & AH).
* **Payout Amount:** Net transfer between reserve pool and available bank payout. Positive values indicate 60/180-day matured reserve releases. Negative values represent top-up deductions pulled from sales to cover excess refunds.
* **Closing Balance:** Ending reserve pool balance carried forward as next month's Opening Balance.

***

## **Marketplace Commission Fee Calculation Model\***

Based on EUR Retail Price incl. VAT per&#x20;category. If a Good&#x20;is sold in a non-EUR currency, it will be converted into EUR.\*

| **Product Type**     | **<35€** | **>35€ and <50€** | >**=50€ and <100€** | **>100€** |
| -------------------- | :------: | :---------------: | :-----------------: | :-------: |
| Women Textile        |    4%    |         5%        |         13%         |    18%    |
| Men Textile          |    6%    |        14%        |         18%         |    22%    |
| Kids                 |    5%    |        12%        |         18%         |    22%    |
| Beauty & Home        |    5%    |        12%        |         13%         |    13%    |
| Acc., Bags & Jewelry |    6%    |        16%        |         18%         |    19%    |
| Shoes                |    4%    |         8%        |         16%         |    19%    |
| Sports & Swimwear    |    5%    |        13%        |         13%         |    13%    |

\*Please refer to the contract for further details.&#x20;

***

### Accounting Reconciliation Guidelines

#### Invoice Date vs. Service Period Label

When matching monthly SPAY fee invoices against CSV settlement statements, your accounting team should rely on the **Invoice Issue Date** as the primary reconciliation reference, rather than the "Service Period" label:

* Invoices issued on July 1st correspond to the June payout run (paid in early July).
* A transaction from an earlier service period (e.g., May) clearing late in the June payout window will be billed on the July 1st invoice package.

#### Reconciliation Across Fulfillment Models (FbM vs. FbAY)

SCAYLE Payments fee invoices are issued **per legal entity/country**, rather than split into separate invoices per fulfillment channel (Fulfillment by Merchant vs. Fulfillment by ABOUT YOU). To split costs between FbM and FbAY for internal cost-center accounting, use the itemized CSV Settlement File, which explicitly breaks down fees by fulfillment model.

#### Commission Credits on Returned Orders

When a customer returns an item, the original Marketplace Commission is credited back to your account in Columns V and X (refund operation lines). This credited commission reduces the net amount drawn from your reserve pool to satisfy the refund.

### Banking Updates, Disputes & Account Offboarding

#### Updating Banking & Entity Details

Bank account modifications are subject to event-driven KYC checks. To change payout details, email <kyc@scayle-payments.com> with a bank statement or bank confirmation letter issued within the last six months. The document must clearly show the account holder name, IBAN, BIC, bank name, and issue date. The document must not be older than 6 months.

#### Disputed Returns & Logistics Escalation

SCAYLE Payments operates strictly as the financial settlement processor, executing automated refund instructions triggered by the platform. SCAYLE Payments does not evaluate delivery statuses or physical return tracking.

* If a customer was refunded but the returned item was not received, contact **ABOUT YOU Customer Service / Account Management** directly via the Seller Center Service Desk in the Help Center.
* Approved reimbursements or dispute corrections granted by the marketplace team are credited back to your settlement ledger separately.

#### Storefront Deactivation & Financial Offboarding

Taking a storefront offline stops new customer sales, but **does not automatically cancel pre-existing financial obligations.**

* Financial ledgers remain open post-deactivation to handle remaining delivery captures, processing windows, customer returns, and chargeback claims.
* If post-deactivation returns exceed remaining sales and reserves, the merchant remains legally responsible for the unrecovered balance, and a formal Debit Note will be issued for settlement.

### Need Support?

* **Technical or Operational Inquiries:** Contact the ABOUT YOU team via the [Help Center](https://aboutyou.atlassian.net/helpcenter/sellercenter/portal/1189/group/1391/create/3361).
* **KYC / Bank Verification:** <kyc@scayle-payments.com>.
* **Direct Financial / Settlement Inquiries:** <merchants@scayle-payments.com>.

***

## Price List ABOUT YOU Fulfillment Marketplace

|                     |                         |             |           |
| ------------------- | ----------------------- | ----------- | --------- |
| **Service**         | **Item/Shipment Level** | **Country** | **Price** |
| Inbound Processing  | Item                    | ALL         | 0.4728 €  |
| Storage/Warehousing | Item/day                | ALL         | 0.0161 €  |
| Outbound            | Shipment                | AT          | 3.45 €    |
|                     |                         | BE          | 4.37 €    |
|                     |                         | BG          | 4.69 €    |
|                     |                         | CH          | 5.79 €    |
|                     |                         | CY          | 7.38 €    |
|                     |                         | CZ          | 3.97 €    |
|                     |                         | DE          | 3.27 €    |
|                     |                         | DK          | 5.50 €    |
|                     |                         | EE          | 4.75 €    |
|                     |                         | ES          | 4.86 €    |
|                     |                         | FI          | 4.89 €    |
|                     |                         | FR          | 5.84 €    |
|                     |                         | GR          | 5.47 €    |
|                     |                         | HR          | 3.62 €    |
|                     |                         | HU          | 4.70 €    |
|                     |                         | IE          | 5.75 €    |
|                     |                         | IT          | 5.73 €    |
|                     |                         | LT          | 5.02 €    |
|                     |                         | LU          | 6.42 €    |
|                     |                         | LV          | 5.11 €    |
|                     |                         | NL          | 4.06 €    |
|                     |                         | NO          | 12.91 €   |
|                     |                         | PL          | 5.04 €    |
|                     |                         | PT          | 5.73 €    |
|                     |                         | RO          | 4.07 €    |
|                     |                         | SE          | 5.70 €    |
|                     |                         | SI          | 4.32 €    |
|                     |                         | SK          | 3.40 €    |
| Returns             | Shipment                | AT          | 2.91 €    |
|                     |                         | BE          | 3.96 €    |
|                     |                         | BG          | 3.70 €    |
|                     |                         | CH          | 5.97 €    |
|                     |                         | CY          | 4.78 €    |
|                     |                         | CZ          | 2.75 €    |
|                     |                         | DE          | 3.11 €    |
|                     |                         | DK          | 4.64 €    |
|                     |                         | EE          | 3.57 €    |
|                     |                         | ES          | 4.84 €    |
|                     |                         | FI          | 5.49 €    |
|                     |                         | FR          | 6.07 €    |
|                     |                         | GR          | 4.13 €    |
|                     |                         | HR          | 4.01 €    |
|                     |                         | HU          | 4.43 €    |
|                     |                         | IE          | 5.79 €    |
|                     |                         | IT          | 5.47 €    |
|                     |                         | LT          | 3.46 €    |
|                     |                         | LU          | 6.26 €    |
|                     |                         | LV          | 3.60 €    |
|                     |                         | NL          | 3.22 €    |
|                     |                         | NO          | 6.71 €    |
|                     |                         | PL          | 3.55 €    |
|                     |                         | PT          | 4.97 €    |
|                     |                         | RO          | 3.68 €    |
|                     |                         | SE          | 5.84 €    |
|                     |                         | SI          | 3.50 €    |
|                     |                         | SK          | 3.22 €    |


# Legal Information

#### Information on the Internal Complaint Management System pursuant to Art. 11 (4) of Regulation (EU) 2019/1150 (P2B Regulation)

This report provides an overview of the functioning and effectiveness of our internal complaint management system for the ABOUT YOU Marketplace during the reporting period from December 4, 2024, to December 3, 2025. Our internal complaint management system, accessible via the Partner Portal / Seller Center (the "Complaint Tool”, enables the business users of the ABOUT YOU Marketplace (“Merchants”) to submit complaints, particularly concerning measures or other actions of ABOUT YOU SE & Co. KG or technical issues directly related to the provision of the Marketplace services.

During the stated reporting period, our Merchants submitted a total of 26 complaints. The complaints received primarily concerned the following topics: Product display/listing deviations, invoicing issues/returns, response times, and deviating price display. The average time required for the complete processing of a complaint was 84 days (it should be noted here that the final closing of the tickets primarily lies with the Merchant. If the Merchant does not respond within two weeks of our last reply, the ticket is automatically closed). Of the total number of complaints, 10 were resolved in favor of the user, while 7 were rejected as unfounded. As of the cut-off date, December 3, 2025, 9 cases were still being processed (Status "Waiting for Partner") as the provision of necessary feedback from the Merchant is still awaited.


# General Product Information

## Product Structure

Products in the Seller Center are organized into three hierarchical levels:

#### Master

A product master represents the overall product as it appears in the shop and has its own product detail page. Each product master has a *style key* that you define yourself. This style key must be unique so the system knows which color ways and sizes belong to that product.

#### Product (Color Ways)&#x20;

A single product master can have multiple color ways, and customers can switch among these on the product detail page. Images and descriptions are tied to each color way, allowing the product presentation to change when a different color is selected.

#### Variants (Sizes)

Variants refer to the various sizes you offer for each color way. Every variant has its own stock, retail price, optional sale price, and VAT. Because variants sit under a particular color way, you can configure different sizes, prices, or stock for each color of the same product.

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FAKbCNJU7fadn7KkXj08y%2Fmaster%20categories.png?alt=media&amp;token=a0296e53-0f18-4261-bd5a-542e791774aa" alt=""><figcaption></figcaption></figure>

***

## Multiple Languages and Countries

When you plan to sell a product in multiple countries, you must specify the price for each country. You can set these prices automatically and then adjust them at any time. You can also provide a product description for each language you sell in. Descriptions are optional, and you can fill in as many or as few languages as you like. Some countries, like Germany, support multiple languages—German and English—within a single market.

***

## Product Name

The Seller Center automatically generates the product name using the selected category and color. However, you can add a unique name for branding by using the “Product Name” attribute at the product master level. This unique name will be wrapped in single quotes alongside the system-generated name. Avoid adding additional details (like color or size) to this field, since the default naming pattern is still applied.

***

## Manufacturer Information

We're sharing crucial information about new requirements under the  General Product Safety Regulation (GPSR), which  affect all products available for sale on ABOUT YOU.

Since December 13, 2024, an EU-wide manufacturer information requirement applies to all online sales. This initiative aims to enhance product safety within the European market and improve transparency for consumers in distance selling. To ensure the manufacturer can be contacted immediately in the event of a product safety risk, you must provide the required manufacturer information for all products you offer for sale on ABOUT YOU.

### What you Need to Do

You need to submit the following manufacturer information for each product available in our shop:

* Name of the EU manufacturer (Art. 3 (8) Regulation (EU) 2023/988). If you're a non-EU supplier, this should be the name of the importer or authorized representative (Art. 3 (10) and (9) Regulation (EU) 2023/988).
* Postal contact address
* Electronic contact address

You can find more details about these new requirements [here](https://ec.europa.eu/commission/presscorner/detail/en/ip_23_4223).

Important: The manufacturer information must be provided clearly and unambiguously. Please enter the required information at the brand level.

***

#### Need Help?

If you have any questions, please create a [support ticket](https://aboutyou.atlassian.net/helpcenter/sellercenter/) in our help center.&#x20;

{% hint style="info" %}
Please Note: We provide this information as guidance only and it doesn't constitute legally binding advice. The responsiility for providing correct product manufacturer data rests solely with the supplier.
{% endhint %}


# Create Products

{% embed url="<https://drive.google.com/file/d/12jjRLKvWZnCI6SdTIC-rn6NvWoM8-GLQ/view?usp=sharing>" %}

**Edit:** The EAN has been made mandatory since for all products to allow for product aggregation.\
\
*Every product listed on the platform must have a **valid EAN code** for unique identification. Official codes can be acquired via GS1.*

***

## Create a Product via UI

When you use the “Add Products” form, you only need to enter the most essential details, such as the product’s name, its category, the countries where it will be sold, and the color ways you want to offer. After you submit this short form, the system automatically generates the product with its corresponding color ways, variants, and countries. You can enrich the product with additional data later on.\
\
**Tip:** If you are creating multiple products via the UI, check out our *Bulk Edit* feature. It is a highly efficient way to quickly enrich or update data across all your products simultaneously.

## How to Use the Bulk Edit Feature

1. **Access the Bulk Editor**
   * Navigate to the Products section in the left sidebar menu and click on Manage Products.
   * Click the purple Bulk Edit button in the upper-right corner of the page.
2. **Filter and Search Products**
   * Filter List: Use the Brand, Status, or Category dropdown filters at the top right to quickly narrow down your product assortment.
   * Search Bar: Type specific details into the search field to locate exact items.
3. **Customize Your Display View**
   * Click the Show / hide Columns dropdown menu on the top left of the editor table to toggle specific attributes on or off for a personalized view.
4. **Locate and Edit Products**
   * View Products & Variants: Review the full list of products and their variants displayed on the main table grid.
   * Modify Cell Data: Double-click any cell (e.g., Category, Name, Brand) within the table to edit its value directly or select a option from the dropdown menu.
   * View Additional Attributes: Use the horizontal scroll bar at the bottom of the table to scroll right and view the full list of product attributes.

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2F64h26B2JqeSp3fy6wsA3%2Fimage.png?alt=media&amp;token=25628de1-cfcd-4e5b-bf75-1c8de5830226" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FCJykSyNOwiIao3uyoXmj%2Fimage.png?alt=media&amp;token=b86fa1d0-b71b-48d1-92c0-af831c7239f8" alt=""><figcaption></figcaption></figure>

***

## Import Products via Excel

To bulk-create or update products, go to “Import Products” in the left navigation. From there, you can either click “Import Products” to add entirely new products or “Import Stock & Price” if you only want to update stock and prices. If you interrupt an import, you can continue it later via the “Continue last import” section, and you can always review completed imports in “Your Last Imports.”

### Updating Existing Products

The Excel import tool can also be used to update products that are already in your Seller Center (including those imported via Shopify).&#x20;

* Any data provided in a cell will replace the existing information for that variant.&#x20;
* If a field (e.g., Material Information) already contains data in the Seller Center but is left blank in your Excel upload, that data will be deleted.&#x20;
* Images are the only attribute protected from this rule. Leaving image columns blank will not delete existing images in the system.&#x20;
* Uploading a file with only a few EANs will not affect other variants or product masters already in the system. Missing rows are simply ignored.

***

### Product Import Steps

The Excel import process includes three steps:

#### 1. Select Category

Choose one or multiple categories for your products.

#### 2. Generate Templates

The system creates one Excel template per category, which may take a few seconds. You can leave the page and return later if needed.

#### 3. Fill and Upload

Download the templates, enter your product information, then upload them. If you have multiple files, compress them into a single ZIP before uploading.

***

### Product Import Excel File

Each generated template has three worksheets:

#### Help

Offers FAQs and information about attributes for that category.

#### Product Feature Information

Lists each attribute that requires a specific selection (e.g., dropdown choices).

#### List Your Products Here

This is where you enter the actual product data. Every row represents a single variant (size + color way), and if you sell in multiple countries, you can duplicate rows and change the country-specific prices. The style key you provide groups rows under the same product master. You can also specify a unique product name or add direct URLs to your product images.

#### Material Compositions

The Material Compositions tab works as a lookup table where each row defines a single material breakdown, linked back to your product tab via a unique identifier. <br>

* Key: An ID of your choice (e.g., BAG\_LEATHER\_01). Paste this exact value into the "Material Composition (Textile)" column on the "List Your Products Here" tab. This Key serves as the only link between the two tabs.&#x20;
* Cluster: Represents a specific part of the item (e.g., Upper, Outer, Lining). Enter its name under Cluster Name (1), (2), or (3) - using one column per part.&#x20;
* Material Name / Fraction: Defines the material used in that specific part and its percentage share. Only use the .2 or .3 columns if a single cluster part is made of a material blend. The total fractions within any single cluster must always equal 100%.&#x20;
* Single Material Parts: If a cluster part consists of only one material, simply fill out the .1 cells (Material Name + 100) and leave the .2 and .3 fields completely blank.\
  \
  See the example below:\ <br>

  <figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FF56sOGF5LpJqBVHI9A50%2Fimage.png?alt=media&amp;token=cf522175-03a7-45b5-9740-574ca2ebb947" alt=""><figcaption></figcaption></figure>

***

### Product Import Upload

After uploading your Excel file, the Seller Center checks each row, groups them under the corresponding product master and color way, and creates the products.

Automatic Publishing: Products will be automatically published (skipping "Draft" status) as long as:

1. All mandatory attributes are completed.
2. Valid images are present, either via URLs in the Excel file or previously added in the UI.

If images are still missing, products will remain in "Draft" until they are provided.

<br>

***

### Faulty Upload and Reports

If one or more rows contain errors, the valid rows will still be created. The system then provides a downloadable report highlighting the problematic rows and explaining the issues. You can fix these rows in the report and upload them again without affecting the rows that were correct.

***

## Import Products using the API

For information about the available API endpoints, please have a look at the API section of this documentation.

***

## How to Delete Published Products

You can delete products that have already been published using either the Seller Center User Interface (UI) or the partner-facing API via the endpoint.

#### 1. General Deletion Conditions

* No Recorded Sales: A product variant can only be deleted if it has absolutely no recorded sales. The backend strictly blocks deletion if any sales history exists.
* SKU & EAN Reuse: Once a product is successfully deleted, its SKU and EAN values are completely freed up and can be reused for new products.

#### 2. Deletable Statuses & Deactivation Rules

Whether you can delete a product immediately depends on its current status:

* Deletable directly: Products in Draft, Pending Approval, Rejected, Inactive, and Needs Input statuses can be deleted right away.
* Not deletable as-is: Products in Active and Pending Active statuses cannot be deleted directly.

For Active or Pending Active products, the UI will only display a Deactivate button. Partners must first deactivate the product to change its status to Inactive.

#### 3. How to Delete via the User Interface

1. Go to Manage Products in the Seller Center UI.
2. If the product is Active or Pending Active, click Deactivate to move it to the Inactive tab.
3. Locate the product in the relevant tab (e.g., Inactive, Draft, or Rejected).
4. Open the Edit Product Details section, where the Delete Product option will now be available to complete the deletion.\ <br>

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2Fwux671qriq6z4w6s3gIW%2Fimage.png?alt=media&amp;token=ecf8e32f-52d9-49f3-99ae-a1b3b07e5117" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FWxsTrXMPGs4wUWGuhw68%2Fimage.png?alt=media&amp;token=3e892586-e550-48dc-82f4-3481b01ead20" alt=""><figcaption></figcaption></figure>


# Product Image Requirements

High-quality product imagery is essential for successful product launches and optimal presentation on ABOUT YOU. Please review the image guidelines that are presented below carefully.&#x20;

## Understanding Image Compliance

We understand that achieving full compliance can sometimes be challenging. It's important to differentiate between images that will be accepted with an exception (and incur the APR increase) and those that will be prohibited entirely (find reasons below), which will prevent your product from going live.

## General Image Requirements

To meet the minimum requirements, an apparel item must have **at least** one **1st bust view** and one **1st model view (cropped)**. Overall, we recommend providing 1-2 bust images, 2-4 model images, and 1-2 detail images.

#### 1st bust image

* Is used as the first view in our shop (customer can select)
* Must be photographed frontally
* Shot on a mannequin/bust and exempted
* Must have a plain transparent or white background (mandatory for online marketing measures)

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FnDFA8ec5gIifWIQNVmSv%2FScreenshot%202025-01-13%20at%2018.42.24.png?alt=media&amp;token=06cb6dde-ee6c-48dc-aa56-bf087b7badab" alt="" width="188"><figcaption></figcaption></figure>

#### 1st model image

* Is used as the first view in our shop (customer can select)
* Must be cropped (focus on product)
* Important for product presentation → better sales through better recognisability
* Model images are not required for shoes, accessories, kids assortment and home & living

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FXFb3i3wAF8ucS3r9SsMf%2FScreenshot%202025-01-13%20at%2018.43.16.png?alt=media&amp;token=e3660195-b046-4990-8587-e55fbc4ebddc" alt="" width="188"><figcaption></figcaption></figure>

***

## Image Format

Model images and (uncropped) bust shots **must always** be **3:4** (upright) in order to be displayed correctly.

If the 1st bust image has a white or transparent background, the format will be automatically adapted to our shop definition.

#### File format

**JPEG:** For images with white or grey background, maximum file size 2 MB

**PNG:** For images with transparent background, maximum file size 4 MB

***Format of 3:4, 1500 x 2000 pxl (min. 1125 x 1500 pxl) at min. 96 dpi***

***

## Background

#### Model Images

For **model images** a **bright grey** is ideal, which is created directly by the corresponding light settings during the shooting and thus transports a light three-dimensionality. Backgrounds with strong colour variations are not permitted.

Please adhere to the following specifications:

* **RGB:** 244 / 244 / 245
* **Hexa-Code:** #F4F4F5

#### Bust Images

For bust images we require a white or transparent background and the background must be plain. ABOUT YOU will adjust the background in the shop automatically to light grey.

***

## Bust View

**Bust images** must meet the following requirements:

* Min. **1125 x 1500 px** (3:4 format)
* Product must be shown from the **front**
* Shot on a **mannequin / bust** and **exempted**
* **Cropped** with **white or transparent** background

The article will be automatically be displayed in the maximum size (taking the grey protective frame on the left into account) and in the middle of the shop tile.

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FEEKHBTeyJft5a1a67XuZ%2FScreenshot%202025-01-13%20at%2018.45.37.png?alt=media&amp;token=7f3a5bd4-641c-4fdb-8145-74280ea45d46" alt="" width="188"><figcaption></figcaption></figure>

***

## Model Image

**Model images** must meet the following requirements:

* A plain **light grey background**, alternatively white

  or transparent
* Min. **1125 x 1500 px** (**3:4** format)
* For the **1st model view**, display the product **without**

  **cutting the textile**
* For the **1st model view**, ensure that the product is

  facing the front without any extreme cuts of the

  model

For the background, please adhere to the following specifications:

* **RGB:** 244 / 244 / 245
* **Hexa-Code:** #F4F4F5

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FyFhs8aPnqOHPLb6xHJjm%2FScreenshot%202025-01-13%20at%2018.46.41.png?alt=media&amp;token=e8aa4264-bd52-4bb0-a1b8-e9ca1d998752" alt="" width="188"><figcaption></figcaption></figure>

***

## Allowed Exceptions (APR Increase Applies)

The following scenarios are considered exceptions to our standard image requirements. While these images will be accepted and your product can go live, they will lead to the 1.0 percentage point increase to your APR.

1. **First View Exception:** You may provide only one initial image, either the 1st bust view or the 1st model view.&#x20;
2. **Background Exception:**&#x20;
   1. Model View: If both first view images (bust and model) are provided, model images may feature a "moody" or "scenic" background. Otherwise, if only one type of image view is provided, model image backgrounds must be plain white or transparent.&#x20;
   2. Bust View: Must always have a plain white or transparent background.&#x20;
3. **3:4 Format Exception:** Based on our standard requirements, the format should be 3:4. A different image format will be accepted only if it appears correct after automated cropping and does not cause image blocking.\*&#x20;
   1. \*Our standard requirement is 3:4 format, because it ensures proper automatic cropping and display across our systems.&#x20;
4. **Shoes and Caps Direction Exception:** Our standard requirement is for images of left shoes to be 30° or angled to the left. However, images of right shoes and caps pointing to the right will also be accepted.

***

## Prohibited Images (Launch Stoppers)

The following types of non-compliant images will not be accepted under any circumstances and will prevent your product from going live:

1. Bust view images that lack a plain white or transparent background.&#x20;
2. Images with quality below 1125 x 1500 pixels.&#x20;
3. Incorrect shoe and cap rotation/direction, including top-down views or photos showing only the inner side of the shoe (e.g., a left shoe pointing to the right).&#x20;
4. Image formats that deviate from the 3:4 ratio and result in image blocking due to incorrect appearance after automated cropping.

<mark style="background-color:orange;">**! Important Note**</mark>

<mark style="background-color:orange;">If your images are rejected and do not qualify for an exception, your product will</mark> <mark style="background-color:orange;"></mark><mark style="background-color:orange;">**not go live**</mark><mark style="background-color:orange;">, and you will</mark> <mark style="background-color:orange;"></mark><mark style="background-color:orange;">**not be charged**</mark> <mark style="background-color:orange;"></mark><mark style="background-color:orange;">for it. Charges will only apply if your product is live on our platform and its images are found to be non-compliant with our requirements.</mark>

***

## Download our Content & Styleguide & Image Requirements

{% file src="/files/VtL3bVtxaa1jNRl8dXJ1" %}


# Product Attributes

## Usage and benefits of product attributes&#x20;

1. Usage for virtual categories Example: Category “Jeans” and attribute Lower Part-Length “Short/Mini” will show the product in our virtual category “Jeans Shorts”.
2. Usage for Filters Example: Attribute Upper Part-Length: ”long” will show the product to customers who are filtering for “Long Tops”.
3. For our Shop-Search Example: Attributegroup Neckline: “Henley” will show the products, if the customer is searching for button placket.
4. Important information regarding the mapping of attributes for AY The attribute value **“Further / No specification”** should only be chosen, if really no other specific value is matching for this product. Without a specific attribute value, the products are more difficult to find for the customers.

**-> Every attribute must be mapped specifically and correctly, for the best possible product presentation.**

## Master (Product Level)&#x20;

* **Product title:** the own product name (if existing) in high quotation marks. Example: ‘Lea’ -> no descriptive terms in the product title
* **Product Category:** Always mapp the deepest possible category
* **Brand**
* **Material style:** Very important, because it will be used for the material filtering in our Shop. Please only choose the main part of the material.
* **Multi-Pack:** Only choose >1, if the same kind of product will be sold. -> If there different kinds of products included (e.g. Top & Shorts) we add the information as a “Set”.

## Pattern&#x20;

It is very important that the correct pattern is selected. Otherwise, the product will be rejected. The pattern which is mapped should always display the main part of the product, as it is used for our filtering. Here are a few examples:&#x20;

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FGOc2zUozOivZ2cjZdHHA%2Fimage.png?alt=media&amp;token=26ea4fae-926e-4640-8848-a92cb49cf8b9" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FbL9bZI3Bnbh8pZ24QBRb%2Fimage.png?alt=media&amp;token=a394e641-eeac-4c47-864e-e913b77d079b" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FNBqnhhHIfDPpD8FTLsg7%2Fimage.png?alt=media&amp;token=95160310-c0e8-4487-9e78-7dad649b8d92" alt=""><figcaption></figcaption></figure>

**For more important information, please take a look at the Content & Style Guide:**

{% file src="/files/i54IUblFlzdFr7KkWez6" %}


# Product Rejection

Minimizing errors is key to ensuring seamless processing and immediate product listings. A high rejection rate prevents your products from reaching customers, slowing down your sales and impacting visibility. Most rejections occur when uploaded product data does not meet ABOUT YOU’s platform requirements.

#### &#x20;Most Common Causes of Product Rejections&#x20;

**Image Issues:** Most rejections occur due to missing or low-quality images, especially for jewelry. Blurry, cropped, or incomplete images fail to meet ABOUT YOU’s minimum standards.

**Material Data**: Incomplete or incorrect material information, particularly for categories with specific requirements (e.g., shoes), often leads to rejections.

**Block listed Content**: Products containing block listed terms or designs (e.g., “Smiley”) are automatically blocked and cannot go live.

**Other Issues**: Mismatched images and descriptions, incorrect sizes, or wrong patterns can also cause rejections.

#### Recommended Actions

In order to mitigate these reasons for product rejection, please refer to the table below for a detailed guide on how to solve the various problem reasons.

| Problem Cluster                        | Problem Reason                                   | Problem Definition                                                                                                                                                                                                                                                                                                                                                                                                                                                         | How to solve                                                                                                                                                                                                                                                                                                                                                                                                  |
| -------------------------------------- | ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Image - Requirements are not Fulfilled | First Bust or Model Image Missing                | This product currently does not fulfill our image requirements. For ABOUT YOU the 1st bust view (white or transparent background, showing the product frontal and 3:4 format) is mandatory for the whole assortment. In addition, the 1st model view (white, transparent or light grey background, cropped and 3:4 format) is mandatory for the whole fashion assortment (excluding kids). For shoes the left shoe pointing to the left is mandatory as a first bust view. | <p>Please check your images and the correct transmission of the mandatory 1st bust and 1st model view. Also consider the correct background (white/transparent for the 1st bust and light grey/white for 1st model) if you check your mandatory views.</p><p>Once the images have been corrected and provided by you, please request a review for the corresponding products.</p>                             |
| Image - Requirements are not Fulfilled | Background not white, transparent or light grey: | This product currently does not fulfill our image requirements. For ABOUT YOU the background needs to fulfill the following: 1st bust view = the background must be plain white or transparent. 1st model view = the background must be plain white, transparent or light grey (Hexa-Code: #F4F4F5).                                                                                                                                                                       | <p>Please correct the image background to white/transparent for the 1st bust view or light grey/white for the 1st model view.</p><p><br></p>                                                                                                                                                                                                                                                                  |
| Image - Requirements are not Fulfilled | Wrong Viewing Angle:                             | This product currently does not fulfill our image requirements. For ABOUT YOU the 1st bust view needs the following viewing angles: Fashion = frontal, Shoes = the left shoe, pointing to the left (30° or 50°), Accessoires = frontal, Caps/Hats = frontal or slightly to the left.                                                                                                                                                                                       | <p>Please check your 1st bust view, the viewing angle must be provided as mentioned under the problem definition.</p><p>You need to adjust the provided 1st bust view's viewing angle. </p>                                                                                                                                                                                                                   |
| Inconsistent Data                      | Images and descriptive data are different        | Currently the transmitted images differ from the transmitted descriptive data you've provided, such as attributes or the product description.                                                                                                                                                                                                                                                                                                                              | Please check the product data you transmit for the affected color variant. Also check the images you sent for this product.                                                                                                                                                                                                                                                                                   |
| Inconsistent Data                      | Product Photos not matching selected color       | For the affected color variant we are currently receiving different images/product data as for the other color variants/related products.                                                                                                                                                                                                                                                                                                                                  | <p>The color variants always need to show the same product/data. Otherwise these variants are linked wrongly as related products in our system.</p><p><br></p><p>You need to please check the provided images for the affected color variant. Please also check the product description. If you can't identify the problem, please check the images & descriptive data for all color variants.</p><p><br></p> |
| Inconsistent Data                      | wrong sizes                                      | The transmitted sizes are currently incorrect. Either the size values are wrong (e.g. sizes "6\_NP"), the sizes are inconsistent within one color variant (e.g. sizes "34", "36", "M") or we currently do not receive a 2nd size dimension for all variants within one color.                                                                                                                                                                                              | <p>Please check the provided sizes for the affected variants. As mentioned in the Problem Definition, the sizes must be known values, the sizes must be consistent over all variants for one color and we always must have a 2nd size dimension (Cup Size or Leg Length) for all variants within one color.</p><p><br></p>                                                                                    |
| Inconsistent Data                      | Missing or wrong brand                           | The currently transmitted brand is not correct or does not match the brand displayed on the images.                                                                                                                                                                                                                                                                                                                                                                        | Please check the brand you've provided for the affected product. The brand needs to match the brand provided on the images.                                                                                                                                                                                                                                                                                   |
| Inconsistent Data                      | Prices are configured incorrectly                | The transmitted prices are currently incorrect. Either the price values are wrong or inconsistent.                                                                                                                                                                                                                                                                                                                                                                         | Please check the provided prices for the affected variants                                                                                                                                                                                                                                                                                                                                                    |
| Inconsistent Data                      | Missing material specification                   | <p>At the moment the transmitted material composition is not complete. For Fashion assortment we always need 100% in total, out of the 100% not more than 15% "unspecified" material is allowed.</p><p>For shoes we must receive at least the following 3 components: 1. upper material, 2. inner material/sole, 3. outer sole.</p><p>For jackets we would need at least 2 components: 1. outer material, 2. lining, (3. filling).</p>                                     | <p>Please check your transmitted material composition, it needs to fulfill our material requirements described in the Problem Definition. Please also keep in mind that the material composition must be provided in german.</p><p>If you corrected the data, please provide everything via the middleware and request a review for the affected products afterwards.</p>                                     |
| AY internal                            | Blocklisted term/ design                         | This product either contains trademarked terms, or looks too similar to a trademarked design. Due to strict legal requirements we are not allowed to sell those products at ABOUT YOU yet or in the future. The articles need to stay offline.                                                                                                                                                                                                                             | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                   |


# Brand Page Requirements

Every brand featured on ABOUT YOU gets its own dedicated brand shop. You can see an [example](https://www.aboutyou.de/b/shop/adidas-originals-290).&#x20;

If you are selling a brand that already has an ABOUT YOU webshop page, you do not need to add brand images. However, for new brands, please attach your brand images and logos to the 'Brands' section of the questionnaire. Remember to include images for each of your brands if you have several.&#x20;

Please follow the requirements below. For more detailed information, please refer to our [Brand Page Guide ](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FWYgik80xJoUlAWWu6jkO%2FBrand%20Page%20Guide_Retail%20Media_AY_new.pdf?alt=media\&token=0c2f1baa-5f78-46c0-abd0-6a2187ed74e0)below. Also, click the link [here ](https://partner.aboutyou.com/merchants/brand-steering)to access the feature in the Seller Center and view the step-by-step guide on how to navigate this in Seller Center:\ <br>

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FfGuFoBEJJix0HXXIGhfp%2Fimage.png?alt=media&amp;token=6fb29b8d-6701-43ff-97c3-14d9e8946377" alt=""><figcaption></figcaption></figure>

## Brand Image Requirements

All the images should be up-to-date and fit the current season and target group.&#x20;

**Desktop Image**

1. Dimensions: 3840 x 990px&#x20;
2. Format: High-res .jpg or .png file&#x20;
3. No text, no logo, one visual per image (no collages).&#x20;

**Mobile Image**

1. Dimensions: 1500 x 1200px&#x20;
2. Format: High-res .jpg or .png file&#x20;
3. No text, no logo, one visual per image (no collages).&#x20;

**App Image**

1. Dimensions: 920 x 1220px&#x20;
2. Format: High-res .jpg or .png file&#x20;
3. No text, no logo, one visual per image (no collages).&#x20;

***

## Logo Requirements

**Black Logo on Transparent Background**

1. Dimensions: Any size&#x20;
2. Format: .png and .eps file 2.&#x20;

**White Logo on Transparent Background**

1. Dimensions: Any size
2. Format: .png file&#x20;

<mark style="background-color:orange;">**! Important Note**</mark>

<mark style="background-color:orange;">We maintain only one brand page for each brand. If your brand features both women's and men's clothing on About You, you'll need to provide unisex or couple images. We can only use one asset for each device/format on your brand page.</mark>


# Categories

Manual Integration via UI or Integration via Excel

Category is the name of the most specific category that a product belongs to, including gender, e.g. Fashion|Women|Tops|Shirt|Traditional Shirt. Kindly try to go into categorisation as deep as you can.

You can also follow the steps below to view all available categories directly in Seller Center:

Tab “Products” > Sub-tab “Import Products” > Button “Import Products”

<figure><img src="https://lh7-qw.googleusercontent.com/docsz/AD_4nXdh7BKmM5AcyyB_bWXLnyfX8y1TxKIIHBXKxyPMH46BS-lik7Tc_SRU1Ec4WWUTHyQjKvMHusEp6sKa4TvQTb-uyAuYK_pj_8XVrbjCVcbZWgXMMty059dwksKDO0-lJifRf5dEpQ?key=pDUG8WhmTEIucdhSmRTf5w" alt=""><figcaption></figcaption></figure>

After that > Section “01 Select Template” > Block “Select categories for your import” > Click on it and you will see all the existing categories in AY shop.

<figure><img src="https://lh7-qw.googleusercontent.com/docsz/AD_4nXeRhnpQtifrrKYBB1TCE5UWFgAUzwK1oFNhHJffFXhu5d2XG1C8cQaPi1zXgdxyg8krA5GmF_oTIDoid5ECSGESdvVyFcl0G1Ndk3yEfgxS1WWiOgIKUbuJnPli2tIeyblBEGQn1w?key=pDUG8WhmTEIucdhSmRTf5w" alt=""><figcaption></figcaption></figure>

Please choose the category you need from the suggested list. If you can’t find the category that you need, just choose the most similar one. If you need to assign a product to a very specific category and this is crucial for your brand, please contact our Help Center using [this link. ](https://aboutyou.atlassian.net/helpcenter/sellercenter/portal/1189/group/1688/create/3031)

\*For some products, we don’t have direct categories in the Seller Center. However, you can list them by following these instructions:

* T-Shirts: Select category ‘Shirt’
* Sneakers: Select category ‘Platform trainers’
* Shorts: Select the correct category (jeans, trousers etc.) and set the Length attribute as Short/Mini

{% hint style="info" %}
**! Important Notes:**&#x20;

* Products can be assigned to only 1 category.
* The category is not editable. It means once the product category is published & approved, there is no possibility of changing the category.
* If a product is unisex, the product should be mapped to women.
  {% endhint %}


# Sizes

We need the size of the item that is mentioned on the physical label. Each variant of the product must have a unique size.  <br>

If you are not sure which size format exactly to choose, simply follow these steps to see all the sizes we have in our AY shop for the category that you need:<br>

1. Tab “Products” > Sub-tab “Import Products” > Button “Import Products” > Section “01 Select Template” > Block “Select categories for your import” > Choose the Categories you need  > Click on Button “Generate Templates” > Click on Button “Download Template” > Open the downloaded files.<br>

<figure><img src="https://lh7-qw.googleusercontent.com/docsz/AD_4nXeuog5yfuSFND_zYgyA5kh8_Lj1g5MyvxEzuDQ1P9MHH4pEq9mBJZgwLwRQwS_fbbzmyiJuyLcUhS0BC2IyLr63GJQ1FjXx2cjJBGsz1vKWcfOa9968jLdLCA1KWpVhvgJ9EXO7mg?key=pDUG8WhmTEIucdhSmRTf5w" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh7-qw.googleusercontent.com/docsz/AD_4nXfgt_csF8b4yPQqt98MCrJqnDoOWTwatDHrlfA2NDzdXY6kQpMymqmTrTPnMnV8BuoEMBR1lEZrOU6jXtZiQTrum2V5JfU7R3SDgHkF7VSNULSdsERrk9B66WMnb7dE6tPKxIur?key=pDUG8WhmTEIucdhSmRTf5w" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Please be aware that you have a unique template for each category. Inside each template, you will find specific sizes available for this category.&#x20;
{% endhint %}

### Follow these Steps to find the correct Sizes:

1. Open the file that you downloaded > Tab “Product Feature Information” > Column “Size”. In this column “Size” you will see all the sizes available for the category you have chosen.&#x20;
2. Check the Tab “List Your Products Here” > Column “Size” > Click on the first cell > Open a drop down menu > Choose the size you need.
3. If you need the second size dimension, you can check the Columns “Type of size”, “Leg length”, "Length", “Cup size” (for bras) and choose one of the suggested options in drop down menus.<br>

<figure><img src="https://lh7-qw.googleusercontent.com/docsz/AD_4nXen8biVe0kYyWkE5aqJrd3tyuxulNESY9CVjKZA52D0TcoE_u1exPESvn1JhP5iTgbZbSRDVcdWRM1933c4Wc7MFJytdyps5Qhs1uPEW14S6Etiy9QudmZOSyqB4bOJ0vGYAgBUTA?key=pDUG8WhmTEIucdhSmRTf5w" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**! Important Notes:**&#x20;

* Once the product variant is published & approved, there is no possibility of changing the value.&#x20;
* If products have the 2nd size dimension (e.g. different leg lengths or cupsizes), the second size dimension is mandatory for ALL variants.
* All sizes within one product and color variant must be consistent (from one sizing range). It could not be that one size is XS, but the second size is 44.
* &#x20;If you can’t find the specific size or second size dimension that you need, please create a missing size request in our Help Center, following [this link.](https://aboutyou.atlassian.net/helpcenter/sellercenter/portal/1189/group/1688/create/3031)
  {% endhint %}


# User Size Guide

This document provides an overview of our **sizing logic**. As only one size run is&#x20;available per product category in the Seller Center, sizes may need to be correctly&#x20;**assigned/mapped**.

For example:

| Product Category | Seller Center Size Run                        | Size Translation  |
| ---------------- | --------------------------------------------- | ----------------- |
| Men/Sweaters     | Herren - Intern. /Men International           | M = 48/50 (Konf.) |
| Women/Trousers   | Damen - Inchgrößen/ Women - Inch sizes        | 29 = M (Intern.)  |
| Women/Gloves     | Accessoires - Damen Handschuhe / Women Gloves | 6 = S (Intern.)   |

\
**Please note**: If you offer your product in only one variant, please select 'One Size' as&#x20;the size and optionally add the exact measurements to the product description. If an&#x20;item of clothing is affected please choose XS/XXL.

\
**Please find an whole overview of all size translations here:**

{% file src="/files/EQEkIEaUHrsKaRcP3MqK" %}


# Product Material

Via Excel Upload

This guide will explain how to accurately provide material information for your products when uploading via Excel templates to the Seller Center. Each product category has a unique Excel template, and understanding the nuances of material fields is important for a successful upload.

## General Rules for Material Specification

Mandatory Material Composition: You must always specify the material composition for your products.

### Material Component Requirements by Category

* **Lined Bags and Backpacks:** A minimum of two different material components (=clusters) are required. Percentage values are not added for non-textile categories.
* **Shoes:** Three components (=clusters) are required: outer material, inner material, and sole material.
* **Lined jackets:** Two components are required: outer material and inner material.&#x20;
* **Other Accessories:** Only the material needs to be specified. Percentage information is generally not required for accessories.

### Approved Material Lists:

All materials must comply with the About You approved materials list. This list can be found in Column E - Material Composition Materials of the "Product Feature Information" tab within your specific category's Excel template. Ensure you use the exact spelling provided in this list.

### "Other Material" Option:

If a material is not explicitly listed in Column E - Material Composition Materials of the "Product Feature Information" tab, you can select "Other material." However, "Other material" should not exceed 15% of the total composition where percentages are required.

### Understanding Material-Related Excel Fields:

It's important to distinguish between the various material-related columns in the Excel templates. The exact column letter may vary slightly by category, but the descriptions remain consistent.

### Material Composition Materials (e.g., "Product Feature Information" tab, Column E):

This column lists all the acceptable specific material types (e.g., "Cotton," "Polyester," "Leather," "Gold"). You must select materials from this list and use the exact spelling.

### Material Composition Clusters (e.g., "Product Feature Information" tab, Column D):

This column provides broader categories or clusters for material components (e.g., "Material," "Outer Material," "Lining," "Sole"). You will use these clusters to group your specific materials.

### Material Composition (1952) (Non-Textile) / Material Composition (1797) (Textile) (e.g., "List Your Products Here" tab, Column T or U):

This is the primary column where you will enter the detailed material breakdown. The specific column name might vary depending on whether the product is textile or non-textile, and the category.

* **For textile products:** this column is named "Material Composition (1797) (Textile)" and requires percentage values.
* **For non-textile products:** this column is named "Material Composition (1952) (Non-Textile)" and does not require percentage values.

### How to add the Materials in Excel:

#### Check the "Material Composition" column (tab "List Your Products Here"). Adding the materials in this column in a certain way is critical for product upload.&#x20;

1. **Always specify a Material Component=Cluster:** Before indicating the material, you must specify the relevant cluster from the "Material Composition Clusters" list (Column D in the "Product Feature Information" tab). Do not use the generic word "Composition." If you only have one material component, "Material:" would be recommended.
2. **Use Approved Materials and Exact Spelling:** Ensure that you only use materials listed in Column E of the "Product Feature Information" tab and use the exact spelling provided.
3. Combine Component=Cluster and Material Entries: You need to combine both the material cluster and the specific material entries.
4. **New Line for Each Component=Cluster:** If your product consists of multiple material components (e.g., outer and inner material), each material component must be entered on a new line within the same cell.

Examples:&#x20;

* Format for Textile Products (with percentages)\
  `[cluster1]: [material]=[fraction]; [material2]=[fraction2];`\
  `[cluster2]: [material]=[fraction]; [material2]=[fraction2];`\
  \
  &#x20; `Material: Textile=70; Polyester=20; Polyester=10;`\
  &#x20; `Lining: Silk=100`
* Format for Non-Textile Products (without percentages)\
  `[cluster]: [material]; [material2]`\
  &#x20; `Material: Leather; Gold`

### Key Takeaways for Material Entry:

Consult "Product Feature Information" Tab: Always refer to Column D (Material Composition Clusters) and Column E (Material Composition Materials) in the "Product Feature Information" tab of your specific category's template for allowed values and exact spelling.

Accurate Column Selection: Pay close attention to the specific "Material Composition" column required for your product type (textile vs. non-textile) as they have different formatting requirements.

New Line for Each Cluster: For products with multiple material components (clusters), ensure each cluster begins on a new line within the same cell in the "Material Composition" column.

Dropdown Menus: Utilize the dropdown menus in the "Material (Multiselect)" columns whenever possible.

By following these guidelines, you can ensure accurate and compliant material information uploads, leading to a smoother product listing process on About You. If you encounter any additional challenges or have specific questions not covered here, please reach out to <marketplace@aboutyou.com> for support.

<br>


# Manage and Publish Products

Once your products are created (via UI, Excel import or API), you will find them in “Manage Products”. The view is organized by status tabs—Draft, Pending Approval, Active, Inactive, and Rejected. Clicking on a product master shows its color ways and variants. You can quickly adjust stock and prices or open “Edit Product Details” to add more data or publish.

{% embed url="<https://drive.google.com/file/d/1JzDKrmnSvjAZdmgoyVZ0rsLrF4IEwJUv/view?usp=sharing>" %}

***

## Product Statuses

#### Active

Products that are published, approved, and currently live in the shop.

#### Inactive

Products that were live but have been taken offline. These can be reactivated without re-approval.

#### Pending Approval

Products you have published but that still need About You’s review before going live.

#### Pending Active

Products that have been approved and are currently being processed for the shop. They will automatically go live shortly.

#### Draft&#x20;

Newly created or incomplete products that aren’t ready to publish.

#### Rejected

Products that failed approval. You can review the rejection reasons, make adjustments, and publish again.

***

## Edit and Publish Products

Clicking on a product master opens a modal containing its color ways and variants. This quick view lets you update stock, retail prices, and sale prices. For more detailed edits, choose “Edit Product Details.” You can upload product images, update descriptions<sup>1</sup>, and then publish the product. Once approved, you can also toggle between active and inactive status without needing further approvals.

<sup>1</sup> Text formatting such as bullet points and paragraphs entered in product descriptions may not display correctly on the About You website. The system currently strips formatting, showing descriptions as plain text only.


# Manage Stock and Prices

{% hint style="info" %}
Currency check: Please ensure your prices are not simply copied numbers. Verify that the value entered aligns with the official currency of the destination country (e.g., DKK, SEK) to avoid pricing mismatches.
{% endhint %}

Stock and prices can be updated through multiple methods in the Seller Center, ensuring you have flexibility in how you handle inventory and pricing changes. Whenever a customer orders a product, the system automatically reduces the stock for the corresponding variant, so you always have up-to-date availability. Below are the primary ways to manage stock and pricing:

***

## Using “Products > Manage Products”

One quick way to make adjustments is through the “Manage Products” view. Simply click on a product master in the list, and a modal will open showing its color ways and variants. Here, you can see and modify the retail price, sale price (if applicable), and available stock for each variant. This approach is useful for smaller changes or immediate updates without needing an Excel import. For more details, see the “Manage Products” section of this documentation.

***

## Stock & Price Excel

If you’d like to handle updates in bulk without coding, you can use the “Import Stock & Price” option under “Products > Import Products.” This generates an Excel file containing all your products, which you can adjust and reupload. The file is organized into three worksheets:

#### Help

Contains FAQs and instructions for updating stock and prices.

#### Manage Stock

Lists each product variant once, reflecting its total stock across all countries. Adjust stock levels here, then reupload the file. Remember that each variant has a single stock count, no matter how many countries it’s sold in.

#### Manage Prices

Displays each variant-country combination, making it easy to set distinct retail or sale prices per market. If you only need to modify prices, you can leave the “Manage Stock” tab untouched or even remove it entirely before uploading.

With this Excel approach, you have the flexibility to focus only on stock, only on prices, or both. After uploading, the Seller Center processes your changes and updates your listings accordingly.

***

## API

For more automated or large-scale updates, you can integrate with the Seller Center via its API. This option allows your internal systems or third-party software to communicate directly with the Seller Center to update stock, retail prices, and sale prices programmatically. Refer to the API documentation for information on the endpoints and data formats required for these updates.


# Orders and Shipments

{% embed url="<https://drive.google.com/file/d/1oLfvPtmYXvkpexrHreORY096kIpcM2Dl/view?usp=sharing>" %}

***

## Receive Orders and Order States

Once your products are active, they appear on About You. Every time a customer orders one or more of your products, that order appears in the “Orders” section of the Seller Center. Inside this section, you’ll find five subsections based on item statuses:

1\. Open Orders

2\. Shipped Orders

3\. Returned Orders

4\. Cancelled Orders

5\. All Orders

It’s important to note that these statuses apply to individual items within an order, not necessarily to the entire order at once. For example, you could have one item in a two-item order listed as “Shipped” and the other as “Cancelled.” Because of that, this same order would appear in the “Shipped Orders,” “Cancelled Orders,” and “All Orders” subsections. When multiple items in a single order have different statuses, the order itself is labeled as “mixed.”

***

## Create Shipments

When you’re ready to ship one or more items, you can do so from the “Open Orders” or “All Orders” views. Unlike other platforms where you must ship all items from one order at once, the Seller Center lets you select individual order items—even across different orders—as long as they share the “Open” status. This flexibility is useful if a single customer made multiple orders and you want to combine them in one shipment.

After selecting your items, click on “Shipment Action.” You’ll be prompted to enter a tracking code for the shipment. You’ll see the carrier that the customer selected for the order, and this cannot be changed because the marketplace only allows one assigned carrier per shipment.

***

## Cancel Shipments

Occasionally, you may discover that an ordered item can’t be shipped—for example, if it turns out to be out of stock or there’s another unforeseen issue. In these cases, you can cancel the specific item by selecting it (still in “Open” status) and clicking “Shipment Actions.” Canceled items are assumed never to have been available in stock, so the system does not re-add them to your inventory. Once canceled, these items cannot be shipped later.

***

## Create Return Shipments

If a customer returns a shipped item, you can reflect this in the Seller Center by creating a return shipment. To do this, go to the list of “Shipped” items (or “All Orders,” filtering as needed), select the returned item, and choose “Shipment Actions” to initiate a return. You will then be prompted to enter a return tracking code. If you originally added a return tracking code when you shipped the item, the field will already be pre-filled. \
\
Only items with the status “Shipped” can be returned, so make sure you check the correct status when looking for items that might come back to your warehouse.\ <br>

***

## Shop Name & ID / Prefix

<table data-header-hidden data-search="false"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td>Shop ID</td><td>Shop Name</td><td>Shop Prefix</td></tr><tr><td>139</td><td>ABOUT YOU [DE] </td><td>ayou</td></tr><tr><td>688</td><td>ABOUT YOU [DE|en] </td><td>aydn </td></tr><tr><td>200</td><td>ABOUT YOU [AT] </td><td>ayat </td></tr><tr><td>731</td><td>ABOUT YOU [AT|en] </td><td>ayae </td></tr><tr><td>545</td><td>ABOUT YOU [NL] </td><td>aynl </td></tr><tr><td>732</td><td>ABOUT YOU [NL|en] </td><td>ayne </td></tr><tr><td>550</td><td>ABOUT YOU [PL] </td><td>aypl </td></tr><tr><td>554</td><td>ABOUT YOU [CZ] </td><td>aycz </td></tr><tr><td>558</td><td>ABOUT YOU [BE|nl] </td><td>aybn </td></tr><tr><td>562</td><td>ABOUT YOU [BE|fr] </td><td>aybf</td></tr><tr><td>586</td><td>ABOUT YOU [SK] </td><td>aysk </td></tr><tr><td>590</td><td>ABOUT YOU [HU] </td><td>ayhu </td></tr><tr><td>594</td><td>ABOUT YOU [RO] </td><td>ayro </td></tr><tr><td>622</td><td>ABOUT YOU [LV] </td><td>aylv </td></tr><tr><td>627</td><td>ABOUT YOU [LT] </td><td>aylt </td></tr><tr><td>632</td><td>ABOUT YOU [EE] </td><td>ayee </td></tr><tr><td>637</td><td>ABOUT YOU [HR] </td><td>ayhr </td></tr><tr><td>642</td><td>ABOUT YOU [BG] </td><td>aybg </td></tr><tr><td>654</td><td>ABOUT YOU [DK] </td><td>aydk </td></tr><tr><td>655</td><td>ABOUT YOU [SE] </td><td>ayse </td></tr><tr><td>656</td><td>ABOUT YOU [FI] </td><td>ayfi </td></tr><tr><td>670</td><td>ABOUT YOU [ES] </td><td>ayes </td></tr><tr><td>671</td><td>ABOUT YOU [IT] </td><td>ayit </td></tr><tr><td>705</td><td>ABOUT YOU [CY] </td><td>aycy </td></tr><tr><td>706</td><td>ABOUT YOU [LU] </td><td>aylu </td></tr><tr><td>685</td><td>ABOUT YOU [PT] </td><td>aypt </td></tr><tr><td>686</td><td>ABOUT YOU [GR] </td><td>aygr </td></tr></tbody></table>

<br>


# User Management

You can find your user profile settings and further merchant specific settings on the top right by clicking on "Settings".

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FOOGooS9csGoElXpXNwbX%2FScreenshot%202025-07-30%20153903.png?alt=media&amp;token=92c3a10a-bf03-4196-8310-53c7672f2175" alt="" width="283"><figcaption></figcaption></figure>

***

## User Profile Settings

Every user has access to their profile settings, where they can:

* View their email, name, and other basic profile information
* Change their password

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2F1vL4zc68RKPUgolByp2Q%2Fimage.png?alt=media&amp;token=c3f57e00-4240-408c-bcef-1d74bf75e82c" alt=""><figcaption></figcaption></figure>

***

## Users and Roles

On the settings page, you can view a list of users in your account. Depending on your role, this list is either for reference only or allows you to manage users.

The Seller Center has two role types: Admins and Members. Admins have elevated privileges, enabling them to:

* Add new users
* Delete users
* Change user roles

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FSxWP7mmjbE2ESM4altQh%2Fimage.png?alt=media&amp;token=cd4ed239-d83a-49c9-ac35-99c2f25bd1bf" alt=""><figcaption></figcaption></figure>


# Notifications Settings

You can manage your email notification preferences by navigating to your user profile settings in the top right corner and selecting "Notifications" from the dropdown menu.

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FH8HcTgV8zDpnqLAaVAO3%2FNotification.png?alt=media&amp;token=298d667e-e218-4e3f-8b63-4c93365f3811" alt=""><figcaption></figcaption></figure>

### Email Notifications for Orders

\
The notification system allows you to control which order-related emails you receive, helping you stay informed.

#### Available Notification Types

**New Orders**

Receive an aggregated email summary when new orders are created. Orders are consolidated over a time period and sent once per day. (**Default: Off**)

**Open Orders >24h (Business Hours)**

Receive a daily email if you have open orders without shipment messages older than 24 business hours (business hours exclude weekends). This helps you track orders that may need attention or follow-up,. (**Default: On**)

### Default Notification view for any other user

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2F75DvnlTlqLgHi5K0N15V%2F13131.png?alt=media&amp;token=fbf8fe74-a0ab-412c-b066-cca344dfda23" alt=""><figcaption></figcaption></figure>

Select or deselect the checkboxes next to each notification type based on your preferences, then click "Save" to apply the changes.&#x20;


# Return Management

This guide outlines how to handle customer returns to ensure high service quality and compliance with ABOUT YOU marketplace requirements.

#### 1. The Return Process Overview

* Customer Initiation: The customer uses the provided return label (either included in the original package or generated via the ABOUT YOU portal) to send the item back to the partner's warehouse.
* Logistics: Partners are responsible for providing the necessary return documents and labels within their shipments.
* Status Tracking: You can view the status of returned items and batches directly in the Seller Center under the Orders and Shipment section.

#### 2. Partner Review and Acceptance

Once a return package arrives at your warehouse, it must be inspected promptly.

* Review Window: Partners must review the returned item and decide whether to accept or reject it within 24 hours of receipt.
* Inspection Standards: Check for the original condition of the item, including tags, packaging, and any signs of wear or damage.

#### 3. Processing the Outcome

Depending on the result of your review, follow the appropriate workflow:

**A. Accepting the Return**

If the item is in good condition and the return is valid:

* Update System: Mark the order as "Returned" directly in the Seller Center.
* Integrated Systems: If you use an integration like Shopify, you can mark the return there, and it will sync automatically with the ABOUT YOU Seller Center.
* Refund Trigger: Once the status is updated, the system will initiate the refund process to the customer automatically.

**B. Rejecting the Return**

If the item cannot be accepted (e.g., it is damaged, used, or the return deadline has passed):

* Do Not Update Status: Do not mark the item as returned in the Seller Center or Shopify and reach out to our Customer Service Team in 24 hours.&#x20;
* Document the Issue: Take clear photos of the damage or document the reason for rejection (such as a crossed return deadline).

**How to efficiently contact Customer Service?**&#x20;

Please contact our Help Center immediately by submitting a support ticket through the provided [link](https://aboutyou.atlassian.net/helpcenter/sellercenter/portal/1189/group/1721/create/3163) to report the issue.

Provide the order number and your supporting documentation, such as photos, so they can assist in communicating with the end customer and resolving the dispute.


# Your Guide to Excel in the Seller Center

## 🚀Unlock Your Full Growth Potential on ABOUT YOU!

Growing successfully on ABOUT YOU is not only about listing products, it is also about strategically activating the right performance levers.&#x20;

The following guide highlights the most impactful measures that directly influence your visibility, revenue, and long-term marketplace success.

We focus on seven key growth drivers:

* Sales Campaigns
* Country Expansion
* Retail Media (Sponsored Products/Sponsored Content)&#x20;
* Assortment Growth: High-NMV Product Groups
  * Product Count
* Product Data Optimization
* Lower Return Rates
* On-Time Shipping & Low Cancellations

### Sales Campaigns: Maximize Visibility During Peak Demand

ABOUT YOU runs more than 40 high-energy campaigns per year, including major shopping events such as Black Friday and Summer Sales. During these periods, substantial marketing investments drive millions of customers to the platform, significantly increasing traffic and demand.

Since visibility plays a crucial role in a marketplace environment with millions of products, participating in campaigns is one of the fastest ways to boost performance.

#### **Why participate?**

* Increased product visibility
* Higher traffic exposure
* Strong uplift potential during peak demand
* Improved algorithmic relevance

We strongly recommend joining every major campaign and including your full assortment whenever possible. Full participation increases your exposure across categories and price segments.

#### **How can I participate?**

Participation is simple and can be managed directly in the Seller Center under the “Campaigns” tab.&#x20;

Steps to join campaign:

1. Check invitation sent via email
2. Find campaign in Seller Center
3. Review Campaign details
4. Click **Join** and choose your method of participation (full assortment or partial)
5. Use the already provided template, either add your full assortment or target specific bestseller products

Refer to our in depth campaign guide [here](https://docs.partner.aboutyou.com/about-you-campaigns/your-guide-to-about-you-campaigns) for further details.

### Country Expansion: Multiply Your Revenue Channels

Expanding into all available marketplace countries can significantly boost your revenue. Beyond Germany and Austria, ABOUT YOU operates in eight additional fast-growing markets, offering access to new customer demographics and reducing dependency on a single market.&#x20;

Partners also benefit from lower return rates, which directly increase profitability.

**List of live countries by global market share in descending order:**

1. Germany
2. The Netherlands
3. Austria
4. Belgium
5. France
6. Italy
7. Spain&#x20;
8. Denmark&#x20;
9. Sweden
10. Finland

To summarize, an average uplift of 25% is expected if you proceed to go live in all available markets.&#x20;

**Return Rates per market:**

<table><thead><tr><th width="88.79998779296875">DE</th><th width="89.60000610351562">NL</th><th width="100">AT</th><th width="89.5999755859375">BE</th><th width="89.60003662109375">FR</th><th width="88.800048828125">IT</th><th width="89.5999755859375">ES</th><th width="89.5999755859375">DK</th></tr></thead><tbody><tr><td>48%</td><td>33%</td><td>45%</td><td>33%</td><td>19%</td><td>18%</td><td>22%</td><td>37%</td></tr></tbody></table>

Expanding into countries with lower return rates allows you to maximize profitability per order while reaching new customer demographics.&#x20;

#### How to Expand to Other Countries in the Seller Center

1. **Start Your Expansion Request**<br>
   1. Click “Apply for New Country” in Seller Center.
   2. You can select up to 10 countries (Sweden and Finland are pending final adjustments).<br>
2. **Complete Three Simple Steps**<br>
   1. Specify your VAT IDs for the Go-Live countries or OSS.
   2. Select the available Last Mile Carriers.
   3. Consent to our Invoicing Requirements.<br>
3. **Go-Live and Profit from the Additional Markets** <br>
   1. After review and approval, share prices in the local currencies.
   2. Start shipping orders and benefit from new revenue streams with optimized return rates.

**To fully leverage expansion, ensure that:**

* Your complete assortment is activated
* Prices are uploaded for your products in the respective currencies for every country
* Stock availability is continuously maintained

Each country is an additional revenue stream contributing to your overall growth strategy!

#### Country Steering Tab&#x20;

This tab provides an overview of all active, pending, and offline countries, giving partners a clear view of their current country setup. In addition, partners can easily apply to launch in additional countries directly from this section. Please see the image below for guidance on how to navigate to this section.

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FxpXq0LNwpFjC9Kfdgtn2%2Fimage.png?alt=media&amp;token=04ff8014-6efb-40c1-9cbb-531dde13224a" alt=""><figcaption></figcaption></figure>

### The FBAY Hybrid Model: Scalable Growth & Efficiency

The Hybrid Model integrates ABOUT YOU fulfillment (FBAY) with your existing dropshipping setup to boost visibility and operational performance. By leveraging our European warehouses in Germany, Poland and Slovakia, we handle the end-to-end fulfillment of your orders.

#### Key Strategic Benefits

* **Algorithmic Priority:** Combined models gain stronger exposure, driving higher traffic and conversion.
* **Market Reach:** Immediate access to 11 countries (Germany, The Netherlands, Austria, Belgium, France, Italy, Spain, Denmark, Sweden, Finland, Luxemburg), with a roadmap to 26, including high-growth CEE markets.
* **Maximized Availability:** If FbAY stock runs out, the system automatically backfills via dropshipping to prevent stockouts and protect sales.

#### Why it works:

This setup ensures your products are always discoverable and ready for delivery. By expanding your geographic footprint and stabilizing your inventory, you can capture long-term revenue and reach new customer segments more effectively.

At the same time, operational complexity is reduced. We manage fulfillment and returns, offer competitive warehousing and shipping rates, and enable you to scale internationally with a streamlined setup.

### Retail Media (SPA / SPC): Take Control of Your Visibility

Retail Media is a powerful tool to further increase product visibility and brand awareness within the marketplace.

* We recommend starting with Sponsored Product Campaigns (SPA), which operate in the lower funnel and are designed to drive incremental sales. These campaigns are particularly effective for boosting selected SKUs and generating short-term revenue growth.
* To complement this, Sponsored Content Campaigns (SPC) support mid- and upper-funnel marketing efforts by increasing brand awareness and long-term demand.&#x20;

#### **Key advantages:**

* Full budget control
* Daily KPI monitoring
* Real-time campaign adjustments
* Autonomous setup within Seller Center

#### **Both campaign types can be set up directly in Seller Center under:**

* Sponsored Products
* Sponsored Content

A combined full-funnel strategy often delivers the strongest and most sustainable performance impact.

Please find a detailed guide on retail media offers [here](https://docs.partner.aboutyou.com/retail-media/marketing-opportunities).

### Increase Assortment: Reach a Broader Audience

Uploading the full available assortment in all expanded countries helps reach more customer segments and improve conversion.&#x20;

Assortment planning should align with marketplace demand and ABOUT YOU’s strong female customer base. However, with robust performance currently trending across all other categories, we strongly encourage you to expand your assortment in unsaturated areas to fully capitalize on this broader marketplace momentum.&#x20;

#### **Strategic category focus enables data-driven growth:**

* **Unisex:** Trainers, Socks
* **Women:** Trainers, Trousers, Dresses, Jackets & Coats
* **Unisex Children:** Shoes category, Sports Shoes category
* **Men:** Sweatshirt & Hoodies, Sports Shoes, T-shirt & Polos

Beyond the established growth categories mentioned above, the following segments are gaining significant momentum. These areas are currently undersaturated, representing a prime window for you to capture market share and unlock incremental revenue.

#### Emerging Growth Categories

* **Unisex:** Sports Underwear & Swimwear, Socks
* **Men:** Sweatshirts & Hoodies, Jackets & Coats, Jeans
* **Women:** Jackets & Coats, Sports Jackets, Dresses, Sweatshirts & Hoodies, Jewelry

#### Low-Return, High-Stability Segments

The following categories boast exceptionally low return rates. Expanding your assortment here allows for higher net margins and more predictable inventory stability.

* **Unisex:** Sports Shoes
* **Unisex Children:** Sports Shoes, Shoes
* **Men:** T-Shirts & Polos, Sports Shoes

#### Strategic Takeaways

To maximize your performance, we recommend leveraging these insights to:

* **Secure Availability:** Maintain consistent stock in these high-velocity categories.
* **Deepen Assortment:** Expand variety within core product groups to capture broader demand.
* **Optimize Campaigns**: Align your marketing and campaign participation with these high-NMV (Net Merchandise Value) segments.
* **Boost Profitability:** Scale into undersaturated and low-return profiles to drive superior net profit margins.

### Product Data Optimization

To maximize performance and customer trust, it is essential to optimize your Product Detail Pages (PDP) with accurate, complete, and visually compelling information. High-quality product presentation directly correlates with improved customer experience, reduced return rates, and higher conversion.

#### Data Accuracy & Attributes

Foundational data ensures your products are discoverable and reliable. Focus on maintaining:

* **Precise Product Data:** Verify that all titles, SKUs, and technical specifications are correct.
* **Standardized Attributes:** Include all relevant details such as size, color, material, and care instructions, ensuring consistency across your entire catalog.
* **Informed Decision Making:** Keep attributes detailed to help customers choose the right product the first time.

#### Visual Excellence

Since customers cannot touch the product, your imagery must do the heavy lifting:

* **High-Resolution Photography:** Use clear, professional images that allow for zooming.
* **Context & Scale:** Incorporate model shots to showcase fit and scale where relevant.
* **360-Degree Views:** Display multiple angles to provide a comprehensive visual understanding of the item.
* **Add Model Images:** This helps customers better visualize your product and understand its fit, incorporating images that feature models wearing the item.

### Proactively work on lowering Return & Cancellations Rates

High return rates and cancellations negatively impact profitability, customer satisfaction, and overall marketplace performance. Proactively managing and reducing returns is therefore essential.

Effective measures include:

* Improving product descriptions and imagery
* Providing accurate size guidance
* Monitoring and analyzing return reasons
* Maintaining precise stock management
* Reviewing available prevention guidelines

For additional support, merchants can refer to our documentation [here](https://docs.partner.aboutyou.com/prevention-guidelines/how-to-reduce-cancellations-rates).

### On-Time Shipping: Build Trust and Stability

Reliable and punctual shipping directly influences customer satisfaction, repeat purchase behavior, and seller ratings. Delays may negatively affect overall visibility within the platform.

To ensure strong shipping performance:

* Maintain accurate stock levels
* Set realistic lead times
* Optimize logistics processes
* Monitor fulfillment KPIs regularly

Operational excellence in shipping builds customer trust and supports sustainable growth.

Please note that our shipping SLAs are available under **Section 3.5** of the Fulfillment Annex.

<br>


# Merchant Performance Scorecard (MPS)

Welcome to the Merchant Performance Scorecard (MPS) documentation. This page explains the logic behind our performance tracking, our 4-tier classification system, and how to navigate the Performance S

### 1. Understanding the Core Logic

The MPS is designed to measure Operational Reliability and Consistency. We prioritize these over simple averages to ensure a stable and trustworthy customer promise.

* KPI 1: On-Time Shipping Rate: The percentage of items shipped on or before the "Target Date."
* KPI 2: Order Completion Rate: The percentage of items successfully fulfilled. This is the inverse of the merchant-led cancellation rate (Stock-outs).
* Note: Customer-requested cancellations are excluded from this calculation.

#### Determining the Current Score:

Your overall performance is defined by your "weakest link." Your daily tier is determined by whichever KPI is currently performing at the lower level. For example, if your On-Time Shipping Rate is "Elite" but your Order Completion Rate is "Poor," your overall status will be Poor.

### 2. Navigating the Dashboard UI

#### **The Performance Meter**

The central meter displays your current standing across our four tiers.

<br>

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2Fqmg8pRwDpI1ciO5oChR0%2Funknown.png?alt=media&amp;token=54a98f15-32d6-4ecf-9636-d5d99770a608" alt=""><figcaption></figcaption></figure>

You can hover over the different tier segments to see the exact requirements for each:

<br>

| Tier         | Status         | On-Time Shipping Rate | Order Completion Rate |
| ------------ | -------------- | --------------------- | --------------------- |
| Elite        | 🟢 Dark Green  | ≥ 98.0%               | ≥ 99.5%               |
| Standard     | 🟢 Light Green | ≥ 95.0%               | ≥ 99.0%               |
| Concerning   | 🟡 Yellow      | ≥ 90.0%               | < 99.0%               |
| Critical     | 🔴 Red         | < 90%                 | <= 98.5%              |
| Insufficient | ⚪ Grey         | < 30 Orders           | < 30 Orders           |

#### **Score Prediction & Leveling**

\
Your dashboard shows a Predicted Rating for your next evaluation cycle:

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FlQ7aR6ifnqx9hqk5qMYW%2Funknown.png?alt=media&amp;token=8f860eab-742e-42b9-902d-5863b934158e" alt=""><figcaption></figcaption></figure>

* This simulates what your score would be if the 28-day cycle ended today.
* The UI indicates if you are currently "Leveling Up" or at risk of a downgrade based on your current performance trend.

#### **Deep Dive: Daily Rolling Averages**

By clicking on the Score Prediction, you can access a detailed view of your metrics.

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FUrVFAAiyp8UHl8YiTQN3%2Funknown.png?alt=media&amp;token=8ab5d9f6-a1f8-4847-b1ff-cfbd46fbf64c" alt=""><figcaption></figcaption></figure>

This includes:

* **Score Prediction** for the next 28-day timeframe
* **Current Score**&#x20;
* **On-Time Shipping Rate**: Your rolling average for dispatch punctuality.
* **Order Completion Rate**: Your rolling average for successfully fulfilled orders (non-cancelled items).

### **3. How is your On-Time Shipping Rate calculated?**

We calculate your target dispatch date fairly, accounting for business hours and data latency.

* **Lead Time**: 2 Business Days.
* **Cut-off Time**: 15:00 (3 PM) local merchant time. Orders placed after this time start their "Day 1" the following business day.
* **Business Days**: Monday - Saturday. Sundays and Public Holidays are excluded.
* **Anchor Date**: We use an "Effective Anchor Date" to allow for a data latency buffer (waiting for dispatch signals and late cancellation confirmations).

### 4. Platform Visibility & Product Sorting Impact

In accordance with your Merchant Agreement, your operational performance directly influences your product visibility in the shop. High operational reliability is rewarded with increased exposure to boost your sales.

#### Automated Visibility Boosts

* **Active Score Impact**: Your Current Score directly impacts your product sorting in the shop.
* **Reward Focus**: Maintaining high operational quality allows you to significantly boost your storefront visibility. Excellent performance unlocks maximum sorting advantages.
* **Cycle Automation**: Visibility adjustments take effect automatically at the start of each new evaluation cycle based on your finalized 28-day score.

#### Operational Escalations & Manual Audits

* **Severe Performance Failures**: In cases where a merchant experiences prolonged operational disruptions—specifically falling into critical thresholds for 14 consecutive days or 28 out of 30 rolling days—the platform reserves the right to manually adjust product sorting scores down.
* **Partner Outreach**: Sorting down-ranking for severe operational failure is handled manually by our Operations team, not by an automated script. Before taking action, our Partner Management team will reach out to the merchant directly to give them the opportunity to clarify the issue, state reason, and stabilize fulfillment workflows.

### 5. Track & Trace (T\&T) Operational Incidents

Track & Trace (T\&T) incidents provide data-driven alerts to help you fix operational gaps before customer satisfaction is impacted.

💡 **Note**: T\&T incidents are currently decoupled from your overall MPS performance score and tiers.

#### Scope & Schedule

* **Scope**: Currently active for Germany (DE) with DHL integration (will expand as carrier integrations grow). Only parcels to Germany sent with DHL standard national and shipped directly by you (no cross-docking) are covered.
* **Schedule**: Incidents fire bi-weekly on the 1st and 3rd Tuesday of every month and remain visible in your dashboard for 3 consecutive days (Tuesday–Thursday).

#### Standard Severity Thresholds

All T\&T incidents follow the same performance rules based on a 30-day rolling lookback window:

* 🔴 **Critical Severity**: Performance < 90%
* 🟡 **Medium Severity**: Performance < 95%

#### T\&T Incident Types

**1A. Outbound Tracking Coverage**

* **Trigger**: Missing valid carrier tracking IDs or trace events for outbound parcels. A tracking code only counts as valid once DHL has scanned the parcel.
* **Evaluated items**: Items ordered in the last 30 days, excluding the last 24 hours, so parcels have time to get their first carrier scan.
* **Impact**: Customers cannot see live delivery updates.
* **How to Solve**: Verify your ERP/carrier integration settings and transmit complete outbound tracking codes end-to-end. Make sure your default last-mile carrier (LMC) matches the tracking codes you provide (see "Tracking Coverage: what triggers an incident and how to avoid it" below).

**1B. Return Tracking Coverage**

* **Trigger**: Missing valid return label tracking IDs or trace events.
* **Evaluated items**: Returned items from orders placed in the last 30 days.
* **Impact**: Reverse logistics timelines cannot be verified.
* **How to Solve**: Check warehouse dispatch settings to ensure valid return tracking numbers are generated and transmitted.
* **Note**: If you are integrated via Shopify or Rithum, we cannot measure your return tracking coverage yet, so you will not receive a Return Tracking Coverage incident for now. We are working on adding this.

**2. Delivery on Target (DoT)**

* **Trigger**: Tracked orders taking longer to reach the first delivery attempt than the market's working-day target.
* **Impact**: Delivery delays reduce customer satisfaction.
* **How to Solve**: Clear warehouse packing backlogs, hit daily carrier cut-off times, and prioritize shipping your oldest open orders first.
* **Reference**: Country target times can be found in the Operations Guide v1.3 (Page 3) or via the[ Logistics Documentation Portal](https://www.google.com/search?q=https://partnercenter.aboutyou.com/documentation/logistics-sla).

**3. Reimbursement on Target (RoT)**

* **Trigger**: Return confirmations and refunds taking longer than the market's working-day target from the return start date.
* **Impact**: Delayed refunds damage customer trust.
* **How to Solve**: Monitor arriving returns daily and confirm/process refunds as soon as items reach your facility.
* **Reference**: Country target times can be found in the Operations Guide v1.3 (Page 3) or via the[ Logistics Documentation Portal](https://www.google.com/search?q=https://partnercenter.aboutyou.com/documentation/logistics-sla).

#### Tracking Coverage: What Triggers an Incident and How to Avoid it

Are you seeing a tracking coverage incident even though you submit tracking codes?&#x20;

In most cases the code exists, but we cannot match it to a parcel scanned by DHL. Below you can see what we check, how to avoid these incidents and the most common reasons why a tracking code is not valid.

#### What is checked:

| Coverage type                | What triggers it?                                                              | Which items are evaluated?                                                                                            |
| ---------------------------- | ------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------- |
| Tracking coverage (outbound) | 95% or less of your shipped items have a valid tracking code that DHL scanned. | Items ordered in the last 30 days, excluding the last 24 hours, so parcels have time to get their first carrier scan. |
| Return tracking coverage     | 95% or less of your returned items have a return tracking code.                | Returned items from orders placed in the last 30 days.                                                                |

#### How to avoid tracking coverage incidents

1. Provide a valid tracking code for every shipped and returned item.
2. Make sure your default last-mile carrier (LMC) matches the tracking code you provide.

#### Common reasons a tracking code is not valid:

| Issue                                             | Description / Example                                                                                                                                                                                       |
| ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| LMC and tracking code mismatch                    | We cannot fetch tracking information if your LMC does not match the tracking code you provide. Example: your LMC in Germany is DHL standard, but you submitted a Hermes tracking code.                      |
| Tracking code and physical parcel mismatch        | We cannot fetch tracking information for the correct parcel. Example: you submitted a legitimate tracking code for the order, but the physical parcel was shipped with a different label and tracking code. |
| Valid carrier and tracking code, but no scan data | Example: you use a carrier that cannot provide tracking information.                                                                                                                                        |
| Same tracking code reused                         | Example: you enter one valid placeholder tracking code on several orders when confirming shipment in the Seller Center.                                                                                     |

#### What is not counted against you

* **Small volumes**: you will not receive a Track & Trace incident if fewer than 30 of your items are evaluated.
* **Shipments outside the Track & Trace scope**: Track & Trace incidents only cover parcels to Germany sent with DHL standard national and shipped directly by you (no cross-docking). Parcels to other countries or sent with other carriers do not trigger a Track & Trace incident today.
* **Shopify or Rithum integration (returns)**: if you are integrated via Shopify or Rithum, we cannot measure your return tracking coverage yet, so you will not receive a Return Tracking Coverage incident.

### 6. Delivery on Target (DoT)&#x20;

Delivery on Target (DoT) metrics track country-specific targets to monitor delivery timeliness.

💡 **Note**: Day 0 is defined as the day the order is placed. Currently, tracking is active exclusively for Germany (DE) orders, with a target of 3 business days for delivery on target.

**Scope & Calculation**

* **Scope**: Currently tracks Germany (DE) orders only.
* **Delivery Target**: 3 business days for DE orders (Day 0 = Order Placement Date).

**Example**

An order is placed on Thursday, 21.05 by a DE customer:

* **GIVEN** carrier working Mon–Fri
* **AND GIVEN** target for DE market is 3 working days
* ✅ **Delivered within target**: Delivery arrives no later than Tuesday of the following week.
* ❌ **Delivery outside target**: Delivery arrives on Wednesday or later.

| **Metric**                   | **Elite (Dark Green)** | **Standard (Light Green)** | **Concerning (Yellow)** | **Critical (Red)** |
| ---------------------------- | ---------------------- | -------------------------- | ----------------------- | ------------------ |
| **Delivery on target (DoT)** | ≥ 98%                  | ≥ 95.0%                    | ≥ 90.0%                 | < 90.0%            |

### 7. Return on Target (RoT)&#x20;

Return on Target (RoT) metrics use country-specific targets to monitor return processing timeliness.

💡 **Note**: Day 0 is defined as the day the customer drops off the parcel or starts the return process. Currently, tracking is active exclusively for Germany (DE) orders, with a target of 6 business days for reimbursement on target.

**Scope & Calculation**

* **Scope**: Currently tracks Germany (DE) orders only.
* **Return Target**: 6 business days for DE orders

**Example**:

Customer dropped off parcel / return started on Thursday, 21.05 by a DE customer:

* **GIVEN** carrier working Mon–Fri
* **AND GIVEN** target for DE market is 6 working days
* ✅ **Reimbursement within target**: Return confirmation by merchant is no later than Friday of the following week.
* ❌ **Reimbursement outside target**: Return confirmation by merchant is Monday of the second week onwards.

| **Metric**                        | **Elite (Dark Green)** | **Standard (Light Green)** | **Concerning (Yellow)** | **Critical (Red)** |
| --------------------------------- | ---------------------- | -------------------------- | ----------------------- | ------------------ |
| **Reimbursement on target (RoT)** | ≥ 98%                  | ≥ 95.0%                    | ≥ 90.0%                 | < 90.0%            |


# FbAY Overview

This paragraph explains details which are solely valid for the FbAY model.

Besides Fulfillment by merchant, ABOUT YOU also offers the Fulfillment by ABOUT YOU (FbAY) model. In this model, you can inbound and store your stock in the About You warehouses and ABOUT YOU is responsible for the fulfillment to the end customer.

In the FbAY model, the Partner commissions ABOUT YOU with the storage of goods in one of ABOUT YOU’s warehouses to which the Partner delivers goods in bulk. The customer shipments and returns are handled by ABOUT YOU.

Currently, your goods will only be stored and sent from the German warehouse. In the future, more warehouses will be implemented.


# Shipping Notice

Before an order can be placed in the ABOUT YOU shops, you must first ship your stock to our warehouses. Once your items are received, have inventory, and have active prices, they will go live online.

Please note it is crucial that all the products you intend to ship have already been successfully created in the Seller Center beforehand.

To advise us of the products you would like to inbound, please check out our step-by-step guide on how to create a shipping notification. Additionally, please make sure to thoroughly read our delivery guidelines (see attachement below) to ensure a smooth reception at the warehouse.

**Upload Guide:**&#x20;

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FWEohahjsSblfFVZFRMjA%2Fimage.png?alt=media&amp;token=67be64a7-1890-452f-b733-e78b7e112615" alt=""><figcaption></figcaption></figure>

**Excel Template & Delivery Guidelines:** &#x20;

{% file src="/files/uEyxWcFGBHEhubT3EPZU" %}

{% file src="/files/TRZVTqy1x2Xt23ETLUMK" %}

**Inbound Suggestion Calculator**

You are not sure how many pieces you should advise for your first season? No problem! Feel free to use our custom inbound calculator below. How does it work?

* Tell us how many products you want to onboard (one color variant equals one product).
* Let us know many different sizes on average you have for one color variant.
* Lastly, please estimate how many pieces you can inbound per size.

Please be aware that this is the inbound we would recommend for the first season and thus can still be split into multiple deliveries to our warehouse.

**Inbound Template Calculator:**

{% file src="/files/g7YYVAE4RNUqusiT5jD4" %}


# Order States

Once your products are active, they appear on ABOUT YOU. Every time a customer orders one or more of your products, that order appears in the “Orders” section of the Seller Center. Inside this section, you’ll find five subsections based on item statuses:

1\. Open Orders

2\. Shipped Orders

3\. Returned Orders

4\. Cancelled Orders

5\. All Orders

It’s important to note that these statuses apply to individual items within an order, not necessarily to the entire order at once. For example, you could have one item in a two-item order listed as “Shipped” and the other as “Cancelled.” Because of that, this same order would appear in the “Shipped Orders,” “Cancelled Orders,” and “All Orders” subsections. When multiple items in a single order have different statuses, the order itself is labeled as “mixed."


# Manage Prices

## Update Price

Prices can be updated through multiple methods in the Seller Center, ensuring you have flexibility in how you handle inventory and pricing changes. Below are the primary ways to manage pricing:

***

## Using “Products > Manage Products”

One quick way to make adjustments is through the “Manage Products” view. Simply click on a product master in the list, and a modal will open showing its color ways and variants. Here, you can see and modify the retail price, sale price (if applicable) for each variant. This approach is useful for smaller changes or immediate updates without needing an Excel import. For more details, see the “Manage Products” section of this documentation.

***

## Price Excel

If you’d like to handle updates in bulk without coding, you can use the “Import Price” option under “Products > Import Products.” This generates an Excel file containing all your products, which you can adjust and reupload. The file is organized into three worksheets:

#### Help

Contains FAQs and instructions for updating stock and prices.

#### Manage Prices

Displays each variant-country combination, making it easy to set distinct retail or sale prices per market.

After uploading, the Seller Center processes your changes and updates your listings accordingly.


# Reporting

Apart from the order status overview, two reportings are available to you in the FbAY model:&#x20;

1. Warehouse Report: As part of the Warehouse Report, merchants will receive information about stock movements within and between About You warehouses. This information is intended to be used for VAT Report, Intrastat, and EC Sales List obligations. The Warehouse Report must not be used to interpret the offerable stock quantity for B2C business in About You shops. It does not differentiate between qualities. In the report, stock movements are grouped per day, SKU, reference, and process type. The movements are categorized into the following process types:

<p align="center"><img src="https://lh7-qw.googleusercontent.com/docsz/AD_4nXfcU3JL719QR2ASzCd5rj3v2kMzmCjdBiTF2IBz30WiAfupXZlXrQFcc60fKDdJ8ZKNGus0pxuVQPX3aFskPnmf_efulECyoJQr4yYryAns9TUBZbXKXEbv7ZPDRGI4BP9_0RsGXA?key=Q1PTl27R7skdPy7sNY-2bw" alt="" data-size="original"></p>

<p align="center"><img src="https://lh7-qw.googleusercontent.com/docsz/AD_4nXfDTfU8rJE9GH-V3FEWvJI6ik7psSf3CK_O1tlj6x3m0LKXxmKyNAClWA4rlX7GLmB7K5CyASStEQ9qHnLrtl1dsS2RCRH197nSfRwfYmjwywR1f215_bT0U3xdnFMK2dTpj-Yx8g?key=Q1PTl27R7skdPy7sNY-2bw" alt=""></p>

<p align="center"><img src="https://lh7-qw.googleusercontent.com/docsz/AD_4nXdTpcfU2-hycWnayrYVMB8wuhAmP7Y8uH0S2IdC4W-OcVlVN7jxzbDumzYo11AZ0Oc8MLhI5tamYeAtxvM2ndDY1BzooRYFHKvodnFdlE3H_gVUnCdEZhsGk6dq_UO_kS5i9u5eqw?key=Q1PTl27R7skdPy7sNY-2bw" alt=""></p>

Some return\_b2c movements will neither have a reference (order id) nor a source\_country because warehouse staff are unable to identify which order a returned item belongs to, e.g. a customer doesn’t include the About You return document in the return parcel, which makes the identification of the related order id impossible.

<p align="center"><img src="https://lh7-qw.googleusercontent.com/docsz/AD_4nXfo5qsHMojE2PKia8Sc49mhn1UR7TKXf6Nk2mdohjkzSuCVYho29koQaoGaNM-pEYUVd1SWzgdKGpAKyl4gpdU7S7wqLL0Ug7tTWsCJs-j5RJXYQKnWc2V4MVfbqh-RVfBpt6lF?key=Q1PTl27R7skdPy7sNY-2bw" alt=""></p>

<p align="center"></p>

2. Stocks

The Seller Center gives you an overview about the sellable stock of your product. However, a historical stock report will also be provided for download.

About You will supply the partner with a periodic stock report.

The stock report includes all SKU’s which have a stock greater than 0. The stock amounts only reflect the final intakes of the About You outbound warehouses (no transitional stock amounts).

The full list of SKUs will be provided in chunks of 10,000 SKUs with pagination. About You provides the chunks in order. Hence, receiving the last page of a job execution, implies the successful reception of the previous pages. If there are no positive stocks, an empty stock report is provided.

The validity of the reported stocks is exactly the validAt date provided for the stock. Processing the stock according to its validity is in the responsibility of the merchant:

* The merchant should skip stock messages older than the last processed stock message per SKU
* The merchant should determine which SKUs are not included in the report anymore & update these SKUs’ stock to 0

The maximum size per request is around 2.2MB

**Please note:** The stock figures cannot be directly compared with the Warehouse Report below, which provides a more detailed breakdown.

{% file src="/files/fcCwlv5QQGr8450AZi82" %}


# Fulfillment Model Expansion

## 🚀 Unlock Scalable Growth with Maximum Efficiency

### Overview

The Fulfillment Model Expansion (FbAY Hybrid Model) is designed to take your business to the next level by combining the strengths of ABOUT YOU Fulfillment (FbAY) with the flexibility of your existing dropshipping setup. Instead of replacing your current model, this approach enhances it, unlocking new growth opportunities while simplifying operations.

By integrating into ABOUT YOU’s fulfillment infrastructure, your products benefit from improved visibility, broader reach, and a significantly more stable supply chain, all while you maintain flexibility where it matters most.

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FsnKB7WONxlEtLSmA5ism%2Funknown.png?alt=media&amp;token=8bd15782-0484-4df5-ad96-da486688444c" alt=""><figcaption></figcaption></figure>

**❗Please Note: Make sure to double-check with your integrator whether the hybrid model is technically supported.**

### &#x20;How to Get Started with the FbAY Hybrid Model

Setting up FbAY is designed to get you live quickly while preparing your business for scalable international growth.

#### Step 1: Submit Your Expansion Request

Go to Seller Center and submit your FbAY Expansion Request via the Inventory section. This initiates your onboarding process.

#### Step 2: Provide Fulfillment Details

Enter all relevant fulfillment information, including your return warehouse for seasonal returns. This ensures a smooth operational setup from the start.

#### Step 3: Select Your Go-Live Countries

Choose the markets you want to launch in. You can start with a focused selection and expand over time.\
Please note that for each country, a valid VAT ID or OSS registration is required.

#### Step 4: Fulfill Tax Requirements

To enable cross-border fulfillment, VAT registrations are required in phases:

* Phase 1 (Initial Setup):\
  German VAT ID and Czech VAT ID are required. OSS is not applicable at this stage.
* Phase 2 (Expansion):\
  Additional VAT IDs for Poland and Slovakia are required as you expand into international warehousing.

As tax requirements can be complex, we recommend coordinating with a tax advisor.

#### Step 5: Ensure Compliance

* Confirm your invoicing setup (you are responsible for local legal compliance)
* Provide your German EPR (LUCID) registration number to sell in Germany

#### Step 6: Confirm the Agreement

Accept the Marketplace Terms of Use and the ABOUT YOU Fulfillment Annex in Seller Center to complete your setup.

Please make sure to submit your request once all required information has been filled in. Simply entering data will only mark the process as “Expansion Started” and does not trigger the review.

After submission, your request will be reviewed. If everything is correct, your account will be set up accordingly, so you’re ready to go live and start scaling with the FbAY Hybrid Model.

#### Step 7: Signing COD Agreement&#x20;

Cash on Delivery (COD) payment options in Slovakia (SK), Slovenia (SI), and Portugal (PT).

Critical Requirement to Go Live: To participate and enable COD options for your store in these three markets, it is a strict mandatory prerequisite that you sign and return the attached agreement. We cannot unblock your setup or take you live in these regions until this signed document is received.

\
What this amendment does:

* Enables Track-and-Trace Refunds: It explicitly authorizes SCAYLE Payments to trigger and process customer refunds based on delivery tracking status, even before the final cash settlement is received from the carriers.
* Clarifies Risk Allocation: It confirms that the standard economic risk of an ultimate payment collection default (non-collection by the carrier) remains with the merchant.

{% file src="/files/q4egcaxLoPN7RfV0cqsk" %}

Please fill out and sign the document and send it to the following email address:&#x20;

**<am.mp@aboutyou.com>**

### Why This Model Drives Growth

One of the biggest advantages of the hybrid model lies in how your products are positioned. Because ABOUT YOU’s shop logic prioritizes FbAY alongside Wholesale and Dropshipping, your assortment gains stronger algorithmic exposure. The result is clear: higher visibility, increased traffic, and ultimately stronger conversion.

At the same time, the model unlocks immediate access to 11 European markets, including key regions such as Germany, France, and the Nordics. This is only the starting point. Over time, you will scale into a network of up to 26 countries, with a strong focus on Central and Eastern Europe, one of the fastest-growing e-commerce regions. This expansion brings not only a larger customer base, but also significant long-term revenue potential.

### Always Available, Always Selling

A core strength of the hybrid model is its ability to protect your sales. FbAY acts as your primary fulfillment channel, ensuring fast and reliable delivery through ABOUT YOU’s warehouse network. However, if an item goes out of stock, the system automatically switches to dropshipping as a fallback.

This seamless backfill logic ensures that your products remain available at all times, eliminating stockouts, safeguarding revenue, and maintaining strong visibility within the platform.

### Operational Simplicity Meets Scale

While your business expands internationally, your operational effort decreases. ABOUT YOU takes over the entire fulfillment and returns process, allowing you to focus on your core business.

You simply inbound your products into our warehouse via the notification feature in Seller Center, and we handle the rest. From storage to delivery and returns. At the same time, you benefit from competitive shipping and warehousing rates, making the model not only scalable but also cost-efficient.

### Smart Assortment Strategy

The hybrid model gives you the flexibility to manage your assortment in a strategic way. Your bestsellers and NOS items can be stored in ABOUT YOU warehouses to maximize availability and performance. Meanwhile, seasonal or trend-driven products can remain in your dropshipping setup, allowing you to react quickly to market changes without taking on unnecessary inventory risk.

This combination creates the perfect balance between stability and flexibility, ensuring you are always ready to capture demand.

### Seamless Setup and Future Expansion

Getting started is straightforward. In the initial phase, your products will be stored in our German warehouse and sold across 11 countries. As your business grows, you will gradually expand into additional markets and warehouse locations across Europe, including Poland and Slovakia, with returns handled via our Czech facilities.

This phased approach allows you to scale step by step, without operational disruption.


# Logistic Price List

This guide provides a detailed overview of the core logistics fees, outbound shipping, and customer return rates across Europe to help you effectively manage and calculate your operational costs.

#### 1. Core Service Fees (Standard Across All Markets)

These baseline fees apply globally to all items processed within the ABOUT YOU multi-warehouse infrastructure, regardless of the destination country.

| **Service**                   | **Level**      | **Price (Excl. VAT)** | **Description**                                                        |
| ----------------------------- | -------------- | --------------------- | ---------------------------------------------------------------------- |
| Inbound Processing            | Per Item       | 0.4728 €              | Processing and sorting items upon arrival at our distribution centers. |
| Storage / Warehousing         | Per Item / Day | 0.0161 €              | Daily inventory storage within our multi-warehouse setup.              |
| Return to Merchant Processing | Per Item       | 0.9082 €              | Processing costs for unsold inventory returned to the partner.         |

**Non-Compliance Penalties:** Inbound Non-Compliant Fee: 0.25 € per shipment (applied if delivery requirements, such as inbound forecast volumes or delivery location splits, are not followed).&#x20;

**Warehouse Non-Compliant Fee:** 0.50 € per shipment (applied if standard smart return re-allocation across all ABOUT YOU warehouses is restricted).

#### 2. Fulfillment Costs by Country (Shipping & Returns)

Outbound shipping and customer return processing fees are calculated at the shipment level and vary depending on the destination market.

| **Country Code** | **Country**    | **Outbound Shipping (Per Shipment)** | **Customer Returns (Per Shipment)** |
| ---------------- | -------------- | ------------------------------------ | ----------------------------------- |
| AT               | Austria        | 3.45 €                               | 2.91 €                              |
| BE               | Belgium        | 4.37 €                               | 3.96 €                              |
| BG               | Bulgaria       | 4.69 €                               | 3.70 €                              |
| CH               | Switzerland    | 5.79 €                               | 5.97 €                              |
| CY               | Cyprus         | 7.38 €                               | 4.78 €                              |
| CZ               | Czech Republic | 3.97 €                               | 2.75 €                              |
| DE               | Germany        | 3.27 €                               | 3.11 €                              |
| DK               | Denmark        | 5.50 €                               | 4.64 €                              |
| EE               | Estonia        | 4.75 €                               | 3.57 €                              |
| ES               | Spain          | 4.86 €                               | 4.84 €                              |
| FI               | Finland        | 4.89 €                               | 5.49 €                              |
| FR               | France         | 5.84 €                               | 6.07 €                              |
| GR               | Greece         | 5.47 €                               | 4.13 €                              |
| HR               | Croatia        | 3.62 €                               | 4.01 €                              |
| HU               | Hungary        | 4.70 €                               | 4.43 €                              |
| IE               | Ireland        | 5.75 €                               | 5.79 €                              |
| IT               | Italy          | 5.73 €                               | 5.47 €                              |
| LT               | Lithuania      | 5.02 €                               | 3.46 €                              |
| LU               | Luxembourg     | 6.42 €                               | 6.26 €                              |
| LV               | Latvia         | 5.11 €                               | 3.60 €                              |
| NL               | Netherlands    | 4.06 €                               | 3.22 €                              |
| NO               | Norway         | 12.91 €                              | 6.71 €                              |
| PL               | Poland         | 5.04 €                               | 3.55 €                              |
| PT               | Portugal       | 5.73 €                               | 4.97 €                              |
| RO               | Romania        | 4.07 €                               | 3.68 €                              |
| SE               | Sweden         | 5.70 €                               | 5.84 €                              |
| SI               | Slovenia       | 4.32 €                               | 3.50 €                              |
| SK               | Slovakia       | 3.40 €                               | 3.22 €                              |

#### 3. Important Billing & Operational Notes

* Combined Shipments Benefit: Due to our consolidated multi-item shipping approach, partners can benefit from highly optimized fulfillment rates compared to single-item direct-to-consumer shipping.
* Market Access Restrictions: Operating via the Hybrid model allows Fulfilment by Merchant (FbM) partners to unlock 100% of ABOUT YOU's geographical reach. While standard FbM models can only service about 55% of the revenue market footprint, utilizing FbAY grants automatic access to the remaining 45% of net revenue markets.
* Value-Added Services (VAS): All stated prices are baseline rates subject to change. Any inbound delivery errors that result in manually fixing packaging, labels, dimensions, or unapproved security tags will trigger extra processing fees on a per-case or per-piece basis as defined in the master operations guide.

#### **Please find all additional logistics requirements in the file below:**

{% file src="/files/LPaezzkluWkFVVTF23bn" %}

<br>


# How To: Reduce Cancellations Rates

High cancellation rates directly affect both customer experience and sales performance. Customers typically cancel due to unclear delivery expectations or fulfillment issues, it impacts your store’s reliability and visibility on our marketplace.

Our goal is to help you minimize cancellations and ensure a smoother, more transparent shopping experience for your customers .

### Most common reasons for High Cancellations

Most frequent causes include:

* **Missing or Delayed Shipment Message**: Slow order handling can result in cancellations before the items are shipped. If customers don’t receive a tracking number, they may assume their order wasn’t processed, prompting customer service inquiries or cancellations.
* **Slow Processing Time**: Delays in order handling can lead to cancellations before the shipment leaves the warehouse.
* **Out-of-Stock or Inventory Inaccuracies**: Selling unavailable items results in cancellations and negative customer experiences. Maintaining adequate safety stock is essential. Introducing a stock buffer could be beneficial to avoid running out of stock.&#x20;

#### **Process in Case of Stock Discrepancies**:&#x20;

* If you are aware of any discrepancies, please do not hesitate and reach out to <am.mp@aboutyou.com> and state the problem as well as the expected time to resolve the issue.

### Recommended Actions

#### Maintain Accurate Inventory Levels

* Sync your stock in real time to avoid overselling.
* Deactivate listings for products temporarily out of stock.
* Maintain a stock buffer if you have challenges with high cancellations

#### Optimize Fulfillment & Shipping Operations

* Review fulfillment data monthly to identify bottlenecks (processing time, delayed pickups, etc.)


# How To: Prevent Missing Shipments

Missing shipments refers to orders that have not been shipped yet or have been delayed, meaning that we have not received the respective tracking ID from a last mile carrier for an order.&#x20;

Our goal is to ensure exceptional service to our customers by timely delivery of orders and increase customer satisfaction. This is why it is important that you always share the valid tracking ID within the provided SLAs.

### Most common reasons for Missing Shipments

**Most frequent causes include:**

**Missing or Delayed Shipment Message:**&#x20;

* If customers don’t receive a tracking number, they may assume their order wasn’t processed, prompting customer service inquiries or cancellations.

**Using Non-Approved Last Mile Carriers:**&#x20;

* Using a different last-mile carrier results in an invalid tracking ID, as it is not directly connected to our system.

#### Process for Delays or Discrepancies:&#x20;

Please do not hesitate and reach out to <am.mp@aboutyou.com> and state the problem as well as the expected time to resolve the issue.<br>

#### **Recommended Actions**

#### Provide Immediate Order Confirmation

* Confirm every order within 24 hours of order activation.
* Automate confirmation emails to avoid forgetting to send confirmation emails.

#### Share Tracking Information as soon as possible

* Provide correct tracking numbers as soon as orders are shipped. Preventing lack of trust with customers leading them to cancelling orders.

*Please Note: For Shopify users, please know that you would have to share the tracking number via Shopify. Additionally, once a tracking number is provided, you cannot change it.*


# How To: Lower Return Rates

A high return rate is typically caused by a disconnect between what the customer expects and what they ultimately receive.

Our goal is to help you improve quality checks and communication in order to increase customer satisfaction and reduce returns to strengthen your presence on our marketplace.

#### Most Common Reasons for High Returns

* **Damaged Items**: Customers return items that are damaged or those that arrive in damaged packaging.
* **Wrongly Shipped Items**: Products shipped in error lead to customer dissatisfaction and lead to returns.
* **Inaccurate Product Description and Photos**: Customers receiving a product that’s somehow different than what is displayed under the product description, would also result in returns.
* **Unclear Sizing Standards**: If the sizing chart is based on foreign standards without clear conversion to local (e.g. EU) standards, or if detailed measurements are not provided, items frequently won't fit, causing returns.

*Please Note: ABOUT YOU does not track specific return reasons for customer orders.*

#### Recommended action

**Improve Packaging Quality:**&#x20;

* Make sure that your products are handled and packed well to prevent returns. Use durable materials according to the order.

**Implement Quality Checks:**&#x20;

* Introduce a final inspection step before dispatch to ensure items and packaging are in perfect condition.&#x20;
* Ensure the information for fulfillment of the product is accurate.
* Make sure that the product photo and description matches the product itself.&#x20;
* The functionality, color and product material should be as accurate as possible.

**Clarify Sizing Standards:**

* &#x20;Indicate whether sizes follow EU, US, UK, or other standards and include conversion charts. Additionally, label items that run bigger or smaller and are in between sizes.

**Remove high return items:**

* If return rates are repeatedly high for a specific product, consider having the product inactive. Slowly introduce the product back to your assortment once the return rate has been reduced.

<br>


# Recordings

Welcome to our Webinar Recording Library. This space provides access to recordings of our past webinars and online sessions, giving you the opportunity to revisit important topics.

Our webinars cover a wide range of topics, including product and platform updates, new features and functionalities, marketplace processes, best practices, and important announcements. Each session is designed to provide practical insights and guidance to help you get the most out of our platform and services.

​You can watch the recordings at your convenience and return to them whenever you need a refresher on a specific topic. Where available, you will also find additional resources and documentation related to the webinar.

We regularly add new recordings to this space, so check back for the latest sessions and updates.

***

#### Webinar: Mastering Product Creation

We unveiled our brand-new Bulk Product Uploads feature and provided a step-by-step guide to creating and enriching your products. We also answered some of our partners’ questions during the session.

{% embed url="<https://drive.google.com/file/d/1iQIlDzfQ2qYBQrYf4lO71ywMlmrhMmm2/view?usp=drive_link>" %}

​Hosted: 11.08.2026

***

#### Webinar: Sponsored Products Basics + Best Practice&#x20;

dd

***

#### Webinar:&#x20;

dd

***

#### Webinar:&#x20;


# Your Guide to ABOUT YOU Campaigns

Welcome! This guide explains our **new Campaigns feature**, showing you how to join major sales events, the benefits for your brand, and how pricing and invoicing work.

With Black Friday just around the corner, this is the perfect time to learn how to use this powerful new tool.

***

### 🚀 What Are Campaigns & Why Should I Join?

At ABOUT YOU, we run over 40 high-energy campaigns a year for events like Black Friday, Summer Sales, and more. These are huge shopping moments when we invest heavily in marketing to bring millions of customers to our shop.

This new feature is your direct ticket to participate. By joining, you can:

* **Boost Your Visibility:** Your products get featured under the official "Sale" banner, reaching many more customers.
* **Highlight Your Offers**: Your products receive a special "DEAL" badge that makes them stand out.
* **Drive Conversion:** Discounts and the "DEAL" badge are proven to increase clicks and sales.
* **Strengthen Your Brand:** Participating in our major events builds brand awareness and shows customers you're a key partner.

***

### 📋 How to Participate: A Step-by-Step Guide

Follow these steps to join a campaign.

#### Step 1: Check Your Invitation

You will receive an invitation via email with all the key details, usually one to two weeks before the campaign starts.

#### Step 2: Find the Campaign in Seller Center

Go to your Seller Center account and navigate to Promotions > Campaigns.

Here, you will find the campaign dashboard. You can see all Now (active), Joined, Past, and Upcoming campaigns. Click on the campaign you want to join.

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2Fh6s6Zoek7CLfhXKfjzmO%2Funknown.png?alt=media&amp;token=c2f27ece-b8cb-4456-b188-ec04072fade5" alt=""><figcaption></figcaption></figure>

#### Step 3: Review the Campaign Details

On the campaign card, you will see all the essential information:

* **Participation Deadline:** The last day to join or edit your submission.
* **Promotion Period:** The dates the campaign will be live in the shop.
* **Participating Countries:** The markets included in this campaign.
* **Discount Range:** Our recommended discount to be competitive.

#### Step 4: Click "Join" and Choose Your Method

You have two simple options for how to add your products.

**OPTION 1: Participate with Your Full Assortment (The Quick Way)**

This is the fastest way to get maximum participation.

1. Select the "Choose a percentage for the whole assortment" option.
2. Choose a single discount (e.g., 20%).
3. Click "Join now".
4. You're done! Your entire assortment will be included in the sale.

**OPTION 2: Select Specific Products (The Strategic Way)**

This is perfect for targeting specific items, like bestsellers or last season's stock.

1. Click on the "Select products" button.
2. Click DOWNLOAD to get the product list.
3. Open the file and enter your discounts for the products you want to include.
4. Upload your completed file.

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FR9yvYimmT5Tc0684EJni%2Funknown.png?alt=media&amp;token=98154310-7ded-47d2-8ec4-a09b3de4cbb2" alt=""><figcaption></figcaption></figure>

#### Step 5: Manage Your Participation (Before the Deadline)

After joining, you can return to the campaign dashboard at any time before the participation deadline to:

* See a countdown to the deadline.
* Edit your discounts.
* Leave the campaign if you change your mind.

Once the deadline passes, your submission is locked, and the discounts will go live automatically during the promotion period.

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FpThpBUpcCSWW2XkYr2dN%2Funknown.png?alt=media&amp;token=01e0cc76-7513-4dd4-b616-a320bda7177f" alt=""><figcaption></figcaption></figure>

***

### ❗️ IMPORTANT RULES – Please Read&#x20;

Please review these rules carefully to ensure your participation is successful.

* Use this Feature only: You must use this "Campaigns" feature to participate. Discounts sent through your normal price feed will not be included in the campaign or get the "DEAL" badge.
* Discounts in Steps of 5: All discounts must be in steps of 5 (e.g., 10%, 15%, 20%, 35%).
* One Discount for all Countries: The discount you set for a product will apply to all participating countries. You cannot set different discounts per country for the same item.
* Lists are by Color: The product list you download for Option 2 is on the Color Variant level, not the EAN level.
* Sale Impact: Discounts configured for a campaign are campaign-specific only. It will not affect or overwrite the sale price you have set through Seller Center, Shopify, or other integrations.

***

### 💸 How Invoicing & Pricing Work

We've made the financial part simple and transparent.

#### How Prices Appear in the Shop

During the campaign, your discount is applied to your last transmitted price. All discounted items get the "DEAL" badge. When the campaign ends, your prices automatically return to normal.

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FOoHCKoLdxB9F91x0kwmd%2Funknown.png?alt=media&amp;token=04b019ee-d30e-4add-ade2-6ebf5a822993" alt=""><figcaption></figcaption></figure>

#### How Invoicing Works

There are no extra fees. The process is fully automated in your settlement file:

Here's a simple example:

* Your product's normal price (*initialAmount*): €100
* You offer a 20% campaign discount.
* The customer pays: €80
* Our commission is then calculated on the final €80 selling price, not the original €100.

**This is a key benefit:** You only pay commission on the final price the customer pays. Furthermore, this lower price might even cause your product to fall into a lower commission cluster, saving you even more.

***

### 🏆 3 Pro-Tips for Campaign Success

1. **Prepare Ahead:** For big events like Black Friday, make sure all your products are online and, most importantly, have enough stock to meet the demand.
2. **Make a Great Offer:** Be competitive. We know our customers love to use the "highest discount" filter. A strong offer can push your products right to the top of the list.
3. **Keep the Momentum Going:** Black Friday is huge, but it's just one of many events. Joining campaigns regularly keeps your products visible. For maximum impact, combine your campaign participation with Sponsored Products.


# ABOUT YOU Top-Up Discounts

This guide will help you understand how to participate in our sales campaigns, the benefits of doing so, how ABOUT YOU Top-Ups work, and how campaign discounts are settled in our invoices.

### Overview of Campaigns

Several times per season, we offer partners the opportunity to join our major sales campaigns. These campaigns are designed to boost sales and increase visibility while helping to reduce inventory holding costs.

In general, there are two different types of campaigns:

* Discounts on the whole shop: Participation requires discounts across the entire assortment.
* Discounts on selected products/parts of your assortment: Partners can choose to participate with specific parts of their assortment.

### Benefits of Participating in Campaigns

Participating in ABOUT YOU campaigns is one of the most effective ways to boost your brand's storefront visibility, drive traffic, and significantly increase conversion rates. Here is why joining our promotional campaigns is essential for growing your sales on the marketplace:

* Increased Sales & Traffic: Drive additional sales volume through heightened storefront visibility and attractive customer discounts.
* ABOUT YOU Top-Up Discounts: Maximize your conversion rates without extra margin impact. ABOUT YOU co-invests by offering additional on-top discounts funded directly by ABOUT YOU.
* Improved Placement: Gain better placement in product assortments on our platform.
* Brand Boosting: Enhance your brand awareness through attractive discounts.
* Inventory Reduction: Move slow-selling or seasonal products more effectively.

### ABOUT YOU Top-Up Discounts

To help marketplace partners maximize their sales performance during campaigns, ABOUT YOU provides Top-Up Discounts, additional promotional funding provided directly by ABOUT YOU on top of active product pricing.

#### How Top-Ups Work

ABOUT YOU automatically offers on-top discounts to products that are not currently being discounted via the sales campaigns tool in the Seller Center. This occurs regardless of whether a partner is actively participating in a campaign.

| Program Feature   | Application Criteria                                                                | Top-Up Mechanics                                                             | Partner Impact                                                                                                             |
| ----------------- | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Automatic Top-Ups | Products that are not discounted via the sales campaigns tool in the Seller Center. | ABOUT YOU automatically applies an on-top discount funded 100% by ABOUT YOU. | Fully automated. Enables non-discounted products to capture additional campaign traffic without affecting partner margins. |

📌 Key Rule on On-Top Funding: All Top-Up discounts provided by ABOUT YOU do not reduce your agreed baseline payout. Standard invoice mechanics ensure you are only charged for your voluntary partner discounts.

#### Managing Your Participation & Opt-Out

All marketplace partners are automatically included with on-top discounts to ensure maximum exposure during major promotional events.

* Default Inclusion: All partners are automatically included with on-top discounts for products not discounted via the campaign tool.

<img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FpC6vQdnuc5bV9XpA2i1d%2Funknown.png?alt=media&amp;token=594b70b1-714a-4f19-ba1b-1f9178322e22" alt="" height="171" width="271">

* Opting Out: If you do not wish for ABOUT YOU to apply on-top discounts to your products, you can actively opt out in the Seller Center at any time for every campaign or as a default for all campaigns in the campaign settings:&#x20;

<img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FRDILxMWrL41zPjy8pKa6%2Funknown.png?alt=media&amp;token=d12458f9-be00-4c6e-89e4-072874dc22cc" alt="" height="322" width="216">

* The final AY fund is decided 3 days before the participation deadline and replaces the ABOUT YOU funds range.&#x20;

### How to Participate in Campaigns

Partners will receive an invitation via email, usually within 9 days before the start of the campaign, to inform them about the upcoming campaign.

#### How to add products to a campaign via SCAYLE

1. Login to Partner Portal using your Marketplace Account > Marketing > New Sales Promotions. Make sure to login with your new Marketplace account, not the old one.
2. Find the description of each campaign, where you can see key framework information: Sales promotion period, participation deadline, participating country(ies), reduction of your choice (only increments of 5%), and minimum reduction (if required). We cannot make any exceptions if the deadlines are not met. Manual lists via Email will not be accepted.
3. Click JOIN on the campaign you would like to participate in.
4. Read and follow the next steps (1 to 3) on the Sales Promotion Overview.
5. To participate, you can download the product list via the DOWNLOAD button from the respective campaign entry. Product lists show all the partner's products that are live in the Shop at that time. Fill in the column Reduction Offer with the desired discount in absolute numbers (example: 30 for 30%) for each product. If a product does not participate in the campaign, the entire line must be removed.
6. Once the list is edited and finalized, upload it via the UPLOAD TEMPLATE button.

Please note:

* The lists are on Shop Product ID level (not on EAN level).
* If there is a “yes” in the column “Deleted” - it means that the product has not been in stock for more than four weeks.
* 📌 The reductions for major campaigns via the portal are uploaded by About You. Only these reductions will count as an “active participation” (not the ones through the middleware). Nonetheless, reductions via the middleware will remain active at all times.

### Campaign Invoicing Process

All discounts from campaign participation are directly applied to the RRP of your sold items within your standard monthly self-billing invoices. Please keep the following key settlement details in mind regarding campaign accounting:

* Campaign participation is reflected in the invoices by applying the granted discount to the RRP of sold items. These statements are issued on a rolling basis at the start of every month for the preceding period.
* ABOUT YOU Top-Up Settlement: Any additional on-top discounts provided by ABOUT YOU are funded entirely by ABOUT YOU and do not deduct from your baseline payout. Your invoice reflects only your voluntary partner discount.
* Refunds will be credited through your upcoming monthly AY voucher compensation invoice.
* Please note that no additional settlement files or separate PDF documents will be provided for these promotions.
* The campaign participation directly reduces the RRP of items in the self-billing invoices.


# Marketing Opportunities

## Discover your Marketing opportunities on ABOUT YOU

## Introduction

Get started with Retail Media to increase your product visibility and brand awareness.

Click [here](https://corporate.aboutyou.de/en/login) to view our **Retail Media Hub**, our dedicated website where you can find all information about our Retail Media offerings. Password: RetailGrowth2026!

{% embed url="<https://drive.google.com/file/d/1i7Bu_lYldWw9NkvSg9VZN3Qq50lEA1T1/view?usp=drive_link>" %}

We recommend starting with **Sponsored Product** Campaigns (lower funnel) to create incremental sales and boost your performance. Completing your marketing activities with **Sponsored Content** Campaigns (mid and upper funnel) would be the full funnel addition.&#x20;

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FFlOxzsWT7MgkFZ4s0kvB%2FMedia%20data_Ad%20Tools_Retail%20Media_AY_2026.png?alt=media&amp;token=7553160e-a310-4e37-9ad9-a427be7a6b14" alt=""><figcaption></figcaption></figure>

You can set up both campaign types autonomously by using our **self-service tools** **directly in the Seller Center** by navigating to the menu points ‘Sponsored Products’ and ‘Sponsored Content’ without leaving your seller center surface. You have full budget control, can view KPIs on a daily basis and adjust your campaigns whenever needed.&#x20;

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2Fr3G0aqVXSAE5IEyBTfpg%2FMedia%20data_Ad%20Tools_Retail%20Media_AY_2026%20(2).png?alt=media&amp;token=6aee9758-ac21-4809-8960-6d77473e862e" alt=""><figcaption></figcaption></figure>

For **Sponsored Products** the **minimum campaign budget is 1k € per month**. At the end of a campaign **only the actual ad spend will be invoiced**. The actual ad spend is dependent on the traffic in the shop, only if a shop user clicks on a Sponsored Product the CPC is being charged.

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FXNVJLe13f7uYbjFIQv51%2FMedia%20data_Ad%20Tools_Retail%20Media_AY_2026%20(1).png?alt=media&amp;token=56f24bdb-44c4-4c74-8c04-4317b56a1826" alt=""><figcaption></figcaption></figure>

For **Sponsored Content** Campaigns the **minimum budget depends on the placement location, gender and country scope**. We recommend starting with a minimum budget of 2k € per campaign. Also here, **only the actual ad spend will be invoiced** at the end of each month.

***

## Start strong with our offers&#x20;

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FHYaiA7qCFXU4ixSoWr9p%2FBild%2022.10.26%20um%2013.37.png?alt=media&amp;token=e9947ebe-c464-4ab7-aba0-ee03b89261cb" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
[**Sign up**](https://share-eu1.hsforms.com/1NqAQQfXITvu5VK5LD9g4Wg2c2t09) for our Retail Media Newsletter and our Sponsored Products & Sponsored Content Newsletter to receive news, opportunities and information about upcoming events in and around ABOUT YOU!&#x20;
{% endhint %}

***

**Need Help?**

Reach out to [service-retailmedia@aboutyou.com](#about-sponsored-products) for all questions in regards to Retail Media.<br>


# Sponsored Products

### NEWS - Black Month&#x20;

Capture high-intent shoppers, maximize platform visibility, and unlock peak annual sales potential.

**Rewatch** *Webinar I* to explore 2025 traffic trends and discover how a full-funnel marketing strategy drives maximum growth during Black Month 2026.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FS7c0pdv27XcXfElHnShe%2FBlack%20month%202026%20-%20ABOUT%20YOU.mp4?alt=media&token=b0b01547-26e0-4c0a-b551-2e31bc60dbfd>" %}

**Rewatch** *Webinar II to* to explore how to set up a Sponsored Products campaign and find the right strategy for your brand.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FD5P5zJLMS2LwPZFh54Yp%2FGMT20261009-102533_Recording.cutfile.20261009121650169_2634x1396%20(2).mp4?alt=media&token=ea00b5f0-01e6-4b22-9b30-6d5cfe52293f>" %}

### About the tool - intro

With Sponsored Products you can **increase your products' ranking and visibility within the categories and on article detail pages** in the ABOUT YOU shop as well as in the ABOUT YOU **CRM channels** (Newsletter and Push Notification) by paying a Cost per Click (CPC) bid. In the Sponsored Products tool you can create and optimize your Sponsored Products campaigns and get valuable insights with our various reporting functions.

By adding a CPC to your products, they will rank higher in the sorting when compared to their organic position. This generates incremental sales of 4% to 20% (*Source: ABOUT YOU A/B Test in June 2022 (5% to 20%) & in July 2023 (4% to 20%); Results are highly influenced by the CPC and product selection used at the time.)*

There are no fixed slots for Sponsored Products, instead they are mixed in our personalized sorting algorithm within product category pages to deliver an inspirational shopping experience.

Have a look at the **introduction video** in the following.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FmJtd91PJlNwtdgHKD10Z%2FSeller%20Center%20Sponsored%20Products%20Introduction.mp4?alt=media&token=0080783f-ec57-4042-a763-47486991d4be>" %}

***

## Tips for your first Campaign

### 1. Start Broad

Start your first campaign by choosing **“all products”** to lever the highest potential and activate **all available countries** to gather valuable performance insights. With that set-up, whenever new products go live, they will automatically be included in the campaign.

Set your **campaign goal to visibility** to maximize your visibility for the first month(s).&#x20;

Push your performance growth by **steering with a dynamic CPC** targeting (+26% more reach\* compared to a manual CPC strategy).\ <sub>*\*Based on n = 1.224 campaigns,  Time frame: 21.09.2024 -21.03.2025*</sub>

### 2. Allocate enough Budget

Make sure you have allocated enough budget to allow your campaigns to run effectively. We offer a **CPC per country** option, with **different minimum CPC values** for each country. Adjust the CPC per country based on campaign performance.

### 3. Steer continuously

Let the campaign run for 1-2 weeks before making changes. Adjust the campaign regularly until performance stabilizes. Once stable, reduce the frequency of changes and let it run as an always-on campaign.

***

## Tips on how to further optimize your Campaign

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FdiGGq2n0WOVMW5dsbjFL%2FSponsored%20Products%20-%20How%20to%20improve%20results.mp4?alt=media&token=942a8bcd-6578-476d-8d4b-30623042174a>" %}

### 1. Find your Sweet Spot

The ROAS should be within the sweet spot range, depending on your chosen strategy. This means that the product is in a profitable position with a good compromise between visibility, clicks and sales.&#x20;

For a visibility strategy a ROAS between 50%-500% is considered as good.

### 2. Track key KPIs

Track your campaign performance on a weekly basis until the performance is stable. In the beginning we advise to check your campaign 1-2 times per week, then revise to a biweekly rhythm. Check the key KPIs such as ROAS, Ad Spend, CTR, CR and Sponsored Sales Share to get an understanding of your campaign performance.

### 3. Optimize Campaign Performance by Adjusting the CPC

Optimize the performance at campaign, country and/or product level by adjusting the CPC.&#x20;

* Adjust the CPC on campaign level:
  * Increase or decrease the CPC according to the performance. If your ROAS is above the Benchmark (BM) we’d advise to increase the CPC. If it’s below BM, we’d advise you to decrease your CPC. <br>
* Adjust the CPC on product level (on the campaign detail page):

  * Products that are spending too much of the budget → decrease the CPC
  * Products that have a very high ROAS → increase the CPC
  * Products that you want to give an extra visibility push → increase the CPC

<figure><img src="https://lh7-qw.googleusercontent.com/docsz/AD_4nXclKT3LvpRjzgEGcfhn0-Tz1fwj0gNgTBIg5sOl3v5hSbVVADBqslT-W3XWcSA6qoZH3TMzH-1BNNP9S_IukKRPrW7k167TEjEz2TZX9ehvW4egx1HLCwBbDhD3wCreC4trjqcGSQ?key=dAXBEuElZzj1EQLb88ggaxQI" alt=""><figcaption></figcaption></figure>

* Adjust the CPC on country level (on the campaign edit page):

  * Countries with a ROAS above the Benchmark → increase the CPC and utilize the highest potential
  * Countries with a ROAS below the Benchmark → decrease the CPC

  <figure><img src="https://lh7-qw.googleusercontent.com/docsz/AD_4nXdZMB7fgAWnTyTp82mUGlljpkx5b0tArPOiblSvG7nTgrZddnP-OA8-Wb8UOarNReugBv8GRHUGeuRuiyz5eZxbr5IOd_2ql82EGdIVefotgmcx_VrOs2dTBM5rhz2sBcz4u3m1lA?key=dAXBEuElZzj1EQLb88ggaxQI" alt=""><figcaption></figcaption></figure>

***

## New Markets. New growth.&#x20;

Scale into new markets with an **exclusive discount!** Launch a Sponsored Products campaign in your newly activated countries to secure **50% off your first month plus 20% off for the rest of the year** (valid until 31.12.2026)\*.

#### How to get your discount:&#x20;

1. Set up a **separate and new** Sponsored Products campaign for all newly added markets.&#x20;
2. Create your campaign as usual and tailor the setup to your individual goals.
3. Select your countries. Please select **only the newly activated countries** from the list below.

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2Ftkqknc8SuCCeUiC3n2vI%2FMP%20Incentives%202026%20(1).png?alt=media&amp;token=d893dc73-bc87-4b07-b244-99ddc1d86d06" alt=""><figcaption></figcaption></figure>

4. Activate your campaign and you are ready to go! Once your campaign is live, there is nothing else you need to do. The discount will be automatically applied to your campaign.

{% hint style="info" %}
Add your markets [here](https://partner.aboutyou.com/promotions/sponsored-products/).&#x20;
{% endhint %}

<sub>\*Valid only for newly created campaigns targeting markets where you have not previously advertised, not to be combined with other incentives, valid until 31.12.2026.</sub>

***

{% hint style="info" %}
Have a look at the [user guide and FAQs](https://drive.google.com/file/d/1e1j4WScthxQ0NUyXfshN7fo5JVUnaEJX/view?usp=drive_link) for further information and useful tips on steering and optimizing your campaigns. Stay up to date with the newsletter. Click [here](https://share-eu1.hsforms.com/1NqAQQfXITvu5VK5LD9g4Wg2c2t09?utm_medium=email&_hsmi=105314829\&utm_content=105314829\&utm_source=hs_email) to subscribe.
{% endhint %}

***

**Need Help?**

If you have any questions, please contact [service-retailmedia@aboutyou.com.](#about-sponsored-products)


# Webinar Space

Watch the recordings of our latest webinars and don't miss to sign up for our frequently webinar series.

## #New -  Black Month

#### Session #1: Get Ready for Black Month&#x20;

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FS7c0pdv27XcXfElHnShe%2FBlack%20month%202026%20-%20ABOUT%20YOU.mp4?alt=media&token=b0b01547-26e0-4c0a-b551-2e31bc60dbfd>" %}

#### Session #2: How to succeed in Black Month

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FynAgy3b4ljMP941wuStB%2FGMT20261014-090013_Recording_1920x1080%20(1).mp4?alt=media&token=272cd9e1-54a1-481c-b8d8-138889400ac2>" %}

## Sponsored Products

#### #Basics - How to get started&#x20;

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FJ2UCmHnHcpEOli0lqbfi%2FGMT20261009-102533_Recording.cutfile.20261009121650169_2634x1396%20(2).mp4?alt=media&token=2b8061ac-56b7-4518-ab29-068547d37ea2>" %}

## Sponsored Content&#x20;

#### #Basics - What you need to know&#x20;

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2Fumw2398FNwiTYbbTRAoS%2FGMT20261030-100014_Recording.cutfile.20261030104521418_1920x992.mp4?alt=media&token=91bc7160-20bf-4fc4-9af9-a540139bef61>" %}


# Sponsored Content

Next to Sponsored Products we recommend running **Sponsored Content** Campaigns to address a full funnel Marketing approach. Through various Onsite Placements you have the opportunity to increase your brand awareness. Have a look at the **introduction video** in the following.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FNR7VZsm0CSCYMXRquB5P%2FSponsored%20Content%20Introduction%20-%2010_25.mp4?alt=media&token=ed823bc2-1391-4c41-82dc-648ee6b876f0>" %}

The **minimum budget depends on the placement location, gender and country scope**. We recommend allocating a minimum budget of 2k € per campaign. In addition to the min. CPM you can set a **boosting CPM** to increase the likelihood of being displayed in the bidding based pricing.&#x20;

The following video gives you tips on how to create your first campaign.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2Ft7Km3N24zeBra3VND0mQ%2FSponsored%20Content%20-%20How%20to%20create%20a%20campaign%20-%2009_25.mp4?alt=media&token=7bfa2c60-90bd-4587-b3eb-23fb0c70338a>" %}

If you’d like to find out more, feel free to check out the slide deck from our last webinar, which includes further information.

{% hint style="info" %}
Have a look at the [user guide and FAQs](https://drive.google.com/file/d/1wJth-zPZEfd1GxyM1HZMRmpb5Pxndtxu/view?usp=drive_link) for further information and useful tips on steering and optimizing your campaigns. Stay up to date with the newsletter. Click [here](https://share-eu1.hsforms.com/1NqAQQfXITvu5VK5LD9g4Wg2c2t09?utm_medium=email&_hsmi=105314829\&utm_content=105314829\&utm_source=hs_email) to subscribe.
{% endhint %}

***

**Need Help?**

If you have any questions, please contact [service-retailmedia@aboutyou.com.](#about-sponsored-products)


# Retail Media WhatsApp channel

Stay Connected with ABOUT YOU Retail Media!

{% columns %}
{% column %}
Join our official ABOUT YOU Retail Media WhatsApp Channel and **stay up to date** with the latest news, insights and exclusive opportunities.

Be the first to know what's new and get valuable insights to make the most of your Sponsored Ads campaigns!
{% endcolumn %}

{% column %}

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FSUett3B2iEcHnS6EnNwm%2Fwhatsapp_signup_qr_1.jpg?alt=media&amp;token=3a10ed6b-1e3e-459e-a22a-73ca39cea2da" alt="" width="188"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2Fkf5ZMYqxl4Zud0zC6iLU%2FPhone_WhatsApp_Max_SignUp_Logo_1%20(1).png?alt=media&amp;token=60cdf612-28af-4fe4-a65e-c86da91a61fc" alt="" width="188"><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
Have a question? We're just a message away! Reach out to our team directly via WhatsApp and get in touch with us whenever you need support.

### Sign up now & win!&#x20;

One month of Sponsored Products budget could be yours! As a little welcome gift, we're giving away one month of Sponsored Products budget worth up to **€5,000** among everyone who joins our WhatsApp Channel.&#x20;

{% endcolumn %}
{% endcolumns %}

<p align="center">Simply join by <strong>November 26, 2026,</strong> and you'll automatically be entered into the raffle. </p>

<p align="center">(Terms &#x26; Conditions apply.)</p>

<p align="center"></p>

#### Consent&#x20;

*By clicking the button, you consent (Art. 6(1)(a) GDPR) that ABOUT YOU uses the contact details stored in your partner profile (email and phone number) to send you information about offers and promotions (e.g. Retail Media campaigns, promotions, events, Partner Updates).You can* [*withdraw your consent* ](https://aboutyou.atlassian.net/helpcenter/sellercenter/portal/1189/group/1819)*at any time with future effect (e.g. by using the linked form in our Service Desk, by emailing <service-retailmedia@aboutyou.com> or by sending "STOP" in the messenger chat). We use the software solution of Charles GmbH, Gartenstr. 86-87, 10115 Berlin ("Charles") to offer and use WhatsApp Conversations. As a processor, Charles processes your data exclusively on our behalf and not for its own purposes. WhatsApp is operated by WhatsApp Ireland Limited, 4 Grand Canal Square, Grand Canal Harbour, Dublin 2, Ireland ("WhatsApp Ireland"). WhatsApp Ireland acts as a controller in terms of data protection law for the transmission of messages via WhatsApp and your responses. Further information on data processing by WhatsApp can be found here:*[ *WhatsApp Ireland privacy notice*](https://www.whatsapp.com/legal/privacy-policy-eea?lang=en)*. For more information on data protection, please see our*[ *Privacy Policy*](https://corporate.aboutyou.de/en/privacy-policy-for-business-partners-and-suppliers)*.*

{% file src="/files/SFHxxgvioPxaF5LLl0nR" %}


# Getting Started

Welcome to the Seller Center API! Our API allows seamless integration with your operations, enabling automation, data synchronization, and workflow customization beyond the user interface.

### Key Features

* **Authentication & Security**: Secured via API Key authentication, available only to **Admin users**.
* **Product & Order Management**: Create, update, and retrieve products and orders programmatically.
* **Asynchronous Processing**: Bulk operations and large data updates return a **BatchRequestId** for asynchronous processing. Use the results endpoint to track status and retrieve the final output.
* **Webhooks**: Subscribe to real-time notifications for key events like order creation and status updates.

### How to get started

To get started integrating and using the Seller Center API, there are two key components to set up: **API Keys** for authentication and the **Sandbox Environment** for safe testing and experimentation. Both features are exclusively available to **Admin users**, ensuring secure access and controlled testing.

* [ ] [API Authentication](https://docs.partner.aboutyou.com/api/getting-started/api-authentication)
* [ ] [Sandbox Environment](https://docs.partner.aboutyou.com/api/getting-started/sandbox-environment)

### API Documentation

You can find our Open API Documentation at [**https://partner.aboutyou.com/api/v1/docs**](https://partner.aboutyou.com/api/v1/docs)**.**&#x20;


# API Authentication

Our API uses **API Key authentication** to ensure secure access. Only **Admin users** can generate API keys, while **Member users** do not have permission to create or manage keys. This ensures that only authorized users can access and integrate the API.

#### Generating an API Key

To obtain an API key:

1. Navigate to **Settings** in the UI.
2. Go to the **API Keys** section.
3. Click **+ Add**.
4. Input a label for the key, optionally set an expiration date and click **Add Key**.
5. Copy and securely store the key, as it will not be shown again.

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FGKzrGvoZ9AMNlXTOAP9j%2Fimage.png?alt=media&amp;token=0b595b1a-f4cd-4e6a-987a-99019baafba9" alt=""><figcaption><p>API Keys settings section</p></figcaption></figure>

#### Using the API Key

Once you have generated an API key, include it in the request header for authentication:

```
X-API-Key: YOUR_API_KEY
```

Example request using `curl`:

```
curl -X GET "https://partner.aboutyou.com/api/v1/products" \
     -H "X-API-Key: YOUR_API_KEY"
```


# Sandbox Environment

The **Sandbox** feature allows Admin users to create an isolated testing environment where they can freely experiment and integrate the API without affecting their production data. All users of the merchant can switch between Live and Sandbox environment once the sandbox has been created.

### Sandbox Guide

#### Creating a Sandbox Environment

1. Navigate to **Settings** in the UI.
2. Go to the **Sandbox** section.
3. Click **Create Sandbox** to generate a new environment.

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FGJWSXWenihQiBvok2QjU%2Fimage.png?alt=media&amp;token=82371802-13cb-4fa8-bfad-c199d863497e" alt=""><figcaption><p>Sandbox settings section</p></figcaption></figure>

Your sandbox environment will have its own API key, resources, and data, completely separate from production. For convenience the sandbox creation process will create up to 10 copies of your products or create a dummy active product such that you can get started expermenting on the Seller Center.

#### Switching Between Sandbox and Production

For the UI, you can switch between **Live** and **Sandbox** environment through the sandbox settings section or in the header account menu.&#x20;

For the API, you can use your **Sandbox API Key** when making requests to the sandbox environment and the **Production API** Key when working with live data.

#### Deleting a Sandbox

If you no longer need a sandbox, you can delete it from the **Settings** page. This will remove all sandbox-related data, API keys associated with it and move all users from sandbox to live.

### Sandbox Exclusive Functionalities

#### Skipping Approval for Products

To maximize flexibility in the sandbox environment, the approval process for products is bypassed. This means that as soon as you attempt to publish a product in sandbox mode, it becomes active immediately. In contrast, in the production environment, all products must go through an approval process before they can be listed in the shop.

#### Simulating Orders

Since the sandbox environment is entirely isolated from real customers, no actual orders will be received. To facilitate testing, the **Receive Orders** button is available on the Orders page in the UI. This feature allows you to generate test orders using active products, enabling you to simulate order workflows and integration scenarios without affecting live operations.

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FB2O1sP2heX5N4pemE2S5%2Fimage.png?alt=media&amp;token=4ecdb96b-4428-471b-9806-293bf68f83dd" alt=""><figcaption><p>Receive Orders button</p></figcaption></figure>


# Make your first API request

Once you have generated your API Key, you are ready to send your first request to the Seller Center API.

Let's try to get all your products:

```bash
curl -X GET "https://partner.aboutyou.com/api/v1/products/" \
    --header "X-API-Key: YOUR_API_KEY"
```

Now let's try to get all the active products:

```bash
curl -X GET "https://partner.aboutyou.com/api/v1/products/?status=active" \
    --header "X-API-Key: YOUR_API_KEY"
```

Now you are ready to explore the full range of Seller Center API endpoints!


# How to create a product

This guide will walk you through the process of creating and publishing a product, from gathering required metadata to submitting it via the "Upsert Product" endpoint.

## Determine available countries and locales

Use the `List countries` endpoint to get the countries and locales your merchant account has been linked to.

* **Countries** determine:
  * Where the product will be published.
  * Which prices must be defined.
* **Locales** determine:
  * Which languages are available for product descriptions.

## Determine product metadata

Before creating a product, gather the necessary information and identifiers from the API.

### Find the product category

Use the `List Categories` endpoint to search available product categories and retrieve the category ID.

### Get the required attributes

Once the category is selected:

* Call `List Attribute Groups` with the `category_id` to get:
  * Required **attributes**
  * Suggested default attributes via `is_default`
  * Available **colors**
  * **Sizes**
  * **Brands**
  * **Material groups** (e.g. "Lining", "Shell") and **materials**

Some attribute groups (currently `material_group_name` in the material composition flow) return `is_default: true` on attributes that we suggest as defaults for the category. The field is omitted when false.

## Creating the product

### Drafting the product

Now that you've gathered all the necessary metadata, you're ready to draft your product.

#### Material compositions

Depending on the product category, you'll need to provide either a **textile** or **non-textile** material composition.

* The composition is a mapping of:
  * **Cluster** (e.g., `Lining`, `Shell`) from `material_group`
  * → to **Materials** (e.g., `Cotton`, `Leather`) from `material`
* **Textile materials** require a `fraction` field for each component.

**Example: Lining made of Cotton, Material made of Leather**

```json
[
    {
        "cluster_id": 164593, // Lining
        "components": [
            {
                "material_id": 293177, // Cotton
                "fraction": 100
            }
        ]
    },
    {
        "cluster_id": 164588, // Material
        "components": [
            {
                "material_id": 186717, // Leather
                "fraction": 100
            }
        ]
    },
]
```

#### Putting everything together

Use the `Upsert Product` endpoint to create or update your product.

**Example Payload**

```json
{
  "items": [
    {
      "style_key": "<your_style_key>",
      "sku": "<your_sku>",
      "ean": "<your_ean>",
      "hs_code": "<your_hs_code>",
      "name": "<your_product_name>",
      "descriptions": {
        "<locale_1>": "<description_in_locale_1>",
        "<locale_2>": "<description_in_locale_2>"
      },
      "color": <color_id>,
      "size": <size_id>,
      "second_size": <second_size_id>|null,
      "brand": <brand_id>,
      "category": <category_id>,
      "quantity": <your_product_quantity>,
      "weight": <product_weight>,
      "countries": [
        "<country_code_1>", "<country_code_2>"
      ],
      "country_of_origin": "<country_of_origin_code>",
      "attributes": [
        <attribute_ids>
      ],
      "material_composition_textile": [
        {
          "cluster_id": <material_group_1_id>,
          "components": [
            {
              "material_id": <material_1_id>,
              "fraction": <material_1_fraction>
            }
          ]
        }
      ],
      "prices": [
        {
          "country_code": "<country_code_1>",
          "retail_price": <your_retail_price>,
          "sale_price": <your_sale_price>
        },
        {
          "country_code": "<country_code_2>",
          "retail_price": <your_retail_price>,
          "sale_price": <your_sale_price>
        }
      ],
      "images": ["<your_product_image_urls>"]
    }
  ]
}
```

### Publishing the draft product

After creating or updating a draft, set its status to `published`. Use [Update Product Status (and Publish)](https://docs.partner.aboutyou.com/api/products/update-product-status-and-publish).

**Example Payload**

```json
{
  "items": [
    {
      "style_key": "<product_style_key>",
      "status": "published"
    }
  ]
}
```

The product then moves to `pending_approval`. Once approved, it moves through `pending_active` to `active`. Products previously approved skip review when republished.

Check the asynchronous request outcome with [Get Product Status Update Batch Results](https://docs.partner.aboutyou.com/api/products/get-product-status-update-batch-results).


# Rate Limiting

## Rate Limiting

The ABOUT YOU Sellers Center API implements comprehensive rate limiting to ensure fair usage and optimal performance for all users. Rate limits are configured per endpoint and vary depending on the operation type and resource requirements.

### How Rate Limiting Works

* **Authentication**: Rate limits apply to authenticated API requests using your API key
* **Per-Endpoint Limits**: Each endpoint has its own specific rate limit configuration
* **Headers**: Current limit and remaining quota information is provided in response headers:
  * `X-RateLimit-Limit`: Total requests allowed in the time window
  * `X-RateLimit-Remaining`: Remaining requests in the current window
* **429 Responses**: When limits are exceeded, the API returns HTTP 429 (Too Many Requests)

### Current Rate Limits by Endpoint

> **⚠️ Important**: This table provides an overview of current rate limits, but you should always refer to the [**up-to-date API documentation**](https://partner.aboutyou.com/api/v1/docs) for the most accurate and current rate limit information, as limits may be adjusted over time.

| Resource Path                        | Method | Rate Limit | Description                   |
| ------------------------------------ | ------ | ---------- | ----------------------------- |
| **Webhooks**                         |        |            |                               |
| `/webhooks/types`                    | GET    | 50/min     | Get webhook event types       |
| `/webhooks/`                         | GET    | 50/min     | List webhook subscriptions    |
| `/webhooks/`                         | POST   | 50/min     | Create webhook subscription   |
| `/webhooks/{id}`                     | GET    | 50/min     | Get webhook subscription      |
| `/webhooks/{id}`                     | PATCH  | 100/min    | Update webhook subscription   |
| `/webhooks/{id}`                     | DELETE | 50/min     | Delete webhook subscription   |
| **Products**                         |        |            |                               |
| `/products/`                         | GET    | 1000/min   | List/search products          |
| `/products/rejected`                 | GET    | 50/min     | Get rejected products         |
| `/products/`                         | POST   | 100/min    | Create/update products        |
| `/products/status`                   | PATCH  | 100/min    | Update product status         |
| `/products/stock`                    | PATCH  | 1000/min   | Update product stock          |
| `/products/price`                    | PATCH  | 200/min    | Update product prices         |
| **Orders**                           |        |            |                               |
| `/orders/`                           | GET    | 100/min    | List orders                   |
| `/orders/{number}/delivery-document` | GET    | 100/min    | Get delivery document         |
| `/orders/cancel`                     | POST   | 50/min     | Cancel order items            |
| `/orders/ship`                       | POST   | 50/min     | Ship order items              |
| `/orders/return`                     | POST   | 50/min     | Return order items            |
| **Results**                          |        |            |                               |
| `/results/products`                  | GET    | 200/min    | Get product batch results     |
| `/results/status`                    | GET    | 200/min    | Get status update results     |
| `/results/stock`                     | GET    | 200/min    | Get stock update results      |
| `/results/price`                     | GET    | 200/min    | Get price update results      |
| `/results/cancel`                    | GET    | 200/min    | Get cancellation results      |
| `/results/ship`                      | GET    | 200/min    | Get shipment results          |
| `/results/return`                    | GET    | 200/min    | Get return results            |
| **Reports**                          |        |            |                               |
| `/reports/`                          | GET    | 10/min     | List available reports        |
| `/reports/{id}/download`             | GET    | 10/min     | Download report file          |
| **Categories**                       |        |            |                               |
| `/categories/`                       | GET    | 100/min    | List categories               |
| `/categories/{id}/attribute-groups`  | GET    | 300/min    | Get category attribute groups |
| **Countries**                        |        |            |                               |
| `/countries/`                        | GET    | 100/min    | List countries and locales    |
| **Brands**                           |        |            |                               |
| `/brands/`                           | GET    | 50/min     | List available brands         |

### Best Practices

1. **Monitor Headers**: Always check the rate limit headers in responses to track your usage
2. **Implement Retry Logic**: Handle 429 responses gracefully with exponential backoff
3. **Batch Requests**: Use batch endpoints when available rather than individual requests
4. **Cache Results**: Cache API responses where appropriate to reduce request frequency
5. **Plan Operations**: For bulk operations, plan your requests within the rate limits

### Official Documentation

For the most current rate limit information, endpoint details, and any updates, always refer to the official API documentation:

[**https://partner.aboutyou.com/api/v1/docs**](https://partner.aboutyou.com/api/v1/docs)

The documentation is automatically generated and always reflects the current API configuration, including any rate limit adjustments.


# Products


# Product Statuses

## Product States

A product can be in one of the following states:

| State              | Description                                            |
| ------------------ | ------------------------------------------------------ |
| `draft`            | Incomplete or not yet submitted for approval           |
| `pending_approval` | Currently under review by ABOUT YOU                    |
| `rejected`         | Rejected during the approval process                   |
| `pending_active`   | Approved and being synchronized with the live database |
| `active`           | Live and visible in the shop                           |
| `inactive`         | Taken offline manually                                 |
| `problem`          | Was active but has become invalid due to a change      |

***

### Draft

The `draft` state represents products that are incomplete or not yet ready for approval.

Newly created products start in the `draft` state. Publishing a draft product triggers the approval process.

***

### Pending Approval

A product in the `pending_approval` state is currently undergoing a review by ABOUT YOU. Products in this state cannot be updated, but can be withdrawn by changing their status back to `draft`.

***

### Rejected

If ABOUT YOU rejects a product during the approval process, it moves to `rejected`. Use [Get Rejected Products](https://docs.partner.aboutyou.com/api/products/get-rejected-products) to retrieve rejection reasons. Republish a rejected product to restart approval.

***

### Pending Active

Once a product is approved, it is synchronized with ABOUT YOU's live database. During this synchronization phase, the product will be in the `pending_active` state.

***

### Active

After the product has been synchronized with ABOUT YOU's live database, it becomes `active` and is visible in the shop, provided that stock is available.

***

### Inactive

Products can be taken offline by setting their status to `inactive`. Once inactive, they can be re-published and will skip the approval process.

***

### Problem

If an active product is modified in a way that makes it invalid, it will transition to the `problem` state. Once the underlying issues are resolved, the product will automatically return to the `active` state.


# Get Products

## Get Products

> List product variants by \`page\` (deprecated) or by \`cursor\`.\
> \
> A cursor comes from the previous response's \`pagination.next\_cursor\`, and\
> cursor mode omits \`page\`, \`pages\` and \`total\`.\
> \
> \*\*Rate limit:\*\* 1000 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"Status":{"enum":["draft","pending_approval","rejected","pending_active","active","inactive","problem"],"title":"Status","type":"string"},"GetProductsResponseSchema":{"properties":{"items":{"items":{"$ref":"#/components/schemas/GetProductItemSchema"},"title":"Items","type":"array"},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["items","pagination"],"title":"GetProductsResponseSchema","type":"object"},"GetProductItemSchema":{"properties":{"style_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Style Key"},"status":{"$ref":"#/components/schemas/Status"},"colorway_key":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Reference key for the colorway, one style in one color combination. Sits between style_key and sku.","title":"Colorway Key"},"sku":{"title":"Sku","type":"string"},"ean":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ean"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"deprecated":true,"description":"Use descriptions instead","title":"Description"},"descriptions":{"anyOf":[{"$ref":"#/components/schemas/LocalizedDescriptionSchema"},{"type":"null"}]},"color":{"anyOf":[{"type":"integer"},{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"description":"Color attribute id, or a list of ids ordered by attribute sort when the product carries more than one color.","title":"Color"},"size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size"},"second_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Second Size"},"brand":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Brand"},"category":{"title":"Category","type":"integer"},"category_secondary":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Id of the unisex counterpart the product is also listed in. Null otherwise, and always while the unisex listing is not offered.","title":"Category Secondary"},"quantity":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Stock quantity of the product variant in the merchant's warehouse.","title":"Quantity"},"quantity_fbm":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Stock quantity of the product variant in ABOUT YOU warehouses.","title":"Quantity Fbm"},"weight":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Weight"},"countries":{"anyOf":[{"items":{"description":"ISO 3166-1 alpha-2 country code","pattern":"^[A-Za-z]{2}$","type":"string"},"type":"array"},{"type":"null"}],"title":"Countries"},"country_of_origin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Of Origin"},"attributes":{"items":{"type":"integer"},"title":"Attributes","type":"array"},"material_composition_textile":{"anyOf":[{"items":{"$ref":"#/components/schemas/MaterialCompositionTextileSchema"},"type":"array"},{"type":"null"}],"title":"Material Composition Textile"},"material_composition_non_textile":{"anyOf":[{"items":{"$ref":"#/components/schemas/MaterialCompositionNonTextileSchema"},"type":"array"},{"type":"null"}],"title":"Material Composition Non Textile"},"prices":{"items":{"$ref":"#/components/schemas/PriceSchema"},"title":"Prices","type":"array"},"images":{"items":{"type":"string"},"title":"Images","type":"array"}},"required":["style_key","status","colorway_key","sku","ean","name","description","descriptions","color","size","second_size","brand","category","category_secondary","quantity","quantity_fbm","weight","countries","country_of_origin","attributes","prices","images"],"title":"GetProductItemSchema","type":"object"},"LocalizedDescriptionSchema":{"additionalProperties":{"type":"string"},"description":"Schema for handling localized descriptions with locale keys.","title":"LocalizedDescriptionSchema","type":"object"},"MaterialCompositionTextileSchema":{"properties":{"cluster_id":{"description":"ID (integer) of this property","minimum":1,"title":"Cluster Id","type":"integer"},"components":{"items":{"$ref":"#/components/schemas/TextileMaterialSchema"},"title":"Components","type":"array"}},"required":["cluster_id","components"],"title":"MaterialCompositionTextileSchema","type":"object"},"TextileMaterialSchema":{"properties":{"material_id":{"description":"ID (integer) of this property","minimum":1,"title":"Material Id","type":"integer"},"fraction":{"description":"Fraction of the material in the composition in percentage.","title":"Fraction","type":"integer"}},"required":["material_id","fraction"],"title":"TextileMaterialSchema","type":"object"},"MaterialCompositionNonTextileSchema":{"properties":{"cluster_id":{"description":"ID (integer) of this property","minimum":1,"title":"Cluster Id","type":"integer"},"components":{"items":{"$ref":"#/components/schemas/NonTextileMaterialSchema"},"title":"Components","type":"array"}},"required":["cluster_id","components"],"title":"MaterialCompositionNonTextileSchema","type":"object"},"NonTextileMaterialSchema":{"properties":{"material_id":{"description":"ID (integer) of this property","minimum":1,"title":"Material Id","type":"integer"}},"required":["material_id"],"title":"NonTextileMaterialSchema","type":"object"},"PriceSchema":{"properties":{"country_code":{"description":"ISO 3166-1 alpha-2 country code","pattern":"^[A-Za-z]{2}$","title":"Country Code","type":"string"},"currency":{"anyOf":[{"description":"ISO 4217 alpha-3 currency code","pattern":"^[A-Za-z]{3}$","type":"string"},{"type":"null"}],"description":"**Warning:** this field is currently optional, but will become mandatory soon - always send it. Currency the prices are denominated in. Must match the currency configured for the country - see the countries endpoint for the currency of each country.","title":"Currency"},"retail_price":{"exclusiveMinimum":0,"maximum":1000000,"title":"Retail Price","type":"number"},"sale_price":{"anyOf":[{"exclusiveMinimum":0,"maximum":1000000,"type":"number"},{"type":"null"}],"title":"Sale Price"}},"required":["country_code","retail_price"],"title":"PriceSchema","type":"object"},"Pagination":{"properties":{"per_page":{"description":"Number of items per page.","exclusiveMinimum":0,"title":"Per Page","type":"integer"},"page":{"anyOf":[{"exclusiveMinimum":0,"type":"integer"},{"type":"null"}],"description":"Page number (null in cursor mode).","title":"Page"},"pages":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"Total pages (null in cursor mode).","title":"Pages"},"total":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"Total count (null in cursor mode).","title":"Total"},"next":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"URL for next page (null in cursor mode).","title":"Next"},"prev":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"URL for previous page (null in cursor mode).","title":"Prev"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque cursor for next page when using cursor-based pagination.","title":"Next Cursor"}},"required":["per_page"],"title":"Pagination","type":"object"},"BadRequestSchema":{"properties":{"message":{"description":"Error message","title":"Message","type":"string"}},"required":["message"],"title":"BadRequestSchema","type":"object"}}},"paths":{"/api/v1/products/":{"get":{"operationId":"scapi_app_endpoints_product_api_get_products","summary":"Get Products","parameters":[{"in":"query","name":"style_key","schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Style key to search for","title":"Style Key"},"required":false,"description":"Style key to search for"},{"in":"query","name":"sku","schema":{"anyOf":[{"items":{"description":"Stock Keeping Unit identifier","maxLength":120,"type":"string"},"maxItems":100,"type":"array"},{"type":"null"}],"description":"Exact SKU to filter by. Repeat the parameter for up to 100 SKUs.","title":"SKU"},"required":false,"description":"Exact SKU to filter by. Repeat the parameter for up to 100 SKUs."},{"in":"query","name":"status","schema":{"anyOf":[{"$ref":"#/components/schemas/Status"},{"type":"null"}],"description":"Status of the product to filter by. Choose from: \"draft\", \"pending_approval\", \"rejected\", \"pending_active\", \"active\", \"inactive\", \"problem\".","title":"Status"},"required":false,"description":"Status of the product to filter by. Choose from: \"draft\", \"pending_approval\", \"rejected\", \"pending_active\", \"active\", \"inactive\", \"problem\"."},{"in":"query","name":"page","schema":{"default":1,"deprecated":true,"description":"Page number to retrieve items from. Deprecated: offset pagination recounts the full result set on every request. Use `cursor` instead.","minimum":1,"title":"Page","type":"integer"},"required":false,"description":"Page number to retrieve items from. Deprecated: offset pagination recounts the full result set on every request. Use `cursor` instead.","deprecated":true},{"in":"query","name":"per_page","schema":{"default":20,"description":"Number of items per page.","maximum":100,"minimum":1,"title":"Per Page","type":"integer"},"required":false,"description":"Number of items per page."},{"in":"query","name":"cursor","schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque cursor from previous response for cursor-based pagination. When provided, omit page or use page=1.","title":"Cursor"},"required":false,"description":"Opaque cursor from previous response for cursor-based pagination. When provided, omit page or use page=1."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetProductsResponseSchema"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"List product variants by `page` (deprecated) or by `cursor`.\n\nA cursor comes from the previous response's `pagination.next_cursor`, and\ncursor mode omits `page`, `pages` and `total`.\n\n**Rate limit:** 1000 requests per minute","tags":["Products"]}}}}
```


# Get Rejected Products

## Get Rejected Products

> Get all rejected product masters with their rejection reasons.\
> \
> \*\*Rate limit:\*\* 50 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"PagedRejectedProductSchema":{"properties":{"items":{"items":{"$ref":"#/components/schemas/RejectedProductSchema"},"title":"Items","type":"array"},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["items","pagination"],"title":"PagedRejectedProductSchema","type":"object"},"RejectedProductSchema":{"properties":{"style_key":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Style key of the product","title":"Style Key"},"rejection_reasons":{"items":{"$ref":"#/components/schemas/RejectionReasonSchema"},"title":"Rejection Reasons","type":"array"},"rejection_message":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The rejection message for the product master","title":"Rejection Message"},"rejected_product_ids_hint":{"anyOf":[{"type":"object"},{"type":"null"}],"description":"Used to hint which products are affected by the rejection reason given","title":"Rejected Product Ids Hint"}},"required":["rejection_reasons"],"title":"RejectedProductSchema","type":"object"},"RejectionReasonSchema":{"properties":{"key":{"maxLength":255,"title":"Key","type":"string"},"type":{"maxLength":255,"title":"Type","type":"string"},"name":{"maxLength":255,"title":"Name","type":"string"},"description":{"title":"Description","type":"string"}},"required":["key","type","name","description"],"title":"RejectionReasonSchema","type":"object"},"Pagination":{"properties":{"per_page":{"description":"Number of items per page.","exclusiveMinimum":0,"title":"Per Page","type":"integer"},"page":{"anyOf":[{"exclusiveMinimum":0,"type":"integer"},{"type":"null"}],"description":"Page number (null in cursor mode).","title":"Page"},"pages":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"Total pages (null in cursor mode).","title":"Pages"},"total":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"Total count (null in cursor mode).","title":"Total"},"next":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"URL for next page (null in cursor mode).","title":"Next"},"prev":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"URL for previous page (null in cursor mode).","title":"Prev"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque cursor for next page when using cursor-based pagination.","title":"Next Cursor"}},"required":["per_page"],"title":"Pagination","type":"object"},"BadRequestSchema":{"properties":{"message":{"description":"Error message","title":"Message","type":"string"}},"required":["message"],"title":"BadRequestSchema","type":"object"}}},"paths":{"/api/v1/products/rejected":{"get":{"operationId":"scapi_app_endpoints_product_api_get_rejected_products","summary":"Get Rejected Products","parameters":[{"in":"query","name":"style_key","schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Style key to search for","title":"Style Key"},"required":false,"description":"Style key to search for"},{"in":"query","name":"page","schema":{"default":1,"description":"Page number to retrieve items from.","minimum":1,"title":"Page","type":"integer"},"required":false,"description":"Page number to retrieve items from."},{"in":"query","name":"per_page","schema":{"default":20,"description":"Number of items per page.","maximum":100,"minimum":1,"title":"Per Page","type":"integer"},"required":false,"description":"Number of items per page."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedRejectedProductSchema"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"Get all rejected product masters with their rejection reasons.\n\n**Rate limit:** 50 requests per minute","tags":["Products"]}}}}
```


# List Countries

## Get Countries

> \*\*Rate limit:\*\* 100 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"CountriesAndLocalesResponseSchema":{"properties":{"countries":{"items":{"$ref":"#/components/schemas/CountrySchema"},"title":"Countries","type":"array"},"locales":{"items":{"$ref":"#/components/schemas/LocaleSchema"},"title":"Locales","type":"array"},"currencies":{"items":{"$ref":"#/components/schemas/CurrencySchema"},"title":"Currencies","type":"array"}},"required":["countries","locales","currencies"],"title":"CountriesAndLocalesResponseSchema","type":"object"},"CountrySchema":{"properties":{"code":{"title":"Code","type":"string"},"name":{"title":"Name","type":"string"}},"required":["code","name"],"title":"CountrySchema","type":"object"},"LocaleSchema":{"properties":{"code":{"title":"Code","type":"string"},"name":{"title":"Name","type":"string"}},"required":["code","name"],"title":"LocaleSchema","type":"object"},"CurrencySchema":{"properties":{"country_code":{"title":"Country Code","type":"string"},"code":{"title":"Code","type":"string"},"name":{"title":"Name","type":"string"}},"required":["country_code","code","name"],"title":"CurrencySchema","type":"object"},"BadRequestSchema":{"properties":{"message":{"description":"Error message","title":"Message","type":"string"}},"required":["message"],"title":"BadRequestSchema","type":"object"}}},"paths":{"/api/v1/countries/":{"get":{"operationId":"scapi_app_endpoints_country_api_get_countries","summary":"Get Countries","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CountriesAndLocalesResponseSchema"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"**Rate limit:** 100 requests per minute","tags":["Countries"]}}}}
```


# List Brands

## List Brands

> \*\*Rate limit:\*\* 50 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"BrandSchema":{"properties":{"id":{"description":"ID (integer) of this property","minimum":1,"title":"Id","type":"integer"},"key":{"deprecated":true,"description":"Identifier of the brand. Deprecated: use 'id' and 'name' instead.","title":"Key","type":"string"},"name":{"description":"Name of the brand","maxLength":255,"minLength":1,"title":"Name","type":"string"}},"required":["id","key","name"],"title":"BrandSchema","type":"object"}}},"paths":{"/api/v1/brands/":{"get":{"operationId":"scapi_app_endpoints_brand_api_list_brands","summary":"List Brands","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/BrandSchema"},"title":"Response","type":"array"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"**Rate limit:** 50 requests per minute","tags":["Brands"]}}}}
```


# List Product Categories

## List Categories

> \*\*Rate limit:\*\* 100 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"GetCategoriesResponseSchema":{"properties":{"items":{"items":{"$ref":"#/components/schemas/CategorySchema"},"title":"Items","type":"array"},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["items","pagination"],"title":"GetCategoriesResponseSchema","type":"object"},"CategorySchema":{"properties":{"id":{"description":"ID (integer) of this property","minimum":1,"title":"Id","type":"integer"},"name":{"description":"Name of the category","maxLength":255,"title":"Name","type":"string"},"path":{"description":"Path of the category for display purposes","maxLength":255,"title":"Path","type":"string"},"parent_id":{"anyOf":[{"description":"ID (integer) of this property","minimum":1,"type":"integer"},{"type":"null"}],"description":"ID of the parent category or null if it's a root category","title":"Parent Id"},"material_composition_type":{"anyOf":[{"enum":["textile","non-textile"],"type":"string"},{"type":"null"}],"description":"Material composition type based on mandatory attribute groups","title":"Material Composition Type"},"unisex_counterpart":{"anyOf":[{"description":"ID (integer) of this property","minimum":1,"type":"integer"},{"type":"null"}],"description":"Id of the category a product in this one can also be listed in, sent as `category_secondary` on the product upsert. Null when the category has no unisex counterpart or the unisex listing is not offered.","title":"Unisex Counterpart"},"parent":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Parent"}},"required":["id","name","path","parent_id","material_composition_type","unisex_counterpart"],"title":"CategorySchema","type":"object"},"Pagination":{"properties":{"per_page":{"description":"Number of items per page.","exclusiveMinimum":0,"title":"Per Page","type":"integer"},"page":{"anyOf":[{"exclusiveMinimum":0,"type":"integer"},{"type":"null"}],"description":"Page number (null in cursor mode).","title":"Page"},"pages":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"Total pages (null in cursor mode).","title":"Pages"},"total":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"Total count (null in cursor mode).","title":"Total"},"next":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"URL for next page (null in cursor mode).","title":"Next"},"prev":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"URL for previous page (null in cursor mode).","title":"Prev"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque cursor for next page when using cursor-based pagination.","title":"Next Cursor"}},"required":["per_page"],"title":"Pagination","type":"object"},"BadRequestSchema":{"properties":{"message":{"description":"Error message","title":"Message","type":"string"}},"required":["message"],"title":"BadRequestSchema","type":"object"}}},"paths":{"/api/v1/categories/":{"get":{"operationId":"scapi_app_endpoints_category_api_list_categories","summary":"List Categories","parameters":[{"in":"query","name":"query","schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Search term to filter items by path name","title":"Query"},"required":false,"description":"Search term to filter items by path name"},{"in":"query","name":"parent_category","schema":{"anyOf":[{"description":"ID (integer) of this property","minimum":1,"type":"integer"},{"type":"null"}],"description":"Filter items by parent category ID","title":"Parent Category"},"required":false,"description":"Filter items by parent category ID"},{"in":"query","name":"page","schema":{"default":1,"description":"Page number to retrieve items from.","minimum":1,"title":"Page","type":"integer"},"required":false,"description":"Page number to retrieve items from."},{"in":"query","name":"per_page","schema":{"default":20,"description":"Number of items per page.","maximum":100,"minimum":1,"title":"Per Page","type":"integer"},"required":false,"description":"Number of items per page."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCategoriesResponseSchema"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"**Rate limit:** 100 requests per minute","tags":["Categories"]}}}}
```


# List Product Attribute Groups

## List Attribute Groups

> \*\*Rate limit:\*\* 300 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"AttributeGroupSchema":{"properties":{"attributes":{"items":{"$ref":"#/components/schemas/AttributeSchema"},"title":"Attributes","type":"array"},"id":{"description":"ID (integer) of this property","minimum":1,"title":"Id","type":"integer"},"name":{"description":"Name of the attribute group","maxLength":255,"minLength":1,"title":"Name","type":"string"},"frontend_name":{"description":"Name of the attribute group for display purposes","maxLength":255,"minLength":1,"title":"Frontend Name","type":"string"},"is_multiselect":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether the group allows multiple attributes to be selected","title":"Is Multiselect"},"is_mandatory":{"description":"Whether the category requires a value for this group.","title":"Is Mandatory","type":"boolean"}},"required":["attributes","id","name","frontend_name","is_mandatory"],"title":"AttributeGroupSchema","type":"object"},"AttributeSchema":{"properties":{"id":{"description":"ID (integer) of this property","minimum":1,"title":"Id","type":"integer"},"name":{"description":"Name of the attribute","maxLength":255,"minLength":1,"title":"Name","type":"string"},"frontend_name":{"description":"Name of the attribute for display purposes","maxLength":255,"minLength":1,"title":"Frontend Name","type":"string"},"is_default":{"default":false,"description":"True if this attribute is one of the suggested defaults for its attribute group within the current category. Currently only populated for the material_group_name group in the material composition flow. Omitted from the response when False — absence of the field means False.","title":"Is Default","type":"boolean"}},"required":["id","name","frontend_name"],"title":"AttributeSchema","type":"object"}}},"paths":{"/api/v1/categories/{category_id}/attribute-groups":{"get":{"operationId":"scapi_app_endpoints_category_api_list_attribute_groups","summary":"List Attribute Groups","parameters":[{"in":"path","name":"category_id","schema":{"title":"Category Id","type":"integer"},"required":true},{"in":"query","name":"with","schema":{"default":[],"description":"Comma-separated expansions; `optional` adds the groups the category links without demanding.","items":{"enum":["optional"],"title":"AttributeGroupWithOption","type":"string"},"title":"With","type":"array"},"required":false,"description":"Comma-separated expansions; `optional` adds the groups the category links without demanding."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/AttributeGroupSchema"},"title":"Response","type":"array"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"**Rate limit:** 300 requests per minute","tags":["Categories"]}}}}
```


# Create and Update Products

## Upsert Product

> Create or update products.\
> \
> Identical payloads sent within a short window (a few hours) are\
> de-duplicated: the same batchRequestId is returned and the upsert is not\
> reprocessed. Clients can detect this by comparing the returned\
> batchRequestId across submissions. Send stock and price changes through the\
> dedicated /stocks and /prices endpoints, which are always applied.\
> \
> Seller Center caches a downloaded image for at least three days and ignores\
> changes behind the same URL in that time. If a URL fails with HTTP 400, 401,\
> 403, 404 or 410, or fails validation, Seller Center reports the same error\
> for three days. To change an image sooner, send a new URL. Serve images with\
> an ETag or Last-Modified header, so Seller Center downloads an unchanged\
> image only once.\
> \
> \*\*Rate limit:\*\* 100 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"BatchRequestResponseSchema":{"properties":{"batchRequestId":{"description":"ID of the asynchronous batch request. Identical payloads from the same merchant within the deduplication window return the existing in-flight ID instead of queuing a new batch. Poll the results endpoint with this ID to retrieve the outcome. Results are available for 7 days.","format":"uuid","title":"Batchrequestid","type":"string"}},"required":["batchRequestId"],"title":"BatchRequestResponseSchema","type":"object"},"BadRequestSchema":{"properties":{"message":{"description":"Error message","title":"Message","type":"string"}},"required":["message"],"title":"BadRequestSchema","type":"object"},"UpsertProductSchema":{"properties":{"items":{"description":"List of product variants to upsert.","items":{"$ref":"#/components/schemas/UpsertProductItemSchema"},"maxItems":100,"minItems":1,"title":"Items","type":"array"}},"required":["items"],"title":"UpsertProductSchema","type":"object"},"UpsertProductItemSchema":{"properties":{"style_key":{"description":"Unique style key for the product.","maxLength":120,"title":"Style Key","type":"string"},"colorway_key":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"description":"Reference key for the colorway, one style in one color combination. Sits between style_key and sku. When set, it identifies the product and the colors in this item are written to it. When omitted, the product is matched by its colors, which is deprecated: send the colorway_key returned by GET /products to adopt explicit keys without creating duplicate products.","title":"Colorway Key"},"sku":{"maxLength":120,"minLength":3,"title":"Sku","type":"string"},"ean":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"EAN-13 barcode (13 digits with valid GS1 prefix and checksum)","title":"Ean"},"hs_code":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"title":"Hs Code"},"name":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"description":"Include only the product/design name. Don't add categories, colors, materials etc. If there is no specific design name, leave the field empty.","title":"Name"},"description":{"anyOf":[{"maxLength":2500,"type":"string"},{"type":"null"}],"deprecated":true,"description":"Use descriptions instead","title":"Description"},"descriptions":{"anyOf":[{"$ref":"#/components/schemas/LocalizedDescriptionSchema"},{"type":"null"}]},"color":{"anyOf":[{"description":"ID (integer) of this property","minimum":1,"type":"integer"},{"items":{"description":"ID (integer) of this property","minimum":1,"type":"integer"},"minItems":1,"type":"array"}],"description":"Color attribute id, or a list of ids up to the configured maximum. A single id and a one-element list are equivalent.","title":"Color"},"size":{"anyOf":[{"description":"ID (integer) of this property","minimum":1,"type":"integer"},{"type":"null"}],"title":"Size"},"second_size":{"anyOf":[{"description":"ID (integer) of this property","minimum":1,"type":"integer"},{"type":"null"}],"title":"Second Size"},"brand":{"description":"ID (integer) of this property","minimum":1,"title":"Brand","type":"integer"},"category":{"description":"ID (integer) of this property","minimum":1,"title":"Category","type":"integer"},"category_secondary":{"anyOf":[{"description":"ID (integer) of this property","minimum":1,"type":"integer"},{"type":"null"}],"description":"Id of the unisex counterpart of `category`, to list the product in both. Omit it to list the product in `category` alone. Only a category's `unisex_counterpart` from GET /categories/ is accepted, and only while the unisex listing is offered.","title":"Category Secondary"},"quantity":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"Quantity of the product variant.","title":"Quantity"},"weight":{"description":"Weight of the product in grams.","maximum":100000,"minimum":0,"title":"Weight","type":"integer"},"countries":{"anyOf":[{"items":{"description":"ISO 3166-1 alpha-2 country code","pattern":"^[A-Za-z]{2}$","type":"string"},"minItems":0,"type":"array"},{"type":"null"}],"title":"Countries"},"country_of_origin":{"description":"ISO 3166-1 alpha-2 country code","pattern":"^[A-Za-z]{2}$","title":"Country Of Origin","type":"string"},"attributes":{"description":"Additional category-specific attribute IDs; fields already provided as top-level fields (e.g. size, brand, color) can not be repeated here.","items":{"description":"ID (integer) of this property","minimum":1,"type":"integer"},"title":"Attributes","type":"array"},"material_composition_textile":{"anyOf":[{"items":{"$ref":"#/components/schemas/MaterialCompositionTextileSchema"},"type":"array"},{"type":"null"}],"title":"Material Composition Textile"},"material_composition_non_textile":{"anyOf":[{"items":{"$ref":"#/components/schemas/MaterialCompositionNonTextileSchema"},"type":"array"},{"type":"null"}],"title":"Material Composition Non Textile"},"prices":{"items":{"$ref":"#/components/schemas/PriceSchema"},"minItems":0,"title":"Prices","type":"array"},"images":{"description":"Image URLs. Seller Center caches image download results. If you change an image, give it a new URL so Seller Center recognizes the change immediately.","items":{"type":"string"},"maxItems":10,"minItems":1,"title":"Images","type":"array"}},"required":["style_key","sku","color","size","brand","category","weight","country_of_origin","attributes","prices","images"],"title":"UpsertProductItemSchema","type":"object"},"LocalizedDescriptionSchema":{"additionalProperties":{"type":"string"},"description":"Schema for handling localized descriptions with locale keys.","title":"LocalizedDescriptionSchema","type":"object"},"MaterialCompositionTextileSchema":{"properties":{"cluster_id":{"description":"ID (integer) of this property","minimum":1,"title":"Cluster Id","type":"integer"},"components":{"items":{"$ref":"#/components/schemas/TextileMaterialSchema"},"title":"Components","type":"array"}},"required":["cluster_id","components"],"title":"MaterialCompositionTextileSchema","type":"object"},"TextileMaterialSchema":{"properties":{"material_id":{"description":"ID (integer) of this property","minimum":1,"title":"Material Id","type":"integer"},"fraction":{"description":"Fraction of the material in the composition in percentage.","title":"Fraction","type":"integer"}},"required":["material_id","fraction"],"title":"TextileMaterialSchema","type":"object"},"MaterialCompositionNonTextileSchema":{"properties":{"cluster_id":{"description":"ID (integer) of this property","minimum":1,"title":"Cluster Id","type":"integer"},"components":{"items":{"$ref":"#/components/schemas/NonTextileMaterialSchema"},"title":"Components","type":"array"}},"required":["cluster_id","components"],"title":"MaterialCompositionNonTextileSchema","type":"object"},"NonTextileMaterialSchema":{"properties":{"material_id":{"description":"ID (integer) of this property","minimum":1,"title":"Material Id","type":"integer"}},"required":["material_id"],"title":"NonTextileMaterialSchema","type":"object"},"PriceSchema":{"properties":{"country_code":{"description":"ISO 3166-1 alpha-2 country code","pattern":"^[A-Za-z]{2}$","title":"Country Code","type":"string"},"currency":{"anyOf":[{"description":"ISO 4217 alpha-3 currency code","pattern":"^[A-Za-z]{3}$","type":"string"},{"type":"null"}],"description":"**Warning:** this field is currently optional, but will become mandatory soon - always send it. Currency the prices are denominated in. Must match the currency configured for the country - see the countries endpoint for the currency of each country.","title":"Currency"},"retail_price":{"exclusiveMinimum":0,"maximum":1000000,"title":"Retail Price","type":"number"},"sale_price":{"anyOf":[{"exclusiveMinimum":0,"maximum":1000000,"type":"number"},{"type":"null"}],"title":"Sale Price"}},"required":["country_code","retail_price"],"title":"PriceSchema","type":"object"}}},"paths":{"/api/v1/products/":{"post":{"operationId":"scapi_app_endpoints_product_api_upsert_product","summary":"Upsert Product","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchRequestResponseSchema"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"Create or update products.\n\nIdentical payloads sent within a short window (a few hours) are\nde-duplicated: the same batchRequestId is returned and the upsert is not\nreprocessed. Clients can detect this by comparing the returned\nbatchRequestId across submissions. Send stock and price changes through the\ndedicated /stocks and /prices endpoints, which are always applied.\n\nSeller Center caches a downloaded image for at least three days and ignores\nchanges behind the same URL in that time. If a URL fails with HTTP 400, 401,\n403, 404 or 410, or fails validation, Seller Center reports the same error\nfor three days. To change an image sooner, send a new URL. Serve images with\nan ETag or Last-Modified header, so Seller Center downloads an unchanged\nimage only once.\n\n**Rate limit:** 100 requests per minute","tags":["Products"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpsertProductSchema"}}},"required":true}}}}}
```


# Get Product Batch Results

## Get Product Batch Results

> \*\*Rate limit:\*\* 200 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"UpsertProductBatchResultsResponseSchema":{"properties":{"batchRequestId":{"description":"Unique identifier (UUID)","format":"uuid","title":"Batchrequestid","type":"string"},"status":{"$ref":"#/components/schemas/RequestStatus","description":"Status of the batch processing"},"items":{"items":{"$ref":"#/components/schemas/UpsertProductResultItemSchema"},"title":"Items","type":"array"}},"required":["batchRequestId","status","items"],"title":"UpsertProductBatchResultsResponseSchema","type":"object"},"RequestStatus":{"enum":["pending","processing","completed","retry","failed"],"title":"RequestStatus","type":"string"},"UpsertProductResultItemSchema":{"properties":{"requestItem":{"$ref":"#/components/schemas/UpsertProductItemSchema"},"success":{"title":"Success","type":"boolean"},"errors":{"items":{"description":"Error message if and why the operation failed","type":"string"},"title":"Errors","type":"array"}},"required":["requestItem","success","errors"],"title":"UpsertProductResultItemSchema","type":"object"},"UpsertProductItemSchema":{"properties":{"style_key":{"description":"Unique style key for the product.","maxLength":120,"title":"Style Key","type":"string"},"colorway_key":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"description":"Reference key for the colorway, one style in one color combination. Sits between style_key and sku. When set, it identifies the product and the colors in this item are written to it. When omitted, the product is matched by its colors, which is deprecated: send the colorway_key returned by GET /products to adopt explicit keys without creating duplicate products.","title":"Colorway Key"},"sku":{"maxLength":120,"minLength":3,"title":"Sku","type":"string"},"ean":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"EAN-13 barcode (13 digits with valid GS1 prefix and checksum)","title":"Ean"},"hs_code":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"title":"Hs Code"},"name":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"description":"Include only the product/design name. Don't add categories, colors, materials etc. If there is no specific design name, leave the field empty.","title":"Name"},"description":{"anyOf":[{"maxLength":2500,"type":"string"},{"type":"null"}],"deprecated":true,"description":"Use descriptions instead","title":"Description"},"descriptions":{"anyOf":[{"$ref":"#/components/schemas/LocalizedDescriptionSchema"},{"type":"null"}]},"color":{"anyOf":[{"description":"ID (integer) of this property","minimum":1,"type":"integer"},{"items":{"description":"ID (integer) of this property","minimum":1,"type":"integer"},"minItems":1,"type":"array"}],"description":"Color attribute id, or a list of ids up to the configured maximum. A single id and a one-element list are equivalent.","title":"Color"},"size":{"anyOf":[{"description":"ID (integer) of this property","minimum":1,"type":"integer"},{"type":"null"}],"title":"Size"},"second_size":{"anyOf":[{"description":"ID (integer) of this property","minimum":1,"type":"integer"},{"type":"null"}],"title":"Second Size"},"brand":{"description":"ID (integer) of this property","minimum":1,"title":"Brand","type":"integer"},"category":{"description":"ID (integer) of this property","minimum":1,"title":"Category","type":"integer"},"category_secondary":{"anyOf":[{"description":"ID (integer) of this property","minimum":1,"type":"integer"},{"type":"null"}],"description":"Id of the unisex counterpart of `category`, to list the product in both. Omit it to list the product in `category` alone. Only a category's `unisex_counterpart` from GET /categories/ is accepted, and only while the unisex listing is offered.","title":"Category Secondary"},"quantity":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"Quantity of the product variant.","title":"Quantity"},"weight":{"description":"Weight of the product in grams.","maximum":100000,"minimum":0,"title":"Weight","type":"integer"},"countries":{"anyOf":[{"items":{"description":"ISO 3166-1 alpha-2 country code","pattern":"^[A-Za-z]{2}$","type":"string"},"minItems":0,"type":"array"},{"type":"null"}],"title":"Countries"},"country_of_origin":{"description":"ISO 3166-1 alpha-2 country code","pattern":"^[A-Za-z]{2}$","title":"Country Of Origin","type":"string"},"attributes":{"description":"Additional category-specific attribute IDs; fields already provided as top-level fields (e.g. size, brand, color) can not be repeated here.","items":{"description":"ID (integer) of this property","minimum":1,"type":"integer"},"title":"Attributes","type":"array"},"material_composition_textile":{"anyOf":[{"items":{"$ref":"#/components/schemas/MaterialCompositionTextileSchema"},"type":"array"},{"type":"null"}],"title":"Material Composition Textile"},"material_composition_non_textile":{"anyOf":[{"items":{"$ref":"#/components/schemas/MaterialCompositionNonTextileSchema"},"type":"array"},{"type":"null"}],"title":"Material Composition Non Textile"},"prices":{"items":{"$ref":"#/components/schemas/PriceSchema"},"minItems":0,"title":"Prices","type":"array"},"images":{"description":"Image URLs. Seller Center caches image download results. If you change an image, give it a new URL so Seller Center recognizes the change immediately.","items":{"type":"string"},"maxItems":10,"minItems":1,"title":"Images","type":"array"}},"required":["style_key","sku","color","size","brand","category","weight","country_of_origin","attributes","prices","images"],"title":"UpsertProductItemSchema","type":"object"},"LocalizedDescriptionSchema":{"additionalProperties":{"type":"string"},"description":"Schema for handling localized descriptions with locale keys.","title":"LocalizedDescriptionSchema","type":"object"},"MaterialCompositionTextileSchema":{"properties":{"cluster_id":{"description":"ID (integer) of this property","minimum":1,"title":"Cluster Id","type":"integer"},"components":{"items":{"$ref":"#/components/schemas/TextileMaterialSchema"},"title":"Components","type":"array"}},"required":["cluster_id","components"],"title":"MaterialCompositionTextileSchema","type":"object"},"TextileMaterialSchema":{"properties":{"material_id":{"description":"ID (integer) of this property","minimum":1,"title":"Material Id","type":"integer"},"fraction":{"description":"Fraction of the material in the composition in percentage.","title":"Fraction","type":"integer"}},"required":["material_id","fraction"],"title":"TextileMaterialSchema","type":"object"},"MaterialCompositionNonTextileSchema":{"properties":{"cluster_id":{"description":"ID (integer) of this property","minimum":1,"title":"Cluster Id","type":"integer"},"components":{"items":{"$ref":"#/components/schemas/NonTextileMaterialSchema"},"title":"Components","type":"array"}},"required":["cluster_id","components"],"title":"MaterialCompositionNonTextileSchema","type":"object"},"NonTextileMaterialSchema":{"properties":{"material_id":{"description":"ID (integer) of this property","minimum":1,"title":"Material Id","type":"integer"}},"required":["material_id"],"title":"NonTextileMaterialSchema","type":"object"},"PriceSchema":{"properties":{"country_code":{"description":"ISO 3166-1 alpha-2 country code","pattern":"^[A-Za-z]{2}$","title":"Country Code","type":"string"},"currency":{"anyOf":[{"description":"ISO 4217 alpha-3 currency code","pattern":"^[A-Za-z]{3}$","type":"string"},{"type":"null"}],"description":"**Warning:** this field is currently optional, but will become mandatory soon - always send it. Currency the prices are denominated in. Must match the currency configured for the country - see the countries endpoint for the currency of each country.","title":"Currency"},"retail_price":{"exclusiveMinimum":0,"maximum":1000000,"title":"Retail Price","type":"number"},"sale_price":{"anyOf":[{"exclusiveMinimum":0,"maximum":1000000,"type":"number"},{"type":"null"}],"title":"Sale Price"}},"required":["country_code","retail_price"],"title":"PriceSchema","type":"object"},"BadRequestSchema":{"properties":{"message":{"description":"Error message","title":"Message","type":"string"}},"required":["message"],"title":"BadRequestSchema","type":"object"}}},"paths":{"/api/v1/results/products":{"get":{"operationId":"scapi_app_endpoints_result_api_get_product_batch_results","summary":"Get Product Batch Results","parameters":[{"in":"query","name":"batch_request_id","schema":{"format":"uuid","title":"Batch Request Id","type":"string"},"required":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpsertProductBatchResultsResponseSchema"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"**Rate limit:** 200 requests per minute","tags":["Results"]}}}}
```


# Update Product Status (and Publish)

## Update Product Status

> Update product status (e.g., publish to marketplace).\
> \
> When publishing a product, some data becomes immutable, e.g. SKUs and sizes can only be added, not modified.\
> \
> \*\*Rate limit:\*\* 100 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"UpdateProductStatusResponseSchema":{"properties":{"batchRequestId":{"description":"ID of the asynchronous batch request. Identical payloads from the same merchant within the deduplication window return the existing in-flight ID instead of queuing a new batch. Poll the results endpoint with this ID to retrieve the outcome. Results are available for 7 days.","format":"uuid","title":"Batchrequestid","type":"string"}},"required":["batchRequestId"],"title":"UpdateProductStatusResponseSchema","type":"object"},"BadRequestSchema":{"properties":{"message":{"description":"Error message","title":"Message","type":"string"}},"required":["message"],"title":"BadRequestSchema","type":"object"},"UpdateProductStatusSchema":{"properties":{"items":{"description":"List of style_keys and corresponding status to update.","items":{"$ref":"#/components/schemas/UpdateProductStatusItemSchema"},"minItems":1,"title":"Items","type":"array"}},"required":["items"],"title":"UpdateProductStatusSchema","type":"object"},"UpdateProductStatusItemSchema":{"properties":{"style_key":{"description":"Style key for the group of products","maxLength":120,"title":"Style Key","type":"string"},"status":{"description":"Status you want to set for the given product.\n`published` moves the product toward approval and eventually marks it active,\n`inactive` keeps it hidden after it was activated,\n`draft` keeps it in preparation and out of the catalog until manual publication begins.\nReverting to `draft` is only supported before the product reaches approval, after which one should use `inactive`.","type":"string"}},"required":["style_key","status"],"title":"UpdateProductStatusItemSchema","type":"object"}}},"paths":{"/api/v1/products/status":{"put":{"operationId":"scapi_app_endpoints_product_api_update_product_status","summary":"Update Product Status","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateProductStatusResponseSchema"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"Update product status (e.g., publish to marketplace).\n\nWhen publishing a product, some data becomes immutable, e.g. SKUs and sizes can only be added, not modified.\n\n**Rate limit:** 100 requests per minute","tags":["Products"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateProductStatusSchema"}}},"required":true}}}}}
```

***

## Settable Product States

Only a subset of product states can be set manually. The system sets the rest. See [Product Statuses](https://docs.partner.aboutyou.com/api/products/product-statuses) for every state.

The manually settable states are:

| State       | Description                                                     |
| ----------- | --------------------------------------------------------------- |
| `published` | Triggers the product lifecycle toward becoming active           |
| `draft`     | Product is incomplete or not yet submitted for approval         |
| `inactive`  | Product is taken offline but remains available for reactivation |

> **Note:** `published` is not a persistent product state — it acts as a trigger that initiates automatic state transitions in the background.

***

### Published

Setting a product's state to `published` initiates its lifecycle toward becoming active.

When a product is published, the approval process starts automatically. The product transitions to `pending_approval` and, once approved, is activated through the `pending_active` state before finally becoming `active`.

While a product is in the `pending_approval` state, it can no longer be updated. However, the approval request can be withdrawn by setting the product back to `draft`, which re-enables updates and allows the product to be published again to restart the approval process.

**Products only require approval once.** If a product has already been approved, publishing it again will immediately activate it without triggering another approval process.

***

### Draft

The `draft` state represents products that are incomplete or not yet ready for approval. Newly created products start in this state.

Publishing a `draft` product triggers the approval process. Products can also be withdrawn from the approval process by setting them back to `draft`, as long as they have not yet been approved.

Once a product has been approved, it can no longer be set back to `draft`. Approved products can only be deactivated by setting them to `inactive`.

***

### Inactive

`inactive` products are not visible in the shop but remain available for reactivation.

Only previously published products can be set to `inactive`. Setting a product to this state removes it from the shop without deleting it.

To make an inactive product available again, simply publish it. Since the product has already been approved, the approval process is skipped and the product is activated immediately.


# Get Product Status Update Batch Results

## Get Product Status Update Batch Results

> \*\*Rate limit:\*\* 200 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"UpdateProductStatusBatchResultsResponseSchema":{"properties":{"batchRequestId":{"description":"Unique identifier (UUID)","format":"uuid","title":"Batchrequestid","type":"string"},"status":{"anyOf":[{"$ref":"#/components/schemas/RequestStatus","description":"Status of the batch processing"},{"type":"string"}],"title":"Status"},"items":{"items":{"$ref":"#/components/schemas/UpdateProductStatusResultItemSchema"},"title":"Items","type":"array"}},"required":["batchRequestId","status","items"],"title":"UpdateProductStatusBatchResultsResponseSchema","type":"object"},"RequestStatus":{"enum":["pending","processing","completed","retry","failed"],"title":"RequestStatus","type":"string"},"UpdateProductStatusResultItemSchema":{"properties":{"requestItem":{"$ref":"#/components/schemas/UpdateProductStatusItemSchema"},"success":{"title":"Success","type":"boolean"},"errors":{"items":{"description":"Error message if and why the operation failed","type":"string"},"title":"Errors","type":"array"}},"required":["requestItem","success","errors"],"title":"UpdateProductStatusResultItemSchema","type":"object"},"UpdateProductStatusItemSchema":{"properties":{"style_key":{"description":"Style key for the group of products","maxLength":120,"title":"Style Key","type":"string"},"status":{"description":"Status you want to set for the given product.\n`published` moves the product toward approval and eventually marks it active,\n`inactive` keeps it hidden after it was activated,\n`draft` keeps it in preparation and out of the catalog until manual publication begins.\nReverting to `draft` is only supported before the product reaches approval, after which one should use `inactive`.","type":"string"}},"required":["style_key","status"],"title":"UpdateProductStatusItemSchema","type":"object"},"BadRequestSchema":{"properties":{"message":{"description":"Error message","title":"Message","type":"string"}},"required":["message"],"title":"BadRequestSchema","type":"object"}}},"paths":{"/api/v1/results/status":{"get":{"operationId":"scapi_app_endpoints_result_api_get_product_status_update_batch_results","summary":"Get Product Status Update Batch Results","parameters":[{"in":"query","name":"batch_request_id","schema":{"format":"uuid","title":"Batch Request Id","type":"string"},"required":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateProductStatusBatchResultsResponseSchema"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"**Rate limit:** 200 requests per minute","tags":["Results"]}}}}
```


# Stock and Prices

This section covers dedicated endpoints for managing stock levels and pricing.<br>

While stock and price data can also be retrieved or updated through the product endpoints, these specialized endpoints provide a more efficient way to handle inventory and pricing updates.


# Update Stock

## Update Stock

> \*\*Rate limit:\*\* 1000 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"UpdateStockResponseSchema":{"properties":{"batchRequestId":{"description":"ID of the asynchronous batch request. Identical payloads from the same merchant within the deduplication window return the existing in-flight ID instead of queuing a new batch. Poll the results endpoint with this ID to retrieve the outcome. Results are available for 7 days.","format":"uuid","title":"Batchrequestid","type":"string"}},"required":["batchRequestId"],"title":"UpdateStockResponseSchema","type":"object"},"BadRequestSchema":{"properties":{"message":{"description":"Error message","title":"Message","type":"string"}},"required":["message"],"title":"BadRequestSchema","type":"object"},"UpdateStockSchema":{"properties":{"items":{"description":"List of stock items to update","items":{"$ref":"#/components/schemas/UpdateStockItemSchema"},"maxItems":1000,"minItems":1,"title":"Items","type":"array"}},"required":["items"],"title":"UpdateStockSchema","type":"object"},"UpdateStockItemSchema":{"properties":{"sku":{"description":"Stock Keeping Unit identifier","maxLength":120,"title":"Sku","type":"string"},"quantity":{"description":"Quantity to update","maximum":1000000,"minimum":0,"title":"Quantity","type":"integer"},"valid_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"When this data was valid on your side. We do not apply an item that is older than the last update we applied, and we clamp a future timestamp to the time we receive the request, so it cannot schedule a change.","title":"Valid At"}},"required":["sku","quantity"],"title":"UpdateStockItemSchema","type":"object"}}},"paths":{"/api/v1/products/stocks":{"put":{"operationId":"scapi_app_endpoints_product_api_update_stock","summary":"Update Stock","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateStockResponseSchema"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"**Rate limit:** 1000 requests per minute","tags":["Products"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateStockSchema"}}},"required":true}}}}}
```


# Get Stock Batch Results

## Get Stock Batch Results

> \*\*Rate limit:\*\* 200 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"StockBatchResultsResponseSchema":{"properties":{"batchRequestId":{"description":"Unique identifier (UUID)","format":"uuid","title":"Batchrequestid","type":"string"},"status":{"$ref":"#/components/schemas/RequestStatus","description":"Status of the batch processing"},"items":{"description":"List of result items for stock update","items":{"$ref":"#/components/schemas/UpdateStockResultItemSchema"},"title":"Items","type":"array"}},"required":["batchRequestId","status","items"],"title":"StockBatchResultsResponseSchema","type":"object"},"RequestStatus":{"enum":["pending","processing","completed","retry","failed"],"title":"RequestStatus","type":"string"},"UpdateStockResultItemSchema":{"properties":{"requestItem":{"$ref":"#/components/schemas/UpdateStockItemSchema"},"success":{"title":"Success","type":"boolean"},"errors":{"items":{"description":"Error message if and why the operation failed","type":"string"},"title":"Errors","type":"array"}},"required":["requestItem","success","errors"],"title":"UpdateStockResultItemSchema","type":"object"},"UpdateStockItemSchema":{"properties":{"sku":{"description":"Stock Keeping Unit identifier","maxLength":120,"title":"Sku","type":"string"},"quantity":{"description":"Quantity to update","maximum":1000000,"minimum":0,"title":"Quantity","type":"integer"},"valid_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"When this data was valid on your side. We do not apply an item that is older than the last update we applied, and we clamp a future timestamp to the time we receive the request, so it cannot schedule a change.","title":"Valid At"}},"required":["sku","quantity"],"title":"UpdateStockItemSchema","type":"object"},"BadRequestSchema":{"properties":{"message":{"description":"Error message","title":"Message","type":"string"}},"required":["message"],"title":"BadRequestSchema","type":"object"}}},"paths":{"/api/v1/results/stocks":{"get":{"operationId":"scapi_app_endpoints_result_api_get_stock_batch_results","summary":"Get Stock Batch Results","parameters":[{"in":"query","name":"batch_request_id","schema":{"format":"uuid","title":"Batch Request Id","type":"string"},"required":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockBatchResultsResponseSchema"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"**Rate limit:** 200 requests per minute","tags":["Results"]}}}}
```


# Update Price

## Update Price

> \*\*Rate limit:\*\* 200 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"UpdatePriceResponseSchema":{"properties":{"batchRequestId":{"description":"ID of the asynchronous batch request. Identical payloads from the same merchant within the deduplication window return the existing in-flight ID instead of queuing a new batch. Poll the results endpoint with this ID to retrieve the outcome. Results are available for 7 days.","format":"uuid","title":"Batchrequestid","type":"string"}},"required":["batchRequestId"],"title":"UpdatePriceResponseSchema","type":"object"},"BadRequestSchema":{"properties":{"message":{"description":"Error message","title":"Message","type":"string"}},"required":["message"],"title":"BadRequestSchema","type":"object"},"UpdatePriceSchema":{"properties":{"items":{"description":"List of price items to update","items":{"$ref":"#/components/schemas/UpdatePriceItemSchema"},"maxItems":1000,"minItems":1,"title":"Items","type":"array"}},"required":["items"],"title":"UpdatePriceSchema","type":"object"},"UpdatePriceItemSchema":{"properties":{"sku":{"description":"Stock Keeping Unit identifier","maxLength":120,"title":"Sku","type":"string"},"price":{"$ref":"#/components/schemas/PriceSchemaNullable"},"valid_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"When this data was valid on your side. We do not apply an item that is older than the last update we applied, and we clamp a future timestamp to the time we receive the request, so it cannot schedule a change.","title":"Valid At"}},"required":["sku","price"],"title":"UpdatePriceItemSchema","type":"object"},"PriceSchemaNullable":{"properties":{"country_code":{"description":"ISO 3166-1 alpha-2 country code","pattern":"^[A-Za-z]{2}$","title":"Country Code","type":"string"},"currency":{"anyOf":[{"description":"ISO 4217 alpha-3 currency code","pattern":"^[A-Za-z]{3}$","type":"string"},{"type":"null"}],"description":"**Warning:** this field is currently optional, but will become mandatory soon - always send it. Currency the prices are denominated in. Must match the currency configured for the country - see the countries endpoint for the currency of each country.","title":"Currency"},"retail_price":{"anyOf":[{"exclusiveMinimum":0,"maximum":1000000,"type":"number"},{"type":"null"}],"title":"Retail Price"},"sale_price":{"anyOf":[{"exclusiveMinimum":0,"maximum":1000000,"type":"number"},{"type":"null"}],"title":"Sale Price"}},"required":["country_code"],"title":"PriceSchemaNullable","type":"object"}}},"paths":{"/api/v1/products/prices":{"put":{"operationId":"scapi_app_endpoints_product_api_update_price","summary":"Update Price","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePriceResponseSchema"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"**Rate limit:** 200 requests per minute","tags":["Products"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePriceSchema"}}},"required":true}}}}}
```


# Get Price Batch Results

## Get Price Batch Results

> \*\*Rate limit:\*\* 200 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"PriceBatchResultsResponseSchema":{"properties":{"batchRequestId":{"description":"Unique identifier (UUID)","format":"uuid","title":"Batchrequestid","type":"string"},"status":{"$ref":"#/components/schemas/RequestStatus","description":"Status of the batch processing"},"items":{"description":"List of result items for batch update","items":{"$ref":"#/components/schemas/UpdatePriceResultItemSchema"},"title":"Items","type":"array"}},"required":["batchRequestId","status","items"],"title":"PriceBatchResultsResponseSchema","type":"object"},"RequestStatus":{"enum":["pending","processing","completed","retry","failed"],"title":"RequestStatus","type":"string"},"UpdatePriceResultItemSchema":{"properties":{"requestItem":{"$ref":"#/components/schemas/UpdatePriceItemSchema"},"success":{"title":"Success","type":"boolean"},"errors":{"items":{"description":"Error message if and why the operation failed","type":"string"},"title":"Errors","type":"array"}},"required":["requestItem","success","errors"],"title":"UpdatePriceResultItemSchema","type":"object"},"UpdatePriceItemSchema":{"properties":{"sku":{"description":"Stock Keeping Unit identifier","maxLength":120,"title":"Sku","type":"string"},"price":{"$ref":"#/components/schemas/PriceSchemaNullable"},"valid_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"When this data was valid on your side. We do not apply an item that is older than the last update we applied, and we clamp a future timestamp to the time we receive the request, so it cannot schedule a change.","title":"Valid At"}},"required":["sku","price"],"title":"UpdatePriceItemSchema","type":"object"},"PriceSchemaNullable":{"properties":{"country_code":{"description":"ISO 3166-1 alpha-2 country code","pattern":"^[A-Za-z]{2}$","title":"Country Code","type":"string"},"currency":{"anyOf":[{"description":"ISO 4217 alpha-3 currency code","pattern":"^[A-Za-z]{3}$","type":"string"},{"type":"null"}],"description":"**Warning:** this field is currently optional, but will become mandatory soon - always send it. Currency the prices are denominated in. Must match the currency configured for the country - see the countries endpoint for the currency of each country.","title":"Currency"},"retail_price":{"anyOf":[{"exclusiveMinimum":0,"maximum":1000000,"type":"number"},{"type":"null"}],"title":"Retail Price"},"sale_price":{"anyOf":[{"exclusiveMinimum":0,"maximum":1000000,"type":"number"},{"type":"null"}],"title":"Sale Price"}},"required":["country_code"],"title":"PriceSchemaNullable","type":"object"},"BadRequestSchema":{"properties":{"message":{"description":"Error message","title":"Message","type":"string"}},"required":["message"],"title":"BadRequestSchema","type":"object"}}},"paths":{"/api/v1/results/prices":{"get":{"operationId":"scapi_app_endpoints_result_api_get_price_batch_results","summary":"Get Price Batch Results","parameters":[{"in":"query","name":"batch_request_id","schema":{"format":"uuid","title":"Batch Request Id","type":"string"},"required":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceBatchResultsResponseSchema"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"**Rate limit:** 200 requests per minute","tags":["Results"]}}}}
```


# Orders and Shipment

This section details the endpoints for managing orders and shipments, including order item cancellations and returns.

For a complete overview, each endpoint is documented on its own subpage


# Get Orders

## Get Orders

> List orders with optional cursor-based pagination.\
> \
> Use \`page\` and \`per\_page\` for offset pagination (default). To avoid offset\
> drift under concurrent writes, use cursor pagination: pass \`cursor\` with\
> the value from the previous response's \`pagination.next\_cursor\`; then\
> \`page\`, \`pages\`, and \`total\` are omitted from the response.\
> \
> \*\*Rate limit:\*\* 100 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"orders_app__models__order__Order__StatusChoices":{"enum":["open","shipped","cancelled","returned","mixed"],"title":"StatusChoices","type":"string"},"orders_app__models__order_item__OrderItem__StatusChoices":{"enum":["open","shipped","cancelled","returned"],"title":"StatusChoices","type":"string"},"FulfillmentTypes":{"enum":["dropshipping","fulfillment_by_marketplace"],"title":"FulfillmentTypes","type":"string"},"PagedGetOrderSchema":{"properties":{"items":{"items":{"$ref":"#/components/schemas/GetOrderSchema"},"title":"Items","type":"array"},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["items","pagination"],"title":"PagedGetOrderSchema","type":"object"},"GetOrderSchema":{"properties":{"order_items":{"description":"List of order items","items":{"$ref":"#/components/schemas/OrderItemSchema"},"title":"Order items","type":"array"},"order_number":{"description":"Order number of the order","title":"Order number","type":"string"},"carrier_key":{"description":"Carrier key from the Carrier model.","title":"Carrier Key","type":"string"},"cost_without_tax":{"description":"Cost of the order without tax in the smallest currency unit (e.g. cents for Euro)","title":"Cost without tax","type":"integer"},"cost_with_tax":{"description":"Cost of the order with tax in the smallest currency unit (e.g. cents for Euro)","title":"Cost with tax","type":"integer"},"delivery_document_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"URL of the delivery document (packing slip). Only dropshipping orders have one; null for every other fulfillment type.","title":"Delivery document URL"},"fulfillment_type":{"$ref":"#/components/schemas/FulfillmentTypes","description":"Who fulfills the order: \"dropshipping\" (the merchant ships) or \"fulfillment_by_marketplace\" (About You ships).","title":"Fulfillment type"},"shop":{"description":"Id of the shop country the order was placed in","title":"Shop country","type":"integer"},"status":{"$ref":"#/components/schemas/orders_app__models__order__Order__StatusChoices"},"customer_key":{"description":"Scayle id of the customer, as text. MAPI calls it customer_key.","maxLength":255,"title":"Customer Key","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"payment_method":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Payment method","title":"Payment Method"},"billing_street":{"description":"Billing address","maxLength":255,"title":"Billing Street","type":"string"},"billing_zip_code":{"description":"Billing zip code","maxLength":255,"title":"Billing Zip Code","type":"string"},"billing_city":{"description":"Billing city","maxLength":255,"title":"Billing City","type":"string"},"billing_country_code":{"description":"Billing country code","maxLength":2,"title":"Billing Country Code","type":"string"},"billing_recipient_gender":{"anyOf":[{"maxLength":1,"type":"string"},{"type":"null"}],"description":"Gender of the recipient","title":"Billing Recipient Gender"},"billing_recipient_first_name":{"description":"First name of the recipient","maxLength":255,"title":"Billing Recipient First Name","type":"string"},"billing_recipient_last_name":{"description":"Last name of the recipient","maxLength":255,"title":"Billing Recipient Last Name","type":"string"},"billing_additional":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Additional billing information","title":"Billing Additional"},"shipping_street":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Shipping address","title":"Shipping Street"},"shipping_zip_code":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Shipping zip code","title":"Shipping Zip Code"},"shipping_city":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Shipping city","title":"Shipping City"},"shipping_country_code":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"description":"Shipping country","title":"Shipping Country Code"},"shipping_additional":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Additional shipping information","title":"Shipping Additional"},"shipping_collection_point_key":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"default":"","description":"Shipping collection point key","title":"Shipping Collection Point Key"},"shipping_collection_point_type":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"default":"","description":"Shipping collection point type","title":"Shipping Collection Point Type"},"shipping_collection_point_description":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"default":"","description":"Shipping collection point description","title":"Shipping Collection Point Description"},"customer_phone":{"anyOf":[{"maxLength":50,"type":"string"},{"type":"null"}],"default":"","description":"Customer phone number for collection point delivery notifications","title":"Customer Phone"},"customer_email":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"default":"","description":"Customer email address for collection point delivery notifications","title":"Customer Email"},"shipping_recipient_gender":{"anyOf":[{"maxLength":1,"type":"string"},{"type":"null"}],"description":"Gender of the recipient","title":"Shipping Recipient Gender"},"shipping_recipient_first_name":{"description":"First name of the recipient","maxLength":255,"title":"Shipping Recipient First Name","type":"string"},"shipping_recipient_last_name":{"description":"Last name of the recipient","maxLength":255,"title":"Shipping Recipient Last Name","type":"string"},"currency_code":{"description":"Currency code","maxLength":3,"title":"Currency Code","type":"string"}},"required":["order_items","order_number","carrier_key","cost_without_tax","cost_with_tax","delivery_document_url","fulfillment_type","shop","status","customer_key","created_at","updated_at","billing_street","billing_zip_code","billing_city","billing_country_code","billing_recipient_first_name","billing_recipient_last_name","shipping_recipient_first_name","shipping_recipient_last_name","currency_code"],"title":"GetOrderSchema","type":"object"},"OrderItemSchema":{"properties":{"return_tracking_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Return Tracking Key"},"shipment_tracking_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shipment Tracking Key"},"sku":{"description":"SKU of the product variant","title":"SKU","type":"string"},"status":{"$ref":"#/components/schemas/orders_app__models__order_item__OrderItem__StatusChoices"},"id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"ID"},"vat":{"default":19,"description":"The tax percentage","title":"Vat","type":"number"},"price_without_tax":{"description":"Price of the product excluding tax in the smallest currency unit (e.g. cents for Euro)","title":"Price Without Tax","type":"integer"},"price_with_tax":{"description":"Price of the product including tax in the smallest currency unit (e.g. cents for Euro)","title":"Price With Tax","type":"integer"}},"required":["return_tracking_key","shipment_tracking_key","sku","status","price_without_tax","price_with_tax"],"title":"OrderItemSchema","type":"object"},"Pagination":{"properties":{"per_page":{"description":"Number of items per page.","exclusiveMinimum":0,"title":"Per Page","type":"integer"},"page":{"anyOf":[{"exclusiveMinimum":0,"type":"integer"},{"type":"null"}],"description":"Page number (null in cursor mode).","title":"Page"},"pages":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"Total pages (null in cursor mode).","title":"Pages"},"total":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"Total count (null in cursor mode).","title":"Total"},"next":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"URL for next page (null in cursor mode).","title":"Next"},"prev":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"URL for previous page (null in cursor mode).","title":"Prev"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque cursor for next page when using cursor-based pagination.","title":"Next Cursor"}},"required":["per_page"],"title":"Pagination","type":"object"},"BadRequestSchema":{"properties":{"message":{"description":"Error message","title":"Message","type":"string"}},"required":["message"],"title":"BadRequestSchema","type":"object"}}},"paths":{"/api/v1/orders/":{"get":{"operationId":"scapi_app_endpoints_order_api_get_orders","summary":"Get Orders","parameters":[{"in":"query","name":"order_number","schema":{"anyOf":[{"items":{"type":"string"},"maxItems":100,"type":"array"},{"type":"null"}],"description":"Exact order number to filter by. Repeat the parameter for up to 100 order numbers.","title":"Order number"},"required":false,"description":"Exact order number to filter by. Repeat the parameter for up to 100 order numbers."},{"in":"query","name":"customer_key","schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Customer key to search for.","title":"Customer key"},"required":false,"description":"Customer key to search for."},{"in":"query","name":"carrier_key","schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Carrier key of the order to filter by. Available carrier keys can be retrieved from the Carrier model (active carriers only).","title":"Carrier Key"},"required":false,"description":"Carrier key of the order to filter by. Available carrier keys can be retrieved from the Carrier model (active carriers only)."},{"in":"query","name":"shop_country","schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Shop country to search for.","title":"Shop country"},"required":false,"description":"Shop country to search for."},{"in":"query","name":"order_status","schema":{"anyOf":[{"$ref":"#/components/schemas/orders_app__models__order__Order__StatusChoices"},{"type":"null"}],"description":"Status of the order to filter by. Choose from: \"open\", \"shipped\", \"cancelled\", \"returned\", \"mixed\".","title":"Status"},"required":false,"description":"Status of the order to filter by. Choose from: \"open\", \"shipped\", \"cancelled\", \"returned\", \"mixed\"."},{"in":"query","name":"order_item_status","schema":{"anyOf":[{"$ref":"#/components/schemas/orders_app__models__order_item__OrderItem__StatusChoices"},{"type":"null"}],"description":"Status of the order item to filter by. Choose from: \"open\", \"shipped\", \"cancelled\", \"returned\"."},"required":false,"description":"Status of the order item to filter by. Choose from: \"open\", \"shipped\", \"cancelled\", \"returned\"."},{"in":"query","name":"orders_from","schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Orders from date to filter by.","title":"Orders from"},"required":false,"description":"Orders from date to filter by."},{"in":"query","name":"orders_to","schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Orders to date to filter by.","title":"Orders to"},"required":false,"description":"Orders to date to filter by."},{"in":"query","name":"fulfillment_type","schema":{"anyOf":[{"$ref":"#/components/schemas/FulfillmentTypes"},{"type":"null"}],"description":"Fulfillment type to filter by.","title":"Fulfillment type"},"required":false,"description":"Fulfillment type to filter by."},{"in":"query","name":"page","schema":{"default":1,"deprecated":true,"description":"Page number to retrieve items from. Deprecated: offset pagination recounts the full result set on every request. Use `cursor` instead.","minimum":1,"title":"Page","type":"integer"},"required":false,"description":"Page number to retrieve items from. Deprecated: offset pagination recounts the full result set on every request. Use `cursor` instead.","deprecated":true},{"in":"query","name":"per_page","schema":{"default":20,"description":"Number of items per page.","maximum":100,"minimum":1,"title":"Per Page","type":"integer"},"required":false,"description":"Number of items per page."},{"in":"query","name":"cursor","schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque cursor from previous response for cursor-based pagination. When provided, omit page or use page=1.","title":"Cursor"},"required":false,"description":"Opaque cursor from previous response for cursor-based pagination. When provided, omit page or use page=1."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedGetOrderSchema"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"List orders with optional cursor-based pagination.\n\nUse `page` and `per_page` for offset pagination (default). To avoid offset\ndrift under concurrent writes, use cursor pagination: pass `cursor` with\nthe value from the previous response's `pagination.next_cursor`; then\n`page`, `pages`, and `total` are omitted from the response.\n\n**Rate limit:** 100 requests per minute","tags":["Orders"]}}}}
```


# Get Carriers

## Get Carriers

> Get list of available carriers for order shipments.\
> \
> \*\*Rate limit:\*\* 100 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"PagedCarrierSchema":{"properties":{"items":{"items":{"$ref":"#/components/schemas/CarrierSchema"},"title":"Items","type":"array"},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["items","pagination"],"title":"PagedCarrierSchema","type":"object"},"CarrierSchema":{"properties":{"country_code":{"title":"Country Code","type":"string"},"display_label":{"title":"Display Label","type":"string"},"carrier_name":{"title":"Carrier Name","type":"string"},"key":{"description":"The key of the carrier (e.g. DHL_STD_NATIONAL).","maxLength":255,"title":"Key","type":"string"}},"required":["country_code","display_label","carrier_name","key"],"title":"CarrierSchema","type":"object"},"Pagination":{"properties":{"per_page":{"description":"Number of items per page.","exclusiveMinimum":0,"title":"Per Page","type":"integer"},"page":{"anyOf":[{"exclusiveMinimum":0,"type":"integer"},{"type":"null"}],"description":"Page number (null in cursor mode).","title":"Page"},"pages":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"Total pages (null in cursor mode).","title":"Pages"},"total":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"Total count (null in cursor mode).","title":"Total"},"next":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"URL for next page (null in cursor mode).","title":"Next"},"prev":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"URL for previous page (null in cursor mode).","title":"Prev"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque cursor for next page when using cursor-based pagination.","title":"Next Cursor"}},"required":["per_page"],"title":"Pagination","type":"object"},"BadRequestSchema":{"properties":{"message":{"description":"Error message","title":"Message","type":"string"}},"required":["message"],"title":"BadRequestSchema","type":"object"}}},"paths":{"/api/v1/orders/carriers/":{"get":{"operationId":"scapi_app_endpoints_order_api_get_carriers","summary":"Get Carriers","parameters":[{"in":"query","name":"page","schema":{"default":1,"description":"Page number to retrieve items from.","minimum":1,"title":"Page","type":"integer"},"required":false,"description":"Page number to retrieve items from."},{"in":"query","name":"per_page","schema":{"default":20,"description":"Number of items per page.","maximum":100,"minimum":1,"title":"Per Page","type":"integer"},"required":false,"description":"Number of items per page."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedCarrierSchema"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"Get list of available carriers for order shipments.\n\n**Rate limit:** 100 requests per minute","tags":["Orders"]}}}}
```


# Ship Order Items

## Ship Order Items

> \*\*Rate limit:\*\* 200 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"BatchRequestResponseSchema":{"properties":{"batchRequestId":{"description":"ID of the asynchronous batch request. Identical payloads from the same merchant within the deduplication window return the existing in-flight ID instead of queuing a new batch. Poll the results endpoint with this ID to retrieve the outcome. Results are available for 7 days.","format":"uuid","title":"Batchrequestid","type":"string"}},"required":["batchRequestId"],"title":"BatchRequestResponseSchema","type":"object"},"BadRequestSchema":{"properties":{"message":{"description":"Error message","title":"Message","type":"string"}},"required":["message"],"title":"BadRequestSchema","type":"object"},"ShipmentRequestSchema":{"properties":{"items":{"description":"List of shipments.","items":{"$ref":"#/components/schemas/ShipmentItemSchema"},"minItems":1,"title":"Items","type":"array"}},"required":["items"],"title":"ShipmentRequestSchema","type":"object"},"ShipmentItemSchema":{"properties":{"order_items":{"description":"List of order item ids to ship.","items":{"description":"ID (integer) of this property","minimum":1,"type":"integer"},"minItems":1,"title":"Order Items","type":"array"},"carrier_key":{"description":"Carrier key of the shipment. Must be a valid active carrier key. Use GET /orders/carriers/ to retrieve available carrier keys.","title":"Carrier Key","type":"string"},"shipment_tracking_key":{"description":"Tracking key of the shipment","maxLength":255,"minLength":1,"title":"Shipment Tracking Key","type":"string"},"return_tracking_key":{"description":"Return tracking key","maxLength":255,"minLength":1,"title":"Return Tracking Key","type":"string"}},"required":["order_items","carrier_key","shipment_tracking_key","return_tracking_key"],"title":"ShipmentItemSchema","type":"object"}}},"paths":{"/api/v1/orders/ship":{"post":{"operationId":"scapi_app_endpoints_order_api_ship_order_items","summary":"Ship Order Items","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchRequestResponseSchema"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"**Rate limit:** 200 requests per minute","tags":["Orders"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentRequestSchema"}}},"required":true}}}}}
```


# Get Shipped Order Batch Results

## Get Ship Order Batch Results

> \*\*Rate limit:\*\* 200 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"ShipmentOrderResultsResponseSchema":{"properties":{"batchRequestId":{"description":"Unique identifier (UUID)","format":"uuid","title":"Batchrequestid","type":"string"},"status":{"$ref":"#/components/schemas/RequestStatus","description":"Status of the batch processing"},"items":{"description":"List of result items for batch shipment order","items":{"$ref":"#/components/schemas/ShipmentResultItemSchema"},"title":"Items","type":"array"}},"required":["batchRequestId","status","items"],"title":"ShipmentOrderResultsResponseSchema","type":"object"},"RequestStatus":{"enum":["pending","processing","completed","retry","failed"],"title":"RequestStatus","type":"string"},"ShipmentResultItemSchema":{"properties":{"requestItem":{"$ref":"#/components/schemas/ShipmentItemSchema"},"success":{"title":"Success","type":"boolean"},"errors":{"items":{"description":"Error message if and why the operation failed","type":"string"},"title":"Errors","type":"array"}},"required":["requestItem","success","errors"],"title":"ShipmentResultItemSchema","type":"object"},"ShipmentItemSchema":{"properties":{"order_items":{"description":"List of order item ids to ship.","items":{"description":"ID (integer) of this property","minimum":1,"type":"integer"},"minItems":1,"title":"Order Items","type":"array"},"carrier_key":{"description":"Carrier key of the shipment. Must be a valid active carrier key. Use GET /orders/carriers/ to retrieve available carrier keys.","title":"Carrier Key","type":"string"},"shipment_tracking_key":{"description":"Tracking key of the shipment","maxLength":255,"minLength":1,"title":"Shipment Tracking Key","type":"string"},"return_tracking_key":{"description":"Return tracking key","maxLength":255,"minLength":1,"title":"Return Tracking Key","type":"string"}},"required":["order_items","carrier_key","shipment_tracking_key","return_tracking_key"],"title":"ShipmentItemSchema","type":"object"},"BadRequestSchema":{"properties":{"message":{"description":"Error message","title":"Message","type":"string"}},"required":["message"],"title":"BadRequestSchema","type":"object"}}},"paths":{"/api/v1/results/ship-orders":{"get":{"operationId":"scapi_app_endpoints_result_api_get_ship_order_batch_results","summary":"Get Ship Order Batch Results","parameters":[{"in":"query","name":"batch_request_id","schema":{"format":"uuid","title":"Batch Request Id","type":"string"},"required":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentOrderResultsResponseSchema"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"**Rate limit:** 200 requests per minute","tags":["Results"]}}}}
```


# Cancel Order Items

## Cancel Order Items

> \*\*Rate limit:\*\* 50 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"BatchRequestResponseSchema":{"properties":{"batchRequestId":{"description":"ID of the asynchronous batch request. Identical payloads from the same merchant within the deduplication window return the existing in-flight ID instead of queuing a new batch. Poll the results endpoint with this ID to retrieve the outcome. Results are available for 7 days.","format":"uuid","title":"Batchrequestid","type":"string"}},"required":["batchRequestId"],"title":"BatchRequestResponseSchema","type":"object"},"BadRequestSchema":{"properties":{"message":{"description":"Error message","title":"Message","type":"string"}},"required":["message"],"title":"BadRequestSchema","type":"object"},"CancelRequestSchema":{"properties":{"items":{"description":"List of order items to cancel.","items":{"$ref":"#/components/schemas/CancelOrderItemSchema"},"minItems":1,"title":"Items","type":"array"}},"required":["items"],"title":"CancelRequestSchema","type":"object"},"CancelOrderItemSchema":{"properties":{"id":{"description":"Order item ID to cancel.","minimum":1,"title":"Id","type":"integer"}},"required":["id"],"title":"CancelOrderItemSchema","type":"object"}}},"paths":{"/api/v1/orders/cancel":{"post":{"operationId":"scapi_app_endpoints_order_api_cancel_order_items","summary":"Cancel Order Items","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchRequestResponseSchema"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"**Rate limit:** 50 requests per minute","tags":["Orders"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelRequestSchema"}}},"required":true}}}}}
```


# Get Cancelled Order Item Batch Results

## Get Cancel Order Batch Results

> \*\*Rate limit:\*\* 200 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"CancelOrderResultsResponseSchema":{"properties":{"batchRequestId":{"description":"Unique identifier (UUID)","format":"uuid","title":"Batchrequestid","type":"string"},"status":{"$ref":"#/components/schemas/RequestStatus","description":"Status of the batch processing"},"items":{"description":"List of result items for batch cancel order","items":{"$ref":"#/components/schemas/CancelOrderResultItemSchema"},"title":"Items","type":"array"}},"required":["batchRequestId","status","items"],"title":"CancelOrderResultsResponseSchema","type":"object"},"RequestStatus":{"enum":["pending","processing","completed","retry","failed"],"title":"RequestStatus","type":"string"},"CancelOrderResultItemSchema":{"properties":{"requestItem":{"$ref":"#/components/schemas/CancelOrderItemSchema"},"success":{"title":"Success","type":"boolean"},"errors":{"items":{"description":"Error message if and why the operation failed","type":"string"},"title":"Errors","type":"array"}},"required":["requestItem","success","errors"],"title":"CancelOrderResultItemSchema","type":"object"},"CancelOrderItemSchema":{"properties":{"id":{"description":"Order item ID to cancel.","minimum":1,"title":"Id","type":"integer"}},"required":["id"],"title":"CancelOrderItemSchema","type":"object"},"BadRequestSchema":{"properties":{"message":{"description":"Error message","title":"Message","type":"string"}},"required":["message"],"title":"BadRequestSchema","type":"object"}}},"paths":{"/api/v1/results/cancel-orders":{"get":{"operationId":"scapi_app_endpoints_result_api_get_cancel_order_batch_results","summary":"Get Cancel Order Batch Results","parameters":[{"in":"query","name":"batch_request_id","schema":{"format":"uuid","title":"Batch Request Id","type":"string"},"required":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelOrderResultsResponseSchema"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"**Rate limit:** 200 requests per minute","tags":["Results"]}}}}
```


# Return Order Items

## Return Order Items

> \*\*Rate limit:\*\* 50 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"BatchRequestResponseSchema":{"properties":{"batchRequestId":{"description":"ID of the asynchronous batch request. Identical payloads from the same merchant within the deduplication window return the existing in-flight ID instead of queuing a new batch. Poll the results endpoint with this ID to retrieve the outcome. Results are available for 7 days.","format":"uuid","title":"Batchrequestid","type":"string"}},"required":["batchRequestId"],"title":"BatchRequestResponseSchema","type":"object"},"BadRequestSchema":{"properties":{"message":{"description":"Error message","title":"Message","type":"string"}},"required":["message"],"title":"BadRequestSchema","type":"object"},"ReturnRequestSchema":{"properties":{"items":{"description":"List of return shipments.","items":{"$ref":"#/components/schemas/ReturnItemSchema"},"minItems":1,"title":"Items","type":"array"}},"required":["items"],"title":"ReturnRequestSchema","type":"object"},"ReturnItemSchema":{"properties":{"order_items":{"description":"List of order item ids to return.","items":{"description":"ID (integer) of this property","minimum":1,"type":"integer"},"minItems":1,"title":"Order Items","type":"array"},"return_tracking_key":{"description":"Return tracking key","maxLength":255,"minLength":1,"title":"Return Tracking Key","type":"string"}},"required":["order_items","return_tracking_key"],"title":"ReturnItemSchema","type":"object"}}},"paths":{"/api/v1/orders/return":{"post":{"operationId":"scapi_app_endpoints_order_api_return_order_items","summary":"Return Order Items","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchRequestResponseSchema"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"**Rate limit:** 50 requests per minute","tags":["Orders"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReturnRequestSchema"}}},"required":true}}}}}
```


# Get Returned Order Batch Results

## Get Return Order Batch Results

> \*\*Rate limit:\*\* 200 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"ReturnResultsSchema":{"properties":{"batchRequestId":{"description":"Unique identifier (UUID)","format":"uuid","title":"Batchrequestid","type":"string"},"status":{"$ref":"#/components/schemas/RequestStatus","description":"Status of the batch processing"},"items":{"description":"List of result items for batch return order","items":{"$ref":"#/components/schemas/ReturnResultItemSchema"},"title":"Items","type":"array"}},"required":["batchRequestId","status","items"],"title":"ReturnResultsSchema","type":"object"},"RequestStatus":{"enum":["pending","processing","completed","retry","failed"],"title":"RequestStatus","type":"string"},"ReturnResultItemSchema":{"properties":{"requestItem":{"$ref":"#/components/schemas/ReturnItemSchema"},"success":{"title":"Success","type":"boolean"},"errors":{"items":{"description":"Error message if and why the operation failed","type":"string"},"title":"Errors","type":"array"}},"required":["requestItem","success","errors"],"title":"ReturnResultItemSchema","type":"object"},"ReturnItemSchema":{"properties":{"order_items":{"description":"List of order item ids to return.","items":{"description":"ID (integer) of this property","minimum":1,"type":"integer"},"minItems":1,"title":"Order Items","type":"array"},"return_tracking_key":{"description":"Return tracking key","maxLength":255,"minLength":1,"title":"Return Tracking Key","type":"string"}},"required":["order_items","return_tracking_key"],"title":"ReturnItemSchema","type":"object"},"BadRequestSchema":{"properties":{"message":{"description":"Error message","title":"Message","type":"string"}},"required":["message"],"title":"BadRequestSchema","type":"object"}}},"paths":{"/api/v1/results/return-orders":{"get":{"operationId":"scapi_app_endpoints_result_api_get_return_order_batch_results","summary":"Get Return Order Batch Results","parameters":[{"in":"query","name":"batch_request_id","schema":{"format":"uuid","title":"Batch Request Id","type":"string"},"required":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReturnResultsSchema"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"**Rate limit:** 200 requests per minute","tags":["Results"]}}}}
```


# Get Order Invoices

## Get Order Invoices

> \*\*Rate limit:\*\* 10 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"BadRequestSchema":{"properties":{"message":{"description":"Error message","title":"Message","type":"string"}},"required":["message"],"title":"BadRequestSchema","type":"object"}}},"paths":{"/api/v1/orders/{order_number}/invoices":{"get":{"operationId":"scapi_app_endpoints_order_api_get_order_invoices","summary":"Get Order Invoices","parameters":[{"in":"path","name":"order_number","schema":{"title":"Order Number","type":"string"},"required":true}],"responses":{"200":{"description":"OK","content":{"application/zip":{"schema":{"type":"string","format":"binary"}},"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"**Rate limit:** 10 requests per minute","tags":["Orders"]}}}}
```


# Get Order Delivery Document

## Get Delivery Document

> \*\*Rate limit:\*\* 100 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"BadRequestSchema":{"properties":{"message":{"description":"Error message","title":"Message","type":"string"}},"required":["message"],"title":"BadRequestSchema","type":"object"}}},"paths":{"/api/v1/orders/{order_number}/delivery_document":{"get":{"operationId":"scapi_app_endpoints_order_api_get_delivery_document","summary":"Get Delivery Document","parameters":[{"in":"path","name":"order_number","schema":{"title":"Order Number","type":"string"},"required":true}],"responses":{"200":{"description":"OK","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"**Rate limit:** 100 requests per minute","tags":["Orders"]}}}}
```


# Webhooks

This section of the API documentation provides details on the webhooks available in our system.

### Subscription Management

This page lists helper endpoints that allow you to subscribe to and unsubscribe from webhooks.

### Webhook Details

Each webhook is documented separately on individual subpages, providing specific information on their payload structure. For all outgoing webhooks, the following delivery and retry logic applies:

* Retry Duration: If the endpoint is unavailable, the system will continue to retry delivery for up to 2 days.
* Retry Interval: Retries are performed hourly throughout the 48-hour window.

***

## Endpoints for Subscription Management

## Get Webhook Event Types

> \*\*Rate limit:\*\* 50 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"WebhookEventSchema":{"properties":{"description":{"title":"Description","type":"string"},"event":{"maxLength":255,"title":"Event","type":"string"}},"required":["description","event"],"title":"WebhookEventSchema","type":"object"},"BadRequestSchema":{"properties":{"message":{"description":"Error message","title":"Message","type":"string"}},"required":["message"],"title":"BadRequestSchema","type":"object"}}},"paths":{"/api/v1/webhooks/types":{"get":{"operationId":"scapi_app_endpoints_webhook_api_get_webhook_event_types","summary":"Get Webhook Event Types","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/WebhookEventSchema"},"title":"Response","type":"array"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"**Rate limit:** 50 requests per minute","tags":["Webhooks"]}}}}
```

## Get Webhook Subscriptions

> \*\*Rate limit:\*\* 50 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"WebhookSubscriptionSchema":{"properties":{"events":{"items":{"$ref":"#/components/schemas/EventType"},"title":"Events","type":"array"},"url":{"format":"uri","maxLength":2083,"minLength":1,"title":"Url","type":"string"},"id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"ID"},"description":{"anyOf":[{"maxLength":1000,"type":"string"},{"type":"null"}],"description":"An optional description of what the webhook is used for.","title":"Description"},"enabled":{"default":true,"description":"Delivery toggle. The merchant owns it, and a deactivation turns it off.","title":"Enabled","type":"boolean"},"deactivated_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Set when we stopped delivering because the endpoint kept failing. enabled goes off with it, and the merchant resumes delivery by turning it back on.","title":"Deactivated At"},"created_at":{"format":"date-time","title":"Created At","type":"string"}},"required":["events","url","created_at"],"title":"WebhookSubscriptionSchema","type":"object"},"EventType":{"enum":["order.created","order.updated","order.cancelled","order.shipped","order.returned","order_items.shipped","order_items.cancelled","order_items.returned","stock.updated","product_master.status_updated"],"title":"EventType","type":"string"},"BadRequestSchema":{"properties":{"message":{"description":"Error message","title":"Message","type":"string"}},"required":["message"],"title":"BadRequestSchema","type":"object"}}},"paths":{"/api/v1/webhooks/":{"get":{"operationId":"scapi_app_endpoints_webhook_api_get_webhook_subscriptions","summary":"Get Webhook Subscriptions","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/WebhookSubscriptionSchema"},"title":"Response","type":"array"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"**Rate limit:** 50 requests per minute","tags":["Webhooks"]}}}}
```

## Post Webhook Subscription

> Each webhook message is retried hourly for up to 2 days. A subscription whose endpoint fails every delivery for 7 days is deactivated: \`enabled\` is set to false and \`deactivated\_at\` carries the time. Fix the endpoint, then PATCH \`enabled\` back to true to resume delivery.\
> \
> \*\*Rate limit:\*\* 50 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"SecretWebhookSubscriptionSchema":{"properties":{"events":{"items":{"$ref":"#/components/schemas/EventType"},"title":"Events","type":"array"},"url":{"format":"uri","maxLength":2083,"minLength":1,"title":"Url","type":"string"},"id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"ID"},"description":{"anyOf":[{"maxLength":1000,"type":"string"},{"type":"null"}],"description":"An optional description of what the webhook is used for.","title":"Description"},"enabled":{"default":true,"description":"Delivery toggle. The merchant owns it, and a deactivation turns it off.","title":"Enabled","type":"boolean"},"deactivated_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Set when we stopped delivering because the endpoint kept failing. enabled goes off with it, and the merchant resumes delivery by turning it back on.","title":"Deactivated At"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"client_secret":{"maxLength":255,"title":"Client Secret","type":"string"}},"required":["events","url","created_at","client_secret"],"title":"SecretWebhookSubscriptionSchema","type":"object"},"EventType":{"enum":["order.created","order.updated","order.cancelled","order.shipped","order.returned","order_items.shipped","order_items.cancelled","order_items.returned","stock.updated","product_master.status_updated"],"title":"EventType","type":"string"},"BadRequestSchema":{"properties":{"message":{"description":"Error message","title":"Message","type":"string"}},"required":["message"],"title":"BadRequestSchema","type":"object"},"WebhookSubscriptionPostSchema":{"properties":{"events":{"items":{"$ref":"#/components/schemas/EventType"},"title":"Events","type":"array"},"url":{"format":"uri","maxLength":2083,"minLength":1,"title":"Url","type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"}},"required":["events","url"],"title":"WebhookSubscriptionPostSchema","type":"object"}}},"paths":{"/api/v1/webhooks/":{"post":{"operationId":"scapi_app_endpoints_webhook_api_post_webhook_subscription","summary":"Post Webhook Subscription","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SecretWebhookSubscriptionSchema"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"Each webhook message is retried hourly for up to 2 days. A subscription whose endpoint fails every delivery for 7 days is deactivated: `enabled` is set to false and `deactivated_at` carries the time. Fix the endpoint, then PATCH `enabled` back to true to resume delivery.\n\n**Rate limit:** 50 requests per minute","tags":["Webhooks"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSubscriptionPostSchema"}}},"required":true}}}}}
```

## Get Webhook Subscription

> \*\*Rate limit:\*\* 50 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"WebhookSubscriptionSchema":{"properties":{"events":{"items":{"$ref":"#/components/schemas/EventType"},"title":"Events","type":"array"},"url":{"format":"uri","maxLength":2083,"minLength":1,"title":"Url","type":"string"},"id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"ID"},"description":{"anyOf":[{"maxLength":1000,"type":"string"},{"type":"null"}],"description":"An optional description of what the webhook is used for.","title":"Description"},"enabled":{"default":true,"description":"Delivery toggle. The merchant owns it, and a deactivation turns it off.","title":"Enabled","type":"boolean"},"deactivated_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Set when we stopped delivering because the endpoint kept failing. enabled goes off with it, and the merchant resumes delivery by turning it back on.","title":"Deactivated At"},"created_at":{"format":"date-time","title":"Created At","type":"string"}},"required":["events","url","created_at"],"title":"WebhookSubscriptionSchema","type":"object"},"EventType":{"enum":["order.created","order.updated","order.cancelled","order.shipped","order.returned","order_items.shipped","order_items.cancelled","order_items.returned","stock.updated","product_master.status_updated"],"title":"EventType","type":"string"},"BadRequestSchema":{"properties":{"message":{"description":"Error message","title":"Message","type":"string"}},"required":["message"],"title":"BadRequestSchema","type":"object"}}},"paths":{"/api/v1/webhooks/{subscription_id}":{"get":{"operationId":"scapi_app_endpoints_webhook_api_get_webhook_subscription","summary":"Get Webhook Subscription","parameters":[{"in":"path","name":"subscription_id","schema":{"title":"Subscription Id","type":"integer"},"required":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSubscriptionSchema"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"**Rate limit:** 50 requests per minute","tags":["Webhooks"]}}}}
```

## Delete Webhook Subscription

> \*\*Rate limit:\*\* 50 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"BadRequestSchema":{"properties":{"message":{"description":"Error message","title":"Message","type":"string"}},"required":["message"],"title":"BadRequestSchema","type":"object"}}},"paths":{"/api/v1/webhooks/{subscription_id}":{"delete":{"operationId":"scapi_app_endpoints_webhook_api_delete_webhook_subscription","summary":"Delete Webhook Subscription","parameters":[{"in":"path","name":"subscription_id","schema":{"title":"Subscription Id","type":"integer"},"required":true}],"responses":{"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"**Rate limit:** 50 requests per minute","tags":["Webhooks"]}}}}
```

## Update Webhook Subscription Patch

> Each webhook message is retried hourly for up to 2 days. A subscription whose endpoint fails every delivery for 7 days is deactivated: \`enabled\` is set to false and \`deactivated\_at\` carries the time. Fix the endpoint, then PATCH \`enabled\` back to true to resume delivery.\
> \
> \*\*Rate limit:\*\* 100 requests per minute

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"WebhookSubscriptionSchema":{"properties":{"events":{"items":{"$ref":"#/components/schemas/EventType"},"title":"Events","type":"array"},"url":{"format":"uri","maxLength":2083,"minLength":1,"title":"Url","type":"string"},"id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"ID"},"description":{"anyOf":[{"maxLength":1000,"type":"string"},{"type":"null"}],"description":"An optional description of what the webhook is used for.","title":"Description"},"enabled":{"default":true,"description":"Delivery toggle. The merchant owns it, and a deactivation turns it off.","title":"Enabled","type":"boolean"},"deactivated_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Set when we stopped delivering because the endpoint kept failing. enabled goes off with it, and the merchant resumes delivery by turning it back on.","title":"Deactivated At"},"created_at":{"format":"date-time","title":"Created At","type":"string"}},"required":["events","url","created_at"],"title":"WebhookSubscriptionSchema","type":"object"},"EventType":{"enum":["order.created","order.updated","order.cancelled","order.shipped","order.returned","order_items.shipped","order_items.cancelled","order_items.returned","stock.updated","product_master.status_updated"],"title":"EventType","type":"string"},"BadRequestSchema":{"properties":{"message":{"description":"Error message","title":"Message","type":"string"}},"required":["message"],"title":"BadRequestSchema","type":"object"},"WebhookSubscriptionPatchSchemaPatch":{"properties":{"events":{"anyOf":[{"items":{"$ref":"#/components/schemas/EventType"},"type":"array"},{"type":"null"}],"title":"Events"},"url":{"anyOf":[{"format":"uri","maxLength":2083,"minLength":1,"type":"string"},{"type":"null"}],"title":"Url"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled"}},"title":"WebhookSubscriptionPatchSchemaPatch","type":"object"}}},"paths":{"/api/v1/webhooks/{subscription_id}":{"patch":{"operationId":"scapi_app_endpoints_webhook_api_update_webhook_subscription_patch","summary":"Update Webhook Subscription Patch","parameters":[{"in":"path","name":"subscription_id","schema":{"title":"Subscription Id","type":"integer"},"required":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSubscriptionSchema"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestSchema"}}}},"default":{"headers":{"X-RateLimit-Limit":{"description":"Total requests allowed in the time window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Seconds until the current window resets","schema":{"type":"integer"}}}}},"description":"Each webhook message is retried hourly for up to 2 days. A subscription whose endpoint fails every delivery for 7 days is deactivated: `enabled` is set to false and `deactivated_at` carries the time. Fix the endpoint, then PATCH `enabled` back to true to resume delivery.\n\n**Rate limit:** 100 requests per minute","tags":["Webhooks"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSubscriptionPatchSchemaPatch"}}},"required":true}}}}}
```


# Order Delegation Webhook

## Order Created Webhook

> This is a dummy endpoint that demonstrates the webhook payload structure that will be sent\
> to webhook subscribers when an order.created event occurs.\
> \
> The actual webhooks will be sent asynchronously to the URLs specified in the webhook\
> subscriptions that are subscribed to the order.created event type.\
> \
> The webhook payload includes:\
> \- id: ID of the webhook message\
> \- event: The event type (order.created)\
> \- timestamp: When the event occurred\
> \- subscription\_id: ID of the webhook subscription\
> \- message: The order data in the same format as the GET /orders/{id} endpoint

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"OrderCreatedWebhookSchema":{"properties":{"id":{"description":"ID of the webhook message","minimum":1,"title":"Id","type":"integer"},"event":{"const":"order.created","description":"Event type of webhook message","title":"Event","type":"string"},"timestamp":{"description":"UTC timestamp when the event was created","format":"date-time","title":"Timestamp","type":"string"},"message":{"$ref":"#/components/schemas/GetOrderSchema","description":"Order payload of the triggered event"},"subscription_id":{"anyOf":[{"description":"ID (integer) of this property","minimum":1,"type":"integer"},{"type":"null"}],"description":"ID of the subscription","title":"Subscription Id"}},"required":["id","event","message"],"title":"OrderCreatedWebhookSchema","type":"object"},"GetOrderSchema":{"properties":{"order_items":{"description":"List of order items","items":{"$ref":"#/components/schemas/OrderItemSchema"},"title":"Order items","type":"array"},"order_number":{"description":"Order number of the order","title":"Order number","type":"string"},"carrier_key":{"description":"Carrier key from the Carrier model.","title":"Carrier Key","type":"string"},"cost_without_tax":{"description":"Cost of the order without tax in the smallest currency unit (e.g. cents for Euro)","title":"Cost without tax","type":"integer"},"cost_with_tax":{"description":"Cost of the order with tax in the smallest currency unit (e.g. cents for Euro)","title":"Cost with tax","type":"integer"},"delivery_document_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"URL of the delivery document (packing slip). Only dropshipping orders have one; null for every other fulfillment type.","title":"Delivery document URL"},"fulfillment_type":{"$ref":"#/components/schemas/FulfillmentTypes","description":"Who fulfills the order: \"dropshipping\" (the merchant ships) or \"fulfillment_by_marketplace\" (About You ships).","title":"Fulfillment type"},"shop":{"description":"Id of the shop country the order was placed in","title":"Shop country","type":"integer"},"status":{"$ref":"#/components/schemas/orders_app__models__order__Order__StatusChoices"},"customer_key":{"description":"Scayle id of the customer, as text. MAPI calls it customer_key.","maxLength":255,"title":"Customer Key","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"payment_method":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Payment method","title":"Payment Method"},"billing_street":{"description":"Billing address","maxLength":255,"title":"Billing Street","type":"string"},"billing_zip_code":{"description":"Billing zip code","maxLength":255,"title":"Billing Zip Code","type":"string"},"billing_city":{"description":"Billing city","maxLength":255,"title":"Billing City","type":"string"},"billing_country_code":{"description":"Billing country code","maxLength":2,"title":"Billing Country Code","type":"string"},"billing_recipient_gender":{"anyOf":[{"maxLength":1,"type":"string"},{"type":"null"}],"description":"Gender of the recipient","title":"Billing Recipient Gender"},"billing_recipient_first_name":{"description":"First name of the recipient","maxLength":255,"title":"Billing Recipient First Name","type":"string"},"billing_recipient_last_name":{"description":"Last name of the recipient","maxLength":255,"title":"Billing Recipient Last Name","type":"string"},"billing_additional":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Additional billing information","title":"Billing Additional"},"shipping_street":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Shipping address","title":"Shipping Street"},"shipping_zip_code":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Shipping zip code","title":"Shipping Zip Code"},"shipping_city":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Shipping city","title":"Shipping City"},"shipping_country_code":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"description":"Shipping country","title":"Shipping Country Code"},"shipping_additional":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Additional shipping information","title":"Shipping Additional"},"shipping_collection_point_key":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"default":"","description":"Shipping collection point key","title":"Shipping Collection Point Key"},"shipping_collection_point_type":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"default":"","description":"Shipping collection point type","title":"Shipping Collection Point Type"},"shipping_collection_point_description":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"default":"","description":"Shipping collection point description","title":"Shipping Collection Point Description"},"customer_phone":{"anyOf":[{"maxLength":50,"type":"string"},{"type":"null"}],"default":"","description":"Customer phone number for collection point delivery notifications","title":"Customer Phone"},"customer_email":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"default":"","description":"Customer email address for collection point delivery notifications","title":"Customer Email"},"shipping_recipient_gender":{"anyOf":[{"maxLength":1,"type":"string"},{"type":"null"}],"description":"Gender of the recipient","title":"Shipping Recipient Gender"},"shipping_recipient_first_name":{"description":"First name of the recipient","maxLength":255,"title":"Shipping Recipient First Name","type":"string"},"shipping_recipient_last_name":{"description":"Last name of the recipient","maxLength":255,"title":"Shipping Recipient Last Name","type":"string"},"currency_code":{"description":"Currency code","maxLength":3,"title":"Currency Code","type":"string"}},"required":["order_items","order_number","carrier_key","cost_without_tax","cost_with_tax","delivery_document_url","fulfillment_type","shop","status","customer_key","created_at","updated_at","billing_street","billing_zip_code","billing_city","billing_country_code","billing_recipient_first_name","billing_recipient_last_name","shipping_recipient_first_name","shipping_recipient_last_name","currency_code"],"title":"GetOrderSchema","type":"object"},"OrderItemSchema":{"properties":{"return_tracking_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Return Tracking Key"},"shipment_tracking_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shipment Tracking Key"},"sku":{"description":"SKU of the product variant","title":"SKU","type":"string"},"status":{"$ref":"#/components/schemas/orders_app__models__order_item__OrderItem__StatusChoices"},"id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"ID"},"vat":{"default":19,"description":"The tax percentage","title":"Vat","type":"number"},"price_without_tax":{"description":"Price of the product excluding tax in the smallest currency unit (e.g. cents for Euro)","title":"Price Without Tax","type":"integer"},"price_with_tax":{"description":"Price of the product including tax in the smallest currency unit (e.g. cents for Euro)","title":"Price With Tax","type":"integer"}},"required":["return_tracking_key","shipment_tracking_key","sku","status","price_without_tax","price_with_tax"],"title":"OrderItemSchema","type":"object"},"orders_app__models__order_item__OrderItem__StatusChoices":{"enum":["open","shipped","cancelled","returned"],"title":"StatusChoices","type":"string"},"FulfillmentTypes":{"enum":["dropshipping","fulfillment_by_marketplace"],"title":"FulfillmentTypes","type":"string"},"orders_app__models__order__Order__StatusChoices":{"enum":["open","shipped","cancelled","returned","mixed"],"title":"StatusChoices","type":"string"}}},"paths":{"/api/v1/webhooks/order-created":{"post":{"operationId":"scapi_app_endpoints_webhook_api_order_created_webhook","summary":"Order Created Webhook","parameters":[],"responses":{"200":{"description":"OK"}},"description":"This is a dummy endpoint that demonstrates the webhook payload structure that will be sent\nto webhook subscribers when an order.created event occurs.\n\nThe actual webhooks will be sent asynchronously to the URLs specified in the webhook\nsubscriptions that are subscribed to the order.created event type.\n\nThe webhook payload includes:\n- id: ID of the webhook message\n- event: The event type (order.created)\n- timestamp: When the event occurred\n- subscription_id: ID of the webhook subscription\n- message: The order data in the same format as the GET /orders/{id} endpoint","tags":["Webhook Messages"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderCreatedWebhookSchema"}}},"required":true}}}}}
```


# Order Status Update Webhooks

## Order Updated Webhook

> This is a dummy endpoint that demonstrates the webhook payload structure that will be sent\
> to webhook subscribers when an order.updated event occurs.\
> \
> The order.updated event is triggered whenever an order's status changes. This is the\
> recommended webhook for tracking order status changes.\
> \
> The actual webhooks will be sent asynchronously to the URLs specified in the webhook\
> subscriptions that are subscribed to the order.updated event type.\
> \
> The webhook payload includes:\
> \- id: ID of the webhook message\
> \- event: The event type (order.updated)\
> \- timestamp: When the event occurred\
> \- subscription\_id: ID of the webhook subscription\
> \- message: The order data in the same format as the GET /orders/{id} endpoint

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"OrderUpdatedWebhookSchema":{"properties":{"id":{"description":"ID of the webhook message","minimum":1,"title":"Id","type":"integer"},"event":{"const":"order.updated","description":"Event type of webhook message","title":"Event","type":"string"},"timestamp":{"description":"UTC timestamp when the event was created","format":"date-time","title":"Timestamp","type":"string"},"message":{"$ref":"#/components/schemas/GetOrderSchema","description":"Order payload of the triggered event"},"subscription_id":{"anyOf":[{"description":"ID (integer) of this property","minimum":1,"type":"integer"},{"type":"null"}],"description":"ID of the subscription","title":"Subscription Id"}},"required":["id","event","message"],"title":"OrderUpdatedWebhookSchema","type":"object"},"GetOrderSchema":{"properties":{"order_items":{"description":"List of order items","items":{"$ref":"#/components/schemas/OrderItemSchema"},"title":"Order items","type":"array"},"order_number":{"description":"Order number of the order","title":"Order number","type":"string"},"carrier_key":{"description":"Carrier key from the Carrier model.","title":"Carrier Key","type":"string"},"cost_without_tax":{"description":"Cost of the order without tax in the smallest currency unit (e.g. cents for Euro)","title":"Cost without tax","type":"integer"},"cost_with_tax":{"description":"Cost of the order with tax in the smallest currency unit (e.g. cents for Euro)","title":"Cost with tax","type":"integer"},"delivery_document_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"URL of the delivery document (packing slip). Only dropshipping orders have one; null for every other fulfillment type.","title":"Delivery document URL"},"fulfillment_type":{"$ref":"#/components/schemas/FulfillmentTypes","description":"Who fulfills the order: \"dropshipping\" (the merchant ships) or \"fulfillment_by_marketplace\" (About You ships).","title":"Fulfillment type"},"shop":{"description":"Id of the shop country the order was placed in","title":"Shop country","type":"integer"},"status":{"$ref":"#/components/schemas/orders_app__models__order__Order__StatusChoices"},"customer_key":{"description":"Scayle id of the customer, as text. MAPI calls it customer_key.","maxLength":255,"title":"Customer Key","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"payment_method":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Payment method","title":"Payment Method"},"billing_street":{"description":"Billing address","maxLength":255,"title":"Billing Street","type":"string"},"billing_zip_code":{"description":"Billing zip code","maxLength":255,"title":"Billing Zip Code","type":"string"},"billing_city":{"description":"Billing city","maxLength":255,"title":"Billing City","type":"string"},"billing_country_code":{"description":"Billing country code","maxLength":2,"title":"Billing Country Code","type":"string"},"billing_recipient_gender":{"anyOf":[{"maxLength":1,"type":"string"},{"type":"null"}],"description":"Gender of the recipient","title":"Billing Recipient Gender"},"billing_recipient_first_name":{"description":"First name of the recipient","maxLength":255,"title":"Billing Recipient First Name","type":"string"},"billing_recipient_last_name":{"description":"Last name of the recipient","maxLength":255,"title":"Billing Recipient Last Name","type":"string"},"billing_additional":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Additional billing information","title":"Billing Additional"},"shipping_street":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Shipping address","title":"Shipping Street"},"shipping_zip_code":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Shipping zip code","title":"Shipping Zip Code"},"shipping_city":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Shipping city","title":"Shipping City"},"shipping_country_code":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"description":"Shipping country","title":"Shipping Country Code"},"shipping_additional":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Additional shipping information","title":"Shipping Additional"},"shipping_collection_point_key":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"default":"","description":"Shipping collection point key","title":"Shipping Collection Point Key"},"shipping_collection_point_type":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"default":"","description":"Shipping collection point type","title":"Shipping Collection Point Type"},"shipping_collection_point_description":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"default":"","description":"Shipping collection point description","title":"Shipping Collection Point Description"},"customer_phone":{"anyOf":[{"maxLength":50,"type":"string"},{"type":"null"}],"default":"","description":"Customer phone number for collection point delivery notifications","title":"Customer Phone"},"customer_email":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"default":"","description":"Customer email address for collection point delivery notifications","title":"Customer Email"},"shipping_recipient_gender":{"anyOf":[{"maxLength":1,"type":"string"},{"type":"null"}],"description":"Gender of the recipient","title":"Shipping Recipient Gender"},"shipping_recipient_first_name":{"description":"First name of the recipient","maxLength":255,"title":"Shipping Recipient First Name","type":"string"},"shipping_recipient_last_name":{"description":"Last name of the recipient","maxLength":255,"title":"Shipping Recipient Last Name","type":"string"},"currency_code":{"description":"Currency code","maxLength":3,"title":"Currency Code","type":"string"}},"required":["order_items","order_number","carrier_key","cost_without_tax","cost_with_tax","delivery_document_url","fulfillment_type","shop","status","customer_key","created_at","updated_at","billing_street","billing_zip_code","billing_city","billing_country_code","billing_recipient_first_name","billing_recipient_last_name","shipping_recipient_first_name","shipping_recipient_last_name","currency_code"],"title":"GetOrderSchema","type":"object"},"OrderItemSchema":{"properties":{"return_tracking_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Return Tracking Key"},"shipment_tracking_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shipment Tracking Key"},"sku":{"description":"SKU of the product variant","title":"SKU","type":"string"},"status":{"$ref":"#/components/schemas/orders_app__models__order_item__OrderItem__StatusChoices"},"id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"ID"},"vat":{"default":19,"description":"The tax percentage","title":"Vat","type":"number"},"price_without_tax":{"description":"Price of the product excluding tax in the smallest currency unit (e.g. cents for Euro)","title":"Price Without Tax","type":"integer"},"price_with_tax":{"description":"Price of the product including tax in the smallest currency unit (e.g. cents for Euro)","title":"Price With Tax","type":"integer"}},"required":["return_tracking_key","shipment_tracking_key","sku","status","price_without_tax","price_with_tax"],"title":"OrderItemSchema","type":"object"},"orders_app__models__order_item__OrderItem__StatusChoices":{"enum":["open","shipped","cancelled","returned"],"title":"StatusChoices","type":"string"},"FulfillmentTypes":{"enum":["dropshipping","fulfillment_by_marketplace"],"title":"FulfillmentTypes","type":"string"},"orders_app__models__order__Order__StatusChoices":{"enum":["open","shipped","cancelled","returned","mixed"],"title":"StatusChoices","type":"string"}}},"paths":{"/api/v1/webhooks/order-updated":{"post":{"operationId":"scapi_app_endpoints_webhook_api_order_updated_webhook","summary":"Order Updated Webhook","parameters":[],"responses":{"200":{"description":"OK"}},"description":"This is a dummy endpoint that demonstrates the webhook payload structure that will be sent\nto webhook subscribers when an order.updated event occurs.\n\nThe order.updated event is triggered whenever an order's status changes. This is the\nrecommended webhook for tracking order status changes.\n\nThe actual webhooks will be sent asynchronously to the URLs specified in the webhook\nsubscriptions that are subscribed to the order.updated event type.\n\nThe webhook payload includes:\n- id: ID of the webhook message\n- event: The event type (order.updated)\n- timestamp: When the event occurred\n- subscription_id: ID of the webhook subscription\n- message: The order data in the same format as the GET /orders/{id} endpoint","tags":["Webhook Messages"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderUpdatedWebhookSchema"}}},"required":true}}}}}
```

## Order Shipped Webhook

> \*\*Deprecated\*\*: Please use the Order Updated Webhook (order.updated) or the Order Item\
> Status Webhooks (order\_items.shipped) instead.\
> \
> This is a dummy endpoint that demonstrates the webhook payload structure that will be sent\
> to webhook subscribers when an order.shipped event occurs.\
> \
> The actual webhooks will be sent asynchronously to the URLs specified in the webhook\
> subscriptions that are subscribed to the order.shipped event type.\
> \
> The webhook payload includes:\
> \- id: ID of the webhook message\
> \- event: The event type (order.shipped)\
> \- timestamp: When the event occurred\
> \- subscription\_id: ID of the webhook subscription\
> \- message: The order data in the same format as the GET /orders/{id} endpoint

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"OrderShippedWebhookSchema":{"properties":{"id":{"description":"ID of the webhook message","minimum":1,"title":"Id","type":"integer"},"event":{"const":"order.shipped","description":"Event type of webhook message","title":"Event","type":"string"},"timestamp":{"description":"UTC timestamp when the event was created","format":"date-time","title":"Timestamp","type":"string"},"message":{"$ref":"#/components/schemas/GetOrderSchema","description":"Order payload of the triggered event"},"subscription_id":{"anyOf":[{"description":"ID (integer) of this property","minimum":1,"type":"integer"},{"type":"null"}],"description":"ID of the subscription","title":"Subscription Id"}},"required":["id","event","message"],"title":"OrderShippedWebhookSchema","type":"object"},"GetOrderSchema":{"properties":{"order_items":{"description":"List of order items","items":{"$ref":"#/components/schemas/OrderItemSchema"},"title":"Order items","type":"array"},"order_number":{"description":"Order number of the order","title":"Order number","type":"string"},"carrier_key":{"description":"Carrier key from the Carrier model.","title":"Carrier Key","type":"string"},"cost_without_tax":{"description":"Cost of the order without tax in the smallest currency unit (e.g. cents for Euro)","title":"Cost without tax","type":"integer"},"cost_with_tax":{"description":"Cost of the order with tax in the smallest currency unit (e.g. cents for Euro)","title":"Cost with tax","type":"integer"},"delivery_document_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"URL of the delivery document (packing slip). Only dropshipping orders have one; null for every other fulfillment type.","title":"Delivery document URL"},"fulfillment_type":{"$ref":"#/components/schemas/FulfillmentTypes","description":"Who fulfills the order: \"dropshipping\" (the merchant ships) or \"fulfillment_by_marketplace\" (About You ships).","title":"Fulfillment type"},"shop":{"description":"Id of the shop country the order was placed in","title":"Shop country","type":"integer"},"status":{"$ref":"#/components/schemas/orders_app__models__order__Order__StatusChoices"},"customer_key":{"description":"Scayle id of the customer, as text. MAPI calls it customer_key.","maxLength":255,"title":"Customer Key","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"payment_method":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Payment method","title":"Payment Method"},"billing_street":{"description":"Billing address","maxLength":255,"title":"Billing Street","type":"string"},"billing_zip_code":{"description":"Billing zip code","maxLength":255,"title":"Billing Zip Code","type":"string"},"billing_city":{"description":"Billing city","maxLength":255,"title":"Billing City","type":"string"},"billing_country_code":{"description":"Billing country code","maxLength":2,"title":"Billing Country Code","type":"string"},"billing_recipient_gender":{"anyOf":[{"maxLength":1,"type":"string"},{"type":"null"}],"description":"Gender of the recipient","title":"Billing Recipient Gender"},"billing_recipient_first_name":{"description":"First name of the recipient","maxLength":255,"title":"Billing Recipient First Name","type":"string"},"billing_recipient_last_name":{"description":"Last name of the recipient","maxLength":255,"title":"Billing Recipient Last Name","type":"string"},"billing_additional":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Additional billing information","title":"Billing Additional"},"shipping_street":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Shipping address","title":"Shipping Street"},"shipping_zip_code":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Shipping zip code","title":"Shipping Zip Code"},"shipping_city":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Shipping city","title":"Shipping City"},"shipping_country_code":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"description":"Shipping country","title":"Shipping Country Code"},"shipping_additional":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Additional shipping information","title":"Shipping Additional"},"shipping_collection_point_key":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"default":"","description":"Shipping collection point key","title":"Shipping Collection Point Key"},"shipping_collection_point_type":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"default":"","description":"Shipping collection point type","title":"Shipping Collection Point Type"},"shipping_collection_point_description":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"default":"","description":"Shipping collection point description","title":"Shipping Collection Point Description"},"customer_phone":{"anyOf":[{"maxLength":50,"type":"string"},{"type":"null"}],"default":"","description":"Customer phone number for collection point delivery notifications","title":"Customer Phone"},"customer_email":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"default":"","description":"Customer email address for collection point delivery notifications","title":"Customer Email"},"shipping_recipient_gender":{"anyOf":[{"maxLength":1,"type":"string"},{"type":"null"}],"description":"Gender of the recipient","title":"Shipping Recipient Gender"},"shipping_recipient_first_name":{"description":"First name of the recipient","maxLength":255,"title":"Shipping Recipient First Name","type":"string"},"shipping_recipient_last_name":{"description":"Last name of the recipient","maxLength":255,"title":"Shipping Recipient Last Name","type":"string"},"currency_code":{"description":"Currency code","maxLength":3,"title":"Currency Code","type":"string"}},"required":["order_items","order_number","carrier_key","cost_without_tax","cost_with_tax","delivery_document_url","fulfillment_type","shop","status","customer_key","created_at","updated_at","billing_street","billing_zip_code","billing_city","billing_country_code","billing_recipient_first_name","billing_recipient_last_name","shipping_recipient_first_name","shipping_recipient_last_name","currency_code"],"title":"GetOrderSchema","type":"object"},"OrderItemSchema":{"properties":{"return_tracking_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Return Tracking Key"},"shipment_tracking_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shipment Tracking Key"},"sku":{"description":"SKU of the product variant","title":"SKU","type":"string"},"status":{"$ref":"#/components/schemas/orders_app__models__order_item__OrderItem__StatusChoices"},"id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"ID"},"vat":{"default":19,"description":"The tax percentage","title":"Vat","type":"number"},"price_without_tax":{"description":"Price of the product excluding tax in the smallest currency unit (e.g. cents for Euro)","title":"Price Without Tax","type":"integer"},"price_with_tax":{"description":"Price of the product including tax in the smallest currency unit (e.g. cents for Euro)","title":"Price With Tax","type":"integer"}},"required":["return_tracking_key","shipment_tracking_key","sku","status","price_without_tax","price_with_tax"],"title":"OrderItemSchema","type":"object"},"orders_app__models__order_item__OrderItem__StatusChoices":{"enum":["open","shipped","cancelled","returned"],"title":"StatusChoices","type":"string"},"FulfillmentTypes":{"enum":["dropshipping","fulfillment_by_marketplace"],"title":"FulfillmentTypes","type":"string"},"orders_app__models__order__Order__StatusChoices":{"enum":["open","shipped","cancelled","returned","mixed"],"title":"StatusChoices","type":"string"}}},"paths":{"/api/v1/webhooks/order-shipped":{"post":{"operationId":"scapi_app_endpoints_webhook_api_order_shipped_webhook","summary":"Order Shipped Webhook","parameters":[],"responses":{"200":{"description":"OK"}},"description":"**Deprecated**: Please use the Order Updated Webhook (order.updated) or the Order Item\nStatus Webhooks (order_items.shipped) instead.\n\nThis is a dummy endpoint that demonstrates the webhook payload structure that will be sent\nto webhook subscribers when an order.shipped event occurs.\n\nThe actual webhooks will be sent asynchronously to the URLs specified in the webhook\nsubscriptions that are subscribed to the order.shipped event type.\n\nThe webhook payload includes:\n- id: ID of the webhook message\n- event: The event type (order.shipped)\n- timestamp: When the event occurred\n- subscription_id: ID of the webhook subscription\n- message: The order data in the same format as the GET /orders/{id} endpoint","tags":["Webhook Messages"],"deprecated":true,"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderShippedWebhookSchema"}}},"required":true}}}}}
```

## Order Cancelled Webhook

> \*\*Deprecated\*\*: Please use the Order Updated Webhook (order.updated) or the Order Item\
> Status Webhooks (order\_items.cancelled) instead.\
> \
> This is a dummy endpoint that demonstrates the webhook payload structure that will be sent\
> to webhook subscribers when an order.cancelled event occurs.\
> \
> The actual webhooks will be sent asynchronously to the URLs specified in the webhook\
> subscriptions that are subscribed to the order.cancelled event type.\
> \
> The webhook payload includes:\
> \- id: ID of the webhook message\
> \- event: The event type (order.cancelled)\
> \- timestamp: When the event occurred\
> \- subscription\_id: ID of the webhook subscription\
> \- message: The order data in the same format as the GET /orders/{id} endpoint

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"OrderCancelledWebhookSchema":{"properties":{"id":{"description":"ID of the webhook message","minimum":1,"title":"Id","type":"integer"},"event":{"const":"order.cancelled","description":"Event type of webhook message","title":"Event","type":"string"},"timestamp":{"description":"UTC timestamp when the event was created","format":"date-time","title":"Timestamp","type":"string"},"message":{"$ref":"#/components/schemas/GetOrderSchema","description":"Order payload of the triggered event"},"subscription_id":{"anyOf":[{"description":"ID (integer) of this property","minimum":1,"type":"integer"},{"type":"null"}],"description":"ID of the subscription","title":"Subscription Id"}},"required":["id","event","message"],"title":"OrderCancelledWebhookSchema","type":"object"},"GetOrderSchema":{"properties":{"order_items":{"description":"List of order items","items":{"$ref":"#/components/schemas/OrderItemSchema"},"title":"Order items","type":"array"},"order_number":{"description":"Order number of the order","title":"Order number","type":"string"},"carrier_key":{"description":"Carrier key from the Carrier model.","title":"Carrier Key","type":"string"},"cost_without_tax":{"description":"Cost of the order without tax in the smallest currency unit (e.g. cents for Euro)","title":"Cost without tax","type":"integer"},"cost_with_tax":{"description":"Cost of the order with tax in the smallest currency unit (e.g. cents for Euro)","title":"Cost with tax","type":"integer"},"delivery_document_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"URL of the delivery document (packing slip). Only dropshipping orders have one; null for every other fulfillment type.","title":"Delivery document URL"},"fulfillment_type":{"$ref":"#/components/schemas/FulfillmentTypes","description":"Who fulfills the order: \"dropshipping\" (the merchant ships) or \"fulfillment_by_marketplace\" (About You ships).","title":"Fulfillment type"},"shop":{"description":"Id of the shop country the order was placed in","title":"Shop country","type":"integer"},"status":{"$ref":"#/components/schemas/orders_app__models__order__Order__StatusChoices"},"customer_key":{"description":"Scayle id of the customer, as text. MAPI calls it customer_key.","maxLength":255,"title":"Customer Key","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"payment_method":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Payment method","title":"Payment Method"},"billing_street":{"description":"Billing address","maxLength":255,"title":"Billing Street","type":"string"},"billing_zip_code":{"description":"Billing zip code","maxLength":255,"title":"Billing Zip Code","type":"string"},"billing_city":{"description":"Billing city","maxLength":255,"title":"Billing City","type":"string"},"billing_country_code":{"description":"Billing country code","maxLength":2,"title":"Billing Country Code","type":"string"},"billing_recipient_gender":{"anyOf":[{"maxLength":1,"type":"string"},{"type":"null"}],"description":"Gender of the recipient","title":"Billing Recipient Gender"},"billing_recipient_first_name":{"description":"First name of the recipient","maxLength":255,"title":"Billing Recipient First Name","type":"string"},"billing_recipient_last_name":{"description":"Last name of the recipient","maxLength":255,"title":"Billing Recipient Last Name","type":"string"},"billing_additional":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Additional billing information","title":"Billing Additional"},"shipping_street":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Shipping address","title":"Shipping Street"},"shipping_zip_code":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Shipping zip code","title":"Shipping Zip Code"},"shipping_city":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Shipping city","title":"Shipping City"},"shipping_country_code":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"description":"Shipping country","title":"Shipping Country Code"},"shipping_additional":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Additional shipping information","title":"Shipping Additional"},"shipping_collection_point_key":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"default":"","description":"Shipping collection point key","title":"Shipping Collection Point Key"},"shipping_collection_point_type":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"default":"","description":"Shipping collection point type","title":"Shipping Collection Point Type"},"shipping_collection_point_description":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"default":"","description":"Shipping collection point description","title":"Shipping Collection Point Description"},"customer_phone":{"anyOf":[{"maxLength":50,"type":"string"},{"type":"null"}],"default":"","description":"Customer phone number for collection point delivery notifications","title":"Customer Phone"},"customer_email":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"default":"","description":"Customer email address for collection point delivery notifications","title":"Customer Email"},"shipping_recipient_gender":{"anyOf":[{"maxLength":1,"type":"string"},{"type":"null"}],"description":"Gender of the recipient","title":"Shipping Recipient Gender"},"shipping_recipient_first_name":{"description":"First name of the recipient","maxLength":255,"title":"Shipping Recipient First Name","type":"string"},"shipping_recipient_last_name":{"description":"Last name of the recipient","maxLength":255,"title":"Shipping Recipient Last Name","type":"string"},"currency_code":{"description":"Currency code","maxLength":3,"title":"Currency Code","type":"string"}},"required":["order_items","order_number","carrier_key","cost_without_tax","cost_with_tax","delivery_document_url","fulfillment_type","shop","status","customer_key","created_at","updated_at","billing_street","billing_zip_code","billing_city","billing_country_code","billing_recipient_first_name","billing_recipient_last_name","shipping_recipient_first_name","shipping_recipient_last_name","currency_code"],"title":"GetOrderSchema","type":"object"},"OrderItemSchema":{"properties":{"return_tracking_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Return Tracking Key"},"shipment_tracking_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shipment Tracking Key"},"sku":{"description":"SKU of the product variant","title":"SKU","type":"string"},"status":{"$ref":"#/components/schemas/orders_app__models__order_item__OrderItem__StatusChoices"},"id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"ID"},"vat":{"default":19,"description":"The tax percentage","title":"Vat","type":"number"},"price_without_tax":{"description":"Price of the product excluding tax in the smallest currency unit (e.g. cents for Euro)","title":"Price Without Tax","type":"integer"},"price_with_tax":{"description":"Price of the product including tax in the smallest currency unit (e.g. cents for Euro)","title":"Price With Tax","type":"integer"}},"required":["return_tracking_key","shipment_tracking_key","sku","status","price_without_tax","price_with_tax"],"title":"OrderItemSchema","type":"object"},"orders_app__models__order_item__OrderItem__StatusChoices":{"enum":["open","shipped","cancelled","returned"],"title":"StatusChoices","type":"string"},"FulfillmentTypes":{"enum":["dropshipping","fulfillment_by_marketplace"],"title":"FulfillmentTypes","type":"string"},"orders_app__models__order__Order__StatusChoices":{"enum":["open","shipped","cancelled","returned","mixed"],"title":"StatusChoices","type":"string"}}},"paths":{"/api/v1/webhooks/order-cancelled":{"post":{"operationId":"scapi_app_endpoints_webhook_api_order_cancelled_webhook","summary":"Order Cancelled Webhook","parameters":[],"responses":{"200":{"description":"OK"}},"description":"**Deprecated**: Please use the Order Updated Webhook (order.updated) or the Order Item\nStatus Webhooks (order_items.cancelled) instead.\n\nThis is a dummy endpoint that demonstrates the webhook payload structure that will be sent\nto webhook subscribers when an order.cancelled event occurs.\n\nThe actual webhooks will be sent asynchronously to the URLs specified in the webhook\nsubscriptions that are subscribed to the order.cancelled event type.\n\nThe webhook payload includes:\n- id: ID of the webhook message\n- event: The event type (order.cancelled)\n- timestamp: When the event occurred\n- subscription_id: ID of the webhook subscription\n- message: The order data in the same format as the GET /orders/{id} endpoint","tags":["Webhook Messages"],"deprecated":true,"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderCancelledWebhookSchema"}}},"required":true}}}}}
```

## Order Returned Webhook

> \*\*Deprecated\*\*: Please use the Order Updated Webhook (order.updated) or the Order Item\
> Status Webhooks (order\_items.returned) instead.\
> \
> This is a dummy endpoint that demonstrates the webhook payload structure that will be sent\
> to webhook subscribers when an order.returned event occurs.\
> \
> The actual webhooks will be sent asynchronously to the URLs specified in the webhook\
> subscriptions that are subscribed to the order.returned event type.\
> \
> The webhook payload includes:\
> \- id: ID of the webhook message\
> \- event: The event type (order.returned)\
> \- timestamp: When the event occurred\
> \- subscription\_id: ID of the webhook subscription\
> \- message: The order data in the same format as the GET /orders/{id} endpoint

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"OrderReturnedWebhookSchema":{"properties":{"id":{"description":"ID of the webhook message","minimum":1,"title":"Id","type":"integer"},"event":{"const":"order.returned","description":"Event type of webhook message","title":"Event","type":"string"},"timestamp":{"description":"UTC timestamp when the event was created","format":"date-time","title":"Timestamp","type":"string"},"message":{"$ref":"#/components/schemas/GetOrderSchema","description":"Order payload of the triggered event"},"subscription_id":{"anyOf":[{"description":"ID (integer) of this property","minimum":1,"type":"integer"},{"type":"null"}],"description":"ID of the subscription","title":"Subscription Id"}},"required":["id","event","message"],"title":"OrderReturnedWebhookSchema","type":"object"},"GetOrderSchema":{"properties":{"order_items":{"description":"List of order items","items":{"$ref":"#/components/schemas/OrderItemSchema"},"title":"Order items","type":"array"},"order_number":{"description":"Order number of the order","title":"Order number","type":"string"},"carrier_key":{"description":"Carrier key from the Carrier model.","title":"Carrier Key","type":"string"},"cost_without_tax":{"description":"Cost of the order without tax in the smallest currency unit (e.g. cents for Euro)","title":"Cost without tax","type":"integer"},"cost_with_tax":{"description":"Cost of the order with tax in the smallest currency unit (e.g. cents for Euro)","title":"Cost with tax","type":"integer"},"delivery_document_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"URL of the delivery document (packing slip). Only dropshipping orders have one; null for every other fulfillment type.","title":"Delivery document URL"},"fulfillment_type":{"$ref":"#/components/schemas/FulfillmentTypes","description":"Who fulfills the order: \"dropshipping\" (the merchant ships) or \"fulfillment_by_marketplace\" (About You ships).","title":"Fulfillment type"},"shop":{"description":"Id of the shop country the order was placed in","title":"Shop country","type":"integer"},"status":{"$ref":"#/components/schemas/orders_app__models__order__Order__StatusChoices"},"customer_key":{"description":"Scayle id of the customer, as text. MAPI calls it customer_key.","maxLength":255,"title":"Customer Key","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"payment_method":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Payment method","title":"Payment Method"},"billing_street":{"description":"Billing address","maxLength":255,"title":"Billing Street","type":"string"},"billing_zip_code":{"description":"Billing zip code","maxLength":255,"title":"Billing Zip Code","type":"string"},"billing_city":{"description":"Billing city","maxLength":255,"title":"Billing City","type":"string"},"billing_country_code":{"description":"Billing country code","maxLength":2,"title":"Billing Country Code","type":"string"},"billing_recipient_gender":{"anyOf":[{"maxLength":1,"type":"string"},{"type":"null"}],"description":"Gender of the recipient","title":"Billing Recipient Gender"},"billing_recipient_first_name":{"description":"First name of the recipient","maxLength":255,"title":"Billing Recipient First Name","type":"string"},"billing_recipient_last_name":{"description":"Last name of the recipient","maxLength":255,"title":"Billing Recipient Last Name","type":"string"},"billing_additional":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Additional billing information","title":"Billing Additional"},"shipping_street":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Shipping address","title":"Shipping Street"},"shipping_zip_code":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Shipping zip code","title":"Shipping Zip Code"},"shipping_city":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Shipping city","title":"Shipping City"},"shipping_country_code":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"description":"Shipping country","title":"Shipping Country Code"},"shipping_additional":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Additional shipping information","title":"Shipping Additional"},"shipping_collection_point_key":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"default":"","description":"Shipping collection point key","title":"Shipping Collection Point Key"},"shipping_collection_point_type":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"default":"","description":"Shipping collection point type","title":"Shipping Collection Point Type"},"shipping_collection_point_description":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"default":"","description":"Shipping collection point description","title":"Shipping Collection Point Description"},"customer_phone":{"anyOf":[{"maxLength":50,"type":"string"},{"type":"null"}],"default":"","description":"Customer phone number for collection point delivery notifications","title":"Customer Phone"},"customer_email":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"default":"","description":"Customer email address for collection point delivery notifications","title":"Customer Email"},"shipping_recipient_gender":{"anyOf":[{"maxLength":1,"type":"string"},{"type":"null"}],"description":"Gender of the recipient","title":"Shipping Recipient Gender"},"shipping_recipient_first_name":{"description":"First name of the recipient","maxLength":255,"title":"Shipping Recipient First Name","type":"string"},"shipping_recipient_last_name":{"description":"Last name of the recipient","maxLength":255,"title":"Shipping Recipient Last Name","type":"string"},"currency_code":{"description":"Currency code","maxLength":3,"title":"Currency Code","type":"string"}},"required":["order_items","order_number","carrier_key","cost_without_tax","cost_with_tax","delivery_document_url","fulfillment_type","shop","status","customer_key","created_at","updated_at","billing_street","billing_zip_code","billing_city","billing_country_code","billing_recipient_first_name","billing_recipient_last_name","shipping_recipient_first_name","shipping_recipient_last_name","currency_code"],"title":"GetOrderSchema","type":"object"},"OrderItemSchema":{"properties":{"return_tracking_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Return Tracking Key"},"shipment_tracking_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shipment Tracking Key"},"sku":{"description":"SKU of the product variant","title":"SKU","type":"string"},"status":{"$ref":"#/components/schemas/orders_app__models__order_item__OrderItem__StatusChoices"},"id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"ID"},"vat":{"default":19,"description":"The tax percentage","title":"Vat","type":"number"},"price_without_tax":{"description":"Price of the product excluding tax in the smallest currency unit (e.g. cents for Euro)","title":"Price Without Tax","type":"integer"},"price_with_tax":{"description":"Price of the product including tax in the smallest currency unit (e.g. cents for Euro)","title":"Price With Tax","type":"integer"}},"required":["return_tracking_key","shipment_tracking_key","sku","status","price_without_tax","price_with_tax"],"title":"OrderItemSchema","type":"object"},"orders_app__models__order_item__OrderItem__StatusChoices":{"enum":["open","shipped","cancelled","returned"],"title":"StatusChoices","type":"string"},"FulfillmentTypes":{"enum":["dropshipping","fulfillment_by_marketplace"],"title":"FulfillmentTypes","type":"string"},"orders_app__models__order__Order__StatusChoices":{"enum":["open","shipped","cancelled","returned","mixed"],"title":"StatusChoices","type":"string"}}},"paths":{"/api/v1/webhooks/order-returned":{"post":{"operationId":"scapi_app_endpoints_webhook_api_order_returned_webhook","summary":"Order Returned Webhook","parameters":[],"responses":{"200":{"description":"OK"}},"description":"**Deprecated**: Please use the Order Updated Webhook (order.updated) or the Order Item\nStatus Webhooks (order_items.returned) instead.\n\nThis is a dummy endpoint that demonstrates the webhook payload structure that will be sent\nto webhook subscribers when an order.returned event occurs.\n\nThe actual webhooks will be sent asynchronously to the URLs specified in the webhook\nsubscriptions that are subscribed to the order.returned event type.\n\nThe webhook payload includes:\n- id: ID of the webhook message\n- event: The event type (order.returned)\n- timestamp: When the event occurred\n- subscription_id: ID of the webhook subscription\n- message: The order data in the same format as the GET /orders/{id} endpoint","tags":["Webhook Messages"],"deprecated":true,"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderReturnedWebhookSchema"}}},"required":true}}}}}
```


# Order Item Status Update Webhooks

## Order Items Shipped Webhook

> This is a dummy endpoint that demonstrates the webhook payload structure that will be sent\
> to webhook subscribers when an order\_items.shipped event occurs.\
> \
> The actual webhooks will be sent asynchronously to the URLs specified in the webhook subscriptions\
> that are subscribed to the order\_items.shipped event type.\
> \
> The webhook payload includes:\
> \- id: ID of the webhook message\
> \- event: The event type (order\_items.shipped)\
> \- timestamp: When the event occurred\
> \- subscription\_id: ID of the webhook subscription\
> \- message: The shipment data in the same format as the GET /shipments/{id} endpoint

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"ShipmentItemsShippedWebhookSchema":{"properties":{"id":{"description":"ID of the webhook message","minimum":1,"title":"Id","type":"integer"},"event":{"const":"order_items.shipped","description":"Event type of webhook message","title":"Event","type":"string"},"timestamp":{"description":"UTC timestamp when the event was created","format":"date-time","title":"Timestamp","type":"string"},"message":{"$ref":"#/components/schemas/GetShipmentSchema","description":"Shipment payload of the triggered event"},"subscription_id":{"anyOf":[{"description":"ID (integer) of this property","minimum":1,"type":"integer"},{"type":"null"}],"description":"ID of the subscription","title":"Subscription Id"}},"required":["id","event","message"],"title":"ShipmentItemsShippedWebhookSchema","type":"object"},"GetShipmentSchema":{"properties":{"items":{"description":"List of order items in this shipment","items":{"$ref":"#/components/schemas/OrderItemSchema"},"title":"Shipment items","type":"array"},"carrier_key":{"description":"Carrier key of the shipment","title":"Carrier key","type":"string"},"return_tracking_key":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"title":"Return Tracking Key"},"tracking_key":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"title":"Tracking Key"}},"required":["items","carrier_key"],"title":"GetShipmentSchema","type":"object"},"OrderItemSchema":{"properties":{"return_tracking_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Return Tracking Key"},"shipment_tracking_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shipment Tracking Key"},"sku":{"description":"SKU of the product variant","title":"SKU","type":"string"},"status":{"$ref":"#/components/schemas/orders_app__models__order_item__OrderItem__StatusChoices"},"id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"ID"},"vat":{"default":19,"description":"The tax percentage","title":"Vat","type":"number"},"price_without_tax":{"description":"Price of the product excluding tax in the smallest currency unit (e.g. cents for Euro)","title":"Price Without Tax","type":"integer"},"price_with_tax":{"description":"Price of the product including tax in the smallest currency unit (e.g. cents for Euro)","title":"Price With Tax","type":"integer"}},"required":["return_tracking_key","shipment_tracking_key","sku","status","price_without_tax","price_with_tax"],"title":"OrderItemSchema","type":"object"},"orders_app__models__order_item__OrderItem__StatusChoices":{"enum":["open","shipped","cancelled","returned"],"title":"StatusChoices","type":"string"}}},"paths":{"/api/v1/webhooks/order-items-shipped":{"post":{"operationId":"scapi_app_endpoints_webhook_api_order_items_shipped_webhook","summary":"Order Items Shipped Webhook","parameters":[],"responses":{"200":{"description":"OK"}},"description":"This is a dummy endpoint that demonstrates the webhook payload structure that will be sent\nto webhook subscribers when an order_items.shipped event occurs.\n\nThe actual webhooks will be sent asynchronously to the URLs specified in the webhook subscriptions\nthat are subscribed to the order_items.shipped event type.\n\nThe webhook payload includes:\n- id: ID of the webhook message\n- event: The event type (order_items.shipped)\n- timestamp: When the event occurred\n- subscription_id: ID of the webhook subscription\n- message: The shipment data in the same format as the GET /shipments/{id} endpoint","tags":["Webhook Messages"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentItemsShippedWebhookSchema"}}},"required":true}}}}}
```

## Order Items Cancelled Webhook

> This is a dummy endpoint that demonstrates the webhook payload structure that will be sent\
> to webhook subscribers when an order\_items.cancelled event occurs.\
> \
> The actual webhooks will be sent asynchronously to the URLs specified in the webhook subscriptions\
> that are subscribed to the order\_items.cancelled event type.\
> \
> The webhook payload includes:\
> \- id: ID of the webhook message\
> \- event: The event type (order\_items.cancelled)\
> \- timestamp: When the event occurred\
> \- subscription\_id: ID of the webhook subscription\
> \- message: The shipment data in the same format as the GET /shipments/{id} endpoint

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"ShipmentItemsCancelledWebhookSchema":{"properties":{"id":{"description":"ID of the webhook message","minimum":1,"title":"Id","type":"integer"},"event":{"const":"order_items.cancelled","description":"Event type of webhook message","title":"Event","type":"string"},"timestamp":{"description":"UTC timestamp when the event was created","format":"date-time","title":"Timestamp","type":"string"},"message":{"$ref":"#/components/schemas/GetShipmentSchema","description":"Shipment payload of the triggered event"},"subscription_id":{"anyOf":[{"description":"ID (integer) of this property","minimum":1,"type":"integer"},{"type":"null"}],"description":"ID of the subscription","title":"Subscription Id"}},"required":["id","event","message"],"title":"ShipmentItemsCancelledWebhookSchema","type":"object"},"GetShipmentSchema":{"properties":{"items":{"description":"List of order items in this shipment","items":{"$ref":"#/components/schemas/OrderItemSchema"},"title":"Shipment items","type":"array"},"carrier_key":{"description":"Carrier key of the shipment","title":"Carrier key","type":"string"},"return_tracking_key":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"title":"Return Tracking Key"},"tracking_key":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"title":"Tracking Key"}},"required":["items","carrier_key"],"title":"GetShipmentSchema","type":"object"},"OrderItemSchema":{"properties":{"return_tracking_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Return Tracking Key"},"shipment_tracking_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shipment Tracking Key"},"sku":{"description":"SKU of the product variant","title":"SKU","type":"string"},"status":{"$ref":"#/components/schemas/orders_app__models__order_item__OrderItem__StatusChoices"},"id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"ID"},"vat":{"default":19,"description":"The tax percentage","title":"Vat","type":"number"},"price_without_tax":{"description":"Price of the product excluding tax in the smallest currency unit (e.g. cents for Euro)","title":"Price Without Tax","type":"integer"},"price_with_tax":{"description":"Price of the product including tax in the smallest currency unit (e.g. cents for Euro)","title":"Price With Tax","type":"integer"}},"required":["return_tracking_key","shipment_tracking_key","sku","status","price_without_tax","price_with_tax"],"title":"OrderItemSchema","type":"object"},"orders_app__models__order_item__OrderItem__StatusChoices":{"enum":["open","shipped","cancelled","returned"],"title":"StatusChoices","type":"string"}}},"paths":{"/api/v1/webhooks/order-items-cancelled":{"post":{"operationId":"scapi_app_endpoints_webhook_api_order_items_cancelled_webhook","summary":"Order Items Cancelled Webhook","parameters":[],"responses":{"200":{"description":"OK"}},"description":"This is a dummy endpoint that demonstrates the webhook payload structure that will be sent\nto webhook subscribers when an order_items.cancelled event occurs.\n\nThe actual webhooks will be sent asynchronously to the URLs specified in the webhook subscriptions\nthat are subscribed to the order_items.cancelled event type.\n\nThe webhook payload includes:\n- id: ID of the webhook message\n- event: The event type (order_items.cancelled)\n- timestamp: When the event occurred\n- subscription_id: ID of the webhook subscription\n- message: The shipment data in the same format as the GET /shipments/{id} endpoint","tags":["Webhook Messages"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentItemsCancelledWebhookSchema"}}},"required":true}}}}}
```

## Order Items Returned Webhook

> This is a dummy endpoint that demonstrates the webhook payload structure that will be sent\
> to webhook subscribers when an order\_items.returned event occurs.\
> \
> The actual webhooks will be sent asynchronously to the URLs specified in the webhook subscriptions\
> that are subscribed to the order\_items.returned event type.\
> \
> The webhook payload includes:\
> \- id: ID of the webhook message\
> \- event: The event type (order\_items.returned)\
> \- timestamp: When the event occurred\
> \- subscription\_id: ID of the webhook subscription\
> \- message: The shipment data in the same format as the GET /shipments/{id} endpoint

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"ShipmentItemsReturnedWebhookSchema":{"properties":{"id":{"description":"ID of the webhook message","minimum":1,"title":"Id","type":"integer"},"event":{"const":"order_items.returned","description":"Event type of webhook message","title":"Event","type":"string"},"timestamp":{"description":"UTC timestamp when the event was created","format":"date-time","title":"Timestamp","type":"string"},"message":{"$ref":"#/components/schemas/GetShipmentSchema","description":"Shipment payload of the triggered event"},"subscription_id":{"anyOf":[{"description":"ID (integer) of this property","minimum":1,"type":"integer"},{"type":"null"}],"description":"ID of the subscription","title":"Subscription Id"}},"required":["id","event","message"],"title":"ShipmentItemsReturnedWebhookSchema","type":"object"},"GetShipmentSchema":{"properties":{"items":{"description":"List of order items in this shipment","items":{"$ref":"#/components/schemas/OrderItemSchema"},"title":"Shipment items","type":"array"},"carrier_key":{"description":"Carrier key of the shipment","title":"Carrier key","type":"string"},"return_tracking_key":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"title":"Return Tracking Key"},"tracking_key":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"title":"Tracking Key"}},"required":["items","carrier_key"],"title":"GetShipmentSchema","type":"object"},"OrderItemSchema":{"properties":{"return_tracking_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Return Tracking Key"},"shipment_tracking_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shipment Tracking Key"},"sku":{"description":"SKU of the product variant","title":"SKU","type":"string"},"status":{"$ref":"#/components/schemas/orders_app__models__order_item__OrderItem__StatusChoices"},"id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"ID"},"vat":{"default":19,"description":"The tax percentage","title":"Vat","type":"number"},"price_without_tax":{"description":"Price of the product excluding tax in the smallest currency unit (e.g. cents for Euro)","title":"Price Without Tax","type":"integer"},"price_with_tax":{"description":"Price of the product including tax in the smallest currency unit (e.g. cents for Euro)","title":"Price With Tax","type":"integer"}},"required":["return_tracking_key","shipment_tracking_key","sku","status","price_without_tax","price_with_tax"],"title":"OrderItemSchema","type":"object"},"orders_app__models__order_item__OrderItem__StatusChoices":{"enum":["open","shipped","cancelled","returned"],"title":"StatusChoices","type":"string"}}},"paths":{"/api/v1/webhooks/order-items-returned":{"post":{"operationId":"scapi_app_endpoints_webhook_api_order_items_returned_webhook","summary":"Order Items Returned Webhook","parameters":[],"responses":{"200":{"description":"OK"}},"description":"This is a dummy endpoint that demonstrates the webhook payload structure that will be sent\nto webhook subscribers when an order_items.returned event occurs.\n\nThe actual webhooks will be sent asynchronously to the URLs specified in the webhook subscriptions\nthat are subscribed to the order_items.returned event type.\n\nThe webhook payload includes:\n- id: ID of the webhook message\n- event: The event type (order_items.returned)\n- timestamp: When the event occurred\n- subscription_id: ID of the webhook subscription\n- message: The shipment data in the same format as the GET /shipments/{id} endpoint","tags":["Webhook Messages"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentItemsReturnedWebhookSchema"}}},"required":true}}}}}
```


# Product Status Update Webhook

## Product Master Status Updated Webhook

> This is a dummy endpoint that demonstrates the webhook payload structure that will be sent\
> to webhook subscribers when a product\_master.status\_updated event occurs.\
> \
> The actual webhooks will be sent asynchronously to the URLs specified in the webhook subscriptions\
> that are subscribed to the product\_master.status\_updated event type.\
> \
> The webhook payload includes:\
> \- id: ID of the webhook message\
> \- event: The event type (product\_master.status\_updated)\
> \- timestamp: When the event occurred\
> \- subscription\_id: ID of the webhook subscription\
> \- message: The product master data with status and rejection information

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"ProductMasterStatusUpdatedWebhookMessageSchema":{"properties":{"id":{"description":"ID of the webhook message","minimum":1,"title":"Id","type":"integer"},"event":{"const":"product_master.status_updated","description":"Event type of webhook message","title":"Event","type":"string"},"timestamp":{"description":"UTC timestamp when the event was created","format":"date-time","title":"Timestamp","type":"string"},"message":{"$ref":"#/components/schemas/GetProductMasterSchema","description":"Product master payload of the triggered event"},"subscription_id":{"anyOf":[{"description":"ID (integer) of this property","minimum":1,"type":"integer"},{"type":"null"}],"description":"ID of the subscription","title":"Subscription Id"}},"required":["id","event","message"],"title":"ProductMasterStatusUpdatedWebhookMessageSchema","type":"object"},"GetProductMasterSchema":{"properties":{"external_reference_key":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Style key of the product master","title":"External Reference Key"},"status":{"description":"Current status of the product master","title":"Status","type":"string"},"rejection_reasons":{"anyOf":[{"items":{"$ref":"#/components/schemas/RejectionReasonSchema"},"type":"array"},{"type":"null"}],"description":"Rejection reasons if the product master is rejected","title":"Rejection Reasons"},"rejection_message":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Rejection message if the product master is rejected","title":"Rejection Message"},"rejected_product_ids_hint":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Hint about which products are affected by rejection","title":"Rejected Product Ids Hint"}},"required":["status"],"title":"GetProductMasterSchema","type":"object"},"RejectionReasonSchema":{"properties":{"key":{"maxLength":255,"title":"Key","type":"string"},"type":{"maxLength":255,"title":"Type","type":"string"},"name":{"maxLength":255,"title":"Name","type":"string"},"description":{"title":"Description","type":"string"}},"required":["key","type","name","description"],"title":"RejectionReasonSchema","type":"object"}}},"paths":{"/api/v1/webhooks/product-master-status-updated":{"post":{"operationId":"scapi_app_endpoints_webhook_api_product_master_status_updated_webhook","summary":"Product Master Status Updated Webhook","parameters":[],"responses":{"200":{"description":"OK"}},"description":"This is a dummy endpoint that demonstrates the webhook payload structure that will be sent\nto webhook subscribers when a product_master.status_updated event occurs.\n\nThe actual webhooks will be sent asynchronously to the URLs specified in the webhook subscriptions\nthat are subscribed to the product_master.status_updated event type.\n\nThe webhook payload includes:\n- id: ID of the webhook message\n- event: The event type (product_master.status_updated)\n- timestamp: When the event occurred\n- subscription_id: ID of the webhook subscription\n- message: The product master data with status and rejection information","tags":["Webhook Messages"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductMasterStatusUpdatedWebhookMessageSchema"}}},"required":true}}}}}
```


# Stock Update Webhook

## Stock Updated Webhook

> This is a dummy endpoint that demonstrates the webhook payload structure that will be sent\
> to webhook subscribers when a stock.updated event occurs.\
> \
> The actual webhooks will be sent asynchronously to the URLs specified in the webhook subscriptions\
> that are subscribed to the stock.updated event type.\
> \
> The webhook payload includes:\
> \- id: ID of the webhook message\
> \- event: The event type (stock.updated)\
> \- timestamp: When the event occurred\
> \- subscription\_id: ID of the webhook subscription\
> \- message: The stock data in the same format as the GET /stock endpoint

```json
{"openapi":"3.1.0","info":{"title":"Sellers Center API","version":"1.3.3"},"security":[{"APIKeyAuth":[]}],"components":{"securitySchemes":{"APIKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"StockWebhookMessageSchema":{"properties":{"id":{"description":"ID of the webhook message","minimum":1,"title":"Id","type":"integer"},"event":{"const":"stock.updated","description":"Event type of webhook message","title":"Event","type":"string"},"timestamp":{"description":"UTC timestamp when the event was created","format":"date-time","title":"Timestamp","type":"string"},"message":{"description":"Stock payload of the triggered event","items":{"$ref":"#/components/schemas/WebhookStockSchema"},"title":"Message","type":"array"},"subscription_id":{"anyOf":[{"description":"ID (integer) of this property","minimum":1,"type":"integer"},{"type":"null"}],"description":"ID of the subscription","title":"Subscription Id"}},"required":["id","event","message"],"title":"StockWebhookMessageSchema","type":"object"},"WebhookStockSchema":{"properties":{"sku":{"description":"Stock Keeping Unit identifier","maxLength":120,"title":"Sku","type":"string"},"quantity":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Stock quantity of the product variant in the merchant's warehouse.","title":"Quantity"},"quantity_fbm":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Stock quantity of the product variant in ABOUT YOU warehouses.","title":"Quantity Fbm"}},"required":["sku","quantity","quantity_fbm"],"title":"WebhookStockSchema","type":"object"}}},"paths":{"/api/v1/webhooks/stock-updated":{"post":{"operationId":"scapi_app_endpoints_webhook_api_stock_updated_webhook","summary":"Stock Updated Webhook","parameters":[],"responses":{"200":{"description":"OK"}},"description":"This is a dummy endpoint that demonstrates the webhook payload structure that will be sent\nto webhook subscribers when a stock.updated event occurs.\n\nThe actual webhooks will be sent asynchronously to the URLs specified in the webhook subscriptions\nthat are subscribed to the stock.updated event type.\n\nThe webhook payload includes:\n- id: ID of the webhook message\n- event: The event type (stock.updated)\n- timestamp: When the event occurred\n- subscription_id: ID of the webhook subscription\n- message: The stock data in the same format as the GET /stock endpoint","tags":["Webhook Messages"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockWebhookMessageSchema"}}},"required":true}}}}}
```


# Mirror Merchant Overview

{% hint style="info" %}
📌 **Important Notice**: This section is exclusively intended for merchants who have transitioned from the DS/FbAY model to the marketplace model via the mirror approach and continue to manage their products and prices using SCAYLE. This area serves as your source of truth for relevant guidelines and updates.
{% endhint %}

## ABOUT YOU Marketplace Model Overview

The ABOUT YOU Marketplace enables fashion brands and retailers to sell directly to millions of customers across Europe. By leveraging our established online platform, merchants expand their international reach while ABOUT YOU handles customer transactions and payment processing via SCAYLE Payments.

**How the Technical & Operational Flow Works**

* **Catalog & Data Sync:** Merchants connect their catalog to ABOUT YOU via their middleware, seamlessly transmitting all product data, inventory, and pricing.
* **Order Processing:** When a customer places an order, ABOUT YOU processes the payment and automatically routes order details to the merchant through the same interface.
* **Fulfillment & Returns:** Merchants handle warehousing, packing, and direct-to-customer shipping. Customer returns are processed directly back to the merchant's warehouse.
* **Settlements:** Payments are collected by ABOUT YOU via SCAYLE Payments, with payouts disbursed to merchants on a predictable monthly schedule.

This end-to-end setup ensures a streamlined partnership—allowing merchants to focus on product selection while ABOUT YOU powers the platform infrastructure and payment operations.

***

Welcome to your Transition Guide!

As you transition to the marketplace model, your core daily workflow remains completely unchanged—you will continue to manage and steer your products directly in SCAYLE, just as you did before.

However, this transition introduces a few important changes, most notably your full price sovereignty and complete control over price steering. Because you do not yet have direct access to the Seller Center, standard Seller Center documentation does not apply to you. This dedicated guide serves as your single source of truth, detailing the key processes—from price updates to product mapping—that are managed differently for mirror merchants.<br>


# Key Services and Logistics Requirements

{% hint style="info" %}
Below is a brief refresher summarizing our core service and logistics standards. As a transitioning merchant, these key requirements should already be familiar to you, but we’ve gathered them here as a quick reference guide to keep in mind.
{% endhint %}

Below are the key services and logistics requirements for a successful integration and efficient live business. By fulfilling these requirements, you help ensure a smooth, reliable experience for both customers and partners. All details regarding shipment, returns, packaging, and communication have been carefully designed to uphold About You’s service quality and brand promise.

***

### Shipment

Orders must be dispatched within 24 hours of order creation (MO-SAT) and delivered with one of the specified Last Mile Carriers (LMC) below within 72 to 96 hours of order creation.&#x20;

Please find below an overview of all available LMCs for the respective countries, as well as the required delivery options (home delivery vs. PUDO).

<table><thead><tr><th width="153">Shop Country</th><th width="165.79998779296875">Last Mile Carrier (for both delivery and return)</th><th width="190.00006103515625">Mandatory Delivery Options</th><th>Optional Delivery Options</th></tr></thead><tbody><tr><td>Germany</td><td>DHL, HERMES</td><td>Home Delivery</td><td>PUDO (DHL, Hermes) </td></tr><tr><td>Austria</td><td>POST AT (preferred), DHL</td><td>Home Delivery</td><td>PUDO (Post AT)</td></tr><tr><td>Switzerland</td><td>CH Post</td><td>Home Delivery</td><td></td></tr><tr><td>Belgium</td><td>BPOST (preferred), DHL</td><td>Home Delivery/PUDO</td><td>PUDO (BPOST)</td></tr><tr><td>Luxembourg</td><td>LU POST</td><td>Home Delivery</td><td>-</td></tr><tr><td>The Netherlands</td><td>POST NL (preferred), DHL NL</td><td>Home Delivery</td><td>PUDO (Post NL)</td></tr><tr><td>France</td><td>COLISSIMO</td><td>Home Delivery/PUDO</td><td>-</td></tr><tr><td>Poland</td><td>Inpost</td><td>Home Delivery/PUDO</td><td>-</td></tr><tr><td>Italy</td><td>POSTEITALIANE (preferred), DHL</td><td>Home Delivery</td><td>PUDO (POSTEITALIANE)</td></tr><tr><td>Denmark</td><td>GLS</td><td>Home Delivery/PUDO</td><td>-</td></tr><tr><td>Sweden</td><td>DHL SE</td><td>PUDO</td><td>-</td></tr><tr><td>Finland</td><td>POSTI</td><td>PUDO</td><td>-</td></tr><tr><td>Spain</td><td>SEUR (preferred), DHL, CORREOS</td><td>Home Delivery</td><td>PUDO (SEUR)</td></tr><tr><td>Czech Republic</td><td>Zásilkovna (preferred), PPL</td><td>Home Delivery/PUDO</td><td>-</td></tr><tr><td>Lithuania</td><td>Omniva</td><td>Home Delivery/PUDO</td><td>-</td></tr><tr><td>Latvia</td><td>Omniva</td><td>Home Delivery/PUDO</td><td>-</td></tr><tr><td>Estonia</td><td>Omniva</td><td>Home Delivery/PUDO</td><td>-</td></tr><tr><td>Slovakia</td><td>SK Post</td><td>Home Delivery/PUDO</td><td>-</td></tr><tr><td>Slovenia</td><td>SI Post</td><td>Home Delivery</td><td>PUDO</td></tr><tr><td>Croatia</td><td>HR Post</td><td>Home Delivery</td><td>PUDO</td></tr><tr><td>Romania</td><td>FAN RO</td><td>Home Delivery</td><td>PUDO</td></tr><tr><td>Hungary</td><td>GLS (preferred), HU Post</td><td>Home Delivery/PUDO</td><td>-</td></tr><tr><td>Bulgaria</td><td>Ekont</td><td>Home Delivery/PUDO</td><td>-</td></tr><tr><td>Greece</td><td>ACS </td><td>Home Delivery</td><td>PUDO</td></tr><tr><td>Portugal</td><td>CTT </td><td>Home Delivery</td><td>PUDO</td></tr><tr><td>Cyprus</td><td>ACS </td><td>Home Delivery</td><td>PUDO</td></tr></tbody></table>

***

### Delivery Documents

All delivery documents should use the About You layout and include the merchant’s company information wherever applicable.

***

### Packaging

Merchants have three distinct packaging options available. Please note that the chosen packaging type directly influences your commission rate:

1. Own Branded Packaging   : Using your existing, branded packaging (e.g. with branded logo, stickers).
2. Neutral Packaging: Using unbranded, generic packaging with no stickers or logos attached.
3. About You Branded Packaging: Using official About You branded materials.

{% hint style="info" %}
Merchants are recommended to use the About You packaging (only in case of absence of your own package material) to ensure a consistent and cohesive presentation of products to the end customer. Please be advised that if you select this option, the merchant is responsible for ordering the packages directly from ABOUT YOU and covering all associated costs.
{% endhint %}

***

### Return Label

Each package must contain a self-adhesive return label valid for 30 days, allowing customers to return items easily if needed.

***

### Tracking Code

Tracking information for each shipment must be transferred to About You in dispatch messages, enabling customers to follow their orders.

***

### Return Notification

Returned items should be processed and acknowledged (including any technical feedback) within 24 hours of arrival at the merchant’s facility.

***

### Misdirected Returns

ABOUT YOU asks Customers to return Goods in the very box they have received the Goods in directly to the Merchant. Nevertheless, Customers sometimes return either Merchant Goods to ABOUT YOU’s warehouse or the other way around. For this reason, an exchange process needs to be set up.

If the Customer returns Goods to the Merchant’s warehouse without the Merchant being able to identify the Goods as its own, the Merchant needs to send such Customers returns back to the ABOUT YOU warehouse:

**Hermes Fulfilment CZ s.r.o.**\
**Komenského 598**\
**332 03 Šťáhlavy**\
**Czech Republic**

ABOUT YOU will send misdirected Customer returns to Merchant’s warehouse accordingly. Based on volumes, this exchange of misdirected returns should take place in regular intervals.

In addition, the following label will be applied to misdirected items before they are returned to the partner.&#x20;

Please find an example below:

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FNmGhNdcf4MAYgdcwWm0z%2Fimage%20(26).png?alt=media&amp;token=aef77855-e1cb-4cb5-9393-db96c0e594b2" alt=""><figcaption></figcaption></figure>

* The EAN can be scanned via the barcode
* The order ID can be scanned via the Data Matrix code
* The QR code is for internal use only and is not relevant for partners

***

### Customer Service

All customer service inquiries—whether received directly or via About You—must be answered within 24 hours.

***

### Availability

Only products with sufficient stock should be made available for sale, reducing the likelihood of cancellations or delivery issues.

***

### Cancellation Rate

The weekly cancellation rate for items that cannot be shipped should remain below 1.0% to maintain a positive customer experience.


# Invoicing & Payout

{% hint style="info" %}
As part of your transition to the marketplace model, certain billing, invoicing, and payout processes may differ from your previous setup. Please take a moment to review the financial documentation to familiarize yourself with these updated settlement workflows and reporting procedures.
{% endhint %}

## What payment documentation will I receive?

At the beginning of each month, you will receive different digital documents for the previous month's transactions. As per our normal procedures, they are sent to you as soon as they are ready. This includes:

* **The Settlement File:** This is a single, detailed .csv file that provides a breakdown of all your itemized order transactions. It's the most important document you'll receive, as the total amount in this file equals your monthly payout. The language of this file is English.
* **Three Additional Invoices:**
  * **Marketplace Commission Invoice:** A detailed breakdown of the commission charges on your sales. This is an informational document. No further action is required.
  * **SCAYLE Payments Fee Invoice:** A breakdown of the payment processing fees (also referred to as "SPAY fee"). This is an informational document. No further action is required.
  * **Voucher Compensation Invoice:** An invoice detailing the compensation for any vouchers or coupons applied to your products (e.g., 10% or 15% discounts). This is an informational document. No further action is required.

All amounts stated in these invoices can also be tracked within your Settlement File.

**Please note that the above mentioned documentation is the only documentation that is currently offered.**

***

## How will I receive the payment documentation?

Your settlement file is sent to you via an automated email from **<no-reply@scayle-payments.com>**

Please note that in rare cases, the email might be forwarded to your SPAM box.

* **Did not receive the email with the link or the link is expired?** Our team will provide it to you manually.

Your settlement file is sent automatically after the monthly payout. If you did not receive a payout and a Settlement File, it might mean your refunds were higher than your sales, resulting in no payout for that month.The information from the month without a payment will be displayed on the next published Settlement File. You can always raise a ticket in our Help Center to confirm.&#x20;

Link here: <https://aboutyou.atlassian.net/helpcenter/sellercenter/portal/1189/group/1391/create/3361>

***

## How to configure the CSV file&#x20;

<details>

<summary>The settlement files (itemized statements) are sent every month in the form of a CSV file. The following steps should be applied to format the file:</summary>

**1. Open the CSV file with Excel**

**2. Mark the entire column A, then go to Data on the top menu and click Text to Columns**

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FYiiwYDMwDb3VLXGpLqVI%2Funknown.png?alt=media&amp;token=433bbb81-0bec-4973-80d1-9e858d398ad2" alt="" width="563"><figcaption></figcaption></figure>

3. **Select Delimited → Click Next**

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2F2hN3l7bS03LGQuovqHjA%2Funknown.png?alt=media&amp;token=628204bc-be4a-41c1-839a-fdc9e99d32ea" alt="" width="529"><figcaption></figcaption></figure>

**4. Delimiters: „Tab“ and „Comma “ → Click Next**

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2Fdk38UzMwNU6ol1HYxc0f%2Funknown.png?alt=media&amp;token=e5280474-2e14-48fb-b2a5-a608834a019c" alt=""><figcaption></figcaption></figure>

5. **Select advanced and Replace information so the decimal separator is: ‘’ .’’ and thousands separator ‘’,’’ → Click Ok and then click Finish.**

<figure><img src="https://2370659135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FY8oZ3Vo4FI5q8bX0AiSf%2Fuploads%2FXo7wZuOpner6WILToDrr%2Funknown.png?alt=media&amp;token=2f1f7ba1-6733-4747-8baa-33f48b8ebce6" alt=""><figcaption></figcaption></figure>

**6. Afterwards, desired filters can be set and the file can be saved in ".xlsx” format**

</details>

***

## When will I receive my money?

We follow a monthly payout structure as outlined in your contract. The payout for all transactions that were fully settled within the previous month is made by SCAYLE Payments and it is sent out on the 5th working day of the new month.

The Voucher Compensation payment for all vouchers used by customers that were fully settled within the previous month is made by ABOUT YOU and it is settled by the end of the month.

***

## Understanding my fees and charges

The following charges and deductions will be applied to your transactions:

* **Marketplace Commission:** This is the amount we charge per order item. It is deducted directly from your payment.
* **SCAYLE Payments (SPAY) Fee:** This is the amount the SCAYLE Payments team charges per order item for payment processing. It is also deducted directly from your payment.
* **Voucher Compensation:** This is the compensation for coupons and vouchers. This amount is paid to you by ABOUT YOU at the beginning of the month.
* **Fulfilment by ABOUT YOU:** This is the amount we charge for storage, and fulfilment of delivery and returns. Please find a breakdown of these fees at the end of the page.\*

\*Please refer to the contract for details.

### How can I find my invoices and fee breakdowns?

All transactional fees can be found in your settlement file. Additionally, you will receive separate invoices for your marketplace and payment fees from the respective teams.

***

## **Marketplace Commission Fee Calculation Model\***

Based on EUR Retail Price incl. VAT per&#x20;category. If a Good&#x20;is sold in a non-EUR currency, it will be converted into EUR.\*

| **Product Type**     | **<35€** | **>35€ and <50€** | >**=50€ and <100€** | **>100€** |
| -------------------- | :------: | :---------------: | :-----------------: | :-------: |
| Women Textile        |    4%    |         5%        |         13%         |    18%    |
| Men Textile          |    6%    |        14%        |         18%         |    22%    |
| Kids                 |    5%    |        12%        |         18%         |    22%    |
| Beauty & Home        |    5%    |        12%        |         13%         |    13%    |
| Acc., Bags & Jewelry |    6%    |        16%        |         18%         |    19%    |
| Shoes                |    4%    |         8%        |         16%         |    19%    |
| Sports & Swimwear    |    5%    |        13%        |         13%         |    13%    |

\*Please refer to the contract for details.&#x20;

***

## What do the columns in the Settlement File mean?

The Settlement File is an essential tool for understanding your finances. Here is a detailed breakdown of the most important columns:

* **payoutAmount (Column AJ)**: This column shows the final debit or credit amount for a specific transaction. The SUM of this column will give you the total transactional amount you will be receiving for your sales (including refunds and chargebacks as a negative amount). If you have received a reserve release or had a top-up amount, these will also be accounted for in the final payout calculation.
* **operationTimestamp, operationType:** These two columns identify the type of transaction. For example, 'captures' are sales that were successful and reconciled. 'Refunds' and 'chargebacks' can also be found clearly in this column.
* **discountCompensation:** This column shows whether a discount voucher was applied to the operation amount. You will be compensated for this discount amount by the ABOUT YOU Marketplace.
* **commissionRate, commissionAmount, commissionVatRate, commissionVatAmount:** These columns display the marketplace commission-related charges per transaction. The marketplace commission is charged per capture.
  * How to calculate the commission fee (with VAT): (Initial amount \* rate\_percentage/100) + (Initial amount \* rate\_percentage/100 \* VAT)
  * The SUM of columns V and X will also give you the total commissions charged for the month.
* **paymentFeeRate, paymentFeeAmount, paymentFeeVatRate, paymentFeeVatAmount:** These columns show the SCAYLE Payments processing fee per item.
  * How to calculate the SPAY fee (with VAT): (Captured amount \* paymentFeeRate) + (Captured amount \* paymentFeeRate \* VAT)
  * The SUM of columns Z and AB will also give you the total SPAY Fee amount charged for the month.
* **refundsReserveWithhold, chargebacksReserveWithhold**: These columns show how much SCAYLE Payments withholds from a transaction to cover for future chargebacks and refunds.
  * A minimum of 63.48% of the capture amount is withheld for refunds, and 0.3% is withheld for chargebacks. SCAYLE Payments determines the amount of the respective Security Retention based on the anticipated Transaction Volume and possible Refunds.
  * Unused refund reserves are released to you after 60 days, and unused chargeback reserves are released after 180 days.
* **refundsReserveUsage, chargebacksReserveUsage:** These columns show how much of the previously withheld reserves are being used to cover refunds and chargebacks. You can see a breakdown of your reserve activity at the bottom of the settlement file.

***

## How is the total payout amount calculated?

Your monthly total payout amount is:

Captured amount - marketplace commission captures - refund reserve - chargeback reserve - SPAY fee - Reserve TopUp + Reserve Release

***

## How do I match transactions to payouts?

**Column AJ** + payout of **Column G** (at the bottom)

\
The payout you receive will always match the total amount you see in your settlement file each month. In the settlement file, the SUM of all cells in the payoutAmount column (column AJ), plus the payoutAmount in the reserve management section, bottom of column G , will show your exact payout amount for that month.

***

## Where can I find help?

* **How can I update my company, contact, or banking details?**\
  Please raise a ticket in the Seller Center Service Desk for any changes [here](https://aboutyou.atlassian.net/helpcenter/sellercenter/portal/1189/group/1391/create/4564). Your request will be forwarded to the responsible team and may be subject to evaluation by our AFC team. We will contact you if any action is required from your side.
* **What should I do if a payout seems incorrect or is missing?**\
  Please immediately contact your account manager or raise a ticket on the Seller Center. The responsible teams will be informed, and an investigation will begin.
* **Who can I contact for technical or operational issues?**\
  Please reach out to the ABOUT YOU team through the Seller Center Service Desk for any technical or operational issues. Your inquiry will be forwarded to the responsible team.

This document covers all the essential details you provided, ensuring it is comprehensive and easy for any partner to navigate.

***

## Price List ABOUT YOU Fulfillment Marketplace

|                     |                         |             |           |
| ------------------- | ----------------------- | ----------- | --------- |
| **Service**         | **Item/Shipment Level** | **Country** | **Price** |
| Inbound Processing  | Item                    | ALL         | 0.4728 €  |
| Storage/Warehousing | Item/day                | ALL         | 0.0161 €  |
| Outbound            | Shipment                | AT          | 3.45 €    |
|                     |                         | BE          | 4.37 €    |
|                     |                         | BG          | 4.69 €    |
|                     |                         | CH          | 5.79 €    |
|                     |                         | CY          | 7.38 €    |
|                     |                         | CZ          | 3.97 €    |
|                     |                         | DE          | 3.27 €    |
|                     |                         | DK          | 5.50 €    |
|                     |                         | EE          | 4.75 €    |
|                     |                         | ES          | 4.86 €    |
|                     |                         | FI          | 4.89 €    |
|                     |                         | FR          | 5.84 €    |
|                     |                         | GR          | 5.47 €    |
|                     |                         | HR          | 3.62 €    |
|                     |                         | HU          | 4.70 €    |
|                     |                         | IE          | 5.75 €    |
|                     |                         | IT          | 5.73 €    |
|                     |                         | LT          | 5.02 €    |
|                     |                         | LU          | 6.42 €    |
|                     |                         | LV          | 5.11 €    |
|                     |                         | NL          | 4.06 €    |
|                     |                         | NO          | 12.91 €   |
|                     |                         | PL          | 5.04 €    |
|                     |                         | PT          | 5.73 €    |
|                     |                         | RO          | 4.07 €    |
|                     |                         | SE          | 5.70 €    |
|                     |                         | SI          | 4.32 €    |
|                     |                         | SK          | 3.40 €    |
| Returns             | Shipment                | AT          | 2.91 €    |
|                     |                         | BE          | 3.96 €    |
|                     |                         | BG          | 3.70 €    |
|                     |                         | CH          | 5.97 €    |
|                     |                         | CY          | 4.78 €    |
|                     |                         | CZ          | 2.75 €    |
|                     |                         | DE          | 3.11 €    |
|                     |                         | DK          | 4.64 €    |
|                     |                         | EE          | 3.57 €    |
|                     |                         | ES          | 4.84 €    |
|                     |                         | FI          | 5.49 €    |
|                     |                         | FR          | 6.07 €    |
|                     |                         | GR          | 4.13 €    |
|                     |                         | HR          | 4.01 €    |
|                     |                         | HU          | 4.43 €    |
|                     |                         | IE          | 5.79 €    |
|                     |                         | IT          | 5.47 €    |
|                     |                         | LT          | 3.46 €    |
|                     |                         | LU          | 6.26 €    |
|                     |                         | LV          | 3.60 €    |
|                     |                         | NL          | 3.22 €    |
|                     |                         | NO          | 6.71 €    |
|                     |                         | PL          | 3.55 €    |
|                     |                         | PT          | 4.97 €    |
|                     |                         | RO          | 3.68 €    |
|                     |                         | SE          | 5.84 €    |
|                     |                         | SI          | 3.50 €    |
|                     |                         | SK          | 3.22 €    |


# Partner Campaigns

This guide will help you understand how to participate in our sales campaigns, the benefits of doing so, and how these are being settled in our invoices.

## Overview of Campaigns

Several times we offer partners the opportunity to join our major sales campaigns several times per season. These campaigns are designed to boost sales and increase visibility while helping to reduce inventory holding costs.

In general, there are two different types of campaigns:

* **Discounts on the whole shop**: Participation requires discounts across the entire assortment.
* **Discounts on selected products/ parts of your assortment**: Partners can choose to participate with specific parts of their assortment.

### Benefits of Participating in Campaigns

Participating in ABOUT YOU campaigns is one of the most effective ways to boost your brand's storefront visibility, drive traffic, and significantly increase conversion rates. Here is why joining our promotional campaigns is essential for growing your sales on the marketplace:

* **Increased Sales**: Drive additional sales through heightened visibility and attractive discounts.
* **Improved Placement**: Gain better placement in product assortments on our platform.
* **Brand Boosting**: Enhance your brand awareness through attractive discounts
* **Inventory Reduction**: Move slow-selling products more effective

***

### How to participate in Campaigns

Partners will receive an invitation via email, usually within 9 days before the start of the campaign, to inform them about the upcoming campaign.

#### How to add products to a campaign via SCAYLE

1. Login to Partner Portal using your Marketplace Account > Marketing > New Sales Promotions. Make sure to login with your **new** Marketplace account, not the old one.
2. Find the description of each campaign, where you can see key framework information: Sales promotion period, participation deadline, participating country(ies), reduction of your choice (only increments of 5%), and minimum reduction (if required) \*\*We cannot make any exceptions if the deadlines are not met. Manual lists via Email will not be accepted.\*\*
3. Click JOIN on the campaign you would like to participate in
4. Read and follow the next steps (1 to 3) on the Sales Promotion Overview
5. To participate, you can download the product list via the DOWNLOAD button from the respective campaign entry. Product lists show all the partner’s products that are live in the Shop at that time. Fill in the column Reduction Offer with the desired discount in absolute numbers (example: 30 for 30%) for each product. If a product does not participate in the campaign, the entire line must be removed
6. Once the list is edited and finalized, upload it via the UPLOAD TEMPLATE button.

{% hint style="info" %}
**Please note:**

* The lists are on Shop Product ID level (not on EAN level).
* If there is a “yes” in the column “Deleted” - it means that the product has not been in stock for more than four weeks.

📌 **The reductions for major campaigns via the portal are uploaded by About You. Only these reductions will count as an “active participation” (not the ones through the middleware). Nonetheless, reductions via the middleware will remain active at all times.**
{% endhint %}

***

### Campaign Invoicing Process

All discounts from campaign participation are directly applied to the RRP of your sold items within your standard monthly self-billing invoices. Please keep the following key settlement details in mind regarding campaign accounting:

* Campaign participation is reflected in the invoices by applying the granted discount to the RRP of sold items. These statements are issued on a rolling basis at the start of every month for the preceding period.&#x20;
* Please note that no additional settlement files or separate PDF documents will be provided for these promotions.
* The campaign participation directly reduces the RRP of items in the self-billing invoices.

***


# Managing Products & Prices

As you transition to the marketplace model, your daily routine remains unchanged—you'll continue managing your products directly in SCAYLE. Here are just a few general reminders on pricing and product onboarding.

{% hint style="info" %}
Note: Your Seller Center account will be ready soon. Once live, it will become your central hub for managing products, pricing, campaigns, and marketing.
{% endhint %}

If you have any questions or need support, feel free to contact us through the [Help Center](https://aboutyou.atlassian.net/helpcenter/sellercenter/?_hsmi=2\&utm_campaign=114326744-Seller+Center+Welcome+Cycle\&utm_content=2\&utm_medium=email\&utm_source=hs_email) and our Account Management Team will be happy to help.&#x20;

***

### Pricing Responsibility & Visibility&#xD;

With price sovereignty, you are fully responsible for setting and managing your prices. ABOUT YOU receives your pricing data directly via your middleware, but we do not verify, validate, or manually modify these prices.&#x20;

Please note that how quickly price updates appear on the platform depends on your middleware configuration—reach out to your middleware provider to adjust these refresh settings.

***

### Product Onboarding & Mapping&#xD;

When you submit new products via your middleware, they enter our system with the status "**New**." From there, items go through our mapping process, which typically takes up to two weeks.&#x20;

Once mapping is complete, your products will automatically go live on the platform without requiring any further action on your end.


# sponsored products

## You are unable to access aboutyou.com

## Why have I been blocked?

This website is using a security service to protect itself from online attacks. The action you just performed triggered the security solution. There are several actions that could trigger this block including submitting a certain word or phrase, a SQL command or malformed data.

## What can I do to resolve this?

You can email the site owner to let them know you were blocked. Please include what you were doing when this page came up and the Cloudflare Ray ID found at the bottom of this page.

Cloudflare Ray ID: **a34468d82a35c731** • Your IP: Click to reveal 104.28.166.238 • Performance & security by [Cloudflare](https://www.cloudflare.com/5xx-error-landing)


