Taxes | Tax Authority Setup PT
The Tax Authority Setup is used to manage default values for each company, such as the Communication to the Tax Authority and Tax Reporting.
Overview
URL | api/{tenantKey}/{orgKey}/taxAuthorityPT/taxAuthoritySetupPTs |
Methods Supported | GET, PUT, POST, DELETE |
All Operations
This service includes the following operations:
-
GET:
- GET TaxAuthoritySetupPTs
- GET TaxAuthoritySetupPTs (paged)
- GET TaxAuthoritySetupPT by identifier
- GET TaxAuthoritySetupPT by key
- GET Print TaxAuthoritySetupPT by identifier
- GET Print TaxAuthoritySetupPT by key
- GET Original Print TaxAuthoritySetupPTOriginal by identifier
- GET Original Print TaxAuthoritySetupPT by key
-
PUT:
- PUT Set Custom Attribute TaxAuthoritySetupPT
- PUT Set IsActive TaxAuthoritySetupPT
- PUT Set Company TaxAuthoritySetupPT
- PUT Set FinancialCommOption TaxAuthoritySetupPT
- PUT Set TransportCommOption TaxAuthoritySetupPT
- PUT Set AuthorityCommUserName TaxAuthoritySetupPT
- PUT Set AuthorityCommPassword TaxAuthoritySetupPT
- PUT Set AuthorityServiceCode TaxAuthoritySetupPT
- PUT Set BalanceSheet TaxAuthoritySetupPT
- PUT Set ProfitAndLoss TaxAuthoritySetupPT
- PUT Set AccountingTaxonomy TaxAuthoritySetupPT
- PUT Set CustomerRecapitulative TaxAuthoritySetupPT
- PUT Set SupplierRecapitulative TaxAuthoritySetupPT
- PUT Set Model TaxAuthoritySetupDetail
- PUT Set Attachment TaxAuthoritySetupDetail
- PUT Set TaxReportSetup TaxAuthoritySetupDetail
- PUT Set DynamicValueList TaxAuthoritySetupDetail
- POST:
- DELETE:
All Resources
This service uses the following resources:
- ApiTaxAuthoritySetupPTResource
- ApiTaxAuthoritySetupPTTaxReportingLinesResource
- TaxAuthoritySetupDetailResource
- TaxAuthoritySetupPTResource
- ExtensibilityCustomAttributeValueResource
All Enumerations
This service uses the following enumerations:
GET TaxAuthoritySetupPTs
Returns the list of all the entity records available.
Response:
When successful, the response body contains the list of records available. See TaxAuthoritySetupPTResource. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
GET TaxAuthoritySetupPTs (paged)
Returns a page of the list of all the entity records available.
The following elements are optional:
page | (int) The index of the page of the list that should be returned. This is a query string parameter. |
pageSize | (int) The number of page elements that should be returned (max. is 1000). This is a query string parameter. |
Response:
When successful, the response body contains the list of records available. See TaxAuthoritySetupPTResource. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
GET TaxAuthoritySetupPT by identifier
Returns the entity record that matches the specified identifier.
The following elements are required:
id | (string) The record identifier. |
Response:
When successful, the response body contains the entity record. See TaxAuthoritySetupPTResource. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
404 | NotFound. The specified record does not exist. |
Resource URL:
GET TaxAuthoritySetupPT by key
Returns the entity record that matches the specified key.
The following elements are required:
company | (string) The company code is the central organizational unit within the system. |
Response:
When successful, the response body contains the entity record. See TaxAuthoritySetupPTResource. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
404 | NotFound. The specified record does not exist. |
Resource URL:
GET Print TaxAuthoritySetupPT by identifier
Prints the specified entity record.
The following elements are required:
id | (string) The record identifier. |
The following elements are optional:
template | (string) The report template that should be used. This is a query string parameter. |
Response:
When successful, the response body contains a stream with the printed file. |
Response status codes:
200 | OK. The operation was completed successfully. |
404 | NotFound. The specified resord does not exist. |
Resource URL:
GET Print TaxAuthoritySetupPT by key
Prints the specified entity record.
The following elements are required:
company | (string) The company code is the central organizational unit within the system. |
The following elements are optional:
template | (string) The report template that should be used. This is a query string parameter. |
Response:
When successful, the response body contains a stream with the printed file. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
404 | NotFound. The specified record does not exist. |
Resource URL:
GET Original Print TaxAuthoritySetupPTOriginal by identifier
Prints the specified entity record.
The following elements are required:
id | (string) The record identifier. |
The following elements are optional:
template | (string) The report template that should be used. This is a query string parameter. |
Response:
When successful, the response body contains a stream with the printed file. |
Response status codes:
200 | OK. The operation was completed successfully. |
404 | NotFound. The specified resord does not exist. |
Resource URL:
GET Original Print TaxAuthoritySetupPT by key
Prints the specified entity record.
The following elements are required:
company | (string) The company code is the central organizational unit within the system. |
The following elements are optional:
template | (string) The report template that should be used. This is a query string parameter. |
Response:
When successful, the response body contains a stream with the printed file. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
404 | NotFound. The specified record does not exist. |
Resource URL:
POST Tax Authority Setup PT
Inserts a new 'Tax Authority Setup Detail' in the 'Tax Authority Setup PT'.
The following elements are required:
company | (string) The company code is the central organizational unit within the system. |
value | (ApiTaxAuthoritySetupPTTaxReportingLinesResource) The ApiTaxAuthoritySetupPTTaxReportingLinesResource instance. See ApiTaxAuthoritySetupPTTaxReportingLinesResource. |
The following elements are optional:
customAttributes | (JSON Document) A key-value pair in JSON format that represents the extensibility custom attributes for this entity. The key should be the custom attribute name prefixed with "custom_", e.g. "custom_attributeName". While the "customAttributes" element is optional, please notice that specific custom attributes might be marked as required. |
Response:
When successful, the response body is empty. |
Response status codes:
204 | NoContent. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set AccountingTaxonomy TaxAuthoritySetupPT
Updates the value of attribute 'AccountingTaxonomy' in the specified entity record.
The following elements are required:
company | (string) The company code is the central organizational unit within the system. |
value | (enum AccountingTaxonomy) The request body should contain the new value for the attribute. See AccountingTaxonomy. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set Attachment TaxAuthoritySetupDetail
Updates the value of attribute 'Attachment' in the specified entity record.
The following elements are required:
company | (string) The company code is the central organizational unit within the system. |
lineId | (string) The detail identifier. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set AuthorityCommPassword TaxAuthoritySetupPT
Updates the value of attribute 'AuthorityCommPassword' in the specified entity record.
The following elements are required:
company | (string) The company code is the central organizational unit within the system. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set AuthorityCommUserName TaxAuthoritySetupPT
Updates the value of attribute 'AuthorityCommUserName' in the specified entity record.
The following elements are required:
company | (string) The company code is the central organizational unit within the system. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set AuthorityServiceCode TaxAuthoritySetupPT
Updates the value of attribute 'AuthorityServiceCode' in the specified entity record.
The following elements are required:
company | (string) The company code is the central organizational unit within the system. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set BalanceSheet TaxAuthoritySetupPT
Updates the value of attribute 'BalanceSheet' in the specified entity record.
The following elements are required:
company | (string) The company code is the central organizational unit within the system. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set Company TaxAuthoritySetupPT
Updates the value of attribute 'Company' in the specified entity record.
The following elements are required:
company | (string) The company code is the central organizational unit within the system. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set CustomerRecapitulative TaxAuthoritySetupPT
Updates the value of attribute 'CustomerRecapitulative' in the specified entity record.
The following elements are required:
company | (string) The company code is the central organizational unit within the system. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set DynamicValueList TaxAuthoritySetupDetail
Updates the value of attribute 'DynamicValueList' in the specified entity record.
The following elements are required:
company | (string) The company code is the central organizational unit within the system. |
lineId | (string) The detail identifier. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set FinancialCommOption TaxAuthoritySetupPT
Updates the value of attribute 'FinancialCommOption' in the specified entity record.
The following elements are required:
company | (string) The company code is the central organizational unit within the system. |
value | (enum AuthorityCommunicationOption) The request body should contain the new value for the attribute. See AuthorityCommunicationOption. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set IsActive TaxAuthoritySetupPT
Updates the value of attribute 'IsActive' in the specified entity record.
The following elements are required:
company | (string) The company code is the central organizational unit within the system. |
value | (bool) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
404 | NotFound. The specified record does not exist. |
Resource URL:
PUT Set Model TaxAuthoritySetupDetail
Updates the value of attribute 'Model' in the specified entity record.
The following elements are required:
company | (string) The company code is the central organizational unit within the system. |
lineId | (string) The detail identifier. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set ProfitAndLoss TaxAuthoritySetupPT
Updates the value of attribute 'ProfitAndLoss' in the specified entity record.
The following elements are required:
company | (string) The company code is the central organizational unit within the system. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set SupplierRecapitulative TaxAuthoritySetupPT
Updates the value of attribute 'SupplierRecapitulative' in the specified entity record.
The following elements are required:
company | (string) The company code is the central organizational unit within the system. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set TaxReportSetup TaxAuthoritySetupDetail
Updates the value of attribute 'TaxReportSetup' in the specified entity record.
The following elements are required:
company | (string) The company code is the central organizational unit within the system. |
lineId | (string) The detail identifier. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set TransportCommOption TaxAuthoritySetupPT
Updates the value of attribute 'TransportCommOption' in the specified entity record.
The following elements are required:
company | (string) The company code is the central organizational unit within the system. |
value | (enum AuthorityCommunicationOption) The request body should contain the new value for the attribute. See AuthorityCommunicationOption. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set Custom Attribute TaxAuthoritySetupPT
Updates the value of 'CustomAttribute' in the specified entity record.
The following elements are required:
companyKey | (string) The company key. |
company | (string) The company code is the central organizational unit within the system. |
customAttributeName | (string) The custom attribute name. |
value | (ExtensibilityCustomAttributeValueResource) The request body should contain the new value for the custom attribute. See ExtensibilityCustomAttributeValueResource. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
404 | NotFound. The specified record does not exist. |
Resource URL:
DELETE Tax Authority Setup Detail by identifier
Deletes the entity record that matches the specified identifier.
The following elements are required:
company | (string) The company code is the central organizational unit within the system. |
lineId | (string) The line identifier. |
Response:
When successful, the response body is empty. |
Response status codes:
204 | NoContent. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
404 | NotFound. The specified record does not exist. |
Resource URL:
Resources
ApiTaxAuthoritySetupPTResource
The following elements are required:
company | (string) The company code is the central organizational unit within the system. |
The following elements are optional:
financialCommOption | (enum AuthorityCommunicationOption) Indicates if the communication of financial documents is is done manually or automatically.
See AuthorityCommunicationOption. |
transportCommOption | (enum AuthorityCommunicationOption) Indicates if the communication of transport documents is is done manually or automatically.
See AuthorityCommunicationOption. |
authorityCommUserName | (string) The username of the login that allows the user to communicate with the financial authority. |
authorityCommPassword | (string) The password of the login that allows the user to communicate with the financial authority. |
authorityServiceCode | (string) Authority Service Code. |
taxReportingLines | (List of ApiTaxAuthoritySetupPTTaxReportingLinesResource) The tax reporting configuration.
See ApiTaxAuthoritySetupPTTaxReportingLinesResource. |
balanceSheet | (string) The balanace sheet model to use in IES (Informação Empresarial Simplificada). |
profitAndLoss | (string) The profit and loss model to use in IES (Informação Empresarial Simplificada). |
accountingTaxonomy | (enum AccountingTaxonomy) The accounting taxonomy used in IES report (Informação Empresarial Simplificada).
See AccountingTaxonomy. |
customerRecapitulative | (string) The Customer Recapitulative Report used in IES report (Informação Empresarial Simplificada). |
supplierRecapitulative | (string) The Supplier Recapitulative Report used in IES report (Informação Empresarial Simplificada). |
ApiTaxAuthoritySetupPTTaxReportingLinesResource
The following elements are required:
model | (string) The Model associeted to the tax report. |
attachment | (string) The Attachment associeted to the tax report. |
taxReportSetup | (string) The Tax Report. |
The following elements are optional:
dynamicValueList | (string) (internal use). |
TaxAuthoritySetupDetailResource
The following elements are required:
model | (string) The Model associeted to the tax report. |
attachment | (string) The Attachment associeted to the tax report. |
taxReportSetup | (string) The Tax Report. |
The following elements are optional:
dynamicValueList | (string) (internal use). |
TaxAuthoritySetupPTResource
The following elements are required:
company | (string) The company code is the central organizational unit within the system.
(fk) Allowed value: the natural key of a record of type Company. These records are accessibly through the Companies service. |
The following elements are optional:
financialCommOption | (enum AuthorityCommunicationOption) Indicates if the communication of financial documents is is done manually or automatically.
See AuthorityCommunicationOption. |
transportCommOption | (enum AuthorityCommunicationOption) Indicates if the communication of transport documents is is done manually or automatically.
See AuthorityCommunicationOption. |
authorityCommUserName | (string) The username of the login that allows the user to communicate with the financial authority. |
authorityCommPassword | (string) The password of the login that allows the user to communicate with the financial authority. |
authorityServiceCode | (string) Authority Service Code. |
taxReportingLines | (List of TaxAuthoritySetupDetailResource) The tax reporting configuration.
See TaxAuthoritySetupDetailResource. |
balanceSheet | (string) The balanace sheet model to use in IES (Informação Empresarial Simplificada).
(fk) Allowed value: the natural key of a record of type FinancialStatement. These records are accessibly through the FinancialStatements service. |
profitAndLoss | (string) The profit and loss model to use in IES (Informação Empresarial Simplificada).
(fk) Allowed value: the natural key of a record of type FinancialStatement. These records are accessibly through the FinancialStatements service. |
accountingTaxonomy | (enum AccountingTaxonomy) The accounting taxonomy used in IES report (Informação Empresarial Simplificada).
See AccountingTaxonomy. |
customerRecapitulative | (string) The Customer Recapitulative Report used in IES report (Informação Empresarial Simplificada).
(fk) Allowed value: the natural key of a record of type RecapitulativeReportSetup. These records are accessibly through the RecapitulativeReportSetups service. |
supplierRecapitulative | (string) The Supplier Recapitulative Report used in IES report (Informação Empresarial Simplificada).
(fk) Allowed value: the natural key of a record of type RecapitulativeReportSetup. These records are accessibly through the RecapitulativeReportSetups service. |
ExtensibilityCustomAttributeValueResource
The following elements are required:
value | (object) The custom attribute value. |