Tax Code

Tax Code - Get

HTTP Request

GET /api/v1/tax-codes/{id}

📋 Description: Retrieves detailed information about a specific tax code within the financial organization structure, identified by its unique ID, to facilitate compliance and reporting within the organizational hierarchy.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseTaxCodeDto

Tax Code - Update

HTTP Request

PUT /api/v1/tax-codes/{id}

📋 Description: Updates the specified tax code within the financial organization structure, allowing for modifications to its attributes to reflect changes in the hierarchy of the financial entity.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

body

body

TaxCodeDto

true

Request body containing the updated tax code information, including attributes relevant to the financial organization structure and hierarchy.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseTaxCodeDto

Tax Code - Delete

HTTP Request

DELETE /api/v1/tax-codes/{id}

📋 Description: Deletes a specified tax code from the financial organization structure, ensuring the hierarchy remains accurate and up-to-date for the financial entity.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseVoid

Tax Code - Delete Or Decommission

HTTP Request

PUT /api/v1/tax-codes/remove/{id}

📋 Description: Removes a specified tax code from the financial organization structure, ensuring the hierarchy remains accurate and compliant with organizational standards.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseVoid

Tax Code - Delete Or Decommission All

HTTP Request

PUT /api/v1/tax-codes/remove/bulk

📋 Description: Removes multiple tax codes in bulk from the financial organization structure, ensuring the hierarchy remains accurate and up-to-date for effective financial entity management.

Parameters

Name

In

Type

Required

Description

body

body

array[integer]

true

Request body containing a list of tax code identifiers to be removed in bulk from the financial organization’s structure, ensuring streamlined management of the entity’s hierarchical tax classifications.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseVoid

Tax Code - Decommission

HTTP Request

PUT /api/v1/tax-codes/decommission/{id}

📋 Description: Decommissions a specified tax code within the financial organization structure, effectively removing it from active use in the hierarchy of financial entities. This operation ensures that outdated or unnecessary tax codes are no longer applied in financial transactions.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseTaxCodeDto

Tax Code - Decommission By Modification Date Before

HTTP Request

PUT /api/v1/tax-codes/decommission/modified-before/{modified_before}

📋 Description: Decommissions tax codes that were modified before the specified date, allowing organizations to maintain an updated financial structure and hierarchy. This operation ensures that obsolete tax codes are effectively removed from the financial entity’s records.

Parameters

Name

In

Type

Required

Description

modified_before

path

string(date-time)

true

Specifies the cutoff date for decommissioning tax codes that were modified before the given date, ensuring alignment with the organization’s financial structure and hierarchy.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseListTaxCodeDto

Tax Code - Decommission Before Now

HTTP Request

PUT /api/v1/tax-codes/decommission/modified-before-now

📋 Description: Decommissions tax codes that have been modified before the current date, ensuring the financial organization structure remains up-to-date and compliant with regulatory standards. This operation is essential for maintaining an accurate hierarchy within the financial entity.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseListTaxCodeDto

Tax Code - Decommission All

HTTP Request

PUT /api/v1/tax-codes/decommission/bulk

📋 Description: Decommissions multiple tax codes in bulk, allowing financial organizations to efficiently manage their organizational structure and hierarchy by removing obsolete or redundant tax classifications.

Parameters

Name

In

Type

Required

Description

body

body

array[integer]

true

Request body containing a list of tax codes to be decommissioned in bulk, ensuring alignment with the organization’s financial structure and hierarchy.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseListTaxCodeDto

Tax Code - Create Or Update Bulk

HTTP Request

PUT /api/v1/tax-codes/createOrUpdate/bulk

📋 Description: Creates or updates multiple tax codes in bulk within the financial organization structure, ensuring accurate alignment with the hierarchy of financial entities.

Parameters

Name

In

Type

Required

Description

body

body

TaxCodeDto

true

Request body containing a bulk array of tax code data, including identifiers and attributes, to facilitate the creation or updating of tax codes within the financial organization structure.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseListTaxCodeDto

Tax Code - Create Or Update

HTTP Request

PUT /api/v1/tax-codes/createOrUpdate

📋 Description: Creates or updates tax codes within the financial organization structure, ensuring accurate representation of the hierarchy and compliance for financial entities.

Parameters

Name

In

Type

Required

Description

body

body

TaxCodeDto

true

Request body containing the tax code details, including identifiers and attributes necessary for creating or updating financial entities within the organizational structure.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseTaxCodeDto

Tax Code - Bulk Update

HTTP Request

PUT /api/v1/tax-codes/bulk

📋 Description: Updates multiple tax codes in bulk for financial entities within the organizational structure, ensuring alignment with the latest regulatory requirements and internal hierarchy.

Parameters

Name

In

Type

Required

Description

body

body

TaxCodeDto

true

Request body containing a collection of tax code entries to be updated in the financial organization structure, including relevant identifiers and attributes for each code.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseListTaxCodeDto

Tax Code - Bulk Create

HTTP Request

POST /api/v1/tax-codes/bulk

📋 Description: Submits a bulk upload of tax codes to enhance the financial organization structure, enabling efficient management of hierarchical relationships within financial entities.

Parameters

Name

In

Type

Required

Description

body

body

TaxCodeDto

true

Request body containing a collection of tax code entries, each associated with the financial organization’s structure and hierarchy, to facilitate bulk updates within the financial entity.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseListTaxCodeDto

Tax Code - Bulk Delete

HTTP Request

DELETE /api/v1/tax-codes/bulk

📋 Description: Deletes multiple tax codes in a single operation, streamlining the management of financial entities within the organizational structure and hierarchy.

Parameters

Name

In

Type

Required

Description

body

body

array[integer]

true

Request body containing an array of tax code identifiers to be deleted in bulk from the financial organization structure.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseVoid

Tax Code - Detach Country

HTTP Request

POST /api/v1/tax-codes/detach/country/{country_id}

📋 Description: Detaches a specified tax code from the financial entity associated with the given country ID, facilitating updates to the organization’s financial structure and hierarchy. This operation ensures accurate alignment of tax codes within the financial organization framework.

Parameters

Name

In

Type

Required

Description

country_id

path

integer(int64)

true

Unique identifier for the country within the financial organization structure, used to detach associated tax codes.

body

body

TaxCodeDto

true

Request body containing the financial entity’s tax code details to be detached from the specified country, ensuring accurate organizational structure and compliance.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseVoid

Tax Code - Attach Country

HTTP Request

POST /api/v1/tax-codes/attach/country/{country_id}

📋 Description: Attaches tax codes to a specified country within the financial organization structure, facilitating the alignment of tax regulations with the hierarchical framework of financial entities.

Parameters

Name

In

Type

Required

Description

country_id

path

integer(int64)

true

Unique identifier for the country associated with the tax code attachment within the financial organization structure.

body

body

TaxCodeDto

true

Request body containing the tax code details to be associated with the specified country, facilitating the alignment of financial entities within the organizational structure.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseVoid

Tax Code - Find All

HTTP Request

GET /api/v1/tax-codes

📋 Description: Retrieves a list of tax codes associated with the financial organization structure, providing insights into the hierarchical categorization of financial entities.

Parameters

Name

In

Type

Required

Description

pageable

query

Pageable

true

Indicates whether the response should be paginated, facilitating efficient retrieval of tax codes within the financial organization structure.

Responses

Status

Meaning

Description

Schema

200

OK

OK

PageTaxCodeDto

Tax Code - Create

HTTP Request

POST /api/v1/tax-codes

📋 Description: Creates a new tax code within the financial organization structure, enabling the establishment of hierarchical tax classifications for financial entities.

Parameters

Name

In

Type

Required

Description

body

body

TaxCodeDto

true

Request body containing the tax code details, including attributes necessary for defining the financial entity’s organizational structure and hierarchy.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseTaxCodeDto

Tax Code - Get Metadata

HTTP Request

GET /api/v1/tax-codes/meta

📋 Description: Retrieves metadata for tax codes within the financial organization structure, providing insights into the hierarchy and classification of financial entities.

Responses

Status

Meaning

Description

Schema

200

OK

OK

Inline

Response Schema

Tax Code - Find All By System ID

HTTP Request

GET /api/v1/tax-codes/erp-system/{systemId}

📋 Description: Retrieves tax codes associated with a specified ERP system, facilitating the management of financial entities within the organizational structure and hierarchy.

Parameters

Name

In

Type

Required

Description

systemId

path

integer(int64)

true

Unique identifier for the system

pageable

query

Pageable

true

Indicates whether the response should be paginated, facilitating the retrieval of tax codes within the specified financial organization structure for the given ERP system.

Responses

Status

Meaning

Description

Schema

200

OK

OK

PageTaxCodeDto

Tax Code - Get All By Country

HTTP Request

GET /api/v1/tax-codes/country/{country_id}

📋 Description: Retrieves tax codes associated with a specified country, facilitating the alignment of financial entities within the organizational structure and hierarchy.

Parameters

Name

In

Type

Required

Description

country_id

path

integer(int64)

true

Unique identifier for the country within the financial organization structure, used to retrieve associated tax codes.

pageable

query

Pageable

true

Indicates whether the results should be paginated, allowing users to retrieve tax codes for a specified country in a structured manner within the financial organization hierarchy.

Responses

Status

Meaning

Description

Schema

200

OK

OK

PageTaxCodeDto