Poland

Enabling support for Poland involves confirming prerequisites and product IDs, registering with the Krajowa Administracja Skarbowa (KAS) tax authority, and setting up credentials.

Prerequisites

An authorization token for the customer's Numer Identyfikacji Podatkowej (NIP), obtained in the Krajowy System e-Faktur (KSeF) system.
Configuration of the token in the customer's account

Available products

pl_Faktura__1.0: Outbound invoicing
pl_Faktura_Polling_1.0: Inbound invoicing
PL_DOCUMENT_1_2.0: Non-invoice documents

Register with the Poland tax authority

Obtain the required authorization token by registering on the Krajowy System e-Faktur (KSeF) system.

Obtain the required authorization token by registering on the KSeF system using their tutorial.

Check KSeF's status webpage for any server or availability issues.

Configure transmission credentials for Poland

You must set up transmission credentials to connect your Sovos account to a valid business that is registered with the Krajowa Administracja Skarbowa (KAS) tax authority in Poland.

Obtain the required authorization token by registering on the Krajowy System e-Faktur (KSeF) system using their tutorial. In case of any server or availability issues, check KSeF's status webpage.

Important information regarding authorization tokens:

Multiple authorization tokens can be generated in parallel if needed.
All tokens are valid until they are explicitly removed from the KSeF system.
If a token is replaced on the KSeF system, it must also be replaced on Sovos.
Tokens are generated separately for KSeF's "Test" and "Production" environments.
KSeF's "pre-production" is not available with Sovos.

Add your transmission credentials to your Admin Settings or via the Configuration v2 resource (API).
Complete and return an Appointment Letter to Sovos or your reseller.
Complete and return a Support and Change Management Document to Sovos or your reseller.

Samples for uploading transmission credentials for Poland

The request and response samples for uploading new transmission credentials using the dedicated Create settings endpoint.

Request sample

Request sample for uploading new transmissions credentials:

curl --location --request POST 'https://api-test.sovos.com/v2/configurations/organizations/YOUR-ORG-ID/settings' \
--header 'Content-Type: application/json' \
--header 'x-correlationId: developer-guide' \
--data-raw '[
    {
        "context": "transmission",
        "configurations": [
            {
                "name": "partner_credentials_KSEF",
                "value": {
                    "authorizationToken": INSERT-TOKEN-HERE
                },
                "scope": {
		    "category": "PL_INV",
		    "productId": "pl_Faktura__1.0",
                    "orgId": YOUR-ORG-ID,
                    "taxId": YOUR-COMPANY-TAXID
                }
            }
        ]
    }
]'

Response sample

Response sample for uploading new transmissions credentials:

{
    "status": 201,
    "message": "Created",
    "success": true,
    "timestamp": 1663415078266,
    "data": [
        {
            "message": "Configurations are created",
            "statusCode": 201,
            "configurationContextResponse": {
                "context": "Transmission",
                "configurations": [
                    {
                        "id": SETTING-ID,
                        "name": "partner_credentials_KSEF",
                        "value": {
                            "authorizationToken": INSERT-TOKEN-HERE,
                        },
                        "scope": {
                            "category": "PL_INV",
                            "productId": "pl_Faktura__1.0",
                            "orgId": YOUR-ORG-ID,
                            "taxId": YOUR-COMPANY-TAXID
                        },
                        "auditData": {
                            "createdAt": 1663415078,
                            "createdBy": "user@company.com",
                            "isDeleted": false,
                            "version": 1
                        }
                    }
                ]
            }
        }
    ]
}

Sovos Docs