Goods and Services Tax (GST) (Singapore)

In Singapore, the VAT equivalent is called Goods and Services Tax (GST). This requires some specific configurations in your marketplace and seller settings.

To qualify for GST, the following criteria must be satisfied:

  • The value of the goods must be 400 Singaporean Dollars (SGD) or lower. Whether this value is calculated for each transaction line or consignment, is specified in your marketplace's regional settings.
  • The goods must be transported by air or sea. To identify a transaction or transaction line as such, you add a flag to the transaction's JSON.

Marketplace Settings

In the regional settings for the marketplace, you need to configure the following settings:

SettingDescription
regions.SG.taxation.physical.threshold_determination_method

This setting determines how the value of goods is calculated. The default setting is per-line. You can specify one of the following values:

  • per-line: Calculated for each transaction line in a transaction.
  • consignment: Calculated on the value of the consignment (as specified in the consignment_id field in the transaction).
regions.SG.taxation.physical.is_approved_ovr_vendorThis setting can be true or false. It specifies whether the marketplace can bear liability for applicable transactions that are identified as qualifying for GST (by the flag in the transaction's JSON).

Seller Settings

To allow a seller to participate in GST, you need to specify the following setting in the Seller's regional settings:

SettingDescription
regions.SG.taxation.physical.is_approved_ovr_vendorThis can be true or false. It specifies whether the seller can be treated as being able to bear liability in Singapore.

For example:

"sellers": [
       {
        "email": "[email protected]",
        "postal_address_line1": "WAW Street 1",
        "postal_address_line2": "Warsaw",
        "first_name": "Juan",
        "settings": {
          "timezone": "GMT",
          "invoicing": {
            "invoice_logo_url": "https://example.com/images/exampleicon.png",
            "detect_currency_from_tax_country": true
          },
          "countries": {
            "SG": {
              "taxation": {
                "physical": {
                  "is_seller_registered": true,
                  "is_physical_tax_enabled": true,
                  "seller_tax_number": "ABCD12345"
                }
              }
            }
          },
          "regions": {
            "SG": {
              "taxation": {
                "digital": {
                  "is_taxation_enabled": true
                },
                "physical": {
                  "is_seller_located_within_region": true,
                  "use_marketplace_as_intermediary": true
                }
              }
            }
          } 
        },
         "business_name": "Acme Inc.",
         "last_name": "Sanchez",
         "country": "PL",
         "seller_code": "sg_seller"
       }
     ]
  }
}

Transactions

After you configure the settings, you need to specify that a transaction qualifies for GST in your transaction requests.

To do so, you need to add a flag to indicate that the goods have been shipped by sea or air.

FlagDescription
tax_engine_additional_parameter.sg_ovr_shipmentThis can be true or false. It indicates that the goods have been transported by air or sea and thus qualify for GST.

For example:

[
    { 
   "tax_engine_additional_parameters" : [{
      param: "sg_ovr_shipment", value: true}
    ]

You can apply this flag to the transaction or on each transaction line.

The following example sets the flag for each transaction line. It also includes the seller settings:

{    
  "transaction":{
    "currency_code": "EUR",
    "buyer_name": "Scenario #1 buyer",
    "purchase_order_number": "1",
    "ship_to_address": {
    "street_name": "30 Monmouth Street", 
    "city": "Berlin",
    "postal_code": "BA1 2AP",
    "country_code": "SG"
    },
   "description": "TC1 SG_Create transaction",
   "transaction_lines": [
     { 
      "tax_engine_additional_parameters" : [
      {param: "sg_ovr_shipment", value: true}]
     }
   ]
     {
       "seller_code": "sg_seller",
       "custom_id": "line_1",
       "amount": 149.99,
       "ship_from_address": {
         "country_code": "SG"
       },
       "product_class": "P",
       "description": "Hammers",
       "parcel_reference": "748593403",
       "carrier_id": "DHL",
       "product_cn_code": "0870",
       "product_reference_number": ""
     }
       {
       "seller_code": "sg_seller",
       "custom_id": "line_2",
       "amount": 19.99,
       "ship_from_address": {
         "country_code": "SG"
       },
       "product_class": "P",
       "description": "Nails",
       "parcel_reference": "2304349",
       "carrier_id": "DHL",
       "product_cn_code": "0870",
       "product_reference_number": ""
     }
   ],
     "sellers": [
       {
        "email": "[email protected]",
        "postal_address_line1": "WAW Street 1",
        "postal_address_line2": "Warsaw",
        "first_name": "Juan",
        "settings": {
          "timezone": "GMT",
          "invoicing": {
            "invoice_logo_url": "https://example.coml/images/exampleicon.png",
            "detect_currency_from_tax_country": true
          },
          "countries": {
            "SG": {
              "taxation": {
                "physical": {
                  "is_seller_registered": true,
                  "is_physical_tax_enabled": true,
                  "seller_tax_number": "ABCD54321"
                }
              }
            }
          },
          "regions": {
            "SG": {
              "taxation": {
                "digital": {
                  "is_taxation_enabled": true
                },
                "physical": {
                  "is_seller_located_within_region": true,
                  "use_marketplace_as_intermediary": true
                }
              }
            }
          } 
        },
         "business_name": "Acme Inc.",
         "last_name": "Juan",
         "country": "PL",
         "seller_code": "sg_seller"
       }
     ]
  }
}

The following example shows how you can apply the flag to the entire transaction:

{    
  "transaction":{
    "currency_code": "EUR",
    "buyer_name": "Scenario #1 buyer",
    "purchase_order_number": "1",
    "ship_to_address": {
    "street_name": "30 Monmouth Street", 
    "city": "Berlin",
    "postal_code": "BA1 2AP",
    "country_code": "SG"
    },
  { 
    "tax_engine_additional_parameters" : [
      {param: "sg_ovr_shipment", value: true}]
     }
   "description": "TC1 SG_Create transaction",
   "transaction_lines": [
     {
       "seller_code": "sg_seller",
       "custom_id": "line_1",
       "amount": 149.99,
       "ship_from_address": {
         "country_code": "SG"
       },
       "product_class": "P",
       "description": "Hammers",
       "parcel_reference": "748593403",
       "carrier_id": "DHL",
       "product_cn_code": "0870",
       "product_reference_number": ""
     }
       {
       "seller_code": "sg_seller",
       "custom_id": "line_2",
       "amount": 19.99,
       "ship_from_address": {
         "country_code": "SG"
       },
       "product_class": "P",
       "description": "Nails",
       "parcel_reference": "2304349",
       "carrier_id": "DHL",
       "product_cn_code": "0870",
       "product_reference_number": ""
     }
   ],
     "sellers": [
       {
        "email": "[email protected]",
        "postal_address_line1": "WAW Street 1",
        "postal_address_line2": "Warsaw",
        "first_name": "Juan",
        "settings": {
          "timezone": "GMT",
          "invoicing": {
            "invoice_logo_url": "https://example.coml/images/exampleicon.png",
            "detect_currency_from_tax_country": true
          },
          "countries": {
            "SG": {
              "taxation": {
                "physical": {
                  "is_seller_registered": true,
                  "is_physical_tax_enabled": true,
                  "seller_tax_number": "ABCD54321"
                }
              }
            }
          },
          "regions": {
            "SG": {
              "taxation": {
                "digital": {
                  "is_taxation_enabled": true
                },
                "physical": {
                  "is_seller_located_within_region": true,
                  "use_marketplace_as_intermediary": true
                }
              }
            }
          } 
        },
         "business_name": "Acme Inc.",
         "last_name": "Juan",
         "country": "PL",
         "seller_code": "sg_seller"
       }
     ]
  }
}