How Can We Help?
Find answers, guides, and resources to get the most out of Tawala.
Getting Started
Set up your account and make your first sale
📄Invoices & TRA VFD
Create invoices and generate compliant receipts
📦Inventory
Manage products, stock, and warehouses
👥CRM & Customers
Manage leads, contacts, and sales pipeline
💰HRM & Payroll
Employees, attendance, and salary processing
🏛️TRA Compliance Guide
Everything about VFD and tax compliance
Getting Started
How do I set up my company profile? ▼
Setting up your company profile is the first step to using Tawala. Follow these steps:
- Log in to your dashboard and navigate to Settings > Company Settings.
- Upload your company logo (recommended size: 500x500px).
- Enter your official business name, TIN number, and VRN (if applicable) – these will appear on your invoices.
- Add your physical address, phone number, and email.
- Click Save Changes.
Note: Ensure your TIN is correct as it is required for TRA VFD integration.
How do I add a new user/employee? ▼
You can invite team members to collaborate on Tawala:
- Go to Settings > Users & Permissions.
- Click the Add User button.
- Enter the user's full name and email address.
- Select a Role (e.g., Admin, Sales Agent, Accountant).
- Click Send Invitation. The user will receive an email to set their password.
How do I reset my password? ▼
If you've forgotten your password:
- Go to the login page.
- Click the Forgot Password? link.
- Enter your registered email address.
- Check your email inbox for a password reset link (valid for 1 hour).
- Click the link and create a new secure password.
How do I download the mobile app? ▼
Tawala is available on mobile:
- Android: Visit the Google Play Store and search for "Tawala Business".
- iOS: Visit the Apple App Store and search for "Tawala Business".
- Login with your existing credentials.
Can I change the system language? ▼
Yes, Tawala supports multiple languages including Swahili:
- Click on your profile avatar in the top right.
- Select My Profile.
- Under Language Preferences, select Swahili or English.
- Click Save. The interface will refresh immediately.
How do I enable Two-Factor Authentication (2FA)? ▼
Enhance security with 2FA:
- Go to Settings > Security.
- Toggle Two-Factor Authentication to ON.
- Scan the QR code with Google Authenticator or Authy.
- Enter the verification code to confirm.
How do I update my billing information? ▼
To manager your subscription:
- Navigate to Settings > Billing & Subscription.
- Click Update Payment Method.
- We accept Visa, Mastercard, and Mobile Money (M-Pesa, Tigo Pesa).
Where can I find my company ID? ▼
Your unique Company ID is located in Settings > Company Profile, right below your logo. You may need this when contacting support.
Can I manage multiple businesses? ▼
Yes! Open the company dropdown menu in the top left header and click Add New Company. You can switch between businesses instantly without logging out.
Invoices & TRA VFD
How do I generate a TRA-compliant receipt? ▼
Generating a fiscal receipt is automatic when you create a sale:
- Go to Sales > New Invoice.
- Select a customer and add items to the cart.
- Click Save & Approve.
- The system will automatically communicate with the VFD server.
- Once approved (usually 1-2 seconds), a QR code and Verification Code will appear on the invoice.
- You can then Print or Email the fiscal invoice.
How do I print a Z-Report? ▼
Z-Reports are required by TRA at the end of every business day:
- Navigate to Finance > TRA VFD.
- Click on Daily Reports.
- Click the Generate Z-Report button.
- The report will generation and is automatically sent to TRA servers.
- You can download or print the PDF for your physical records.
How do I issue a Credit Note? ▼
Used for returns or refunds:
- Open the original Invoice.
- Click More Actions > Create Credit Note.
- Adjust the items/amounts to be refunded.
- Click Approve. This updates your VFD records automatically.
Can I create Proforma Invoices? ▼
Yes. Go to Sales > Quotes/Proformas > New Quote. These impact inventory or VFD only when converted to an Invoice.
How do I handle multi-currency invoices? ▼
Enable Multi-currency in Settings. When creating an invoice, select the currency (e.g., USD). The system will use the daily exchange rate for VFD reporting in TZS.
What if the VFD server is offline? ▼
Tawala works offline. Invoices are stored locally and will automatically sync with TRA servers as soon as internet connectivity is restored. Do not issue a manual receipt if you have already keyed it into the system.
How do I customize my invoice template? ▼
Go to Settings > Document Templates. You can change colors, fonts, add footers, and choose from 5 professional layouts.
How do I set up Recurring Invoices? ▼
For subscriptions or retainers: Go to Sales > Recurring Invoices. Set the schedule (e.g., Monthly on the 1st) and the system will auto-generate and email them.
How do I verify a VFD receipt? ▼
Scan the QR code on the printable invoice using the TRA Verification app or visit the TRA Verify portal and enter the Verification Code.
Inventory Management
How do I add products in bulk? ▼
To save time, use our bulk import feature:
- Go to Inventory > Products.
- Click the Import button.
- Download the CSV Template.
- Fill in your product details (Name, SKU, Price, Cost, Opening Stock).
- Upload the completed CSV file.
- Map the columns if requested and click Confirm Import.
How do I set low stock alerts? ▼
Never run out of stock again:
- Edit any product in your inventory.
- Find the Inventory Levels section.
- Enter a value in the Low Stock Threshold field (e.g., 10).
- When stock falls below this number, you will get an email alert and dashboard notification.
How do I handle stock transfers between warehouses? ▼
- Go to Inventory > Transfer Orders.
- Select Source Warehouse and Destination Warehouse.
- Add items and quantities.
- Approve. Stock decreases in Source and increases in Destination.
How do I perform a Stock Adjustment? ▼
For damaged or expired goods: Go to Inventory > Adjustments. Select "Quantity Adjustment" or "Value Adjustment", choose the reason (e.g., "Damage"), and update the figures.
Can I use a Barcode Scanner? ▼
Yes. Tawala supports all standard USB and Bluetooth barcode scanners. Just click into the prodcut search field on POS or Invoice creation and scan.
How do I create Product Bundles/Kits? ▼
When creating a product, select "Composite Item" type. You can then add component items. When the bundle is sold, stock is deducted from the individual components.
How do I manage expiry dates? ▼
Enable "Batch Tracking" in Inventory Settings. You will then be prompted to enter Batch Number and Expiry Date when receiving stock.
How do I print barcode labels? ▼
Select items in the Product list, click Actions > Print Labels. Choose your label size (e.g., A4 24-up) and print.
What is FIFO and does Tawala use it? ▼
FIFO (First-In, First-Out) means the oldest stock is sold first. Yes, Tawala uses FIFO for accurate Cost of Goods Sold (COGS) calculations.
CRM & Sales
How do I create a new lead? ▼
Track potential customers effectively:
- Navigate to CRM > Leads.
- Click New Lead.
- Enter the prospect's details and current status (e.g., New, Interested, Negotiating).
- Assign the lead to a sales agent if needed.
- Add notes or schedule follow-up calls in the Activity tab.
How do I import contacts from Excel/Google? ▼
Go to CRM > Contacts > Import. Download our sample template, paste your contacts, and upload.
How do I set Sales Targets for agents? ▼
Go to CRM > Sales Team. Click on an agent and set their Monthly/Quarterly revenue target. Track progress in the Reports section.
Can I integrate with Mailchimp? ▼
Yes. Go to Settings > Integrations > Mailchimp. Connect your API key to sync newsletter subscribers.
How do I create Email Templates? ▼
Save time on common responses. Go to Settings > Email Templates. Create templates for "Welcome", "Follow-up", etc.
How do I track deal stages? ▼
Use the Pipeline View in Deals. Drag and drop deals between columns like "New", "Qualification", "Proposal", "Negotiation", and "Won".
Can I log calls and meetings? ▼
Yes. Open any Contact or Deal. In the Timeline/Activity feed, click "Log Call" or "Log Meeting" to keep a history of interactions.
How do I segment customers? ▼
Use "Tags" or "Customer Groups" (e.g., VIP, Wholesaler). You can then filter reports or send bulk emails to specific groups.
HRM & Payroll
How do I process payroll? ▼
Running payroll is simple and automated:
- Ensure all employee attendance and salary info IS up to date in Employees.
- Go to Payroll > Run Payroll.
- Select the month/period.
- Review the generated payslips (deductions like NSSF and PAYE are calculated automatically).
- Click Approve & Finalize.
- You can then export a bank payment file or print payslips.
How do I manage Leave Requests? ▼
Employees can request leave via the Employee Portal. Managers approve it in HRM > Leave. Approved leave balances are updated automatically.
How are NSSF and PAYE calculated? ▼
We maintain up-to-date Tanzanian Tax Tables. Enter the Gross Salary, and the system automatically calculates statutory deductions based on current TRA/NSSF rates.
Can I track employee loans? ▼
Yes. Go to Payroll > Loans/Advances. Record the loan amount and repayment terms. Deductions will be automatically applied to payslips.
What is the Employee Portal? ▼
It's a self-service login for staff to view Payslips, apply for Leave, and view assigned Tasks without accessing sensitive company data.
How do I handle Overtime? ▼
Record extra hours in the Timesheet feature. Define your overtime rate (e.g., 1.5x) in Settings, and it will be added to the next payroll run.
How do I create an implementation plan for new hires? ▼
Use the Onboarding feature in HRM. specific tasks (e.g., "Collect ID", "Sign Contract") to be completed before the employee becomes active.
How do I export the bank transfer file? ▼
After finalizing payroll, click Export > Bank File. We support formats for CRDB, NMB, and Standard Chartered.
Finance & Accounting
How do I connect my bank account? ▼
Go to Banking > Connect Bank. We support automated feeds for major banks. For others, simply import your Statement CSV.
How do I record Expenses? ▼
Click New Expense. Upload a photo of the receipt, select the category (e.g., Travel, Meals), and approve. It updates your P&L instantly.
Can I manage multiple Currencies? ▼
Yes. Base currency is TZS. You can add USD, EUR, etc. The system tracks exchange gains/losses automatically.
What is the Chart of Accounts? ▼
It's the backbone of your accounting. We provide a default standard setup, but you can add custom Asset, Liability, Income, or Expense accounts in Settings.
How do I view my Profit & Loss? ▼
Go to Reports > Profit and Loss. Filter by date range to see your Net Profit in real-time.
How do I reconcile bank transactions? ▼
In Banking, select an account. Match "Bank Lines" (statement) with "System Lines" (invoices/bills). Click OK to reconcile.
How do I set up a Budget? ▼
Go to Reports > Budgets. Set monthly limits for accounts (e.g., Marketing). Compare "Actual vs. Budget" to stay on track.
Still Need Help?
Our support team is available Monday-Friday, 8am-6pm EAT.