org.posper.fiscal.at

Class CashBoxUtils

java.lang.Object

org.posper.fiscal.at.CashBoxUtils

public class CashBoxUtils
extends Object

Constructor Summary

Constructors

Constructor and Description
CashBoxUtils()

Method Summary

Modifier and Type	Method and Description
static String	calcCheckSumFromKey(String base64AESKey, int numberOfBytes) Calculation of check sum
static boolean	checkReceiptForDamagedSigatureCreationDevice(String jwsCompactRepresentation) check whether the JWS compact representation of signed receipt contains indicator for damaged signature creation device
static SecretKey	createAESKey() Generates a random AES key for encrypting/decrypting the turnover value ATTENTION: In a real cash box this key would be generated during the init process and stored in a secure area
static String	createAESKeyBase64()
static long	decryptTurnOverCounter(String encryptedTurnOverCounterBase64, String hashAlgorithm, String cashBoxIDUTF8String, String receiptIdentifierUTF8String, SecretKey aesKey) decrypt the turnover counter with the given AES key, and parameters for IV creation Ref: Detailspezifikation Abs 8/Abs 9/Abs 10
static long	decryptTurnOverCounter(String encryptedTurnOverCounterBase64, String hashAlgorithm, String cashBoxIDUTF8String, String receiptIdentifierUTF8String, String aesKeyBase64)
static double	getDoubleFromTaxSet(String taxSetValue) get double value from arbitrary String represent a double (0,00) or (0.00)
static String	getJWSCompactRepresentationFromQRMachineCodeRepresentation(String qrMachineCodeRepresentation) convert QR-machine-code representation of signed receipt to JWS compact representation
static String	getPayloadFromQRCodeRepresentation(String qrCodeRepresentation) extract the payload of the QR-Code (remove signature value)
static String	getQRCodeRepresentationFromJWSCompactRepresentation(String jwsCompactRepresentationOfReceipt) convert JWS compact representation to QR-machine-code representation of signed receipt
static double	getTaxSetTurnOverSumFromQRMachineCodeRepresentation(String qrMachineCodeRepresentation, boolean calcAbsValue) get sum of all tax-set turnover values from QR-machine-code-representation of signed receipt
static String	getValueFromMachineCode(String machineCodeRepresentation, MachineCodeValue machineCodeValue) get a value from the machine code representation
static boolean	isJWSCompactRepStornoReceipt(String jwsCompactRepresentation) determine wheter current receipt is "Stornobuchung", check via encrypted turnover value, (BASE64 encoding of STO)
static boolean	isJWSCompactRepTrainingReceipt(String jwsCompactRepresentation) determine wheter current receipt is "Trainingsbuchung", check via encrypted turnover value, (BASE64 encoding of TRA)
static boolean	isQRCodeRepStornoReceipt(String qrMachineCodeRepresentation)
static boolean	isQRCodeRepTrainingReceipt(String qrMachineCodeRepresentation) see above, same method, here: for machine code rep
static X509Certificate	parseCertificate(String base64EncodedCertificate) extract certificates from DEP Export Format String representation
static List<X509Certificate>	parseCertificates(String[] base64EncodedCertificates) extract certificates from DEP Export Format String representation

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CashBoxUtils

public CashBoxUtils()

Method Detail

createAESKey

public static SecretKey createAESKey()

Generates a random AES key for encrypting/decrypting the turnover value ATTENTION: In a real cash box this key would be generated during the init process and stored in a secure area

Returns:

generated AES key

createAESKeyBase64

public static String createAESKeyBase64()

calcCheckSumFromKey

public static String calcCheckSumFromKey(String base64AESKey,
                                         int numberOfBytes)

Calculation of check sum

Parameters:

base64AESKey -

numberOfBytes -

Returns:

getValueFromMachineCode

public static String getValueFromMachineCode(String machineCodeRepresentation,
                                             MachineCodeValue machineCodeValue)

get a value from the machine code representation

Parameters:

machineCodeRepresentation - machinecode representation (QR or OCR code)

machineCodeValue - which value? e.g. signature value, rk-suite etc.

Returns:

the extracted value as String

getQRCodeRepresentationFromJWSCompactRepresentation

public static String getQRCodeRepresentationFromJWSCompactRepresentation(String jwsCompactRepresentationOfReceipt)

convert JWS compact representation to QR-machine-code representation of signed receipt

Parameters:

jwsCompactRepresentationOfReceipt - JWS compact representation of signed receipt

Returns:

the QR-machine-code-representation of signed receipt

getPayloadFromQRCodeRepresentation

public static String getPayloadFromQRCodeRepresentation(String qrCodeRepresentation)

extract the payload of the QR-Code (remove signature value)

Parameters:

qrCodeRepresentation - the QR-machine-code-representation of signed receipt

Returns:

extracted payload of QR-machine-code-representation of signed receipt

getJWSCompactRepresentationFromQRMachineCodeRepresentation

public static String getJWSCompactRepresentationFromQRMachineCodeRepresentation(String qrMachineCodeRepresentation)

convert QR-machine-code representation of signed receipt to JWS compact representation

Parameters:

qrMachineCodeRepresentation - the QR-machine-code-representation of signed receipt

Returns:

JWS compact representation of signed receipt

decryptTurnOverCounter

public static long decryptTurnOverCounter(String encryptedTurnOverCounterBase64,
                                          String hashAlgorithm,
                                          String cashBoxIDUTF8String,
                                          String receiptIdentifierUTF8String,
                                          String aesKeyBase64)
                                   throws Exception

Throws:

Exception

decryptTurnOverCounter

public static long decryptTurnOverCounter(String encryptedTurnOverCounterBase64,
                                          String hashAlgorithm,
                                          String cashBoxIDUTF8String,
                                          String receiptIdentifierUTF8String,
                                          SecretKey aesKey)
                                   throws Exception

decrypt the turnover counter with the given AES key, and parameters for IV creation Ref: Detailspezifikation Abs 8/Abs 9/Abs 10

Parameters:

encryptedTurnOverCounterBase64 - encrypted turnover counter

hashAlgorithm - hash-algorithm used to generate IV

cashBoxIDUTF8String - cashbox-id, required for IV creation

receiptIdentifierUTF8String - receiptidentifier, required for IV creation

aesKey - aes key

Returns:

derypted turnover value as long

Throws:

Exception

getDoubleFromTaxSet

public static double getDoubleFromTaxSet(String taxSetValue)
                                  throws Exception

get double value from arbitrary String represent a double (0,00) or (0.00)

Parameters:

taxSetValue - double value as String

Returns:

double value

Throws:

Exception

checkReceiptForDamagedSigatureCreationDevice

public static boolean checkReceiptForDamagedSigatureCreationDevice(String jwsCompactRepresentation)

check whether the JWS compact representation of signed receipt contains indicator for damaged signature creation device

Parameters:

jwsCompactRepresentation - JWS compact representation of signed receipt

Returns:

signature device was damanged?

getTaxSetTurnOverSumFromQRMachineCodeRepresentation

public static double getTaxSetTurnOverSumFromQRMachineCodeRepresentation(String qrMachineCodeRepresentation,
                                                                         boolean calcAbsValue)
                                                                  throws Exception

get sum of all tax-set turnover values from QR-machine-code-representation of signed receipt

Parameters:

qrMachineCodeRepresentation - QR-machine-code-representation of signed receipt

calcAbsValue - flag which indicates whether abs(value) should be used, if set, this can be used to check whether the sum is zero. this is needed for checking the first receipt of the DEP or the first receipt after recovering from a failed signature creation device.

Returns:

Throws:

Exception

parseCertificate

public static X509Certificate parseCertificate(String base64EncodedCertificate)
                                        throws CertificateException

extract certificates from DEP Export Format String representation

Parameters:

base64EncodedCertificate - BASE64 encoded DER-encoded-certificate

Returns:

java object for X509Certificate

Throws:

CertificateException

parseCertificates

public static List<X509Certificate> parseCertificates(String[] base64EncodedCertificates)
                                               throws CertificateException

extract certificates from DEP Export Format String representation

Parameters:

base64EncodedCertificates - BASE64 encoded DER-encoded-certificates

Returns:

java objects for X509Certificate

Throws:

CertificateException

isJWSCompactRepTrainingReceipt

public static boolean isJWSCompactRepTrainingReceipt(String jwsCompactRepresentation)

determine wheter current receipt is "Trainingsbuchung", check via encrypted turnover value, (BASE64 encoding of TRA)

Parameters:

jwsCompactRepresentation - JWS compact representation of signed receipt

Returns:

is "Trainingsbuchung"?

isQRCodeRepTrainingReceipt

public static boolean isQRCodeRepTrainingReceipt(String qrMachineCodeRepresentation)

see above, same method, here: for machine code rep

Parameters:

qrMachineCodeRepresentation -

Returns:

isJWSCompactRepStornoReceipt

public static boolean isJWSCompactRepStornoReceipt(String jwsCompactRepresentation)

determine wheter current receipt is "Stornobuchung", check via encrypted turnover value, (BASE64 encoding of STO)

Parameters:

jwsCompactRepresentation - JWS compact representation of signed receipt

Returns:

is "Stornobuchung"?

isQRCodeRepStornoReceipt

public static boolean isQRCodeRepStornoReceipt(String qrMachineCodeRepresentation)