You can use the service to help you to meet Swiss requirements such as the following:

Seller information is included in Marketplace invoices and credit notes.
Switzerland defines goods as either low- or high-value goods. The service accounts for both types, if it is correctly configured to do so.
A custom footer is added to meet Swiss requirements. For example:

Restrictions

The service treats the following as part of Switzerland for tax calculation and liability determination:

Liechtenstein: This country is considered part of Switzerland. However, you do need to define it as a country in your settings, alongside Switzerland.
Busingen: Only the Swiss address is recognized. The German address is not included as part of Germany.
Euroairport, Basel: Only the Swiss address is recognized. The French address is not included in France.

Default Currency

Switzerland uses the Swiss Franc (CHF) as the default currency.

Settings

You must specify Switzerland (CH) as both a country and region in both your Marketplace and Seller settings.

If you want to use the service for Lichtenstein, you must define it as a country. It will be considered a part of the Swiss region.

Marketplace Settings

The same settings can be used as for any other country. More details are provided in the Marketplace Settings Overview topic.

Seller Settings

The same settings can be used as for any other country. More details are provided in the Seller Settings Overview topic.

The following shows a seller with Switzerland and Liechtenstein defined as countries. Switzerland is also specified as a region:

    "sellers": [
      {
        "seller-code": "seller-1",
        "settings": {
          "countries": {
            "CH": {
              "taxation": {
                "physical": {
                  "is-physical-tax-enabled": true,
                  "is-seller-registered": true
                }

              }
            },
            "LI": {
              "taxation": {
                "physical": {
                  "is-physical-tax-enabled": true,
                  "is-seller-registered": true
                }

              }
            }
          },
          "regions": {
            "CH": {
              "taxation": {
                "physical": {
                  "use-marketplace-as-intermediary": true,
                  "is_seller_located_within_region": true
                }
<--------------------------Code Removed for clarity------------------------------------------------------>

Required Fields

Invoices

The following fields are needed for invoices and credit notes in Switzerland:

Field Description	Invoice Field	API Field
Supply date.	Supply date	`supply_timestamp`
The Seller's VAT ID.	VAT# under Provided By:	`seller_tax_number`. This field is defined at the country level in the Seller's settings as described in the Country section of the Seller Settings - Tax topic.
The Marketplace's name.	Provided By:	`marketplace_description`
The Marketplace's VAT ID.	Provided By:	`seller_tax_number`. This field is defined at the country level in the Marketplace's settings as described in the Country section of the Marketplace Settings - Tax topic.
The Buyer's name.	Provided To	`buyer_name`
The Buyer's address.	Provided To	`ship_to_address`
The Buyer's Tax ID.	Provided To	`buyer_tax_number`
The delivery address.	Provided To	`ship_to_address`

Credit Notes

In addition, the following fields are also needed for credit notes in Switzerland:

Field Description	Invoice Field	API Field
Credit Note. (The words "Credit Note" need to be displayed on the invoice.	n/a. Credit Note is displayed.	n/a
Date of the original invoice.	Invoice Date	This is usually `tax_timestamp` but it can vary depending on your configuration.
The refund reason.	Refund reason	`refund_reason`
The total credited amount.	TOTAL CREDITED	`total_amount`

Example API Requests and Responses

This section contains some example requests and responses.

Requests

Invoice

The following request shows a transaction being shipped to Lichtenstein with the seller specified as a Virtual Seller:

{
  "transaction": {
    "ship-to-address": {
      "country-code": "LI"
    },
    "discounts": [
    ],
    "currency-code": "CHF",
    "supply_timestamp": "2024-10-22T11:45:30Z",
    "transaction-lines": [
      {
        "description": "Stuff",
        "product-class": "P",
        "custom_id": "custom_id",
        "seller-code": "seller-1",
        "ship-from-address": {
          "country-code": "LI"
        },
        "unit-price": 199.00,
        "quantity": 1
      }
    ],
    "billing-address": {
      "country-code": "LI"
    },
    "sellers": [
      {
        "seller-code": "seller-1",
        "settings": {
          "countries": {
            "CH": {
              "taxation": {
                "physical": {
                  "is-physical-tax-enabled": true,
                  "is-seller-registered": true
                }

              }
            },
            "LI": {
              "taxation": {
                "physical": {
                  "is-physical-tax-enabled": true,
                  "is-seller-registered": true
                }

              }
            }
          },
          "regions": {
            "CH": {
              "taxation": {
                "physical": {
                  "use-marketplace-as-intermediary": true,
                  "is_seller_located_within_region": true
                }
              }
            }
          }
        }
      }
    ]
  }
}

Refund

The following example is the body of a Refund Transaction request:

{
  "refunds": [
    {
      "refund_total_amount": 10,
      "refund_reason": "Faulty stuff",
      "line_key": "eb3DK3T3B-AeC2UO",
      "refund_note_number": 1,
      "refund_unique_reference": "ref1"
    }
  ]
}

Responses

Transaction

The response to a Store Transaction or Confirm Transaction is similar to other countries. The following example shows the response to the example request:

{
 "transaction": {
  "ship_to_address": {
   "country_code": "LI",
   "tax_region": "CH"
  },
  "amount": 199.00,
  "required_fields": {
   "tax_required_fields": [],
   "storage_required_fields": [
    {
     "field_name": "supply_timestamp"
    }
   ]
  },
  "marketplace_code": "examplemarketplace",
  "tax_country_codes": "LI",
  "key": "PwvxYSQBCVHh2FApoCgvu9g2pKdVnN0k3-A0VEw",
  "tax_amount": 16.12,
  "update_date": "2024-11-15",
  "invoice_timestamp": "2024-11-15T13:14:31Z",
  "tax_liability_owner_codes": "",
  "create_timestamp": "2024-11-15T13:14:31Z",
  "transaction_lines": [
   {
    "description": "Stuff",
    "reverse_charge": false,
    "amount": 199.00,
    "tax_engine_additional_parameters": [
     {
      "param": "FLEX.output.example",
      "value": "Example Marketplace"
     }
    ],
    "tax_rule_applied": "physical-tax",
    "unit_price": 199.00,
    "taxes": [
     {
      "tax_type": "VAT",
      "imposition_type": "VAT",
      "tax_jurisdiction_code": "78294",
      "tax_amount": 16.12,
      "tax_calculation_rule_id": "v315211496",
      "exempt_amount": 0.0,
      "tax_base_amount": 199,
      "tax_jurisdiction_type": "COUNTRY",
      "rate": 8.1,
      "taxable_amount": 199.0,
      "tax_authority_name": "SWITZERLAND",
      "rate_type": "Standard",
      "tax_authority_id": "78294",
      "tax_name": "VAT",
      "non_taxable_amount": 0.0,
      "imposition": "VAT",
      "amount_fraction_taxable": 1
     }
    ],
    "tax_amount": 16.12,
    "tax_region": "CH",
    "invoice_place": "",
    "tax_exempt": false,
    "tax_country_code": "LI",
    "line_key": "QrT4GWkYvDTwC7mC",
    "custom_id": "custom_id",
    "tax_address_kind": "ship_to_address",
    "ship_from_address": {
     "country_code": "LI",
     "tax_region": "CH"
    },
    "tax_engine": "oseries",
    "invoice_status": "R",
    "kind": "b2c",
    "tax_number_service": "self-declaration",
    "product_class": "P",
    "custom_rules_applied": [],
    "line_num": 1,
    "is_seller_permanent": false,
    "quantity": 1.000000000000,
    "invoice_capable": false,
    "total_amount": 215.12,
    "seller_code": "seller-1",
    "tax_entity_name": "Liechtenstein",
    "tax_supported": true
   }
  ],
  "discounts": [],
  "refunded_tax_amount": 0,
  "product_classes": "P",
  "billing_address": {
   "country_code": "LI",
   "tax_region": "CH"
  },
  "status": "N",
  "sellers": [
   {
    "settings": {
     "regions": {
      "CH": {
       "taxation": {
        "physical": {
         "use_marketplace_as_intermediary": true,
         "is_seller_located_within_region": true
        }
       }
      }
     },
     "countries": {
      "CH": {
       "taxation": {
        "physical": {
         "is_seller_registered": true,
         "is_physical_tax_enabled": true
        }
       }
      },
      "LI": {
       "taxation": {
        "physical": {
         "is_seller_registered": true,
         "is_physical_tax_enabled": true
        }
       }
      }
     }
    },
    "seller_code": "seller-1"
   }
  ],
  "refunded_total_amount": 0,
  "supply_timestamp": "2024-10-22T11:45:30Z",
  "update_timestamp": "2024-11-15T13:14:32Z",
  "tax_timestamp": "2024-11-15T13:14:31Z",
  "total_amount": 215.12,
  "currency_code": "CHF"
 }
}

Refund

The following is an example response to a Refund Transaction request:

{
	"transaction": {
		"ship_to_address": {
			"country_code": "LI",
			"tax_region": "CH"
		},
		"amount": 199,
		"required_fields": {
			"tax_required_fields": [],
			"storage_required_fields": [
				{
					"field_name": "supply_timestamp"
				}
			]
		},
		"refunded_amount": 10.00,
		"marketplace_code": "market_d0ha9t13",
		"tax_country_codes": "LI",
		"key": "Psru1gABHxCUlCGB4wKgBBP4kGmZnPHCbBGy0AQ",
		"tax_amount": 0,
		"update_date": "2024-11-19",
		"invoice_timestamp": "2024-11-19T11:03:55Z",
		"confirm_timestamp": "2024-11-19T11:03:58Z",
		"tax_liability_owner_codes": "",
		"create_timestamp": "2024-11-19T11:03:55Z",
		"transaction_lines": [
			{
				"description": "Stuff",
				"reverse_charge": false,
				"amount": 199.00,
				"refunded_amount": 10.00,
				"tax_rule_applied": "physical-tax",
				"unit_price": 199.00,
				"taxes": [],
				"tax_region": "CH",
				"invoice_place": "",
				"invoice_number": "LI2024-3",
				"tax_exempt": false,
				"tax_country_code": "LI",
				"line_key": "eb3DK3T3B-AeC2UO",
				"custom_id": "custom_id",
				"refunded_tax_amount": 0.00,
				"tax_address_kind": "ship_to_address",
				"ship_from_address": {
					"country_code": "LI",
					"tax_region": "CH"
				},
				"tax_engine": "taxamo",
				"invoice_status": "R",
				"kind": "b2c",
				"invoice_image_url": "http://localhost:3008/html/v3/invoices/Psru1gABHxCUlCGB4wKgBBP4kGmZnPHCbBGy0AQ/0/31U-vxkMlUPAtFm3/LI2024-3",
				"tax_number_service": "self-declaration",
				"refunded_total_amount": 10.00,
				"product_class": "P",
				"custom_rules_applied": [],
				"line_num": 1,
				"is_seller_permanent": false,
				"deducted_tax_amount": 0,
				"quantity": 1,
				"invoice_capable": true,
				"total_amount": 199.00,
				"seller_code": "seller-1",
				"deducted_tax_rate": 0,
				"invoice_image_url_secret": "31U-vxkMlUPAtFm3",
				"refunds": [
					{
						"refund_reason": "Faulty stuff",
						"refund_amount": 10.00,
						"refund_timestamp": "2024-11-19T11:04:23Z",
						"refund_note_url": "http://localhost:3008/html/v3/invoices/Psru1gABHxCUlCGB4wKgBBP4kGmZnPHCbBGy0AQ/0/31U-vxkMlUPAtFm3/LI2024-3/refunds/1",
						"refund_tax_amount": 0.00,
						"refund_unique_reference": "ref1",
						"refund_note_number": 1,
						"refund_note_subnumber": 1,
						"refund_key": "KRE9TNVTOCvQP6PdyU7jMQ",
						"refund_total_amount": 10.00
					}
				],
				"tax_entity_name": "Liechtenstein",
				"tax_supported": true
			}
		],
		"discounts": [],
		"refunded_tax_amount": 0.00,
		"product_classes": "P",
		"billing_address": {
			"country_code": "LI",
			"tax_region": "CH"
		},
		"status": "C",
		"sellers": [
			{
				"settings": {
					"regions": {
						"CH": {
							"taxation": {
								"physical": {
									"use_marketplace_as_intermediary": true,
									"is_seller_located_within_region": true
								}
							}
						}
					},
					"countries": {
						"CH": {
							"taxation": {
								"physical": {
									"is_seller_registered": true,
									"is_physical_tax_enabled": true
								}
							}
						},
						"LI": {
							"taxation": {
								"physical": {
									"is_seller_registered": true,
									"is_physical_tax_enabled": true
								}
							}
						}
					}
				},
				"seller_code": "seller-1"
			}
		],
		"refunded_total_amount": 10.00,
		"supply_timestamp": "2024-11-15T11:45:30Z",
		"update_timestamp": "2024-11-19T11:03:55Z",
		"tax_timestamp": "2024-11-19T11:03:55Z",
		"total_amount": 199,
		"invoice_image_url_secret": "31U-vxkMlUPAtFm3",
		"currency_code": "CHF"
	}
}

Example Invoices and Credit Notes

This section contains some example invoices and credit notes.

Invoice

The following is an example Swiss invoice. Note the information in the footer:

Credit Note

The following is an example credit note: