How to set up Xero
Prepare your Xero organization for Swiss banking.
Setup Bank Accounts
Configure your funding bank accounts.
- Ensure your Xero bank accounts have a valid IBAN and BIC assigned.
- In Xero, go to Accounting -> Bank Accounts.
- For the bank account you want to pay your bills from, click Manage Account, then select Edit Account Details.
- In the Edit Bank Account Details dialog, enter your IBAN in the field Account Name and your BIC in the field Account Number.
Setup Contacts
Ensure contact details are valid for formatting.
- In Xero, go to the Edit Contact page.
- Click on Financial details, enter the contact's IBAN in the field Bank account number and the contact's BIC in the field Details.
- Click on Addresses, and enter the customer's address, city, and zip code.
Setup Supplier QR Bills
Add the required reference to process QR payments.
- To process QR payments, go to the Edit Bill page in Xero.
- Enter the bill's Swiss QR reference in the field Reference.
Setup Organization Details
Validate your corporate identity details.
- Go to Settings -> Organization details.
- Ensure the Legal Name, physical address, and Tax Number are completely filled out.
Connecting to Xero
Manage Xero integrations and multi-tenant constraints.
Link Organization
- Navigate to the Organizations Workspace.
- Click "Add Organization" and follow the OAuth2 Xero prompts.
- Select the Xero tenant you want to allow Digintu to access.
Multi-entity Configuration
- Free and Standard plans are limited to 1 active connection.
- Advanced plans include 3 connections by default. You can purchase additional organization limits via your Profile settings.
Disconnecting Organizations
- In the Organizations Workspace, click the unlink/disconnect icon next to the active connection.
- This severs the OAuth2 tracking token immediately.
Importing Invoices
Digitize PDFs and reconcile ledgers. This feature covers both suppliers and customer invoices.
QR-Bills & ZUGFeRD
Handling individual PDF uploads.
- Select 'Purchases' or 'Sales' direction.
- Choose 'Swiss QR' to parse standard slips or 'Factur-X/ZUGFeRD' for embedded XML.
- Contact from QR or ZUGFeRD is detected and matched automatically to Xero's contact.
- Digintu validates QR-IBAN rules and 27-digit QRR references automatically.
CSV Bulk Import
Handling bulk spreadsheet data.
- Upload a CSV file and map your specific columns to Xero fields.
- Set a fallback currency (e.g., CHF) for rows missing currency data.
- Generate a staging preview to verify amounts before pushing to Xero.
Manual Entry
For invoices without digital documents.
- Select 'Manual Entry'.
- Search for an existing Xero contact or enter a new name.
- Fill in the required IBAN, Address, and Amount fields to push directly.
Paying Bills (PAIN.001)
Generate compliant payment execution files for your bank.
Compiling a payment batch
- In the Invoices Workspace, filter for "Purchases (Supplier Invoice)".
- Select the invoices you wish to pay using the checkboxes.
- Click "Process Selected Bills" to stage them in the Clearing Engine.
Payment Strategies
- Select your funding Xero Bank Account and Execution Date.
- Choose the strategy: Swiss Inland (Regular), Swiss QR-Bill, or International (SEPA).
- Click Compile & Download to receive your XML file.
Inline Editing & Validation
Modify details before compiling.
- You can update the creditor's IBAN, BIC, or Amount directly in the staging grid.
- Warnings will appear if a BIC is missing or if you attempt to use a QR-IBAN without a valid QRR reference.
Swiss Inland (Regular)
Standard domestic bank transfer.
- Requires a standard IBAN or account number.
- Explicitly forbids QR-IBAN formats.
- Beneficiary Name, IBAN, and Amount are strictly required.
Swiss QR-Bill Payment
Mandatory strategy for QR-IBAN accounts.
- Requires a valid 21-character Swiss QR-IBAN (format CH/LI with ID range 30000-31999).
- Mandatory 27-digit numeric QR Reference with valid Modulo10 checksum.
- Settlement is strictly limited to CHF or EUR currencies.
International Transfer (SEPA / Cross-Border)
For multi-currency or international payments.
- Requires Beneficiary City and Country, along with standard IBAN or non-IBAN account numbers.
- Requires specifying a Fee Charge Bearer (Shared, Sender Pays All, Recipient Pays All) and a Mandatory Purpose Code (e.g., General Goods, Salary).
- For SEPA (Scenario A), the currency must be exactly EUR.
Modifiable Fields & Xero Sync
What can be entered and saved to the cloud ledger.
- You can manually edit the Beneficiary Name, Address (Street/ZIP/City/Country), Contact IBAN, BIC/SWIFT, Reference, Currency, and Amount directly in Digintu.
- Using the "Save" action pushes changes for Contact Name, Address Block, and Invoice Reference directly back to Xero.
- Changes to Banking Details (IBAN/BIC), Currency, and Amount apply ONLY to the generated payment file and will not override your master records in Xero.
Importing Bank Statements
Automate reconciliation mapping using CAMT data.
Reconcile Lines
- Open the Bank Statement Workspace.
- Select the Target Bank Account.
- Upload the CAMT.053/054 XML file provided by your bank.
- Review the confidence matching scores (Perfect, Partial, Name Match).
Confidence Scores & Matching
How the engine links transactions.
- Perfect Match (Green): Exact amount and reference matched.
- Ref Matched (Blue): Reference matched but amount may differ.
- Partial/Overpayment (Yellow): Potential discrepancy in amounts.
- Duplicate (Red): Transaction has already been synchronized.
Manual CSV Export & Upload
Download the generated CSV and manually upload it to Xero.
- In the Accounting menu, select Bank accounts.
- For the bank account you want to import your file into, click the menu icon, then select Import a Statement.
- In File to upload, drag and drop the CSV downloaded from Digintu or click Select file.
- If prompted, assign the columns in your import file to the matching bank statement fields in Xero, then click Next.
- If prompted, select the date format used in your bank statement, then click Next.
- Review the imported transactions and clear the checkbox next to any transaction you don't want to import.
- Click Complete import.
Direct 1-Click Reconciliation Push
Push statements directly into Xero for automatic reconciliation.
- When transactions are pushed directly, Digintu determines the record type based on the matching confidence.
- For highly confident matches (80% or greater) linked to an existing Xero invoice, a Payment record is created against the invoice.
- For other transactions, a direct Spend or Receive Bank Transaction (Account Transaction) is generated, mapped to account code "200" and linked to the detected contact.
- All direct pushes bypass manual file mapping, updating your Xero ledger instantly.
Generating QR-Bills
Create official Swiss QR payment slips and ZUGFeRD XMLs from Accounts Receivable.
Standard PDF
- Generates a standard print layout without embedded metadata.
- Toggle 'Save modified address back to Xero' to permanently update the customer's address directly from Digintu.
- Select 'Attach PDF back to Xero' to upload the file directly to the Xero invoice, allowing you to email it to the customer natively from Xero.
ZUGFeRD XML
- Creates a PDF/A-3 document with embedded XML invoice data.
- Choose between Basic (Itemized), Comfort (EN16931), Extended, or Minimum (Header Only) ZUGFeRD profiles to meet your customer's B2B requirements.
- Toggle 'Save modified address back to Xero' to permanently update the customer's address.
- Select 'Attach PDF back to Xero' to upload the file directly to the Xero invoice, allowing you to email it natively.
Swiss QR Bill
- Appends an official, vector-rendered visual Swiss QR slip to the last page.
- For QR-IBANs, the system automatically computes a 27-digit QRR reference with a valid Mod10 checksum.
- For standard IBANs, an ISO 11649 SCOR reference starting with RF is generated.
- Toggle 'Sync reference back to Xero Invoice' to save the generated QRR or SCOR token back to the cloud ledger.
- Toggle 'Save modified address back to Xero' to permanently update the customer's address.
- Select 'Attach PDF back to Xero' to upload the file directly to the Xero invoice for native emailing.
Hybrid (Full)
- Combines embedded XML data with a scannable Swiss QR payment slip on the last page.
- Configure ZUGFeRD profiles (Basic, Comfort, Extended, Minimum) to meet XML schema strictness.
- The system handles reference generation (QRR for QR-IBANs, SCOR for standard IBANs) and allows syncing the reference back to the Xero invoice.
- Toggle 'Save modified address back to Xero' to permanently update the customer's address.
- Select 'Attach PDF back to Xero' to upload the file directly to the Xero invoice for native emailing.
Know Your Contact (KYC)
Verify counterparties against the Swiss Zefix registry for AMLA compliance.
How Verification Works
The matching process uses strict UID and fuzzy name logic.
- Digintu first attempts to match the contact using the Xero Account Number, assuming it contains a valid Swiss UID.
- If no UID is found or the match fails, Digintu falls back to a text search using the contact's Name.
- If multiple entities share similar names, you will be presented with a list to manually select the correct counterpart.
Zefix Fields Explained
Understanding the retrieved compliance data.
- EHRA-ID & CH-ID: Unique federal and cantonal identifiers for the entity.
- SOGC Date: The date of the most recent publication in the Swiss Official Gazette of Commerce.
- Status: Indicates if the company is ACTIVE or LIQUIDATED. Red badges require immediate attention.
- Legal Seat & Purpose: Verifies the official registered address and the binding corporate purpose.
Xero Synchronization
How Digintu updates your ledger.
- When linking a verified record, Digintu utilizes the 'Account Number' field in Xero to store the validated Zefix UID (e.g., CHE-123.456.789).
- By default, Digintu will overwrite any existing data in the Account Number field to ensure compliance consistency.
- You can toggle this automatic update off before clicking 'Accept & Link Record'.
Pricing & Credits
Verification costs.
- Querying the registry and viewing initial search results is completely free.
- Fetching the full, detailed compliance profile costs 1 Verification Credit.
- Credits are deducted automatically from your workspace balance upon successful retrieval.
Billing & Subscriptions
Understand our scalable pricing, capacity usage, and subscription management.
Transaction Quotas
- The Free plan includes 10 document extractions/syncs per month.
- The Standard plan includes 100 transactions per month.
- The Advanced plan includes Unlimited transaction parsing.
Managing your subscription & capacity
- Go to Profile.
- Under "Workspace Capacity", click "Manage Capacity" to scale your team seats or connected organizations.
- All billing modifications are prorated instantly.
Swiss NGO Discounts
- During checkout, enter your Zefix UID.
- If your organization is a registered Verein/Association/Foundation, a 50% discount is applied to your premium subscription permanently.
Upgrading and Downgrading
Changing your base subscription.
- Navigate to your Profile.
- Click 'Upgrade to Advanced' to switch via the Stripe portal. Unused time is prorated automatically.
- To downgrade to Standard, you must first reduce your team seats and connected organizations to 1.
- Click 'Downgrade to Standard' directly in the app interface.
Managing Capacity Add-ons
Adding seats or organizations.
- On the Advanced plan, click 'Manage Capacity'.
- Use the +/- buttons to scale Team Seats or Connected Organizations.
- The system will show a live preview of the prorated upgrade cost or downgrade credit before saving.
Customer Billing Portal
Invoices and Payment Methods.
- Click 'Manage Subscription' to access the secure Stripe portal.
- Update your default credit card or billing address.
- Download past PDF invoices and receipts.
- Cancel your subscription at any time (cancellation takes effect at the end of the current billing period).
Enterprise Plan
Custom tailored environments for large operations.
- Includes custom pricing paid via B2B invoicing and traditional wired payments.
- Unlock unlimited custom organizations, dedicated seats, and personalized onboarding.
- To request an Enterprise quote, use the contact button at the bottom of the page.
Team Management
Invite colleagues and configure inherited Xero access rights.
Inviting and Removing Members
- Go to the Team Management page.
- Click "Invite Member" and enter their email address. They will receive a link to join.
- To remove a member, click "Remove". Their account will be converted into an independent free workspace.
Security & Permissions
- Digintu inherits Xero permissions directly via OAuth2.
- If a team member does not have explicit access to an organization in Xero, they cannot access its data within Digintu.
Workspace Settings
Customizing your environment.
- The Workspace Owner can click 'Edit' next to the workspace name to rename it.