FiscoBridge Help Main Site

Creating an Invoice

Web Invoicing lets you create fiscally signed invoices in a guided, step-by-step process. Each invoice is signed with your PFX certificate and reported to the tax authority automatically.

Before You Start

Make sure you have:

  • At least one active certificate uploaded (see Invoicing Manager)
  • An active Web Invoicing subscription

Step-by-Step Guide

Step 1: Select Your POS

  1. Go to Web Invoicing → Create Invoice in the sidebar
  2. If you have one active certificate, it is selected automatically. If you have several, choose the certificate you want to use for signing
  3. The page shows your currently selected certificate with its location, UID, and taxpayer name
  4. To use a different certificate, click Change POS

Select Point of Sale dialog listing a certificate with its taxpayer, UID, expiry date, and status

When a certificate is selected, Web Invoicing automatically connects to the V-SDC and retrieves the current tax rates for that location.

Step 2: Add Invoice Items

  1. Click Add Item. A list of your saved products opens. If you have no saved products yet, the new item form opens instead

Add item dialog listing saved products with a search box and a New item button

  1. Add items in any of these ways:
    • Pick a saved product — Click it in the list. It is added to the invoice with quantity 1. Click it again to add one more
    • Search or scan — Type part of the name or barcode in the search box, or scan the barcode with a barcode reader. A scanned product is added straight away and the box is ready for the next scan
    • New item — Click New item for a product or service that is not in the list. If your search finds nothing, click Add "..." as a new item and the name or barcode you typed is filled in for you
  2. For a new item, fill in the item details:
    • GTIN — Global Trade Item Number / product barcode (optional). See Product Management for details
    • Name — Item description
    • Quantity — Number of units (supports decimal quantities for items sold by weight or measure)
    • Unit Price — Price per unit (minimum two decimal places)
    • Tax category — Select from the available options. These are received from the V-SDC and include the label letter and rate (e.g., "VAT (A) - 15%"). See Tax Rates
    • Save to my products — Ticked by default, so the item appears in your product list next time. Untick it to use the item on this invoice only
  3. Click Add to include the new item, then Done when all items are on the invoice

Scanning without opening Add Item

With a barcode reader you do not need to click Add Item first. Scan a product while the Create Fiscal Invoice page is open and:

  • If one saved product has that barcode, it is added to the invoice with quantity 1. Scan it again to add one more
  • If no saved product has that barcode, the new item form opens with the barcode filled in
  • If several saved products share the barcode, the product list opens so you can pick the right one

You do not need to click into a field before scanning. A scan made while the cursor is in a quantity box or another field is still added as an item, and the field keeps what you typed.

The barcode reader must work as a keyboard and send Enter after each barcode, which is the factory default on most models. Barcodes of 8 to 14 digits are recognised. Select a POS before you scan.

You can see all added items listed as lines. The running subtotal and total are shown in the Payment section below.

Invoice items listed as lines showing name, GTIN, tax category, quantity controls, price, and line total, with edit and delete icons

  • To change a quantity, use the minus and plus buttons on the line, or type the quantity
  • To change the name, price, or tax category of an item, click the edit icon on its line
  • To remove an item, click the delete icon — this is the void function, allowing you to remove any selected item before the invoice is issued

Note: You must add at least one item before you can fiscalize the invoice.

Step 3: Choose Payment Method

The Payment section shows the total and how the customer is paying. By default the full amount is allocated to a single payment method.

  1. Select the Payment Method from the dropdown — Cash, Card, Check, Wire Transfer, Voucher, Mobile Money, or Other. See Payment Types
  2. The total updates automatically to match the invoice items

Payment section showing the payment method dropdown, a Split Payment link, and the invoice total

Splitting a Payment Across Multiple Methods

When a customer pays with more than one method (for example, part cash and part card), use split payment:

  1. Click + Split Payment below the Payment Method dropdown
  2. In the dialog, the first row is pre-filled with the invoice total
  3. Click Add payment method to add another row — pick a payment type and an amount
  4. As you edit an amount, the last row rebalances automatically so the allocated total matches the invoice total
  5. The Remaining value must reach 0.00 (shown in green) for the split to be valid
  6. Click Save to apply the split

Split Payment dialog with multiple payment rows, allocated and remaining totals, and Save and Cancel buttons

After saving, the Payment section shows each allocated method and amount, and the Payment Method dropdown is locked to Multiple (N methods). Click the edit icon next to the total or the Edit payment split link to adjust the split again.

Note: You can't fiscalize until the split is balanced. If the payment total doesn't match the invoice total, a warning appears and the Fiscalize button is disabled.

Step 4: Configure Invoice Settings

Expand the Invoice Settings panel to review or change:

Setting Options Notes
Invoice Type Normal, Advance, Training, Copy, Proforma Most sales use Normal. See Invoice Types for details
Transaction Type Sale, Refund Use Refund for returns
Reference Number Text field Required for Refunds and Copies — enter the original invoice number in format RequestedBy-SignedBy-OrdinalNumber. Optional when linking a Normal Sale to a prior Advance or Proforma invoice
Buyer Tax ID Text field The buyer's TIN — mandatory for B2B transactions, optional otherwise
Buyer Cost Center Text field Optional internal code the buyer gave you (e.g. BRANCH-12). Requires Buyer Tax ID. Labelled Project Number for Eswatini certificates
Cashier ID/Name Text field Identifies who processed the sale
Additional fields Key/value rows Eswatini certificates only. Extra header lines printed on the fiscal invoice, such as projectName. See Eswatini invoices

Invoice settings panel with dropdowns for invoice type and transaction type, and optional fields for reference number, buyer tax ID, buyer cost center, and cashier

Tip: Use Training invoice type to practice without creating real fiscal records. Training invoices are not reported to the tax authority.

Step 5: Fiscalize

  1. Review your invoice — check the type, payment, items, and total
  2. Click Fiscalize
  3. A confirmation dialog appears showing a summary:
    • Invoice type and transaction type
    • Payment breakdown (one row per payment method when split)
    • Total amount
    • Number of items

Fiscalization confirmation dialog summarizing invoice type, payment type, total amount, and item count with Confirm and Cancel buttons

  1. Confirm to submit the invoice for fiscal signing

The invoice data is sent to the V-SDC, which signs it and returns the fiscal result. The POS cannot issue an invoice if it is not connected to the V-SDC.

After Fiscalization

Once the invoice is signed, you'll see a success screen with:

Field Description
Invoice Number The fiscal invoice number assigned by the SDC (format: RequestedBy-SignedBy-OrdinalNumber)
Invoice Counter A sequential counter generated by the V-SDC
SDC DateTime The official timestamp from the SDC, used for tax calculation and reporting
Verification URL A link anyone can use to verify the invoice
QR Code Scannable code linking to the verification URL
Signed By The certificate that signed the invoice

Fiscalization success screen showing invoice number, counter, timestamp, total, the verification URL with WhatsApp, Email, and Copy link buttons, the receipt preview with QR code, and the available actions

From here you can:

  • Send the verification link to the customer — Use the WhatsApp, Email or Copy link buttons under the Verification URL, or let the customer scan the QR code on the receipt
  • Print the receipt — See Printing an Invoice
  • Create another invoice — Start a new sale
  • View in invoice history — Go to Invoices

Eswatini invoices

Certificates issued by the Eswatini Revenue Service use the newer TaxCore invoice format. FiscoBridge handles this automatically, and these extra details are reported to the Eswatini Revenue Service:

  • Project Name and Project Number are printed in the header of every Eswatini fiscal invoice. Project Number is the Buyer Cost Center value (the field is labelled Project Number when an Eswatini certificate is selected). Project Name comes from the Additional fields rows at the bottom of Invoice Settings: enter projectName as the key and the project's name as the value. A projectName row is pre-filled for you; leave it blank if the sale is not tied to a project. You can add further rows for any other key the Eswatini Revenue Service defines. Keys are limited to 64 characters and values to 256. The District line on the invoice is filled by the SDC from the certificate issued to your business location and cannot be changed in the POS.

  • Date of supply is printed when the invoice carries a buyer tax number. It is the date the goods were handed over or the service was completed. Integrations that know this date (for example a delivery date in Odoo or a service date in QuickBooks) pass it through; otherwise the current date in Eswatini is used.

  • Taxable amount per tax label shows the tax-exclusive value of the items under each label. FiscoBridge takes the tax-exclusive line amount from your accounting platform when it is available and otherwise derives it from the line total and the tax rate.

Invoices without a buyer tax number are reported as business-to-consumer; invoices with one are reported as business-to-business.

Next Steps