NAME

Business::Tax::ID::PPH21 - Routines to help calculate Indonesian income tax article 21 (PPh pasal 21)

VERSION

This document describes version 0.067 of Business::Tax::ID::PPH21 (from Perl distribution Business-Tax-ID-PPH21), released on 2023-03-30.

SYNOPSIS

DESCRIPTION

Notes about laws/regulations

PP 55/2022

Regarding PPh Pasal 21, this law only regulates the taxing of "natura" (non-cash benefits given to employees, such as laptops, phones, etc). PP 55/2022 does not change PTKP or tax brackets.

UU HPP 7/2021

UU 36/2008

UU 7/1983

The law ("undang-undang") for income tax ("pajak penghasilan") in Indonesia is UU 7/1983 (along with its several amendments, the latest two of which are UU 36/2008, UU HPP 7/2021, and PP 55/2022). This law is comprised of several articles ("pasal"). Article 21 ("pasal 21") regulates earned income, which is income generated by individual/statutory bodies from performed work/services, including: employment (salary and benefits, as well as severance pay), freelance work, business, pension, and "jaminan hari tua" (life insurance paid to dependents when a worker is deceased). Article 21 also regulates some types of passive income, which is income generated from capital or other non-work sources, including: savings interests, gifts/lotteries, royalties.

Some other passive income like rent and dividends are regulated in article 23 ("pasal 23") instead of article 21. And some articles regulate other aspects or special cases, e.g. income tax for sales to government agencies/import/specific industries ("pasal 22"), rules regarding monthly tax payments ("pasal 25"), or rules regarding work earned in Indonesia by non-citizens ("pasal 26").

This module contains several routines to help calculate income tax article 21.

FUNCTIONS

calc_net_income_from_pph21_op

Usage:

calc_net_income_from_pph21_op(%args) -> [$status_code, $reason, $payload, \%result_meta]

Given that someone pays a certain amount of PPh 21 op, calculate her yearly net income.

Examples:

  • Someone who doesn't pay PPh 21 op earns at or below PTKP:

    calc_net_income_from_pph21_op(year => 2016, pph21_op => 0, tp_status => "TK/0"); # -> [200, "OK", 54000000, {}]
  • Example #2:

    calc_net_income_from_pph21_op(year => 2016, pph21_op => 20000000, tp_status => "K/2");

    Result:

    [200, "OK", 234166666.666667, {}]

If pph21_op is 0, will return the PTKP amount. Actually one can earn between zero and the full PTKP amount to pay zero PPh 21 op.

This function is not exported by default, but exportable.

Arguments ('*' denotes required arguments):

  • monthly => bool

    Instead of yearly, return monthly net income.

  • pph21_op* => float

    Amount of PPh 21 op paid.

  • tp_status* => str

    Taxypayer status.

    Taypayer status reflects his/her marital status and affects the amount of his/her non-taxable income.

  • year => int

    (No description)

Returns an enveloped result (an array).

First element ($status_code) is an integer containing HTTP-like status code (200 means OK, 4xx caller error, 5xx function error). Second element ($reason) is a string containing error message, or something like "OK" if status is 200. Third element ($payload) is the actual result, but usually not present when enveloped result is an error response ($status_code is not 2xx). Fourth element (%result_meta) is called result metadata and is optional, a hash that contains extra information, much like how HTTP response headers provide additional metadata.

Return value: (any)

calc_pph21_op

Usage:

calc_pph21_op(%args) -> [$status_code, $reason, $payload, \%result_meta]

Calculate PPh 21 for individuals ("OP", "orang pribadi").

Examples:

  • Someone who earns below PTKP:

    calc_pph21_op(year => 2015, net_income => 30000000, tp_status => "TK/0"); # -> [200, "OK", 0, {}]
  • Example #2:

    calc_pph21_op(year => 2015, net_income => 300000000, tp_status => "K/2");

    Result:

    [200, "OK", 33750000, {}]

This function is not exported by default, but exportable.

Arguments ('*' denotes required arguments):

  • net_income* => float

    Yearly net income.

  • tp_status* => str

    Taxypayer status.

    Taypayer status reflects his/her marital status and affects the amount of his/her non-taxable income.

  • year => int

    (No description)

Returns an enveloped result (an array).

First element ($status_code) is an integer containing HTTP-like status code (200 means OK, 4xx caller error, 5xx function error). Second element ($reason) is a string containing error message, or something like "OK" if status is 200. Third element ($payload) is the actual result, but usually not present when enveloped result is an error response ($status_code is not 2xx). Fourth element (%result_meta) is called result metadata and is optional, a hash that contains extra information, much like how HTTP response headers provide additional metadata.

Return value: (any)

get_pph21_op_ptkp

Usage:

get_pph21_op_ptkp(%args) -> [$status_code, $reason, $payload, \%result_meta]

Get PPh21 non-taxable income amount ("PTKP") for individuals.

Examples:

  • Example #1:

    get_pph21_op_ptkp(year => 2016);

    Result:

    [
      200,
      "OK",
      {
        "K/0"   => 58500000,
        "K/1"   => 63000000,
        "K/2"   => 67500000,
        "K/3"   => 72000000,
        "K/I/0" => 112500000,
        "K/I/1" => 117000000,
        "K/I/2" => 121500000,
        "K/I/3" => 126000000,
        "TK/0"  => 54000000,
        "TK/1"  => 58500000,
        "TK/2"  => 63000000,
        "TK/3"  => 67500000,
      },
      {},
    ]

When calculating individual income tax, the net income is subtracted by this amount first. This means that if a person has income below this amount, he/she does not need to pay income tax.

This function is not exported by default, but exportable.

Arguments ('*' denotes required arguments):

  • year => int

    (No description)

Returns an enveloped result (an array).

First element ($status_code) is an integer containing HTTP-like status code (200 means OK, 4xx caller error, 5xx function error). Second element ($reason) is a string containing error message, or something like "OK" if status is 200. Third element ($payload) is the actual result, but usually not present when enveloped result is an error response ($status_code is not 2xx). Fourth element (%result_meta) is called result metadata and is optional, a hash that contains extra information, much like how HTTP response headers provide additional metadata.

Return value: (any)

get_pph21_op_rates

Usage:

get_pph21_op_rates(%args) -> [$status_code, $reason, $payload, \%result_meta]

Get tax rates for PPh21 for individuals ("OP", "orang pribadi").

Examples:

  • Example #1:

    get_pph21_op_rates(year => 2022);

    Result:

    [
      200,
      "OK",
      [
        { max => 60000000, rate => 0.05 },
        { xmin => 60000000, max => 250000000, rate => 0.15 },
        { xmin => 250000000, max => 500000000, rate => 0.25 },
        { xmin => 500000000, max => 5000000000, rate => 0.3 },
        { xmin => 5000000000, rate => 0.35 },
      ],
      {
        "table.field_formats" => [undef, undef, ["percent", { sprintf => "%3.0f%%" }]],
        "table.fields"        => ["xmin", "max", "rate"],
      },
    ]

PPh21 differentiates rates between individuals ("OP", "orang pribadi") and statutory bodies ("badan"). Both are progressive. This routine returns the tax rates for individuals.

Keywords: tax rates, tax brackets.

This function is not exported by default, but exportable.

Arguments ('*' denotes required arguments):

  • year => int

    (No description)

Returns an enveloped result (an array).

First element ($status_code) is an integer containing HTTP-like status code (200 means OK, 4xx caller error, 5xx function error). Second element ($reason) is a string containing error message, or something like "OK" if status is 200. Third element ($payload) is the actual result, but usually not present when enveloped result is an error response ($status_code is not 2xx). Fourth element (%result_meta) is called result metadata and is optional, a hash that contains extra information, much like how HTTP response headers provide additional metadata.

Return value: (any)

HOMEPAGE

Please visit the project's homepage at https://metacpan.org/release/Business-Tax-ID-PPH21.

SOURCE

Source repository is at https://github.com/perlancar/perl-Business-Tax-ID-PPH21.

SEE ALSO

AUTHOR

perlancar <perlancar@cpan.org>

CONTRIBUTING

To contribute, you can send patches by email/via RT, or send pull requests on GitHub.

Most of the time, you don't need to build the distribution yourself. You can simply modify the code, then test via:

% prove -l

If you want to build the distribution (e.g. to try to install it locally on your system), you can install Dist::Zilla, Dist::Zilla::PluginBundle::Author::PERLANCAR, Pod::Weaver::PluginBundle::Author::PERLANCAR, and sometimes one or two other Dist::Zilla- and/or Pod::Weaver plugins. Any additional steps required beyond that are considered a bug and can be reported to me.

COPYRIGHT AND LICENSE

This software is copyright (c) 2023, 2021, 2020, 2019, 2017, 2015 by perlancar <perlancar@cpan.org>.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

BUGS

Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=Business-Tax-ID-PPH21

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.