New Light partners with Greenstep to bring agentic finance to the NordicsLight partners with Greenstep Read the announcement

API/Reference/Tax codes

Import default tax codes

POST 
https://api.light.inc/v1/tax-codes/import-default-taxes

Imports the country's default tax codes and their tax tags, and assigns the codes to the requested company entities. A new code takes the status of its default code; activate a disabled one with updateTaxCode. A code the company already has is never changed: it is only assigned to the requested company entities it lacks, so running the import again creates nothing. Requires the company admin role.

Authorization

Send one of these on every request. See Authentication for how to get credentials.

  • API key

    Basic authentication header of the form Basic <api_key>, where <api_key> is your api key.

  • Bearer token

Request body

application/json;charset=UTF-8

  • country stringrequired

    Country whose default tax codes are imported

    ⚠️ This enum is not exhaustive; new values may be added in the future.

    One of AC AD AE AF AG AI AL AM AN AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BU BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CP CR CS CU CV CW CX CY CZ DE DG DJ DK DM DO DZ EA EC EE EG EH ER ES ET EU EZ FI FJ FK FM FO FR FX GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU IC ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NT NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SF SG SH SI SJ SK SL SM SN SO SR SS ST SU SV SX SY SZ TA TC TD TF TG TH TJ TK TL TM TN TO TP TR TT TV TW TZ UA UG UK UM US UY UZ VA VC VE VG VI VN VU WF WS XI XU XK YE YT YU ZA ZM ZR ZW

  • companyEntityIds array of string · uuidrequired

    Company entities the imported tax codes are assigned to

  • salesTaxAccountId string · uuidrequired

    Ledger account sales tax codes post their tax to. Must be assigned to every requested company entity

  • euSalesGoodsTaxAccountId string · uuid

    Ledger account for tax on EU sales of goods. Defaults to salesTaxAccountId. Must be assigned to every requested company entity

  • euSalesServicesTaxAccountId string · uuid

    Ledger account for tax on EU sales of services. Defaults to salesTaxAccountId. Must be assigned to every requested company entity

  • euSalesContraTaxAccountId string · uuid

    Contra ledger account for EU sales. Defaults to salesTaxAccountId. Must be assigned to every requested company entity

  • purchaseTaxAccountId string · uuidrequired

    Ledger account purchase tax codes post their tax to. Must be assigned to every requested company entity

  • euPurchaseGoodsTaxAccountId string · uuid

    Ledger account for tax on EU purchases of goods. Defaults to purchaseTaxAccountId. Must be assigned to every requested company entity

  • euPurchaseServicesTaxAccountId string · uuid

    Ledger account for tax on EU purchases of services. Defaults to purchaseTaxAccountId. Must be assigned to every requested company entity

  • euPurchaseContraTaxAccountId string · uuid

    Contra ledger account for EU purchases. Defaults to purchaseTaxAccountId. Must be assigned to every requested company entity

Response

The country's tax codes assigned to the requested company entities, the new ones and the ones that already existed

  • id string · uuid

    Unique identifier for the tax code. Documents reference it as taxCodeId

  • companyId string · uuid

    ID of the company

  • code string

    Short code of the tax code, unique within the company

  • name string

    Display name of the tax code

  • rate number

    Tax rate as a fraction: 0.25 is 25%. Null for an exempt tax code

  • type string

    Whether the tax code applies to purchases (bills) or to sales (sales invoices)

    ⚠️ This enum is not exhaustive; new values may be added in the future.

    One of PURCHASE SALES

  • status string

    Status of the tax code. DISABLED_EXTERNALLY is set by an ERP sync when the code was disabled in the ERP

    ⚠️ This enum is not exhaustive; new values may be added in the future.

    One of ACTIVE DISABLED DISABLED_EXTERNALLY

  • sourceType string

    Where the tax code is maintained. SYNCED_EXTERNALLY means the code mirrors one in the company's ERP; INTERNAL means it was created in Light

    ⚠️ This enum is not exhaustive; new values may be added in the future.

    One of INTERNAL SYNCED_EXTERNALLY

  • country string

    Country whose tax rules the tax code follows

    ⚠️ This enum is not exhaustive; new values may be added in the future.

    One of AC AD AE AF AG AI AL AM AN AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BU BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CP CR CS CU CV CW CX CY CZ DE DG DJ DK DM DO DZ EA EC EE EG EH ER ES ET EU EZ FI FJ FK FM FO FR FX GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU IC ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NT NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SF SG SH SI SJ SK SL SM SN SO SR SS ST SU SV SX SY SZ TA TC TD TF TG TH TJ TK TL TM TN TO TP TR TT TV TW TZ UA UG UK UM US UY UZ VA VC VE VG VI VN VU WF WS XI XU XK YE YT YU ZA ZM ZR ZW

  • taxCategory string

    Whether the tax code is for goods or for services. Null when not set

    ⚠️ This enum is not exhaustive; new values may be added in the future.

    One of GOODS SERVICES

  • edifactCode string

    Duty or tax category code from the UNCL5305 code list, used on electronic invoices (https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL5305/)

    ⚠️ This enum is not exhaustive; new values may be added in the future.

    One of AE E G K L M O S Z

  • context string

    Free-text guidance describing when the tax code applies

  • baseTaxTag object

    Tax tag a tax code reports its taxable base or a posted share under on the tax report

    • id string · uuid

      Unique identifier for the tax tag

    • label string

      Label of the tax tag, as it appears on the tax report

    • country string

      Country whose tax report the tax tag belongs to

      ⚠️ This enum is not exhaustive; new values may be added in the future.

      One of AC AD AE AF AG AI AL AM AN AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BU BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CP CR CS CU CV CW CX CY CZ DE DG DJ DK DM DO DZ EA EC EE EG EH ER ES ET EU EZ FI FJ FK FM FO FR FX GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU IC ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NT NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SF SG SH SI SJ SK SL SM SN SO SR SS ST SU SV SX SY SZ TA TC TD TF TG TH TJ TK TL TM TN TO TP TR TT TV TW TZ UA UG UK UM US UY UZ VA VC VE VG VI VN VU WF WS XI XU XK YE YT YU ZA ZM ZR ZW

  • postingRules array of object

    • percentage number

      Share of the tax this rule posts, as a fraction: 1 is all of it and -1 reverses all of it

    • accountId string · uuid

      Ledger account the share is posted to. Null when the share is posted to the account of the line the tax code is used on

    • taxTag object

      Tax tag a tax code reports its taxable base or a posted share under on the tax report

      • id string · uuid

        Unique identifier for the tax tag

      • label string

        Label of the tax tag, as it appears on the tax report

      • country string

        Country whose tax report the tax tag belongs to

        ⚠️ This enum is not exhaustive; new values may be added in the future.

        One of AC AD AE AF AG AI AL AM AN AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BU BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CP CR CS CU CV CW CX CY CZ DE DG DJ DK DM DO DZ EA EC EE EG EH ER ES ET EU EZ FI FJ FK FM FO FR FX GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU IC ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NT NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SF SG SH SI SJ SK SL SM SN SO SR SS ST SU SV SX SY SZ TA TC TD TF TG TH TJ TK TL TM TN TO TP TR TT TV TW TZ UA UG UK UM US UY UZ VA VC VE VG VI VN VU WF WS XI XU XK YE YT YU ZA ZM ZR ZW

  • companyEntityIds array of string · uuid

    Company entities the code may be used in

  • createdAt string · date-time

    Timestamp when the tax code was created

  • updatedAt string · date-time

    Timestamp when the tax code was last updated