This is a html view of the json schema please take the json schema as reference DOWNLOAD THE JSON SCHEMA

Sellers


seller topic object description.

UPSERT (default) action

Type: object
No Additional Properties

Seller

Type: object

a seller object description

No Additional Properties

Type: array

List of the seller's applicable taxes

No Additional Items

Each item of this array must be:

Type: integerFormat: int64

Average time for a seller to accept or refuse an order (in seconds)

Type: number

Rate of accepted orders

Type: string

Url of the seller's banner image

Type: array of string

List of the channel codes associated to the seller

No Additional Items

Each item of this array must be:

Type: stringFormat: date-time

The start date of the closing of the seller

Type: stringFormat: date-time

The end date of the closing of the seller

Type: object

Contact information

Type: string

City of the contact

Type: string

Civility of the contact (Mr, Mrs, Miss or Neutral)

Type: string

Code ISO 3166-1 alpha-3 of the contact's country

Type: string

Fax, max length: 20 characters.

Type: string

First name of the contact

Type: string

Last name of the contact

Type: string

State (address) of the contact

Type: string

First line of the address of the contact

Type: string

Second line of the address of the contact

Type: string

Website of the seller

Type: string

Zip code of the contact

Type: string

The currency of the seller (iso format)

Type: stringFormat: date-time

Creation date of the seller

Type: string

The description of the seller, max length: 3000 characters.

Type: array of string

Seller domains

No Additional Items

Each item of this array must be:

Type: integerFormat: int64

Number of evaluations for the seller

Type: boolean

Whether or not this seller offers free shipping to customers

Type: number

Global grade of the seller

Type: stringFormat: date-time

Date until when the seller is immunized against suspension

Type: boolean

Whether or not the seller is professional

Type: object

KYC information (only supported when KYC feature is enabled)

Type: string

KYC refusal reason

Type: string

KYC status

Type: stringFormat: date-time

The date of the last modification of the seller

Type: string

Seller platform model, current possible values :

  • MARKETPLACE
  • DROPSHIP
  • ONE_CREDITOR

Type: integerFormat: int64

Total count of active offers of the seller

Type: string

Opco internal id for the seller. (operator internal id in mirakl)

Type: integerFormat: int64

Average time for a seller to answer to an order message (in seconds)

Type: integerFormat: int64

Total count of debited orders (or if Pay on Delivery, accepted) of the seller

Type: object

Payment details

Type: boolean

Is the subscription to the marketplace charged to the seller

Type: boolean

Is the payment blocked by the operator

Type: stringFormat: date-time

Subscription is free from this date

Type: stringFormat: date-time

Subscription is free until this date

Type: object

Payment information

ABA


Type: object

Type: string

Bank Account Number

Must match regular expression: [0-9]+

Must be at least 3 characters long

Must be at most 17 characters long

Type: string

Bank city

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank name

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Bank street name

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank zip code

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Bank account BIC code (aka Swift Code)

Type: string

Routing Number of the bank, (aka ABA code)

Must match regular expression: [0-9]+

AUBSB


Type: object

Type: string

Bank account number

Must be at least 6 characters long

Must be at most 10 characters long

Type: string

Bank state branch code

Type: string

Bank city

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank name

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Bank street name

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank zip code

Must be at least 0 characters long

Must be at most 255 characters long

BRAZILIAN


Type: object

Type: string

Account number

Must match regular expression: [0-9]+

Must be at least 10 characters long

Must be at most 11 characters long

Type: string

Account type
- C: Checking account
- P: Savings account

Type: string

Bank city

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank code

Must match regular expression: [0-9]+

Type: string

Bank name

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Bank street name

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank zip code

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Branch code

Must match regular expression: [0-9]+

CANADIAN


Type: object

Type: string

Bank account number

Must match regular expression: [0-9]+

Must be at least 5 characters long

Must be at most 12 characters long

Type: string

Bank city

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank name

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Bank street name

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank zip code

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Bank institution number

Must match regular expression: [0-9]+

Type: string

Bank transit number

Must match regular expression: [0-9]+

COLOMBIAN


Type: object

Type: string

Account number

Must match regular expression: [0-9]+

Type: string

Account type
- C: Checking account
- P: Savings account

Type: string

Bank city

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank name

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Bank street name

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank zip code

Must be at least 0 characters long

Must be at most 255 characters long

HK


Type: object

Type: string

Bank account number

Must match regular expression: [0-9]+

Must be at least 9 characters long

Must be at most 12 characters long

Type: string

Bank city

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank name

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Bank street name

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank zip code

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Bank account swift code

IBAN


Type: object

Type: string

Bank city

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank name

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Bank street name

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank zip code

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Bank account BIC code

INDIAN


Type: object

Type: string

Account number

Must match regular expression: [0-9a-zA-Z]+

Must be at least 6 characters long

Must be at most 20 characters long

Type: string

Bank city

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank name

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Bank street name

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank zip code

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Bank account swift code

ISRAELI


Type: object

Type: string

Bank account number

Must match regular expression: [0-9]+

Must be at least 1 characters long

Must be at most 9 characters long

Type: string

Bank city

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank code

Must match regular expression: [0-9]+

Must be at least 1 characters long

Must be at most 4 characters long

Type: string

Bank name

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Bank street name

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank zip code

Must be at least 0 characters long

Must be at most 255 characters long

JAPANESE


Type: object

Type: string

Bank account number

Must be at least 6 characters long

Must be at most 8 characters long

Type: string

Account type
- C: Current account
- P: Savings account

Type: string

Bank city

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank code

Must match regular expression: [0-9]+

Type: string

Bank name

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Bank street name

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank zip code

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Branch code

Must match regular expression: [0-9]+

MEXICAN


Type: object

Type: string

Bank account number

Must match regular expression: [0-9]+

Must be at least 5 characters long

Must be at most 20 characters long

Type: string

Bank city

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank name

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Bank street name

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank zip code

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Clave Bancaria Estandarizada

NUBAN


Type: object

Type: string

Bank city

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank name

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Bank street name

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank zip code

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

The bank account NUBAN code

Must be at least 10 characters long

Must be at most 255 characters long

NZBSB


Type: object

Type: string

Bank city

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank name

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Bank street name

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank zip code

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Bank Account Number

Must be at least 10 characters long

Must be at most 10 characters long

Type: string

Bank State Branch code.

SG


Type: object

Type: string

Bank Account Number

Must match regular expression: [0-9]+

Must be at least 9 characters long

Must be at most 12 characters long

Type: string

Bank city

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank Key

Must match regular expression: [0-9]+

Type: string

Bank name

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Bank street name

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank zip code

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Name of the owner of the payment information

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank account swift code

TAIWANESE


Type: object

Type: string

Account number

Must match regular expression: [0-9]+

Must be at least 8 characters long

Must be at most 14 characters long

Type: string

Bank city

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank code

Must match regular expression: [0-9a-zA-Z]+

Must be at least 2 characters long

Must be at most 3 characters long

Type: string

Bank name

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Bank street name

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank zip code

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Branch code

Must match regular expression: [0-9a-zA-Z]+

Must be at least 3 characters long

Must be at most 4 characters long

THAI


Type: object

Type: string

Account number

Must match regular expression: [0-9]+

Must be at least 10 characters long

Must be at most 12 characters long

Type: string

Bank city

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank name

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Bank street name

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank zip code

Must be at least 0 characters long

Must be at most 255 characters long

UK


Type: object

Type: string

Bank Account Number

Must match regular expression: [0-9]+

Must be at least 6 characters long

Must be at most 11 characters long

Type: string

Bank city

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank name

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Bank Sort Code (Size must be 6 digits)

Must match regular expression: [0-9]+

Type: string

Bank street name

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank zip code

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Bank account swift code

URUGUAYAN


Type: object

Type: string

Account number

Must match regular expression: [0-9]+

Must be at least 5 characters long

Must be at most 20 characters long

Type: string

Account type
- C: Checking account
- P: Savings account

Type: string

Bank city

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank name

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Bank street name

Must be at least 3 characters long

Must be at most 100 characters long

Type: string

Bank zip code

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Branch code

Must match regular expression: [0-9]+

Must be at least 1 characters long

Must be at most 10 characters long

Type: enum (of string)

Must be one of:

  • "ABA"
  • "AUBSB"
  • "BRAZILIAN"
  • "CANADIAN"
  • "COLOMBIAN"
  • "HK"
  • "IBAN"
  • "INDIAN"
  • "ISRAELI"
  • "JAPANESE"
  • "MEXICAN"
  • "NUBAN"
  • "NZBSB"
  • "SG"
  • "TAIWANESE"
  • "THAI"
  • "UK"
  • "URUGUAYAN"

Type: string

Name of the owner of the payment information

Must be at least 3 characters long

Must be at most 100 characters long

Type: boolean

Whether or not the seller is premium

Type: string

Method used to determine if the seller is premium or not

Type: object

Professional details

Type: string

Corporate name

Type: string

Identification number of the seller. For France it would be the SIRET

Type: string

Tax identification number

Type: array

List of seller’s producer identifiers per Extended Producer Responsibility (EPR) categories. Only available if the operator setting Activate data collection related to circular economy regulations is enabled.

No Additional Items

Each item of this array must be:

Type: object

Type: string

Extended Producer Responsibility (EPR) category code.

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Seller producer identifier.

Must be at least 0 characters long

Must be at most 255 characters long

Type: string

Recycling policy - only available if the operator setting Activate data collection related to circular economy regulations has been enabled.

Must be at most 5000 characters long

Type: string

Terms of restitution, max length: 5000 characters.

Type: string

Code ISO 3166-1 alpha-3 of the shipping country

Type: array

All the pair shipping zone / shipping type accepted by the seller

No Additional Items

Each item of this array must be:

Type: object

Type: array

List of custom shipping fields for this shipping zone and shipping method

No Additional Items

Each item of this array must be:

Type: object

Type: enum (of string)

Additional field's type

Must be one of:

  • "BOOLEAN"
  • "DATE"
  • "LINK"
  • "LIST"
  • "MULTIPLE_VALUESLIST"
  • "NUMERIC"
  • "REGEX"
  • "STRING"
  • "TEXTAREA"

Type: number

Minimal amount for free shipping

Type: string

The code of the shipping type

Type: string

The label of the shipping type

Type: string

The code of the shipping zone

Type: string

The label of the shipping zone

Type: array

List of additional fields

No Additional Items

Each item of this array must be:

Type: object

Type: enum (of string)

Additional field's type

Must be one of:

  • "BOOLEAN"
  • "DATE"
  • "LINK"
  • "LIST"
  • "MULTIPLE_VALUESLIST"
  • "NUMERIC"
  • "REGEX"
  • "STRING"
  • "TEXTAREA"

Type: integer

The identifier of the seller

Type: string

The name of the seller

Type: string

Seller state : OPEN or CLOSE

Type: string

Seller suspension type, current possible values:
- MANUAL: Seller account has been manually suspended in the back-office
- PENDING_APPROVAL: Seller account has been suspended at creation
- AUTOMATIC_SUSPENSION: Seller account has been suspended by Mirakl Quality Control
- INCOMPLETE_PROFILE: Seller account is suspended because some mandatory fields are missing in its profile

Type: const Default: "UPSERT"

Action defines if the seller has to be added/updated or deleted

Specific value: "UPSERT"

DELETE action

Type: object

Type: const

Action defines if the seller has to be added/updated or deleted

Specific value: "DELETE"

Type: object
No Additional Properties

Type: integer

The identifier of the seller