Managing Companies, Customers & Suppliers

Companies, customers, and suppliers are the party records that feed every e-Invoice. Get them right once and the rest of your invoicing runs clean. This page covers creating and editing each one, which fields are required, and how a party being local (Malaysian) or foreign changes what LHDN expects.

Everything under Business — customers, suppliers, invoices — is scoped to the company selected in the top-bar dropdown. Set up your company first.

Companies (the seller)

A company is the seller on every invoice you issue, so its details go straight onto your e-Invoices. Find companies under Workspace → Companies.

Create a company

1. Open Workspace → Companies and press New Company.
2. Fill in the fields (required fields are marked * on screen):
   • Company Name — the registered name.
   • Business Registration Number (BRN) — e.g. 202301045612.
   • TIN — your tax identification number.
   • Address — line 1, city, state, postal code, country.
   • Phone and Email.
   • MSIC Code — your business classification. The field is a searchable dropdown; type a few letters of your industry.
   • SST Registration — optional; fill it in only if you're SST-registered.
   • Logo — optional; appears on your invoice PDFs.
3. Press Save.

You can edit any of these later. The invoice and submission screens tell you exactly which company details are still missing before a submission, with links to fix them.

How many companies you can own depends on your plan. At the limit, the New Company button disappears and the create form refuses — see Plans, Limits & Preferences.

Customers (the buyer)

Customers are the buyers on your invoices. Find them under Business → Customers.

Add a customer

1. Open Business → Customers and press Add Customer.
2. Fill in the required fields: Customer Name, ID Type, Country, City, State, and Phone.
3. Save.

ID types and the TIN rule

Every Malaysian party is identified by one of four ID types:

• BRN — a business
• NRIC, PASSPORT, or ARMY — individuals

Whether the TIN is required depends on the ID type:

• Malaysian business (BRN) → TIN required. A business buyer must have one.
• Malaysian individual (NRIC / PASSPORT / ARMY) → TIN optional.
• Foreign customer → TIN optional on the form (see foreign rules below).

The form updates the TIN field's required marker as you change the ID type, and the server applies the same rule when you save. You don't have to complete every LHDN field up front — anything still missing surfaces in the pre-submission checklist with a link to fix it. See Submitting to LHDN MyInvois.

Suppliers (the self-billed seller)

Suppliers are the other side — the parties that bill you. Find them under Business → Suppliers. You'll use a supplier in two places:

• Self-billed documents. When you issue a self-billed invoice (or self-billed credit/debit/refund note), the seller is a supplier, not you. The invoice form swaps the customer picker for a supplier picker. See Creating & Managing Invoices.
• Supplier bills (accounting plans) — recording what suppliers charge you, which flow into AP aging and the tax report. See The Accounting Module and Capturing Supplier Documents.

Local vs foreign parties

LHDN treats a party as foreign when its Country is not MYS (Malaysia). The direction of trade decides which document you issue:

• Foreign buyer (export) → a normal e-Invoice, issued by you as the Malaysian seller.
• Foreign supplier (import) → a self-billed e-Invoice, issued by you as the Malaysian buyer, because a foreign seller can't use MyInvois themselves.

Declare the party's Country first — it drives what LHDN needs from the rest of the record.

What changes for a foreign party

For a Malaysian party, LHDN wants real, conforming identifiers. When a foreign party's real data genuinely isn't available, LHDN sanctions specific placeholder values instead:

For a foreign supplier on a self-billed invoice, three seller-only fields also accept placeholders when unavailable: MSIC Code → 00000, Business Activity Description → NA, and Tourism Tax No. → NA.

The EI… general TINs

These three LHDN-issued codes are the only non-conforming TINs, used when the real one isn't available:

Fixing gaps at submission time

You don't need every LHDN field perfect while creating a party. When you press Submit to LHDN, the confirmation page lists every remaining gap under "Complete these details before submitting to LHDN:" — a missing supplier address line, a buyer TIN, an MSIC code — each with a link to the exact form that fixes it. Fix, come back, submit.

For the full submission flow and how TIN mismatches are reported, see Submitting to LHDN MyInvois and Troubleshooting. For the end-to-end happy path — company, customer, first invoice — see Getting Started: Your First e-Invoice.