Skip to content
English
  • There are no suggestions because the search field is empty.

Fiscal Device

Touch - Peripherals

IMPORTANT

 

Venues currently configured to use the SoftSDC V2 (Taxcore Fiji) integration, can continue using this version until it ceases on 31 December 2026.

Before the 31 December 2026, Venues MUST be upgraded and configured to use the SoftSDC V3 (Taxcore Fiji) integration. Refer HERE for more information.

 

 

Subjects      ▲ ▼

 

About      ▲ ▼

 

What Is SoftCDC?      ▲ ▼

SoftSDC (S-SDC) is an application designed for Point of Sale (POS) mobile/desktop devices that converts non-fiscal invoices into fiscal ones.

The application works within the fiscal TaxCore system. Installing SoftSDC on your device transforms it into an ESDC (Electronic Sales Data Controller). This allows your device to connect your POS application with the Tax Administration's security element and generate properly reported fiscal receipts.

Refer HERE for more information.

 

What Is Required?      ▲ ▼

  • For SoftSDC v3, Swiftpos 10.79.3+ is required. For SoftSDC v3, Swiftpos v10.79.16+ is required.
  • The Fiscal Devices for Taxes option must be selected as part of the Swiftpos Registration. This may require requesting a Registration to be submitted.
  • Touch POS will need to be upgraded to the minimum required release of Swiftpos.
  • Ensure the Fiscal Device PIN (#650) and the Fiscal Buyer TIN (#651) POS Keys are added to the appropriate Keyboard Layout using the Designer. Refer HERE for more information.
  • SoftSDC has been installed and configured for the site.  
  • The required fiscal certificate / smart card has been configured as required.
  • The required Fiji tax rates are available from SoftSDC.
  • Swiftpos taxes have been configured and are marked as Active where appropriate.
  • Swiftpos taxes have been linked to the correct SoftSDC tax labels in the Fiscal device setup.
  • Item/Product and barcode data has been configured as required, including GTIN / barcode details where applicable.
  • Receipt printing has been configured and tested.

 

What Is Supported?      ▲ ▼

The following is a list of Fiscal device Peripheral types that are available:

  • SoftSDC V2
  • SoftSDC V3

 

What To Consider?      ▲ ▼

  • Venues currently configured for SoftSDC V2 (Taxcore Fiji) integration, can continue using this integration until it ceases on 31 December 2026.
  • Only one Fiscal device Peripheral Type can be configured for each Touch POS device.
  • SoftSDC is the source of truth for the tax rates used on fiscal invoices. Swiftpos Touch POS receives and utilises the tax rates from SoftSDC for fiscal invoice processing. 

 

When Is It Used?      ▲ ▼

Used when a Venue requires POS devices to be integrated with tax authorities to handle tax compliance, secure audits, and data synchronization. Originally designed to support Fiji's TaxCore solution.

 

Examples?      ▲ ▼

  • Example of Fiscal receipts.


FAQs?      ▲ ▼

  • What Happens At Touch Startup?

    When Touch POS starts, the configured Fiscal device is checked as part of the normal startup process.
    As part of this process, Touch POS and the Fiscal device are authenticated before fiscal processing is used.
    If the Fiscal device cannot be contacted or authenticated, Touch POS will display the relevant warning or error message.

  • Product Identification And GTIN / Barcode Entry?
    Swiftpos supports product identification using configured item/product and barcode data.
    Global Trade Item Numbers (GTINs) can be entered or scanned where they have been configured against items/products.
    Depending on the Venue’s item/product setup, Touch POS can use GTIN / barcode data to identify items/products during an order/sale.
    Item/Product and barcode configuration should be completed before fiscal processing is used in a live environment.

  •  Processing Fiscal Sales?

    Once SoftSDC V3 is configured, Touch POS will send applicable order/sales to the Fiscal device during finalisation.
    A successful fiscal order/sale will return fiscal information from SoftSDC and produce a fiscal invoice.
    Touch POS supports standard POS sale workflows, including sales paid using a single payment type or split across multiple payment types.
    The fiscal invoice is issued for the completed invoice total after the order/sale has been successfully finalised.

  • Fiscal Invoice Output?
    Touch POS produces a fiscal invoice after a successful response is received from the configured Fiscal device.
    The fiscal invoice may be issued in printed form, or electronically where the Venue’s configured workflow supports electronic output. The fiscal invoice may include:

    • Swiftpos sale details
    • Fiscal invoice information
    • Tax information
    • Buyer TIN, if entered
    • Buyer Cost Centre, if entered
    • Fiscal QR code
  •  Refund, Copy And Linked Invoice Reference Numbers?

    Certain fiscal invoice workflows require the invoice to reference another invoice.
    When issuing Refund or Copy invoices, Touch POS prompts the operator to enter a Reference Number. This Reference Number is used to link the invoice to the original fiscal invoice.
    When issuing a Normal Sale invoice connected to an Advance or Proforma invoice, Touch POS allows the operator to enter a Reference Number. This Reference Number is used to link the normal sale invoice to the related invoice where required.
    The Reference Number prompt appears when these transaction types are used.

  • Reviewing Issued Invoices / Electronic Journal?
    Swiftpos provides access to issued invoices via the:

  • Failed Fiscalisation Behaviour?
    If fiscalisation fails, Touch POS will block the sale from finalising.
    A warning or error prompt will appear with the relevant response details returned by SoftSDC. This may include an error or warning code from SoftSDC.

    The operator will be presented with options such as:

    • Retry fiscalisation
    • Cancel the fiscalisation attempt

        The order/sale cannot be finalised as a fiscal sale until a successful response is received from SoftSDC.

      •  Fiscal Device screen

        Control

        Required documentation

        Fiscal Device Type

        Radio buttons—not a dropdown. Options: Disabled, SoftSDC V2 (Taxcore Fiji) and SoftSDC V3 (Taxcore Fiji).

        Host

        Explain configuring the address of the SoftSDC installation. Distinguish local and network-host examples. Confirm the required Host-entry format before publishing examples.

        Timeout

        Explain the timeout in seconds and the default of 10 seconds.

        Test

        Enabled only when SoftSDC V3 is selected. Displays the returned status through the FISCAL COMMUNICATION dialog.

        Hide Sale Details On Receipt

        Available only for V3. Ticked: Swiftpos header, fiscal journal and Swiftpos footer. Unticked: normal Touch receipt plus the fiscal journal.

        V2 receipt behaviour

        V2 always prints the fiscal journal plus Sale Total and tenders. Hide Sale Details On Receipt is not available for V2.

        Detailed Logging

        Available for both V2 and V3. Remove conflicting descriptions of earlier proposed logging controls.

        QR Barcode Size

        Large, Medium and Small. A new Fiscal Device defaults to Small. Large prints at full receipt width, Medium at three quarters and Small at half.

        Save validation

        Saving V3 without tax links is blocked by “Tax Links are not set”. Explain how to resolve this.

       

      How To?      ▲ ▼

       

      How To GET STARTED?     ▲ ▼

      In Touch POS:

      • Add a new peripheral with the Fiscal Device option selected as the Peripheral Type. Refer HERE for more information.
      • Navigate to the Terminal Settings menu and select the Peripheral List option.
      • Select Peripheral List.
      • Select Add New.
      • Add a new peripheral with the type Fiscal Device.
      • The Fiscal Device will appear in the Peripheral List.
      • Select the Fiscal Device peripheral.
      • Select Edit.
      • The Fiscal Device screen will open.
      • Select from the available options the required Fiscal Device Type.
      • Enter the required Host value.
      • Enter the appropriate Timeout value.
      • Select from the QR Barcode Size drop-down list the size of the QR code to be printed on the fiscal receipt. The default QR Barcode Size is Small. The size can be adjusted to suit the Venue’s receipt layout as required.

      • Select the Tax Links option to open the Tax Linking screen. Then:
        • Select the Get Tax Rates option to retrieve the SoftSDC fiscal tax rates.

        • Map the SoftSDC fiscal tax rates to the relevant Swiftpos Tax IDs in the grid.

        • Select OK to save the changes.
      • Select the Test option to test the configuration.
      • If the test was successful, select Save to save the configuration.Otherwise, make the required changes to the configuration and test it again.
      • Restart Touch POS.

       

      How To Upgrade?     ▲ ▼

      To upgrade to use the SoftSDC V3 (Taxcore Fiji) integration, ensure the upgrade includes the folowing steps:

      • Confirm SoftSDC V3 is installed and configured for the Venue.
      • Configure Touch POS to use the SoftSDC V3 the Fiscal Device Type, and ensure:
        • Confirm the correct SoftSDC V3 Host value is entered.
        • Confirm the Timeout value is entered.
        • Confirm the appropriate QR Barcode Size is selected.
        • Review and map Tax Links.
        • Test the connection to the Fiscal device.
      • Process a fiscal order/sale in a test environment before going live.

       

      Screens      ▲ ▼

       

      Fiscal Device Screen     ▲ ▼

      tpos-fiscal-device-12

       

      To access, select the Peripheral List option in the Terminal Settings menu. Used to manage/view Fiscal device configurations in Touch POS. 

      • Fiscal Device Type - Select the appropriate Fiscal Device type from the following options:
        • Disabled - Select to ensure fiscal integration is disabled and sales will not be sent to SoftSDC.
        • SoftSDC V2 - Select to display and configure the setting options for the Fiji SoftSDC V2 integration.
        • SoftSDC V3 - Select to display and configure the setting options for the Fiji SoftSDC V3 integration.

       

      SoftSDC V2 Settings     ▲ ▼

       

      tpos-fiscal-device-4

       

      • Host - Displays/Enter the local address http://localhost:8080/ if SoftSDC is installed on the same PC as Touch POS. If SoftSDC is installed on another PC, enter the correct network address for that PC.
      • Timeout - Displays/Enter the appropriate timeout value in seconds. The default timeout is 10 seconds. This controls how long Touch POS will wait for a response from the Fiscal device before treating the request as failed. The timeout can be adjusted to suit the Venue’s specific requirements if required. If the Fiscal device does not respond within the configured timeout, Touch POS will display an error or warning message.
      • QR Barcode Size - Displays/Select from the drop-down list the size of the QR code to be printed on the fiscal receipt. The default QR barcode size is Small. The size can be adjusted to suit the Venue’s receipt layout as required.
      • Tax Links - Select to open the Tax Linking screen.
      • Detailed Logging - Select to enable.
      • Save - Select to save the changes and exit the screen.

       

      Notes ...

       

      Changes will not be saved if Tax Links are not configured. Refer HERE for more information.

       

      • Cancel - Select to exit the screen without saving the changes

       

      SoftSDC V3 Settings     ▲ ▼

       

      tpos-fiscal-device-13

       

      • Host - Displays/Enter the local address http://localhost:8431/ if SoftSDC is installed on the same PC as Touch POS. If SoftSDC is installed on another PC, enter the correct network address for that PC.
      • Timeout - Displays/Enter the appropriate timeout value in seconds. The default timeout is 10 seconds. This controls how long Touch POS will wait for a response from the Fiscal device before treating the request as failed. The timeout can be adjusted to suit the Venue’s specific requirements if required. If the Fiscal device does not respond within the configured timeout, Touch POS will display an error or warning message.
      • QR Barcode Size - Displays/Select from the drop-down list the size of the QR code to be printed on the fiscal receipt. The default QR barcode size is Small. The size can be adjusted to suit the Venue’s receipt layout as required.
      • Tax Links - Select to open the Tax Linking screen.
      • Test - Only enabled when the SoftSDC V3 (Taxcore Fiji) option is selected. Select to confirm whether Touch POS can connect to the configured Fiscal device. If the connection is successful, a Success message will be displayed. If the connection fails, an Unable to connect to Fiscal Device message will be displayed. In which case confirm the following:
        • SoftSDC is installed and running.
        • The Host address is correct.
          • The SoftSDC port is correct.
          • The PC or network is not blocking the connection.
        • The timeout value is suitable.
        • The fiscal certificate / smart card is available if required.
      • Hide Sales Details On Receipt - Only enabled when the SoftSDC V3 (Taxcore Fiji) option is selected. Select to hide the receipt header, fiscal journal and footer information. Unselect to print a normal Touch POS receipt with the fiscal journal information.
      • Detailed Logging - Select to enable.
      • Save - Select to save the changes and exit the screen.

       

      Notes ...

       

      Changes will not be saved if Tax Links are not configured. Refer HERE for more information.

       

      • Cancel - Select to exit the screen without saving the changes

         

        Tax Linking V2 Screen     ▲ ▼

         

        tpos-fiscal-device-6-1

         

        Used to map the SoftSDC fiscal tax rates to the relevant Swiftpos Taxes for SoftSDC V2 integration.

         

        Grid Section     ▲ ▼

         

        tpos-fiscal-device-6a-2

         

        Lists the SoftSDC V2 fiscal tax rates along with their ID, Name and Label. It allows the SoftSDC V2 fiscal tax rates to be mapped to the Swiftpos taxes.

         

        Tax Link Section     ▲ ▼

         

        tpos-fiscal-device-6b-1

         

        • Label - Displays/Enter the label for the selected tax.

         

        Footer Section     ▲ ▼

         

        tpos-fiscal-device-6c

         

        • OK - Select to save the changes and exit.
        • Cancel - Select to exit without saving the changes.

         

        Tax Linking V3 Screen     ▲ ▼

         

        tpos-fiscal-device-2

         

         

        Used to map the SoftSDC fiscal tax rates to the relevant Swiftpos Taxes for SoftSDC V3 integration.

         

        Header Section     ▲ ▼

         

        tpos-fiscal-device-2a-1

         

        • Get Tax Rates - Select to retrieve the SoftSDC V3 fiscal tax rates.

        • Valid From - Displays the date ...

        • Last Retrieved - Displays the date Tax Rates were last retrieved using the Get Tax Rates option.

         

        Grid Section     ▲ ▼

         

        tpos-fiscal-device-2b

         

        Lists the SoftSDC V3 fiscal tax rates along with their Name, Label, Rate, Tax ID and Description. It allows the SoftSDC V3 fiscal tax rates to be mapped to the Swiftpos taxes.

         

        Noteworthy

        • Tax ID - Enter the ID of the Swiftpos Tax code to which the SoftSDC V3 fiscal tax rate is to map to.

        • Last Column - Select to open the Tax with Rates screen to select a Swiftpos tax. Once selected, the tax's ID and Description will be added to the grid.

         

        Footer Section     ▲ ▼

         

        tpos-fiscal-device-2c

         

        • OK - Select to save the changes and exit.
        • Cancel - Select to exit without saving the changes.

         

        Troubleshooting      ▲ ▼

         

        IMPORTANT

         

        We do NOT recommend disabling fiscal processing to complete an order/sale requiring fiscalisation. 

         

         

        Issues      ▲ ▼

         

        Problem Action To Be Taken

        SoftSDC unavailable/connection failure

        Check the configured Host, service availability, network access and timeout; use Test to confirm communication.

        PIN required/rejected

        Use the supported PIN-entry path. Do not encourage repeated guesses or invent recovery/reset procedures.

        Smart card/reader unavailable

        Document the actual checks and operator messages supported by the approved installation.
        Tax Links are not set Retrieve and map rates before saving V3 configuration.
        Swiftpos tax missing from search Check that the tax is Active and the relevant configuration has reached Touch.
        Get Tax Rates fails Explain the connection checks and how to collect the error details.
        Other SoftSDC errors Explain the displayed result and escalation process. Confirm error-specific advice before publishing it.

         

        Logging      ▲ ▼

        To facilitate troubleshooting and issue resolution, ensure the Detailed Logging option is selected.

         

        Support      ▲ ▼

        Ensure Support staff are provided with the relevant information. For example, Touch POS version, selected fiscal device type, timestamp, operation attempted, displayed error and relevant logs/transaction identifiers.

         

        UI Communication      ▲ ▼

         

        State/action

        Meaning

        Please wait...

        Indicates the request is in progress.

        SUCCESS / OK

        Indicates a successful result and operator confirmation.

        Retry

        Requires the request to be re-attempted after addressing the reported issue.

        Cancel

        Select to cancel the order/sale. The order/sale will remain unfinalised.

        Close

        Select to close the order/sale. The order/sale will be finalised.

        Display Error

        Indicates an error has occurred. Ensure the information provided is made available to Support staff.

        Enter PIN

        Indicate that the entry of a PIN is required. Refer HERE for more information.

         

         

         

         

         

         

         

         

         

         

         

         

        End of article      ▲