> For the complete documentation index, see [llms.txt](https://transiteo.gitbook.io/transiteo/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://transiteo.gitbook.io/transiteo/management-system/sellers.md).

# Sellers (SIM)

Sellers Information Manager

## Method to add customer sellers

<mark style="color:green;">`POST`</mark> `https://api.transiteo.io/v1/customer/sellers`

This endpoint allows you to add customer sellers, up to 100 per request

#### Headers

| Name          | Type   | Description      |
| ------------- | ------ | ---------------- |
| Content-type  | string | application/json |
| Authorization | string | "your id\_token" |

### Json Request Format

```
[
    {
        "mail": "a@a.com",
        "id": "001",
        "name": "Seller 001",
        "manager_name": "Jean Bretthon",
        "phone": "+33601020304",
        "vat_number": "1234",
        "eori_number": "5678",
        "country": "FR",
        "street": "3 Place de l'église",
        "city": "PARIS",
        "postal_code": "12345",
        "annual_revenue": {},
        "syderep": {
            "AAA": "CheckOK",
            "BBB": "CheckOK"
        },
        "ids": {
            "products": [],
            "categories": [],
            "orders": [],
            "invoices": [],
        }
    },
    {
        "mail": "a@a.com",
        "id": "002",
        "name": "Seller 002",
        "manager_name": "Juliette Caranet",
        "phone": "+33601020304",
        "vat_number": "1234",
        "eori_number": "5678",
        "country": "FR",
        "street": "3 Place de l'église",
        "city": "PARIS",
        "postal_code": "12345",
        "annual_revenue": {},
        "syderep": {
            "AAA": "CheckOK",
            "BBB": "CheckOK"
        },
        "ids": {
            "products": [],
            "categories": [],
            "orders": [],
            "invoices": [],
        }
    }
]
```

## Method to update a customer seller

<mark style="color:orange;">`PUT`</mark> `https://api.transiteo.io/v1/customer/sellers/:sellerId`

This endpoint allows you to update customer seller

#### Headers

| Name          | Type   | Description      |
| ------------- | ------ | ---------------- |
| Content-type  | string | application/json |
| Authorization | string | "your id\_token" |

{% tabs %}
{% tab title="200 " %}

```
{
    "mail": "a@a.com",
    "id": "001",
    "name": "Seller 001",
    "manager_name": "Jean Bretthon",
    "phone": "+33601020304",
    "vat_number": "12340000",
    "eori_number": "56780000",
    "country": "FR",
    "street": "7 Place de l'église",
    "city": "PARIS",
    "postal_code": "12345",
    "annual_revenue": {},
    "syderep": {
        "AAA": "CheckOK",
        "NEW_SYDEREP": "NEW_OK!",
        "BBB": "CheckOK"
    },
    "ids": {
        "orders": [],
        "categories": [],
        "invoices": [],
        "products": []
    }
}
```

{% endtab %}
{% endtabs %}

## Method to retrieve seller informations

<mark style="color:blue;">`GET`</mark> `https://api.transiteo.io/v1/customer/sellers/:sellerId}`

This endpoint allows you to get customer seller informations.&#x20;

#### Headers

| Name          | Type   | Description      |
| ------------- | ------ | ---------------- |
| Content-type  | string | application/json |
| Authorization | string | "your id\_token" |

{% tabs %}
{% tab title="200 " %}

```
{
    "mail": "a@a.com",
    "id": "001",
    "name": "Seller 001",
    "manager_name": "Jean Bretthon",
    "phone": "+33601020304",
    "vat_number": "1234",
    "eori_number": "5678",
    "country": "FR",
    "street": "3 Place de l'église",
    "city": "PARIS",
    "postal_code": "12345",
    "annual_revenue": {
        "2025": {
          "FR": { "amount": 12390.98, "currency": "EUR" },
          "US": { "amount": 78098.57, "currency": "USD" }
        }
    },
    "syderep": {
        "AAA": "CheckOK",
        "BBB": "CheckOK"
    },
    "ids": {
        "products": ["SKU_A"],
        "categories": ["CAT_1", "CAT_2"],
        "orders": ["ORDER_00002"],
        "invoices": ["INV0000001"],
    }
}
```

{% endtab %}
{% endtabs %}

## Method to retrieve all customer sellers

<mark style="color:blue;">`GET`</mark> `https://api.transiteo.io/v1/customer/sellers`

This endpoint allows you to get all customer sellers, paginated, pages of 500 items

#### Headers

| Name          | Type   | Description      |
| ------------- | ------ | ---------------- |
| Content-type  | string | application/json |
| Authorization | string | "your id\_token" |

{% tabs %}
{% tab title="200 " %}

```
{
    "data": [
        {
            "mail": "a@a.com",
            "id": "001",
            "name": "Seller 001",
            "manager_name": "Jean Bretthon",
            "phone": "+33601020304",
            "vat_number": "1234",
            "eori_number": "5678",
            "country": "FR",
            "street": "3 Place de l'église",
            "city": "PARIS",
            "postal_code": "12345",
            "annual_revenue": {
                "2025": {
                  "FR": { "amount": 12390.98, "currency": "EUR" },
                  "US": { "amount": 78098.57, "currency": "USD" }
                }
            },
            "syderep": {
                "AAA": "CheckOK",
                "BBB": "CheckOK"
            },
            "ids": {
                "products": ["SKU_A"],
                "categories": ["CAT_1", "CAT_2"],
                "orders": ["ORDER_00002"],
                "invoices": ["INV0000001"],
            }
        },
        {
            "mail": "a@a.com",
            "id": "002",
            "name": "Seller 002",
            "manager_name": "Juliette Caranet",
            "phone": "+33601020304",
            "vat_number": "1234",
            "eori_number": "5678",
            "country": "FR",
            "street": "3 Place de l'église",
            "city": "PARIS",
            "postal_code": "12345",
            "annual_revenue": {
                "2025": {
                  "FR": { "amount": 12390.98, "currency": "EUR" },
                  "US": { "amount": 78098.57, "currency": "USD" }
                }
            },
            "syderep": {
                "AAA": "CheckOK",
                "BBB": "CheckOK"
            },
            "ids": {
                "products": [],
                "categories": [],
                "orders": [],
                "invoices": [],
            }
        },
        ...
    ],
    "nextIndex": "500"
}
```

{% endtab %}
{% endtabs %}

## Method to delete a customer seller

<mark style="color:red;">`DELETE`</mark> `https://api.transiteo.io/v1/customer/sellers/:sellerIdu}`

This endpoint allows you to delete a customer seller

#### Headers

| Name          | Type   | Description      |
| ------------- | ------ | ---------------- |
| Content-type  | string | application/json |
| Authorization | string | "your id\_token" |

{% tabs %}
{% tab title="200 " %}

```

{
    "mail": "a@a.com",
    "id": "001",
    "name": "Seller 001",
    "manager_name": "Jean Bretthon",
    "phone": "+33601020304",
    "vat_number": "12340000",
    "eori_number": "56780000",
    "country": "FR",
    "street": "7 Place de l'église",
    "city": "PARIS",
    "postal_code": "12345",
    "annual_revenue": {},
    "syderep": {
        "AAA": "CheckOK",
        "NEW_SYDEREP": "NEW_OK!",
        "BBB": "CheckOK"
    },
    "ids": {
        "orders": [],
        "categories": [],
        "invoices": [],
        "products": []
    }
}
```

{% endtab %}
{% endtabs %}