Multi-Company Invoice v1.0 - Complete User Guide
📖 Complete User Guide

Multi-Company Invoice

Step-by-step guide to set up and use the Multi-Company Invoice plugin. Learn how to manage multiple companies, create invoices, track payments, and more.

Version 1.0.0

📦 1. Installation

How to install the Multi-Company Invoice plugin on your WordPress site

📥 Method 1: WordPress Admin Upload (Recommended)

1

Download the Plugin

Download the multi-company-invoice.zip file to your computer.

2

Go to WordPress Plugins

Log in to your WordPress admin and navigate to:

Plugins Add New Upload Plugin
3

Upload and Install

Click "Choose File", select the ZIP file, then click Install Now

4

Activate the Plugin

After installation completes, click Activate Plugin

📁 Method 2: FTP Upload

1

Extract the ZIP File

Extract multi-company-invoice.zip on your computer.

2

Upload via FTP

Connect to your server via FTP and upload the multi-company-invoice folder to:

/wp-content/plugins/
3

Activate in WordPress

Go to Plugins → Installed Plugins and activate "Multi-Company Invoice".

✅ After Installation

The plugin will automatically:

  • Create all necessary database tables
  • Register custom user roles (Company Admin, Company Staff)
  • Add the "Invoices" menu to your WordPress admin sidebar

⚠️ Requirements

  • WordPress 5.6 or higher
  • PHP 7.4 or higher
  • MySQL 5.7 or higher
  • At least 128MB PHP memory limit

🚀 2. First Time Setup

Quick start guide to set up your first company and start invoicing

🏢
Create Company

Add your business

⚙️
Configure Settings

Currency, tax, etc.

👥
Add Clients

Your customers

📄
Create Invoice

First invoice

✉️
Send to Client

Email or link

🎯 Quick Start Checklist

1

Create Your First Company

Go to Invoices → Companies → Add New

Fill in your company name, address, logo, and contact information.

2

Configure Invoice Numbering

In the company form, set up:

  • Invoice Prefix: e.g., "INV-" or "2024-"
  • Next Invoice Number: Starting number (e.g., 1 or 1001)
3

Set Up Taxes (Optional)

Go to Invoices → Settings → Taxes to add tax rates like VAT, GST, etc.

4

Add Your First Client

Go to Invoices → Clients → Add New and enter client details.

5

Create Your First Invoice

Go to Invoices → Add New, select client, add items, and save!

💡 Pro Tip

If you have multiple companies, you can switch between them using the company dropdown at the top of most pages.

🏢 3. Managing Companies

How to create and manage multiple companies in the system

➕ Creating a New Company

1

Navigate to Companies

Invoices Companies Add New
2

Fill in Company Information

FieldDescriptionRequired
Company NameLegal name of your businessYes
LogoUpload company logo (appears on invoices)No
AddressStreet addressNo
City, State, ZIPCity, state/province, postal codeNo
CountryCountry nameNo
PhoneContact phone numberNo
EmailCompany email addressNo
Tax ID / VAT NumberBusiness tax identification numberNo
3

Configure Invoice Settings

FieldDescriptionExample
Invoice PrefixPrefix added to invoice numbersINV-, 2024-
Next Invoice NumberThe next number to be used1, 1001
Quote PrefixPrefix for quotationsQT-, QUOTE-
Default CurrencyCurrency for new invoicesEUR, USD
Default Payment TermsDays until payment is due30 days
4

Save the Company

Click Save Company to create the company.

✅ Best Practices

  • Upload a high-quality logo (PNG or JPG, recommended 300x100 pixels)
  • Use unique invoice prefixes for each company (e.g., "ACME-", "GLOBAL-")
  • Set realistic payment terms (15, 30, or 45 days are common)

👥 4. Managing Clients

How to add and manage your client database

➕ Adding a New Client

1

Navigate to Clients

Invoices Clients Add New
2

Select Company (if multiple)

If you have multiple companies, select which company this client belongs to.

⚠️ Important

Clients are company-specific. A client added to Company A will not appear when creating invoices for Company B.

3

Fill in Client Details

FieldDescriptionRequired
Client NameBusiness or individual nameYes
Contact PersonPrimary contact nameNo
EmailEmail for sending invoicesYes
PhoneContact phone numberNo
AddressBilling addressNo
Tax ID / VATClient's tax numberNo

👁️ Viewing Client Details

Click on any client name to view their complete profile:

📊 Account Balance

Total invoiced, paid, and outstanding amounts.

📋 Transaction Ledger

Complete history with running balance.

💰 Payment History

All payments received from this client.

📄 Outstanding Invoices

Invoices with balance due.

📦 5. Products & Services

Create a catalog for quick invoice creation

➕ Adding Products/Services

1

Navigate to Products

Invoices Products Add New
2

Fill in Product Details

FieldDescriptionExample
Product NameName of product/serviceWeb Design Service
SKU/CodeInternal reference codeWEB-001
DescriptionDetailed descriptionCustom website design...
Unit PriceDefault price1500.00
UnitUnit of measurementhour, piece, project
Tax RateDefault tax rate20%

✅ Why Use Products?

  • Quickly add items to invoices without retyping
  • Maintain consistent pricing and descriptions
  • Save time when creating recurring invoices

📄 6. Creating Invoices

Step-by-step guide to create and manage invoices

➕ Creating a New Invoice

1

Navigate to Invoices

Invoices All Invoices Add New
2

Select Company & Client

Choose which company this invoice is for, then select the client from the dropdown.

3

Set Invoice Details

FieldDescription
Invoice DateDate the invoice is issued (defaults to today)
Due DatePayment due date (auto-calculated from payment terms)
Reference NumberYour internal reference (e.g., project code)
PO NumberClient's purchase order number
CurrencyInvoice currency
4

Add Line Items

  • From Products: Select a product from dropdown to auto-fill
  • Manual Entry: Type item name, description, quantity, and price
  • Tax: Select applicable tax rate for each item

Click + Add Item to add more lines.

5

Review & Save

Review totals, add notes if needed, then:

  • Save as Draft - Save without sending
  • Save & Send - Save and email to client

📊 Invoice Statuses

StatusBadgeDescription
DraftDraftSaved but not sent. Can be edited freely.
SentSentSent to the client via email.
ViewedViewedClient has opened the invoice.
PartialPartialPartial payment has been received.
PaidPaidInvoice is fully paid.
OverdueOverdueDue date has passed.
CancelledCancelledInvoice has been voided.

⚡ Invoice Actions

✏️ Edit

Edit details (Draft, Sent, Viewed, Partial)

📧 Send

Email invoice to client

📄 Download PDF

Download as PDF file

💰 Record Payment

Record payment received

📋 Duplicate

Create a copy

📝 Credit Note

Issue credit against this invoice

📋 7. Creating Quotations

Create quotes and convert them to invoices

📝
Create Quote

Draft proposal

📧
Send to Client

Email for review

Client Accepts

Or declines

📄
Convert to Invoice

One-click conversion

➕ Creating a Quotation

1

Navigate to Quotations

Invoices Quotations Add New
2

Fill in Details

Same process as invoices - select client, add items, set dates.

Additional field: Valid Until - expiry date for the quote.

3

Convert to Invoice

Once accepted, click Convert to Invoice to create an invoice with all quote details.

💰 8. Recording Payments

Track payments, advances, and partial payments

💵 Recording Payment for an Invoice

1

Method 1: From Invoice

Open the invoice and click Record Payment

2

Method 2: From Payments Menu

Invoices Payments Record Payment

Select company, client, and invoice from dropdowns.

3

Enter Payment Details

FieldDescription
Payment DateWhen payment was received
AmountAmount received (can be partial)
Payment MethodCash, Check, Bank Transfer, Card, etc.
Reference NumberCheck number, transaction ID
4

Save Payment

The system automatically updates invoice status to "Partial" or "Paid".

💎 Recording Advance Payments

Advance payments are deposits received before an invoice is created.

1

Record Advance

Invoices Payments Record Advance

Select client but leave invoice field empty.

2

Apply to Invoice Later

View the advance payment and click "Apply to Invoice" to use the credit.

💡 Client Account View

View complete payment history and available credit by clicking on the client name in the Clients list.

📝 9. Credit Notes

Issue credits and apply them to invoices

❓ What is a Credit Note?

A credit note reduces the amount a client owes. Common reasons: returned goods, billing errors, discounts, or goodwill adjustments.

➕ Creating a Credit Note

1

Method 1: From Invoice

Open an invoice and click Create Credit Note

2

Method 2: From Menu

Invoices Credit Notes Add New
3

Fill Details & Issue

Select client, add reason and items, then click Save & Issue

4

Apply to Invoice

Open the credit note and select which invoice to apply the credit to.

📅 10. Installment Plans

Set up payment plans for large invoices

➕ Creating an Installment Plan

1

Start from Invoice or Menu

From Invoice: Click Create Installment Plan

From Menu:

Invoices Installments Create Plan
2

Configure the Plan

FieldDescriptionExample
InvoiceSelect the invoiceINV-001
Total AmountAmount to be paid€5,000.00
Number of InstallmentsHow many payments5
FrequencyHow oftenMonthly
Start DateFirst payment due2024-02-01
3

Record Installment Payments

View the plan and click Record Payment next to each installment as they're received.

📊 11. Reports & AR Aging

View financial reports and track receivables

📅 AR Aging Report

Invoices AR Aging

Track outstanding receivables by age:

Aging BucketDescription
CurrentInvoices not yet due
1-30 DaysOverdue by 1 to 30 days
31-60 DaysOverdue by 31 to 60 days
61-90 DaysOverdue by 61 to 90 days
90+ DaysOverdue by more than 90 days

📊 Other Reports

Invoices Reports

📈 Revenue Report

Total revenue by period with comparisons.

👥 Client Report

Revenue by client, top clients ranking.

📄 Invoice Report

Invoice count and values by status.

💰 Payment Report

Payments received by method and period.

👤 12. User Management

Manage staff access and permissions

👑 Super Admin

Full System Access

Capabilities
  • Access ALL companies
  • Create/edit/delete companies
  • Manage all settings
  • View all reports
  • Manage user assignments

🏢 Company Admin

Company-Level Manager

Capabilities
  • Access assigned companies only
  • Full invoice/quote management
  • Manage clients and products
  • Record payments
  • View company reports

👤 Company Staff

Limited Access

Capabilities
  • Access assigned companies only
  • Create invoices and quotes
  • Add/edit clients
  • Record payments
  • Limited by visibility settings

➕ Adding a Staff User

1

Create WordPress User

Users Add New

Create user with role "Company Staff" or "Company Admin".

2

Assign to Companies

Edit the company and add the user to "Assigned Staff".

⚠️ Staff Visibility Settings

Control what staff can see in Settings → Permissions:

  • Staff See All Invoices ON: Staff see all company invoices
  • Staff See All Invoices OFF: Staff only see invoices they created

⚙️ 13. Settings

Configure the plugin to match your business needs

⚙️ Settings Location

Invoices Settings

🏢 General

Currency, date format, number format

💹 Taxes

Add tax rates, set default tax, tax display

📧 Email

From name, email, templates

📄 PDF

Template, paper size, logo position

🔢 Numbering

Prefixes, number padding

👁️ Visibility

Staff permissions, field visibility

🔧 14. Troubleshooting

Common issues and solutions

❓ Frequently Asked Questions

Q

Why can't I see any clients when creating an invoice?

Answer: Clients are company-specific. Check that you have created clients for the selected company and are assigned to that company.

Q

Invoice emails are not being sent?

Answer: Check client has valid email, test WordPress email sending, check spam folder, consider using an SMTP plugin.

Q

How do I change the invoice number format?

Answer: Go to Companies → Edit Company and change Invoice Prefix and Next Number.

Q

Can I edit an invoice that's been sent?

Answer: Yes, you can edit Draft, Sent, Viewed, or Partial invoices. A warning will appear. Paid and Cancelled cannot be edited.

Q

Staff member can't see invoices?

Answer: Check: user is assigned to a company, has correct role, and "Staff See All Invoices" setting in Settings.

📌 Quick Reference

Plugin menu structure

Multi-Company Invoice v1.0

Enterprise-grade invoicing for WordPress. Manage multiple companies, track payments, issue credit notes, and handle installment plans.

Created by Nasir Mehmood

Multi-Company Invoice