Partner commands
Creating an a.sign RK HSM basic/advanced/premium (customer account)
To create a customer account a HTTP POST request is used. The request consists of the partner password (partner_password), the product version and the data for the classification key (equivalent to Ordnungsbegriff in 1). The response contains the access data for the created a.sign RK HSM account.
The classification key (e.g. VAT ID) must be specified in two values. To differentiate the three possible categories of the classification key an integer is used. A second value contains the data itself.
- classification_key_type=0
- VAT-ID (ger: UID-Nummer);
- e.g. classification_key = ATU12345678
- classification_key_type=1
- Global Location Number (GLN)
- e.g. classification_key = 5012345000008
- classification_key_type=2
- Tax authority number and tax number (ger: Finanzamt- und Steuernummer)
- e.g. classification_key=12345/1234
There are three different version of the a.sign RK HSM
- product_version=1 a.sign RK HSM basic
- product_version=2 a.sign RK HSM advanced
- product_version=3 a.sign RK HSM premium
Additionally an e-mail address is required. This is used for communication with the customer when, for example, the certificate expires. Either the customer or partner e-mail address can be entered here. It is recommended to use a group mailbox instead of personal e-mail addresses.
List customer accounts
List all customer accounts for a partner account.
Query available credits
Query available credis per product version.
Add "Sorglos Paket" to account
Extension of the validity of the signature service by another 5 years.
This command can only be made if there is a remaining term of 1 month or at the latest 1 year after the certificate or signature service has expired.
This call does not make any changes to the certificate, the certificate validity and certificate serial number remain the same. You can continue to use the signature service without having to make any adjustments to the cash register. The extension of the signature service entitles you to issue a new certificate, this is described in chapter Issue new certificate for account with "Sorglos Paket".
The username parameter specifies the customer account for which the signature service should be extended.
The product_version parameter specifies the credit to be used to extend the validity of the signature service. (see chapter Product Version)
A credit from the same or more expensive product version can be used. If a more expensive credit is used, the customer account will be switched to the more expensive product version.
Issue new certificate for account with "Sorglos Paket"
If a "Sorglos Paket" has been add to a customer account (see chapter Add "Sorglos Paket" to account), the associated certificate can be reissued. This changes the certificate and the certificate serial number. The new certificate values must be stored in the cash register, and the certificate serial number in the signing input data has to be changed. The new certificate needs to be added to the cash register in Finanzonline, also changes to the DEP may be required.