🇺🇸 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.
// Multi-Tenant Data Isolation Model
Tenant Workspace [/agency-slug] → Isolated CRM Clients, Invoices, Retainers, SMTP & Bank Keys
✓ Zero cross-tenant leakage • Row-level workspace_id enforcement • Cryptographic portal tokens

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
Email Verification Required: Newly invited team members receive a signed activation email. Until their email address is verified via the cryptographic link, their login remains locked to prevent account spoofing.

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.

Invoice Lifecycle Flow
1. Draft 2. Issued 3. Sent / Emailed 4. Partially Paid 5. Fully Paid

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:

Dispatch Status

Dispatches via authenticated SMTP. Re-send safety dialog asks confirmation if invoice was previously dispatched.

Email Open Tracking

Embedded 1x1 transparent beacon telemetry logs exact timestamps and count when recipient opens the email in their client.

Portal / PDF Views

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:

Pre-Due Notice Sends gentle reminder 3 days prior to due date.
Due Date Alert Sends notification on the exact due date.
Overdue Follow-up Escalates notification at 7, 14, and 30 days overdue.

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:

Supported Languages English, Urdu (اردو), Hindi (हिन्दी), Turkish (Türkçe), Arabic (العربية), Spanish, French, German, Chinese.
Supported Currencies USD ($), EUR (€), GBP (£), AED (د.إ), SAR (﷼), CAD (C$), AUD (A$), INR (₹), TRY (₺), PKR (Rs).
Payment Terms Due on Receipt, Net 7 Days, Net 14 Days, Net 30 Days, Net 60 Days.

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:

Custom Logo & Colors Upload PNG, JPG, or SVG logos and configure primary brand hex colors.
Wire Transfer Details Add Bank Name, IBAN, Swift code, and routing numbers automatically stamped on PDF invoices.
Custom Outgoing SMTP Dispatch invoices from your own corporate domain email address with live connection test.

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.