Create Seller

If you want to create a permanent record of a seller's details, use the Seller API to create it.

📘
Information
If you do not want to store the seller's details, you can use the Transaction API to create the required seller information directly in the same request as the transaction.

For more information about the settings, see General Settings for a Seller.

For a list of the available fields, see Seller Settings Reference Guide.

To create the seller, use a POST method and the following URL:

{service_uri}/marketplace/v1/sellers

where {service_uri} is the service's URI.

For example:

$ curl \
    -H "x-marketplace-token: ms_{ACCESS_TOKEN}" \
    -H "Content-Type: application/json" \
    -X POST \
    --data '{JSON}' \
    https://sellers-api.sandbox.marketplace.taxamo.com/marketplace/v1/sellers

where:

{ACCESS_TOKEN} is your access token used for authentication.
{JSON} is the body of the request where you specify the seller's details.

Details

API Component Type	API Component
Endpoint	`/marketplace/v1/sellers`
Method	POST
API Reference Document	For a full list of available fields, see Create seller

Fields

The following table lists the general settings:

Field	Description
`seller_code`	The unique code that is used to identify the seller. It cannot be the same as the one used for the `marketplace_code` field or another `seller_code`.
`country`	Specifies the seller's country.
`postal_code`	The seller's postal code.
`business_name`	The seller's name.
`email`	The email address for your business.
`postal_address_line3`	The third line of the seller's address.
`postal_address_line2`	The second line of the seller's address.
`last_name`	The seller's second name.
`first_name`	The seller's first name.
`postal_address_line1`	The first line of the seller's address.
`middle_name`	The seller's middle name.
`effective_from`	The date from which the settings will take effect.
`timezone`	The time zone that is used for all time-based operations.

You can also configure settings for tax, regions, LILA, Invoices and Tax Number validation. For more information, see

For a full list of the available fields for seller settings, see Seller Settings Reference Guide.

Response

When the record is created successfully, a 200 code is returned.

📘Information

Details

Fields

Response

📘
Information