seller

Contains information about the party providing the offer. Enables identification and location-specific details for support or compliance.

commercial_name

Description

Recognised trading name of the business entity. Enables brand attribution and customer trust.

Guideline

Commonly recognised brand name or trading name. This may differ from legal name.

Correct Example

"commercial_name": "Ecosound"

Incorrect Example

"commercial_name": "Ecosound & Partners Limited"

entity_name

Description

Displays the officially registered name of the business or organisation. Helps for transparency and compliance.

Guideline

Full legal name as registered with official authorities.

Correct Example

"entity_name": "Ecosound & Partners Limited"

Incorrect Example

"entity_name": "Ecosound"

locations

Description

Specifies physical seller sites customers can visit or contact. Enables online seller compliance and customer support.

branch_name

Description

Identifying label for the specific seller location. Aids customer clarity for multi-branch operations.

Guideline

Official name of the branch.

address_line

Description

Provides the house number and street address of the seller location. Used for customer reference and compliance.

Guideline

Street and number in the country's valid format.

Correct Example

"address_line": "Keizersgracht 456"

Incorrect Example

"address_line": "456 Keizersgracht Street"

postal_code

Description

The local postal or ZIP code for the seller location. Enables precise geolocation and compliance.

Guideline

Valid local postal format.

Correct Example

"postal_code": "1017 EG"

Incorrect Example

"postal_code": "1017EG"

city

Description

The name of the city or municipality where the branch or facility is located. Enables customers to visit locations and meet digital seller compliance laws.

Guideline

Official city name.

Correct Example

"city": "Amsterdam"

Incorrect Example

"city": "The Dam"

country

Description

The full name of the country in which the location resides. Enables location filtering and compliance enforcement.

Guideline

Use the ISO 3166 short name.

Correct Example

"country": "Netherlands"

Incorrect Example

"country": "NL"

intent

Description

Defines the operational purposes the location supports. Enables functional categorization of seller locations for accurate user guidance and operational logic.

Guideline

Use a clear and recognisable singular action for each value.

Correct Example

"intent": ["purchase"]

Incorrect Example

"intent": ["purchase and pickup"]