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

API/Reference/Tax codes

Update a tax code

PATCH 
https://api.light.inc/v1/tax-codes/{id}

Activates or disables a tax code. The status applies to every company entity the code is assigned to. Rate, posting rules and tax tags cannot be changed through the external API. 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

Path parameters

  • id string · uuidrequired

Request body

application/json;charset=UTF-8 · required

  • status stringrequired

    New status of the tax code, for every company entity it is assigned to. DISABLED_EXTERNALLY is set only by an ERP sync and cannot be set or changed here

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

    One of ACTIVE DISABLED DISABLED_EXTERNALLY

Response

The updated tax code, with the company entities it is assigned to

  • 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