Tax

These endpoints let you manage tax-related features in the system. It allows you to retrieve tax configurations, calculate taxes, and manage tax records.

Get Kpp

get

Search Query

Supported Keys

Supported Operators

Notes

name

Like operator

code

Like operator

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

application/json

totalPagesintegerRequired

Total number of pages available

lastbooleanRequired

Indicates whether this is the last page

totalElementsintegerRequired

Total number of elements across all pages

numberOfElementsintegerRequired

Number of elements in the current page

firstbooleanRequired

Indicates whether this is the first page

sizeintegerRequired

Size of the page (number of elements per page)

numberintegerRequired

Current page number (zero-indexed)

400

Bad Request

get

/core/v1/kpps

curl -X GET \
  "https://api.catapa.com/core/v1/kpps" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

{
  "content": [
    {
      "id": "string",
      "code": "string",
      "name": "string",
      "address": "string",
      "responsiblePersonName": "string",
      "responsiblePersonNpwp": "string",
      "responsiblePersonJobTitle": "string",
      "kppStatus": "string"
    }
  ],
  "totalPages": 1,
  "last": true,
  "totalElements": 1,
  "numberOfElements": 1,
  "sort": [
    {
      "direction": "DESC",
      "property": "updatedDate",
      "ignoreCase": false,
      "nullHandling": "NATIVE",
      "ascending": false,
      "descending": true
    },
    {
      "direction": "DESC",
      "property": "id",
      "ignoreCase": false,
      "nullHandling": "NATIVE",
      "ascending": false,
      "descending": true
    }
  ],
  "first": true,
  "size": 10,
  "number": 0
}

Get Monthly Tax Report

get

Search Query

Supported Keys

Supported Operators

Notes

year

: > <

Equal operator Greater than or equal to Less than or equal to

month

: > <

Equal operator Greater than or equal to Less than or equal to equal operator

taxObject

Equal operator

taxObjectIn

Equal operator with multiple value delimited by “;”

pph21Method

Equal operator

employeeId

Equal operator

employeeIdentificationNumber

Like operator

employeeName

Like operator

kppId

Equal operator

migrated

Equal operator

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

application/json

totalPagesintegerRequired

Total number of pages available

lastbooleanRequired

Indicates whether this is the last page

totalElementsintegerRequired

Total number of elements across all pages

numberOfElementsintegerRequired

Number of elements in the current page

firstbooleanRequired

Indicates whether this is the first page

sizeintegerRequired

Size of the page (number of elements per page)

numberintegerRequired

Current page number (zero-indexed)

400

Bad Request

get

/core/v1/monthly-tax-reports

curl -X GET \
  "https://api.catapa.com/core/v1/monthly-tax-reports" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

{
  "content": [
    {
      "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
      "year": 2020,
      "month": 1,
      "pph21Method": "GROSS",
      "membershipNumber": "123456789012345",
      "membershipAddress": "Kalideres",
      "totalMonthlyGrossIncome": 7000000,
      "totalTaxAndAllowance": {
        "original": 60000,
        "penalty": 200,
        "tax": 60200,
        "allowance": 0
      },
      "paidTaxAndAllowance": {
        "original": 60000,
        "penalty": 200,
        "tax": 60200,
        "allowance": 0
      },
      "taxObject": "PERMANENT",
      "sequenceNumber": 1,
      "migrated": false,
      "employee": {
        "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
        "identificationNumber": "id-01",
        "name": "Employee Name"
      },
      "kpp": {
        "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
        "identificationNumber": "kpp-01",
        "name": "Kpp Name"
      }
    }
  ],
  "pageable": "INSTANCE",
  "number": 0,
  "size": 10,
  "totalPages": 1,
  "numberOfElements": 1,
  "totalElements": 1,
  "last": true,
  "sort": [],
  "first": true,
  "empty": true
}

Get Monthly Tax Detail

get

Search Query

Supported Keys

Supported Operators

Notes

year

: > <

Equal operator Greater than or equal to Less than or equal to

month

: > <

Equal operator Greater than or equal to Less than or equal to equal operator

taxObject

Equal operator

taxObjectIn

Equal operator with multiple value delimited by “;”

pph21Method

Equal operator

employeeId

Equal operator

employeeIdentificationNumber

Like operator

employeeName

Like operator

kppId

Equal operator

migrated

Equal operator

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

pageintegerOptional

Page number

Default: 0Example: 0

sizeinteger · min: 1 · max: 50Optional

Page size

Default: 10Example: 10

Responses

200

application/json

totalPagesintegerRequired

Total number of pages available

lastbooleanRequired

Indicates whether this is the last page

totalElementsintegerRequired

Total number of elements across all pages

numberOfElementsintegerRequired

Number of elements in the current page

firstbooleanRequired

Indicates whether this is the first page

sizeintegerRequired

Size of the page (number of elements per page)

numberintegerRequired

Current page number (zero-indexed)

400

Bad Request

get

/core/v1/monthly-tax-details

curl -X GET \
  "https://api.catapa.com/core/v1/monthly-tax-details?page=0&size=10" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

{
  "content": [
    {
      "annualCalculation": true,
      "taxObject": "PERMANENT",
      "year": 2024,
      "month": 1,
      "employeeId": "string",
      "npwpNumber": "string",
      "npwpAddress": "string",
      "ptkpCategoryCode": "string",
      "terCategory": "string",
      "percentage": 0,
      "monthlyGrossIncome": 0,
      "tax": {
        "original": 0,
        "penalty": 0
      },
      "regularTax": {
        "original": 0,
        "penalty": 0
      },
      "bonusTax": {
        "original": 0,
        "penalty": 0
      },
      "income": {
        "basicSalary": 0,
        "taxAllowance": 0,
        "bonus": 0,
        "irregularBonus": 0,
        "bonusAllowance": 0,
        "honorarium": 0,
        "insurancePremium": 0,
        "enjoymentRevenue": 0,
        "otherAllowance": 0,
        "irregularOtherAllowance": 0,
        "retirementContribution": 0,
        "religionAllowance": 0
      },
      "positionalAllowance": 0,
      "baseIncomeTaxDeduction": 0
    }
  ],
  "pageable": "INSTANCE",
  "number": 0,
  "size": 10,
  "totalPages": 1,
  "numberOfElements": 1,
  "totalElements": 1,
  "last": true,
  "sort": [],
  "first": true,
  "empty": true
}

Get Pph21 Policy

get

Return the Pph21 policy.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

application/json

idstringOptional

linkToPayrollbooleanOptional

pph21FormFormatNumberstringOptional

pph21MethodstringOptional

400

Bad Request

get

/core/v1/pph21-policies

curl -X GET \
  "https://api.catapa.com/core/v1/pph21-policies" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

{
  "id": "string",
  "linkToPayroll": true,
  "pph21FormFormatNumber": "CONTINUE_NUMBERING",
  "pph21Method": "GROSS"
}

Get Ptkp Categories

get

Search Query

Supported Keys

Supported Operators

Notes

name

Like operator

code

Like operator

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

application/json

totalPagesintegerRequired

Total number of pages available

lastbooleanRequired

Indicates whether this is the last page

totalElementsintegerRequired

Total number of elements across all pages

numberOfElementsintegerRequired

Number of elements in the current page

firstbooleanRequired

Indicates whether this is the first page

sizeintegerRequired

Size of the page (number of elements per page)

numberintegerRequired

Current page number (zero-indexed)

400

Bad Request

get

/core/v1/ptkp-categories

curl -X GET \
  "https://api.catapa.com/core/v1/ptkp-categories" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

{
  "content": [
    {
      "id": "string",
      "code": "string",
      "name": "string",
      "maxDependent": 0,
      "formula": "string"
    }
  ],
  "totalPages": 1,
  "last": true,
  "totalElements": 1,
  "numberOfElements": 1,
  "sort": [
    {
      "direction": "DESC",
      "property": "updatedDate",
      "ignoreCase": false,
      "nullHandling": "NATIVE",
      "ascending": false,
      "descending": true
    },
    {
      "direction": "DESC",
      "property": "id",
      "ignoreCase": false,
      "nullHandling": "NATIVE",
      "ascending": false,
      "descending": true
    }
  ],
  "first": true,
  "size": 10,
  "number": 0
}

Get Tax Calculations

get

Search Query

Supported Keys

Supported Operators

Notes

idIn

Equal operator with multiple value delimited by “;”

employeeIdIn

Equal operator with multiple value delimited by “;”

year

: > <

Equal operator Greater than or equal to Less than or equal to

month

: > <

Equal operator Greater than or equal to Less than or equal to equal operator

paymentDate

: > <

Equal operator Greater than or equal to Less than or equal to equal operator

taxObject

Equal operator

taxObjectIn

Equal operator with multiple value delimited by “;”

pph21Method

Equal operator

employeeId

Equal operator

employeeName

Like operator

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

application/json

totalPagesintegerRequired

Total number of pages available

lastbooleanRequired

Indicates whether this is the last page

totalElementsintegerRequired

Total number of elements across all pages

numberOfElementsintegerRequired

Number of elements in the current page

firstbooleanRequired

Indicates whether this is the first page

sizeintegerRequired

Size of the page (number of elements per page)

numberintegerRequired

Current page number (zero-indexed)

400

Bad Request

get

/core/v1/tax-calculations

curl -X GET \
  "https://api.catapa.com/core/v1/tax-calculations" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

{
  "content": [
    {
      "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
      "createdBy": "admin",
      "createdDate": 1092038012,
      "updatedBy": "admin",
      "updatedDate": 1092038012,
      "employee": {
        "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
        "identificationNumber": "id-01",
        "name": "Employee Name",
        "company": "Company Name"
      },
      "kpp": {
        "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
        "identificationNumber": "kpp-01",
        "name": "Kpp Name"
      },
      "externalId": "79f537af-83b2-4a8b-851c-5d14ec046553",
      "year": 2020,
      "month": 1,
      "pph21Method": "GROSS",
      "membershipNumber": "123456789012345",
      "membershipAddress": "Kalideres",
      "totalMonthlyGrossIncome": 7000000,
      "totalTaxAndAllowance": {
        "original": 60000,
        "penalty": 200,
        "tax": 60200,
        "allowance": 0
      },
      "paidTaxAndAllowance": {
        "original": 60000,
        "penalty": 200,
        "tax": 60200,
        "allowance": 0
      },
      "type": "PERMANENT",
      "taxObject": "PERMANENT",
      "referenceYear": 2020,
      "referenceMonth": 1,
      "multiplier": 1,
      "calculationType": "REGULAR",
      "paymentMethod": "COMBINED",
      "referenceDate": "2020-01-01",
      "paymentDate": "2020-01-01"
    }
  ],
  "pageable": "INSTANCE",
  "number": 0,
  "size": 10,
  "totalPages": 1,
  "numberOfElements": 8,
  "totalElements": 8,
  "last": true,
  "sort": [],
  "first": true,
  "empty": true
}

Create Tax Calculation

post

Create a tax calculation.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

employeeIdstringRequired

referenceDatestring · dateRequired

paymentMethodstring · enumRequiredPossible values:

externalIdstringRequired

multipliernumberRequired

paymentDatestring · dateRequired

calculationTypestringRequired

workingDaysnumberRequired

Responses

200

application/json

idstring · uuidOptional

createdBystringOptional

createdDatenumberOptional

updatedBystringOptional

updatedDatenumberOptional

externalIdstringOptional

yearnumberOptional

monthnumberOptional

pph21MethodstringOptional

membershipNumberstringOptional

membershipAddressstringOptional

totalMonthlyGrossIncomenumberOptional

typestringOptional

taxObjectstring · enumOptionalPossible values:

referenceYearnumberOptional

referenceMonthnumberOptional

multipliernumberOptional

calculationTypestringOptional

paymentMethodstring · enumOptionalPossible values:

referenceDatestring · dateOptional

paymentDatestring · dateOptional

400

Bad Request

post

/core/v1/tax-calculations

curl -X POST \
  "https://api.catapa.com/core/v1/tax-calculations" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id" \
  -H "Content-Type: application/json" \
  -d '{
  "employeeId": "d2ea6f82-dd24-4415-9e6a-73782100a625",
  "incomes": [
    {
      "method": "GROSS_UP",
      "amount": 40000000,
      "item": "ITEM_01_BASIC_SALARY"
    },
    {
      "method": "GROSS_UP",
      "amount": 10000000,
      "item": "ITEM_03_OTHER_ALLOWANCE"
    },
    {
      "method": "GROSS_UP",
      "amount": 2000000,
      "item": "ITEM_04_HONORARIUM"
    },
    {
      "method": "GROSS_UP",
      "amount": 1000000,
      "item": "ITEM_05_INSURANCE_PREMIUM"
    },
    {
      "method": "GROSS_UP",
      "amount": 5000000,
      "item": "ITEM_06_OTHER_ENJOYMENT_REVENUE"
    },
    {
      "method": "GROSS",
      "amount": 50000000,
      "item": "ITEM_07_BONUS"
    },
    {
      "method": "GROSS_UP",
      "amount": 6000000,
      "item": "ITEM_10_RETIREMENT_CONTRIBUTION"
    }
  ],
  "referenceDate": "2101-12-31",
  "paymentMethod": "COMBINED",
  "externalId": "21ba5875-d732-401a-ace8-3b55741ed36b",
  "multiplier": 1,
  "paymentDate": "2101-12-31",
  "calculationType": "REGULAR",
  "workingDays": 26
}'

{
  "id": "a5abd33b-57f0-4ee6-8729-ebd3ce9b25e5",
  "createdBy": "anonymousUser",
  "createdDate": 1665455950038,
  "updatedBy": "anonymousUser",
  "updatedDate": 1665455950038,
  "employee": {
    "id": "d2ea6f82-dd24-4415-9e6a-73782100a625",
    "identificationNumber": "EMP-01",
    "name": "Employee Name",
    "company": "Company Name"
  },
  "kpp": {
    "id": "1446d13d-933c-40a3-8c63-695f741b6fa7",
    "name": "KPP Pratama",
    "code": "098"
  },
  "externalId": "21ba5875-d732-401a-ace8-3b55741ed36b",
  "year": 2101,
  "month": 12,
  "pph21Method": "GROSS_UP",
  "membershipNumber": "123456789012345",
  "membershipAddress": "Kalideres",
  "totalMonthlyGrossIncome": 104864864,
  "totalTaxAndAllowance": {
    "original": 2864864,
    "penalty": 572973,
    "tax": 3437837,
    "allowance": 2864864
  },
  "paidTaxAndAllowance": {
    "original": 2864864,
    "penalty": 572973,
    "tax": 3437837,
    "allowance": 2864864
  },
  "type": "NON_EMPLOYEE",
  "taxObject": "EXPERT_CONTINUOUS",
  "referenceYear": 2101,
  "referenceMonth": 12,
  "multiplier": 1,
  "calculationType": "REGULAR",
  "paymentMethod": "COMBINED",
  "referenceDate": "2101-12-31",
  "paymentDate": "2101-12-31"
}

Get Tax Calculations by Id

get

Return the tax calculation by Id.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequiredExample: f47ac10b-58cc-4372-a567-0e02b2c3d479

Responses

200

application/json

idstring · uuidOptional

createdBystringOptional

createdDatenumberOptional

updatedBystringOptional

updatedDatenumberOptional

externalIdstringOptional

yearnumberOptional

monthnumberOptional

pph21MethodstringOptional

membershipNumberstringOptional

membershipAddressstringOptional

totalMonthlyGrossIncomenumberOptional

typestringOptional

taxObjectstring · enumOptionalPossible values:

referenceYearnumberOptional

referenceMonthnumberOptional

multipliernumberOptional

calculationTypestringOptional

paymentMethodstring · enumOptionalPossible values:

referenceDatestring · dateOptional

paymentDatestring · dateOptional

400

Bad Request

get

/core/v1/tax-calculations/{id}

curl -X GET \
  "https://api.catapa.com/core/v1/tax-calculations/f47ac10b-58cc-4372-a567-0e02b2c3d479" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

{
  "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
  "createdBy": "admin",
  "createdDate": 1092038012,
  "updatedBy": "admin",
  "updatedDate": 1092038012,
  "employee": {
    "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
    "identificationNumber": "id-01",
    "name": "Employee Name"
  },
  "kpp": {
    "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
    "identificationNumber": "kppd-01",
    "name": "KPP Name"
  },
  "externalId": "79f537af-83b2-4a8b-851c-5d14ec046553",
  "year": 2020,
  "month": 1,
  "pph21Method": "GROSS",
  "membershipNumber": "123456789012345",
  "membershipAddress": "Kalideres",
  "totalMonthlyGrossIncome": 7000000,
  "totalTaxAndAllowance": {
    "original": 60000,
    "penalty": 200,
    "tax": 60200,
    "allowance": 0
  },
  "paidTaxAndAllowance": {
    "original": 60000,
    "penalty": 200,
    "tax": 60200,
    "allowance": 0
  },
  "type": "PERMANENT",
  "taxObject": "PERMANENT",
  "referenceYear": 2020,
  "referenceMonth": 1,
  "multiplier": 1,
  "calculationType": "REGULAR",
  "paymentMethod": "COMBINED",
  "referenceDate": "2020-01-01",
  "paymentDate": "2020-01-01"
}

Undo Tax Calculation by Id

delete

Undo the tax calculation by Id.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequiredExample: f47ac10b-58cc-4372-a567-0e02b2c3d479

Responses

200

application/json

anyOptional

400

Bad Request

delete

/core/v1/tax-calculations/{id}

curl -X DELETE \
  "https://api.catapa.com/core/v1/tax-calculations/f47ac10b-58cc-4372-a567-0e02b2c3d479" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

{}

Get 1721 A1 Reports

get

Return the 1721 A1 reports.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

application/json

totalPagesintegerRequired

Total number of pages available

lastbooleanRequired

Indicates whether this is the last page

totalElementsintegerRequired

Total number of elements across all pages

numberOfElementsintegerRequired

Number of elements in the current page

firstbooleanRequired

Indicates whether this is the first page

sizeintegerRequired

Size of the page (number of elements per page)

numberintegerRequired

Current page number (zero-indexed)

400

Bad Request

get

/core/v1/tax-reports/1721-a1

curl -X GET \
  "https://api.catapa.com/core/v1/tax-reports/1721-a1" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

{
  "content": [
    {
      "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
      "employee": {
        "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
        "identificationNumber": "id-01",
        "name": "Employee Name"
      },
      "kpp": {
        "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
        "identificationNumber": "kppid-01",
        "name": "KPP Name"
      },
      "externalId": "79f537af-83b2-4a8b-851c-5d14ec046553",
      "year": 2020,
      "endMonth": 12,
      "sequenceNumber": 1,
      "membershipNumber": "123456789012345",
      "ptkp": "54000000",
      "jobTitle": "Titel",
      "totalGrossIncome": 7000000,
      "outstandingOriginalTax": 7000000,
      "outstandingPenaltyTax": 0,
      "outstandingTax": 7000000,
      "paidOriginalTax": 7000000,
      "paidPenaltyTax": 0,
      "paidTax": 7000000,
      "paidTaxAllowance": 0,
      "basicSalary": 800000000,
      "taxAllowance": 0,
      "otherAllowance": 0,
      "honorarium": 0,
      "insurancePremium": 0,
      "enjoymentRevenue": 0,
      "bonus": 0,
      "retirementContribution": 0,
      "totalDeduction": 0,
      "netIncome": 800000,
      "previousNetIncome": 0,
      "totalNetIncome": 800000,
      "baseIncomeTaxDeduction": 50000,
      "baseIncomeTax": 300000,
      "yearlyOriginalTax": 70000,
      "yearlyPenaltyTax": 0,
      "yearlyTax": 70000,
      "previousOriginalTax": 0,
      "previousPenaltyTax": 0,
      "previousTax": 0
    }
  ],
  "pageable": "INSTANCE",
  "number": 0,
  "size": 10,
  "totalPages": 1,
  "numberOfElements": 8,
  "totalElements": 8,
  "last": true,
  "sort": [],
  "first": true,
  "empty": true
}

Download 1721 A1 Report

get

Download the 1721 A1 report.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequiredExample: f47ac10b-58cc-4372-a567-0e02b2c3d479

Responses

200

application/json

string · binaryOptional

400

Bad Request

get

/core/v1/tax-reports/1721-a1/{id}/download

curl -X GET \
  "https://api.catapa.com/core/v1/tax-reports/1721-a1/f47ac10b-58cc-4372-a567-0e02b2c3d479/download" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

binary

Get 1721 VI Reports

get

Return the 1721 VI reports.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

application/json

totalPagesintegerRequired

Total number of pages available

lastbooleanRequired

Indicates whether this is the last page

totalElementsintegerRequired

Total number of elements across all pages

numberOfElementsintegerRequired

Number of elements in the current page

firstbooleanRequired

Indicates whether this is the first page

sizeintegerRequired

Size of the page (number of elements per page)

numberintegerRequired

Current page number (zero-indexed)

400

Bad Request

get

/core/v1/tax-reports/1721-vi

curl -X GET \
  "https://api.catapa.com/core/v1/tax-reports/1721-vi" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

{
  "content": [
    {
      "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
      "employee": {
        "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
        "identificationNumber": "id-01",
        "name": "Employee Name"
      },
      "kpp": {
        "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
        "identificationNumber": "id-01",
        "name": "Employee Name"
      },
      "year": 2020,
      "month": 12,
      "sequenceNumber": 1,
      "npwpNumber": "123456789012345",
      "monthlyGrossIncome": 7000000,
      "tax": {
        "original": 50000,
        "penalty": 0,
        "total": 50000
      }
    }
  ],
  "pageable": "INSTANCE",
  "number": 0,
  "size": 10,
  "totalPages": 1,
  "numberOfElements": 8,
  "totalElements": 8,
  "last": true,
  "sort": [],
  "first": true,
  "empty": true
}

Download 1721 VI Report

get

Download the 1721 VI report.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequiredExample: f47ac10b-58cc-4372-a567-0e02b2c3d479

Responses

200

application/json

string · binaryOptional

400

Bad Request

get

/core/v1/tax-reports/1721-vi/{id}/download

curl -X GET \
  "https://api.catapa.com/core/v1/tax-reports/1721-vi/f47ac10b-58cc-4372-a567-0e02b2c3d479/download" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

binary

Get Detailed 1721 VI Reports

get

Return the detailed 1721 VI reports.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

application/json

idstringOptional

yearnumberOptional

Tax report year

monthnumberOptional

Tax report month

sequenceNumbernumberOptional

Report sequence number

npwpNumberstringOptional

NPWP (Tax identification number)

monthlyGrossIncomenumberOptional

Monthly gross income amount

totalGrossIncomenumberOptional

Total gross income amount

pkpnumberOptional

PKP (Penghasilan Kena Pajak) value

400

Bad Request

get

/core/v1/tax-reports/1721-vi/detail

curl -X GET \
  "https://api.catapa.com/core/v1/tax-reports/1721-vi/detail" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

{
  "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
  "employee": {
    "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
    "identificationNumber": "id-01",
    "name": "Employee Name"
  },
  "kpp": {
    "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
    "identificationNumber": "kppid-01",
    "name": "KPP Name"
  },
  "year": 2020,
  "month": 12,
  "sequenceNumber": 1,
  "npwpNumber": "123456789012345",
  "monthlyGrossIncome": 7000000,
  "tax": {
    "original": 50000,
    "penalty": 0,
    "total": 50000
  },
  "totalGrossIncome": 7000000,
  "pkp": 3000000
}

Get 1721 VII Reports

get

Return the 1721 VII reports.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

application/json

totalPagesintegerRequired

Total number of pages available

lastbooleanRequired

Indicates whether this is the last page

totalElementsintegerRequired

Total number of elements across all pages

numberOfElementsintegerRequired

Number of elements in the current page

firstbooleanRequired

Indicates whether this is the first page

sizeintegerRequired

Size of the page (number of elements per page)

numberintegerRequired

Current page number (zero-indexed)

400

Bad Request

get

/core/v1/tax-reports/1721-vii

curl -X GET \
  "https://api.catapa.com/core/v1/tax-reports/1721-vii" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

{
  "content": [
    {
      "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
      "employee": {
        "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
        "identificationNumber": "id-01",
        "name": "Employee Name"
      },
      "kpp": {
        "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
        "identificationNumber": "kpp-01",
        "name": "Kpp Name"
      },
      "year": 2020,
      "month": 12,
      "sequenceNumber": 1,
      "npwpNumber": "123456789012345",
      "income": 7000000,
      "tax": 30000
    }
  ],
  "pageable": "INSTANCE",
  "number": 0,
  "size": 10,
  "totalPages": 1,
  "numberOfElements": 8,
  "totalElements": 8,
  "last": true,
  "sort": [],
  "first": true,
  "empty": true
}

Download 1721 VII Report

get

Download the 1721 VII report.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequiredExample: f47ac10b-58cc-4372-a567-0e02b2c3d479

Responses

200

application/json

string · binaryOptional

400

Bad Request

get

/core/v1/tax-reports/1721-vii/{id}/download

curl -X GET \
  "https://api.catapa.com/core/v1/tax-reports/1721-vii/f47ac10b-58cc-4372-a567-0e02b2c3d479/download" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

binary

Get 1721 VI Reports

get

Return the 1721 VI reports.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

application/json

totalPagesintegerRequired

Total number of pages available

lastbooleanRequired

Indicates whether this is the last page

totalElementsintegerRequired

Total number of elements across all pages

numberOfElementsintegerRequired

Number of elements in the current page

firstbooleanRequired

Indicates whether this is the first page

sizeintegerRequired

Size of the page (number of elements per page)

numberintegerRequired

Current page number (zero-indexed)

400

Bad Request

get

/core/v1/pph21-reports/1721-vi

curl -X GET \
  "https://api.catapa.com/core/v1/pph21-reports/1721-vi" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

{
  "content": [
    {
      "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
      "employee": {
        "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
        "identificationNumber": "id-01",
        "name": "Employee Name"
      },
      "kpp": {
        "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
        "identificationNumber": "id-01",
        "name": "Employee Name"
      },
      "year": 2020,
      "month": 12,
      "sequenceNumber": 1,
      "npwpNumber": "123456789012345",
      "monthlyGrossIncome": 7000000,
      "tax": {
        "original": 50000,
        "penalty": 0,
        "total": 50000
      }
    }
  ],
  "pageable": "INSTANCE",
  "number": 0,
  "size": 10,
  "totalPages": 1,
  "numberOfElements": 8,
  "totalElements": 8,
  "last": true,
  "sort": [],
  "first": true,
  "empty": true
}

Download 1721 VI Report

get

Download the 1721 VI report.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequiredExample: f47ac10b-58cc-4372-a567-0e02b2c3d479

Responses

200

application/json

string · binaryOptional

400

Bad Request

get

/core/v1/pph21-reports/1721-vi/{id}/download

curl -X GET \
  "https://api.catapa.com/core/v1/pph21-reports/1721-vi/f47ac10b-58cc-4372-a567-0e02b2c3d479/download" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

binary

Get Detailed 1721 VI Reports

get

Return the detailed 1721 VI reports.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

application/json

idstringOptional

yearnumberOptional

Tax report year

monthnumberOptional

Tax report month

sequenceNumbernumberOptional

Report sequence number

npwpNumberstringOptional

NPWP (Tax identification number)

monthlyGrossIncomenumberOptional

Monthly gross income amount

totalGrossIncomenumberOptional

Total gross income amount

pkpnumberOptional

PKP (Penghasilan Kena Pajak) value

400

Bad Request

get

/core/v1/pph21-reports/1721-vi/detail

curl -X GET \
  "https://api.catapa.com/core/v1/pph21-reports/1721-vi/detail" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

{
  "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
  "employee": {
    "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
    "identificationNumber": "id-01",
    "name": "Employee Name"
  },
  "kpp": {
    "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
    "identificationNumber": "kppid-01",
    "name": "KPP Name"
  },
  "year": 2020,
  "month": 12,
  "sequenceNumber": 1,
  "npwpNumber": "123456789012345",
  "monthlyGrossIncome": 7000000,
  "tax": {
    "original": 50000,
    "penalty": 0,
    "total": 50000
  },
  "totalGrossIncome": 7000000,
  "pkp": 3000000
}

Get 1721 VII Reports

get

Return the 1721 VII reports.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

application/json

totalPagesintegerRequired

Total number of pages available

lastbooleanRequired

Indicates whether this is the last page

totalElementsintegerRequired

Total number of elements across all pages

numberOfElementsintegerRequired

Number of elements in the current page

firstbooleanRequired

Indicates whether this is the first page

sizeintegerRequired

Size of the page (number of elements per page)

numberintegerRequired

Current page number (zero-indexed)

400

Bad Request

get

/core/v1/pph21-reports/1721-vii

curl -X GET \
  "https://api.catapa.com/core/v1/pph21-reports/1721-vii" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

{
  "content": [
    {
      "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
      "employee": {
        "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
        "identificationNumber": "id-01",
        "name": "Employee Name"
      },
      "kpp": {
        "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
        "identificationNumber": "kpp-01",
        "name": "Kpp Name"
      },
      "year": 2020,
      "month": 12,
      "sequenceNumber": 1,
      "npwpNumber": "123456789012345",
      "income": 7000000,
      "tax": 30000
    }
  ],
  "pageable": "INSTANCE",
  "number": 0,
  "size": 10,
  "totalPages": 1,
  "numberOfElements": 8,
  "totalElements": 8,
  "last": true,
  "sort": [],
  "first": true,
  "empty": true
}

Download 1721 VII Report

get

Download the 1721 VII report.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequiredExample: f47ac10b-58cc-4372-a567-0e02b2c3d479

Responses

200

application/json

string · binaryOptional

400

Bad Request

get

/core/v1/pph21-reports/1721-vii/{id}/download

curl -X GET \
  "https://api.catapa.com/core/v1/pph21-reports/1721-vii/f47ac10b-58cc-4372-a567-0e02b2c3d479/download" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

binary

Get 1721 VIII Reports

get

Return the 1721 VIII reports.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

application/json

totalPagesintegerRequired

Total number of pages available

lastbooleanRequired

Indicates whether this is the last page

totalElementsintegerRequired

Total number of elements across all pages

numberOfElementsintegerRequired

Number of elements in the current page

firstbooleanRequired

Indicates whether this is the first page

sizeintegerRequired

Size of the page (number of elements per page)

numberintegerRequired

Current page number (zero-indexed)

400

Bad Request

get

/core/v1/tax-reports/1721-viii

curl -X GET \
  "https://api.catapa.com/core/v1/tax-reports/1721-viii" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

{
  "content": [
    {
      "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
      "employee": {
        "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
        "identificationNumber": "id-01",
        "name": "Employee Name"
      },
      "kpp": {
        "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
        "identificationNumber": "kppid-01",
        "name": "KPP Name"
      },
      "year": 2020,
      "month": 1,
      "sequenceNumber": 1,
      "npwpNumber": "123456789012345",
      "address": "Address",
      "monthlyGrossIncome": 100000,
      "monthlyTax": {
        "original": 10000,
        "penalty": 0
      }
    }
  ],
  "pageable": "INSTANCE",
  "number": 0,
  "size": 10,
  "totalPages": 1,
  "numberOfElements": 8,
  "totalElements": 8,
  "last": true,
  "sort": [],
  "first": true,
  "empty": true
}

Download 1721 VIII Report

get

Download the 1721 VIII report.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequiredExample: f47ac10b-58cc-4372-a567-0e02b2c3d479

Responses

200

application/json

string · binaryOptional

400

Bad Request

get

/core/v1/tax-reports/1721-viii/{id}/download

curl -X GET \
  "https://api.catapa.com/core/v1/tax-reports/1721-viii/f47ac10b-58cc-4372-a567-0e02b2c3d479/download" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

binary

Simulate annual tax calculation

post

Simulate annual tax calculation based on the provided scenario. This API only works for PERMANENT taxObject.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

taxMethodstring · enumRequiredPossible values:

ptkpCategorystringRequired

taxObjectstring · enumRequiredPossible values:

startMonthinteger · int32 · min: 1 · max: 12Required

Responses

200

application/json

400

Bad Request

post

/core/v1/tax-calculators

curl -X POST \
  "https://api.catapa.com/core/v1/tax-calculators" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id" \
  -H "Content-Type: application/json" \
  -d '...'

{
  "monthlyTaxReports": [
    {
      "type": "PERMANENT",
      "monthlyGrossIncome": 10000000,
      "percentage": 1,
      "monthlyTax": 100000,
      "nettoTax": 100000,
      "basicSalary": 10000000,
      "taxAllowance": 0,
      "otherAllowance": 0,
      "honorarium": 0,
      "insurancePremium": 0,
      "enjoymentRevenue": 0,
      "bonus": 0,
      "monthlyRetirementContribution": 0,
      "monthlyReligionAllowance": 0
    },
    {
      "type": "PERMANENT",
      "monthlyGrossIncome": 10000000,
      "percentage": 1,
      "monthlyTax": 100000,
      "nettoTax": 100000,
      "basicSalary": 10000000,
      "taxAllowance": 0,
      "otherAllowance": 0,
      "honorarium": 0,
      "insurancePremium": 0,
      "enjoymentRevenue": 0,
      "bonus": 0,
      "monthlyRetirementContribution": 0,
      "monthlyReligionAllowance": 0
    }
  ],
  "annualTaxReport": {
    "basicSalary": 120000000,
    "taxAllowance": 0,
    "otherAllowance": 0,
    "honorarium": 0,
    "insurancePremium": 0,
    "enjoymentRevenue": 0,
    "bonus": 0,
    "totalGrossIncome": 120000000,
    "positionalAllowance": 0,
    "retirementContribution": 0,
    "totalDeduction": 0,
    "netIncome": 120000000,
    "previousNetIncome": 0,
    "totalNetIncome": 120000000,
    "baseIncomeTaxDeduction": 0,
    "baseIncomeTax": 12000000,
    "yearlyOriginalTax": 12000000,
    "yearlyPenaltyTax": 0,
    "yearlyTax": 12000000,
    "previousOriginalTax": 0,
    "previousPenaltyTax": 0,
    "previousTax": 0,
    "outstandingOriginalTax": 12000000,
    "outstandingPenaltyTax": 0,
    "outstandingTax": 12000000
  }
}

Simulate monthly tax calculation

post

Simulate monthly tax calculation based on the provided scenario.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

taxObjectstring · enumRequiredPossible values:

taxMethodstring · enumRequiredPossible values:

ptkpCategorystringRequired

Responses

200

application/json

400

Bad Request

post

/core/v1/tax-calculators/monthly

curl -X POST \
  "https://api.catapa.com/core/v1/tax-calculators/monthly" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id" \
  -H "Content-Type: application/json" \
  -d '...'

{
  "type": "PERMANENT",
  "monthlyGrossIncome": 10000000,
  "percentage": 1,
  "monthlyTax": 100000,
  "nettoTax": 100000,
  "basicSalary": 10000000,
  "taxAllowance": 0,
  "otherAllowance": 0,
  "honorarium": 0,
  "insurancePremium": 0,
  "enjoymentRevenue": 0,
  "bonus": 0,
  "monthlyRetirementContribution": 0,
  "monthlyReligionAllowance": 0
}

Last updated 16 days ago

hashtagGet Kpp

hashtagSearch Query

hashtagGet Monthly Tax Report

hashtagSearch Query

hashtagGet Monthly Tax Detail

hashtagSearch Query

hashtagGet Pph21 Policy

hashtagGet Ptkp Categories

hashtagSearch Query

hashtagGet Tax Calculations

hashtagSearch Query

hashtagCreate Tax Calculation

hashtagGet Tax Calculations by Id

hashtagUndo Tax Calculation by Id

hashtagGet 1721 A1 Reports

hashtagDownload 1721 A1 Report

hashtagGet 1721 VI Reports

hashtagDownload 1721 VI Report

hashtagGet Detailed 1721 VI Reports

hashtagGet 1721 VII Reports

hashtagDownload 1721 VII Report

hashtagGet 1721 VI Reports

hashtagDownload 1721 VI Report

hashtagGet Detailed 1721 VI Reports

hashtagGet 1721 VII Reports

hashtagDownload 1721 VII Report

hashtagGet 1721 VIII Reports

hashtagDownload 1721 VIII Report

hashtagSimulate annual tax calculation

hashtagSimulate monthly tax calculation

Get Kpp

Search Query

Get Monthly Tax Report

Search Query

Get Monthly Tax Detail

Search Query

Get Pph21 Policy

Get Ptkp Categories

Search Query

Get Tax Calculations

Search Query

Create Tax Calculation

Get Tax Calculations by Id

Undo Tax Calculation by Id

Get 1721 A1 Reports

Download 1721 A1 Report

Get 1721 VI Reports

Download 1721 VI Report

Get Detailed 1721 VI Reports

Get 1721 VII Reports

Download 1721 VII Report

Get 1721 VI Reports

Download 1721 VI Report

Get Detailed 1721 VI Reports

Get 1721 VII Reports

Download 1721 VII Report

Get 1721 VIII Reports

Download 1721 VIII Report

Simulate annual tax calculation

Simulate monthly tax calculation