Skip to main content
PUT
Save the corporate tax inputs
Live capability. Melso runs this in production today. Partner keys reach it once your partner account is enabled. See Availability.
A person decides. The company’s owner makes this call, signed in to Melso. Partner keys cannot make it: send the person the approval link instead. See Approvals and filing.
Only the fields you send change; an empty amount takes the value from the books. It does not approve or file the 200.

Authorizations

Authorization
string
header
required

Your partner secret key, mk_live_… for real companies or mk_test_… for test companies. Keep it on your servers. See Authentication.

Path Parameters

company_id
string<uuid>
required

The company's ID. Every company-scoped call works in exactly this company.

year
integer
required

The fiscal year, such as 2025.

Required range: 2000 <= x <= 2100

Body

application/json
expected_version
integer
required

The version you read; 0 when nothing was saved yet.

Required range: x >= 0
adjustments
object[]

Every adjustment to the accounting result (ajustes extracontables). Replaces the saved list.

Maximum array length: 50
capitalization_reserve
boolean

Apply the capitalization reserve (art. 25 LIS).

deductions
string

An amount in euros as a decimal string with two decimals, such as "121.00".

Pattern: ^-?[0-9]+\.[0-9]{2}$
Example:

"121.00"

instalments
string

The year's 202 instalments paid. Empty to take them from the books.

losses_offset
string

Negative bases of earlier years offset.

new_entity
boolean

A company in its first or second year with a positive base

period_base
boolean

The company opted for the 202 on the year's result so far (art. 40.3 LIS).

prior_turnover
string

The year before's turnover, which sets the rate. Empty to take it from the books.

withholdings
string

Withholdings suffered. Empty to take them from the books.

workforce_growth
integer

Growth of the average workforce over the year before

Response

The recalculated tax.

year
integer
version
integer
result_before_tax
string

An amount in euros as a decimal string with two decimals, such as "121.00".

Pattern: ^-?[0-9]+\.[0-9]{2}$
Example:

"121.00"

adjustments_total
string

An amount in euros as a decimal string with two decimals, such as "121.00".

Pattern: ^-?[0-9]+\.[0-9]{2}$
Example:

"121.00"

capitalization_reserve
string

An amount in euros as a decimal string with two decimals, such as "121.00".

Pattern: ^-?[0-9]+\.[0-9]{2}$
Example:

"121.00"

losses_offset
string

An amount in euros as a decimal string with two decimals, such as "121.00".

Pattern: ^-?[0-9]+\.[0-9]{2}$
Example:

"121.00"

taxable_base
string

An amount in euros as a decimal string with two decimals, such as "121.00".

Pattern: ^-?[0-9]+\.[0-9]{2}$
Example:

"121.00"

rate
string

A decimal number as a string, such as "21" or "0.5".

Pattern: ^-?[0-9]{1,10}(\.[0-9]{1,6})?$
gross_tax
string

An amount in euros as a decimal string with two decimals, such as "121.00".

Pattern: ^-?[0-9]+\.[0-9]{2}$
Example:

"121.00"

net_tax
string

An amount in euros as a decimal string with two decimals, such as "121.00".

Pattern: ^-?[0-9]+\.[0-9]{2}$
Example:

"121.00"

withholdings
string

An amount in euros as a decimal string with two decimals, such as "121.00".

Pattern: ^-?[0-9]+\.[0-9]{2}$
Example:

"121.00"

instalments_paid
string

An amount in euros as a decimal string with two decimals, such as "121.00".

Pattern: ^-?[0-9]+\.[0-9]{2}$
Example:

"121.00"

to_pay
string

An amount in euros as a decimal string with two decimals, such as "121.00".

Pattern: ^-?[0-9]+\.[0-9]{2}$
Example:

"121.00"

instalments
object[]

The modelo 202 instalments of the next year that build on this result.

review
string[]