🇺🇸 RedMaple Invoice Generator - Multilingual User Manual
Complete guide for multi-tenant SaaS invoicing, client CRM, Stripe/PayPal checkout, localized taxes, and secure PDF delivery.
1. Platform Architecture & Multi-Tenancy
Cryptographically isolated agency workspaces and tenant scopes
RedMaple is built on a strict multi-tenant schema where every agency operates in an isolated workspace container:
- Tenant Scoping: All database queries are automatically scoped using
WorkspaceScope, guaranteeing zero data leakage between agencies. - Enterprise Authentication: Strong Bcrypt credential hashing and CSRF token verification.
- Role-Based Access Control (RBAC): Permissions segregated by Owner, Admin, and Staff tiers.
2. Team Members & Granular Role Privileges
Seat allocations, activation invites, and permission enforcement
Agency teams are managed under Agency Settings → Team Members. Each team member is assigned one of three granular roles:
| Privilege / Capability | Primary Owner | Workspace Admin | Staff Member |
|---|---|---|---|
| Create & Manage Invoices | ✓ Full | ✓ Full | ✓ Full |
| Client CRM & Service Catalog | ✓ Full | ✓ Full | ✓ Full |
| Credit Notes & Reminders | ✓ Full | ✓ Full | ✓ Full |
| Agency Settings & SMTP Config | ✓ Full | ✓ Full | ✗ Restricted (Hidden) |
| Plan & Billing Upgrades | ✓ Full | ✓ Full | ✗ Restricted (Hidden) |
| Invite & Change Team Roles | ✓ Full | ✓ Full | ✗ Restricted |
3. Invoicing Engine & Sequential Numbering Lock
Atomic gap-less sequence locking per workspace
Every issued invoice is assigned a concurrency-safe sequential code (e.g., INV-2026-0001). An atomic database sequence counter prevents duplicate numbering even under simultaneous checkout attempts.
4. Email Dispatches, Resend Confirmation & Open Tracking
Real-time engagement telemetry, beacon tracking, and duplicate prevention
Invoicy provides real-time client engagement analytics for every invoice dispatched to a client email address:
Dispatches via authenticated SMTP. Re-send safety dialog asks confirmation if invoice was previously dispatched.
Embedded 1x1 transparent beacon telemetry logs exact timestamps and count when recipient opens the email in their client.
Logs every view of the secure web payment portal or PDF download with date and IP telemetry.
5. Country Taxation Rules & PDF Security
GAAP/IFRS pre-tax discounts and optional client PIN protection
- Pre-Tax Discount Calculation: Taxes are computed strictly after deducting discounts:
Taxable Amount = Subtotal - Discount. - Regional Tax Presets: UK VAT (20%), DE MwSt (19%), UAE VAT (5%), Saudi Arabia VAT (15%), India GST (18%), Turkey KDV (20%), Pakistan Sales Tax (16%).
- PDF Security PIN: When creating sensitive commercial invoices, enable "Password Protect PDF". The client must enter the assigned PIN before downloading the document.
6. Recurring Retainers & Auto-Billing
Automated monthly billing cycles and recurring client retainers
Agencies with monthly retainer agreements can configure automated recurring billing under Recurring Retainers:
- Billing Cycles: Weekly, Monthly, Quarterly, Semi-Annually, or Annually.
- Generation Mode: Automated dispatch or Draft queue requiring admin approval before delivery.
- Auto-Numbering: Each generation pulls from the next sequential invoice number.
7. Credit Notes & Ledger Refunds
Accounting integrity and immutable reversal trail
In commercial accounting, issued invoices must never be deleted. To correct errors, billing mistakes, or cancelled projects, an agency issues a Credit Note (CN-YYYY-XXXX).
Credit notes automatically adjust outstanding balances, update the financial audit trail, and maintain strict accounting compliance.
8. Reminders & Automated Scheduler
Automated receivables follow-up before and after invoice due dates
Configure automated payment reminder rules to minimize overdue invoices:
9. Client Directory & CRM
Multi-currency billing and localized customer preferences
When registering a client in the CRM, you can configure their specific language and billing rules:
10. Service Catalog & Line Item Presets
Pre-saved products, hourly deliverables, and standard rates
Save recurring service items under Catalog & Presets. When drafting new invoices, simply select a preset from the autocomplete dropdown to instantly populate unit rate, description, and tax category.
11. Stripe, PayPal & Merchant Gateways
Direct client payments deposit directly into your agency merchant account
Connect your own Stripe and PayPal accounts in Agency Settings:
- Direct Merchant Settlement: Client payments flow directly into your agency merchant balance. Invoicy charges 0% transaction commission.
- Free Trial Evaluation Mode: In trial mode, gateway input is locked to prevent live payments on test accounts. Upgrading to a paid subscription unlocks live Stripe and PayPal integrations immediately.
- Idempotent Webhooks: Webhook events are deduplicated to prevent double-crediting.
12. Agency Branding, Wire Transfer & Custom SMTP
Custom logos, brand colors, whitelabel PDFs, and custom outgoing email servers
Customize your agency's visual identity and communications under Agency Settings:
13. Bulk Operations Suite
High-velocity multi-record batch processing
Invoicy provides bulk selection toolbars across key management modules:
- Invoices Bulk Actions: Select multiple invoices to batch Mark as Paid, batch Mark as Issued, dispatch Batch Email Invoices, or Delete Drafts in a single click.
- Tenant Workspaces (Admin): Batch Activate, Suspend, grant +14 Days Trial Extensions, or Renew for 1 Month across multiple subscribed agencies.
- Promotional Coupons & Offers (Admin): Batch Activate, Pause, or Delete discount offers.