SoftSDC v3
User Manual

Actions Menu

Available actions and operations in SoftSDC

Overview

The Actions menu provides access to important system operations and maintenance tasks. This section explains each action and when to use it.

Enter PIN

Entering your PIN authenticates you with the smart card's security element and enables fiscal operations.

How PIN Storage Works

Entering PIN will save your PIN in temporary memory for the duration of your session, allowing the application to communicate securely with the smart card without requiring repeated PIN entry for each transaction.

This enhances user experience while maintaining security since:

  • The PIN is never permanently stored
  • It's automatically cleared when the application is closed
  • It's cleared when the device is restarted
  • It's cleared after a period of inactivity
  • The temporary storage occurs only in volatile memory
  • Industry-standard encryption protects this sensitive information

PIN Entry Design

Entering pin has no submit button after entering last digit. This is by design to streamline the authentication process and reduce friction during daily operations.

Once you've entered all digits of your PIN code, the system automatically processes the credentials without requiring an additional confirmation step. The system provides immediate visual feedback through a brief animation that indicates the PIN has been accepted and is being processed.

If you make a mistake while entering your PIN, you can use the clear button to erase the entire entry and start again.

PIN Attempt Limits

The number of PIN attempts is limited to 5 to protect your smart card against unauthorized access attempts.

After entering an incorrect PIN:

  • The system displays a warning message
  • Shows how many attempts remain before the card becomes locked
  • This prevents brute-force attacks

If your card becomes locked due to excessive failed attempts:

  • Your secure element will be locked and unusable
  • You must contact the tax authority to reset your card

The number of PIN attempts resets to five after you successfully enter a valid PIN.

Restart Service

Restart service restarts all services related to the SoftSDC application:

  • Terminates and reinitializes the API service
  • Resets security module connections
  • Restarts background processes for receipt management and synchronization

When to Use

Use this function when experiencing:

  • Connectivity issues with the smart card reader
  • API response delays
  • After making configuration changes that require a refresh

The restart process typically completes within 10-15 seconds, during which time the application interface may briefly become unresponsive.

After restarting services, it is essential to enter your PIN code to re-authenticate with the security element. This step is mandatory because the restart process clears all active security contexts and authentication sessions.

Download Init Commands

Download init commands is a fundamental operation that requires an active internet connection to function properly.

What It Does

This feature initializes the core system processes by:

  • Securely retrieving cryptographic parameters from the central server
  • Downloading configuration settings
  • Establishing a secure channel with the Tax Authority infrastructure
  • Retrieving verification certificates
  • Downloading tax rate tables
  • Getting system parameters

Duration

The initialization process typically takes between 30-60 seconds to complete, depending on your connection speed and server response time.

When Required

This operation must be performed:

  • At least once during initial setup
  • After major system updates
  • When directed by technical support personnel to resolve synchronization issues

Notify Online

Notify online feature establishes a direct connection with the Tax Authority server to report the current operational status of your SoftSDC installation.

What It Does

When activated, this function:

  • Immediately sends a heartbeat signal to the Tax Authority
  • Contains essential system information (device identifiers, software version, security element status)
  • Helps tax authorities monitor registered fiscal devices
  • Ensures your system remains in compliance with regulatory requirements

The notification process typically completes within seconds and requires an active internet connection.

Start Local Init

Start local Init is an advanced troubleshooting feature that allows you to manually initiate the device initialization process using local parameters rather than downloading them from the central server.

When to Use

This function is particularly useful when:

  • Internet connectivity is limited
  • You need to configure the system using pre-approved initialization files

Requirements

  • Valid smart card must be inserted
  • PIN must be entered before execution
  • Configuration data must be available in the predefined location

During this process, the application will read configuration data from a predefined location on your device and apply it to the current SoftSDC instance.

Audit

SoftSDC exports audit packages in the same format to Tax Authority in two manners: Local Audit and Remote Audit. All data is encrypted using AES-256 with Encryption Key as per technical instructions. SoftSDC keeps all audit data locally until a Proof of Audit (PoA) has been received from the Tax Authority. Proof of Audit (PoA) is initiated periodically. Audit package (json file) is named after the secure component UID. SoftSDC stores audit package locally before sending response data to POS.

Start Remote Audit

Remote audit is initiated automatically whenever SoftSDC has Internet connection and access to Tax Authority server. Communication protocol is implemented as per technical specification. SoftSDC continuously sends audit packages, it also sends previously not sent audit packages when Remote Audit is performed

Start Local Audit

Local audit initiated by a taxpayer is a common scenario for devices that lack the ability to connect to the internet due to technical limitations of the devices or limited infrastructure. Audit files are stored in the subfolder named after the secure component UID. In case that folder does not exist on a medium, SoftSDC will create it.

How It Works

An audit is initiated by inserting:

  • An SD card
  • A USB Flash drive
  • Using a local folder or cloud drive (for mobile devices that don't support USB or SD cards)

During the Local Audit, the E-SDC doesn't submit audit packages to the tax authority system directly; instead, those files are saved to the chosen location. SoftSDC displays proper notification when local audit is started, in progress and completed.

Local Audit Steps

  1. Transfer the audit packages and ARP file from an E-SDC to external storage (e.g. SD card or a USB Flash drive)
  2. Upload the audit packages and the ARP file using the section "Upload audit packages" on the Taxpayer Administration Portal
  3. Check if there are pending commands for your E-SDC using the section "Download Commands" on the Taxpayer Administration Portal
  4. If there are pending commands, download them to the external storage
  5. Transfer the commands from the external storage to the same E-SDC
  6. Transfer the confirmation about receiving the commands from the E-SDC to the external storage
  7. Upload the confirmation using "Upload Commands Status" on the Taxpayer Administration Portal

NOTE: If you do not have any internet access, you can take the SD Card or USB Flash Drive to a tax office where a Tax officer will perform steps 2, 3, 4, and 7.

Create Test Invoice

Create test invoice allows you to generate a test fiscal receipt without integrating with a real POS system.

Purpose

This functionality is invaluable for:

  • Verifying that your SoftSDC installation is properly configured
  • Testing the complete fiscalization workflow
  • Ensuring the system can create valid fiscal documents

How It Works

When selected, the system will:

  1. Automatically generate a sample invoice with predefined items, tax rates, and payment information
  2. Process it through the complete fiscalization workflow
  3. Perform digital signing
  4. Submit to the tax authority when online

Preview Last Invoice

Preview last invoice option allows you to quickly view the most recently created fiscal document without having to navigate through transaction logs or reporting interfaces.

Features

  • View full details of the last invoice processed
  • See all line items
  • Review tax calculations
  • Check payment information
  • View fiscal identification elements

The preview appears in a dedicated window that can be:

  • Easily printed
  • Saved as a PDF if needed

Use Cases

This function is particularly useful for:

  • Verifying that a transaction was properly completed
  • Confirming specific details with customers
  • Troubleshooting issues that may have occurred during the fiscalization process

Explore Data

This option allows you to browse and review stored fiscal data on your device, including invoice history, audit logs, and transaction records.