Hungary
Enabling support for Hungary involves confirming prerequisites and product IDs, registering with the NAV (NTCA) tax authority, and setting up credentials.
Prerequisites
Requirements for CTC integration:
-
A username obtained from the NAV tax authority
-
A password obtained from the NAV tax authority
-
A signature and replacement keys obtained from the NAV tax authority
To obtain them, follow these instructions.
Requirements for EKAER integration:
To obtain them, follow these instructions.
Available products
-
hu_invoiceData_Polling_3.0
-
hu_InvoiceData__3.0
-
hu_TradeCard__2.1
Configure transmission credentials for Hungary CTC
You must have already configured a company and a product, as well as obtained the username, password, signature key, and replacement key from the NAV (NTCA) tax authority.
Upon successful creation, the API will return a JSON object containing the uploaded transmission credentials and their assigned SETTING-ID
Samples for uploading transmission credentials for Hungary CTC
The request and response samples for adding new credentials using the dedicated Create settings endpoint.
Request sample
Request sample for uploading new credentials:
curl --location --request POST 'https://api-test.sovos.com/v2/configurations/organizations/{orgId}/settings' \
--header 'Authorization: Bearer {accessToken}' \
--header 'x-correlationId: {uniqueValue}' \
--header 'Content-Type: application/json' \
--data-raw '[
{
"context": "transmission",
"configurations": [
{
"name": "partner_credentials_nav",
"value": {
"username": INSERT-USERNAME-HERE,
"password": INSERT-PASSWORD-HASH-HERE,
"tokenDecryptionKey": INSERT-TOKENDECRKEY-HERE,
"signatureEncryptionKey": INSERT-SIGNATUREENCKEY-HERE
},
"scope": {
"category": "HU_INV",
"productId": "hu_InvoiceData__3.0",
"orgId": {orgId},
"taxId": {taxId}
}
}
]
}
]'Response sample
Response sample for adding new credentials:
{
"status": 201,
"message": "Created",
"success": true,
"timestamp": 1666259266257,
"data": [
{
"message": "Configurations are created",
"statusCode": 201,
"configurationContextResponse": {
"context": "Transmission",
"configurations": [
{
"id": SETTING-ID,
"name": "partner_credentials_nav",
"value": {
"username": INSERT-USERNAME-HERE,
"password": INSERT-PASSWORD-HASH-HERE,
"tokenDecryptionKey": INSERT-TOKENDECRKEY-HERE,
"signatureEncryptionKey": INSERT-SIGNATUREENCKEY-HERE
},
"scope": {
"category": "HU_INV",
"productId": "hu_InvoiceData__3.0",
"orgId": {orgId},
"taxId": {taxId}
},
"auditData": {
"createdAt": 1666259265,
"createdBy": "user@company.com",
"isDeleted": false,
"version": 1
}
}
]
}
}
]
}Configure transmission credentials for Hungary EKAER
You must have already configured a company and a product, as well as obtained the username and password from EKAER .
Samples for uploading transmission credentials for Hungary EKAER
The request and response samples for adding new credentials using the dedicated Create settings endpoint.
Request sample
Request sample for uploading new credentials:
curl --location --request POST 'https://api-test.sovos.com/v2/configurations/organizations/{orgId}/settings' \
--header 'Authorization: Bearer {accessToken}' \
--header 'x-correlationId: {uniqueValue}' \
--header 'Content-Type: application/json' \
--data-raw '[
{
"context": "transmission",
"configurations": [
{
"name": "partner_credentials_nav",
"value": {
"username": INSERT-USERNAME-HERE,
"password": INSERT-PASSWORD-HASH-HERE
},
"scope": {
"category": "HU_DLV",
"productId": "hu_TradeCard__2.1",
"orgId": {orgId},
"taxId": {taxId}
}
}
]
}
]'Response sample
Response sample for adding new credentials:
{
"status": 201,
"message": "Created",
"success": true,
"timestamp": 1666259266257,
"data": [
{
"message": "Configurations are created",
"statusCode": 201,
"configurationContextResponse": {
"context": "Transmission",
"configurations": [
{
"id": SETTING-ID,
"name": "partner_credentials_nav",
"value": {
"username": INSERT-USERNAME-HERE,
"password": INSERT-PASSWORD-HASH-HERE
},
"scope": {
"category": "HU_DLV",
"productId": "hu_TradeCard__2.1",
"orgId": {orgId},
"taxId": {taxId}
},
"auditData": {
"createdAt": 1666259265,
"createdBy": "user@company.com",
"isDeleted": false,
"version": 1
}
}
]
}
}
]
}