Skip to main content

Working with Fees

About This Section​

The Fees section provides information on tax rates available for your company. This data is required when creating goods — each good must be linked to a specific VAT rate via the vat.fee_item_id field.

How Fees Are Structured​

The API returns a list of fees, each containing:

  • Fee header: name (name), category (category, e.g. tax), and application rule (application_rule, e.g. inclusive — VAT included in price).
  • Fee items: specific rates within the fee. The id of a fee item is exactly what you use in the vat.fee_item_id field when creating a good.

Main Scenarios​

Scenario 1: Retrieving All Available Rates​

Before creating goods, retrieve the full list of VAT rates available to your company. The list is returned in full, without pagination.

Endpoint:

GET /fees

Example response:

{
  "items": [
    {
      "id": "55555555-5555-4555-8555-555555555555",
      "name": "VAT",
      "category": "tax",
      "application_rule": "inclusive",
      "fee_items": [
        {
          "id": "66666666-6666-4666-8666-666666666666",
          "name": "20%",
          "percentage": 20.0
        },
        {
          "id": "77777777-7777-4777-8777-777777777777",
          "name": "10%",
          "percentage": 10.0
        },
        {
          "id": "88888888-8888-4888-8888-888888888888",
          "name": "VAT Exempt",
          "percentage": 0.0
        }
      ]
    }
  ]
}

Scenario 2: Retrieving a Specific Fee by ID​

Endpoint:

GET /fees/{fee_id}

Returns a single fee with its items.

Scenario 3: Linking a Rate to a Good​

When creating a good, use the id of one of the fee items from the GET /fees response as the vat.fee_item_id value. All variations of the good share the same VAT rate — it is set at the good level, not per individual variation.

Example:

"vat": {
  "fee_item_id": "66666666-6666-4666-8666-666666666666"
}

If you need a detailed fee information (name and category, not just fee_item_id) when reading a good response, make a separate request to GET /fees and match fee_item_id with the entries in fee_items[].