Tenant configurations

Manage Tenant Configurations

Retrieving configurations

get

Retrieves a list of configurations.

Required scopes

This endpoint requires the following scopes:

Authorizations

OAuth2

OAuth2clientCredentialsRequired

Token URL:

Path parameters

tenantstringRequired

Your Emporix tenant name.

Note: The tenant should always be written in lowercase.

Query parameters

keysstringOptional

Responses

200

OK

application/json

get

/configuration/{tenant}/configurations

HTTPcURLJavaScriptPython

GET /configuration/{tenant}/configurations HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

200

OK

[
  {
    "key": "customer.deletion.redirecturl",
    "secured": false,
    "value": "https://tenant.com/custDelete?token=",
    "version": 1
  },
  {
    "key": "customer.passwordreset.redirecturl",
    "secured": false,
    "value": "https://tenant.com/changePassword?token=",
    "version": 1
  },
  {
    "key": "customer.changeemail.redirecturl",
    "secured": false,
    "value": "https://tenant.com/emailChangeConfirm?token=",
    "version": 1
  },
  {
    "key": "cust.notification.email.from",
    "secured": false,
    "value": "[email protected]",
    "version": 3
  },
  {
    "key": "project_country",
    "secured": false,
    "value": "EN",
    "version": 2
  },
  {
    "key": "project_curr",
    "secured": false,
    "value": "[{\"id\":\"EUR\",\"label\":\"Euro\",\"default\":true,\"required\":true}]",
    "version": 3
  },
  {
    "key": "project_lang",
    "secured": false,
    "value": "[{\"id\":\"en\",\"label\":\"English\",\"default\":true,\"required\":true}]",
    "version": 2
  },
  {
    "key": "taxConfiguration",
    "secured": false,
    "value": {
      "taxClassOrder": [
        "FULL",
        "HALF",
        "ZERO"
      ],
      "taxClasses": {
        "FULL": 19,
        "HALF": 7,
        "ZERO": 0
      }
    },
    "version": 2
  },
  {
    "key": "packagingConf",
    "secured": false,
    "value": {
      "packagingGroupOptions": [
        "1_cooling_product",
        "2_standard",
        "3_fragile"
      ],
      "packagingPositionOptions": [
        "1_bottom_robust",
        "2_bottom_insensitive",
        "3_middle_standard",
        "4_top_sensitive"
      ]
    },
    "version": 2
  },
  {
    "key": "storefront.htmlPage",
    "secured": false,
    "value": "index.html",
    "version": 1
  },
  {
    "key": "storefront.host",
    "secured": false,
    "value": "tenant.com",
    "version": 1
  },
  {
    "key": "unitConf",
    "secured": false,
    "value": [
      {
        "units": {
          "LTR": {
            "availableUnitValue": 1,
            "conversion": {
              "MLT": 1000
            }
          },
          "GRM": {
            "availableUnitValue": 100,
            "conversion": {
              "KGM": 0.001
            }
          },
          "KGM": {
            "availableUnitValue": 1,
            "conversion": {
              "GRM": 1000
            }
          },
          "MLT": {
            "availableUnitValue": 100,
            "conversion": {
              "LTR": 0.001
            }
          }
        },
        "name": "UnitConfiguration",
        "description": "This object holds the unit configurations and the factors to calculate between different units"
      }
    ],
    "version": 1
  }
]

Creating configurations

post

Creates new configurations.

Required scopes

This endpoint requires the following scopes:

Authorizations

OAuth2

OAuth2clientCredentialsRequired

Token URL:

Path parameters

tenantstringRequired

Your Emporix tenant name.

Note: The tenant should always be written in lowercase.

Bodyobject · Configuration[]

application/json

keystring · min: 1Optional

Configuration key.

valueone ofOptional

Client configuration value. It can be any valid JSON object.

objectOptional

or

stringOptional

or

object[]Optional

or

booleanOptional

versionintegerOptional

Configuration version.

securedbooleanOptional

Flag indicating whether the configuration should be encrypted.

Default: false

Responses

201

Created

application/json

400

Bad Request

application/json

409

Conflict

application/json

post

/configuration/{tenant}/configurations

HTTPcURLJavaScriptPython

POST /configuration/{tenant}/configurations HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 278

[
  {
    "key": "project_country",
    "secured": false,
    "value": "DE",
    "version": 1
  },
  {
    "key": "project_lang",
    "secured": false,
    "value": "[{\"id\":\"en\",\"label\":\"English\",\"default\":true,\"required\":true},{\"id\":\"de\",\"label\":\"German\",\"default\":false,\"required\":false}]",
    "version": 1
  }
]

Request exampleCreate invoice settings example

[
  {
    "key": "project_country",
    "secured": false,
    "value": "DE",
    "version": 1
  },
  {
    "key": "project_lang",
    "secured": false,
    "value": "[{\"id\":\"en\",\"label\":\"English\",\"default\":true,\"required\":true},{\"id\":\"de\",\"label\":\"German\",\"default\":false,\"required\":false}]",
    "version": 1
  }
]

Retrieving a configuration

get

Retrieves a specified configuration.

Required scopes

This endpoint requires the following scopes:

Authorizations

OAuth2

OAuth2clientCredentialsRequired

Token URL:

Path parameters

tenantstringRequired

Your Emporix tenant name.

Note: The tenant should always be written in lowercase.

propertyKeystringRequired

Desired configuration key.

Responses

200

OK

application/json

404Error

application/json

get

/configuration/{tenant}/configurations/{propertyKey}

HTTPcURLJavaScriptPython

GET /configuration/{tenant}/configurations/{propertyKey} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "key": "project_lang",
  "secured": false,
  "value": "[{\"id\":\"en\",\"label\":\"English\",\"default\":true,\"required\":true}]",
  "version": 2
}

Updating a configuration

put

Updates a specified configuration.

Required scopes

This endpoint requires the following scopes:

Authorizations

OAuth2

OAuth2clientCredentialsRequired

Token URL:

Path parameters

tenantstringRequired

Your Emporix tenant name.

Note: The tenant should always be written in lowercase.

propertyKeystringRequired

Desired configuration key.

Body

application/json

keystring · min: 1Optional

Configuration key.

valueone ofOptional

Client configuration value. It can be any valid JSON object.

objectOptional

or

stringOptional

or

object[]Optional

or

booleanOptional

versionintegerOptional

Configuration version.

securedbooleanOptional

Flag indicating whether the configuration should be encrypted.

Default: false

Responses

200

OK

application/json

400

Bad Request

application/json

409

Conflict

application/json

put

/configuration/{tenant}/configurations/{propertyKey}

HTTPcURLJavaScriptPython

PUT /configuration/{tenant}/configurations/{propertyKey} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 66

{
  "key": "project_country",
  "secured": false,
  "value": "AT",
  "version": 1
}

{
  "key": "project_country",
  "secured": false,
  "value": "AT",
  "version": 1
}

Deleting a configuration

delete

Deletes a specified configuration.

Required scopes

This endpoint requires the following scopes:

Authorizations

OAuth2

OAuth2clientCredentialsRequired

Token URL:

Path parameters

tenantstringRequired

Your Emporix tenant name.

Note: The tenant should always be written in lowercase.

propertyKeystringRequired

Desired configuration key.

Responses

204

No Content

404

Not Found

application/json

delete

/configuration/{tenant}/configurations/{propertyKey}

HTTPcURLJavaScriptPython

DELETE /configuration/{tenant}/configurations/{propertyKey} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

No content