Set Settings

Use this request to set a specific setting.

To update the details for a specific setting and seller code, use a PUT method and the following URL:

{service_uri}/marketplace/v1/sellers/{seller_code}/settings/{effective_from}/{settings_path}

where:

  • {service_uri} is the service's URL.
  • {seller_code} is the ID of the record that you want to retrieve.
  • {effective_from} is the date when the setting was started. For example 1970-01-01. See Start and Block Dates for Settings.
  • {settings_path} the path to the specific setting. For example countries.FR is the path to the following setting:
{
  "countries": {
    "FR": {
      "is_domestic": true
    }
  }
}

For example:

$ curl \
    -H "x-marketplace-token: ms_{TOKEN}" \
    -X GET \
    https://sellers-api.sandbox.marketplace.taxamo.com/marketplace/v1/sellers/liz.doe.123

where {TOKEN} is your access token.

Details

API Component TypeAPI Component
Endpoint/marketplace/v1/sellers/{seller_code}/settings/{start_date}/{settings_path}
MethodPUT
API Reference DocumentationSet settings

Path Parameters

ParameterDescription
seller_codeSpecify the ID of the record that you want to retrieve. This code is returned by the API when the seller was created.
start_dateSpecify the date when the setting was started. For example 1970-01-01.
settings_pathSpecify the path to the setting. For example countries.FR.

Response

If the response to this request was 200, it means it succeeded and the taxation configuration has been set correctly. The response contains the full and updated reference seller map. It can be used to verify that settings have been applied as intended.