bnussbau/rksv-parser-php

Parses Austrian RKSV String and extracts information

Maintainers

Details

github.com/bnussbau/rksv-parser-php

Source

Issues

Installs: 80

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 0

v0.2.0 2025-03-30 17:36 UTC

Requires

  • php: >=8.0

Requires (Dev)

MIT 36889ae354fb8ead32ed5c9ba69ad413c1a0f7ec

  • Benjamin Nussbaum <bnussbau.woop@users.noreply.github.com>

This package is auto-updated.

Last update: 2025-03-30 17:43:44 UTC

README

A PHP package for parsing RKSV (Registrierkassen-Sicherheitsverordnung) receipts, specifically designed for Austrian cash register systems.

Features

  • Parse RKSV receipt strings
  • Extract receipt details including:
    • Cash register algorithm identifier
    • Cash register ID
    • Receipt number
    • Receipt date and time
    • Tax amounts (normal, reduced rates, zero, special)
    • Turnover counter
    • Certificate serial number
    • Company EU VAT ID
    • Signature values
  • Support for SPAR JSON response format
  • Calculate total amounts including tax
  • Calculate individual tax amounts for different tax rates

Installation

composer require bnussbau/rksv-parser-php

Usage

Basic Usage

use Bnussbau\Rksv\RksvParser;

$rksvString = "_R1-AT0_0003111_0003111001000202404157928_2024-04-15T16:28:54_0,00_13,80_0,00_0,00_0,00_4jJVnlBGlgw=_U:ATU59193205-001_xg2ik+BDjGE=_MRuODBrEHpIbqWbi+JbMg3A8jaCrind4hTi07PpeqwN9i+Anww4pEjrFXQ1+sQ7vi1M6d5a0aN+X0+EMbHt2HA==";
$parser = new RksvParser($rksvString);

// Get receipt details
$receiptDateTime = $parser->getReceiptDateTime();
$totalIncludingTax = $parser->getTotalIncludingTax();
$companyVatId = $parser->getCompanyEuVatId();

Parse from SPAR JSON Response

$jsonResponse = '{"code":"_R1-AT0_0487502_0404875001001202203314713_2022-03-31T17:16:44_0,00_1,89_0,00_0,00_0,00_oIY9ibHmpIc=_U:ATU33803701-3_NEen0fnOY9M=_H+KLP63QRYvxajhywX3JDskJeQdtPzMN6eUOVV7fAMxiRb9WyAWRMB06ynFB7hpeCGFM34adT14BcWpx0PGxnA=="}';
$parser = RksvParser::fromSparJson($jsonResponse);

Available Methods

  • getCashRegisterAlgorithmIdentifier(): Get the algorithm identifier (e.g., "R1-AT0")
  • getCashRegisterID(): Get the cash register ID
  • getReceiptNumber(): Get the unique receipt number
  • getReceiptDateTime(): Get the receipt date and time as DateTime object
  • getSumTaxSetNormal(): Get the sum of normal tax rate
  • getSumTaxSetReduced1(): Get the sum of first reduced tax rate
  • getSumTaxSetReduced2(): Get the sum of second reduced tax rate
  • getSumTaxSetZero(): Get the sum of zero tax rate
  • getSumTaxSetSpecial(): Get the sum of special tax rate
  • getTurnoverCounterAES256ICM(): Get the turnover counter
  • getCertificateSerialNumber(): Get the certificate serial number
  • getCompanyEuVatId(): Get the company EU VAT ID
  • getSignatureValuePreviousReceipt(): Get the signature value of the previous receipt
  • getSignatureValue(): Get the current receipt signature value
  • getTotalIncludingTax(): Get the total amount including tax
  • getAmountTaxSetNormal(): Get the tax amount for normal rate
  • getAmountTaxSetReduced1(): Get the tax amount for first reduced rate
  • getAmountTaxSetReduced2(): Get the tax amount for second reduced rate
  • getAmountTaxSetZero(): Get the tax amount for zero rate

Requirements

  • PHP 8 or higher

License

This package is licensed under the MIT License.