Your role in one paragraph
Businesses record their own trade. You are the compliance gate between what they record and what the Federal Board of Revenue receives. Every sales invoice and credit note stops in your queue. You approve it and file it, or send it back with a reason. You also hold the accounting powers a business owner does not have: manual journal vouchers, opening balances, and locking a month once it is filed.
You work across several clients from one login. Everything you open is scoped to the client you have selected, and every action you take is recorded against your name.
There is no route by which an invoice reaches FBR without a lawyer's approval. Not a manual issue, not a bulk Excel import, not a retry. The approval step is the system, not a convention.
Signing in and choosing a client
Go to /lawyer and sign in. You land on the command centre, which covers every client assigned to you.
Most screens carry a client selector at the top. Choose a client and the page shows only their data; the choice follows you as you move between screens. The review queue is the exception โ it deliberately spans all your clients, because the work is to clear the backlog, not to work one client at a time.
The sidebar
Command centre
- Dashboard across all clients
Review
- Review queue
Client masters
- Bank Accounts
- Chart of Accounts
- Customers
- Products
- Suppliers
Client sales
- Sales Invoices
- Credit Notes
Client purchases
- Purchase Invoices
- Debit Notes
Client expenses & inventory
- Expenses
- Stock Adjustments
Client accounting
- Receipts
- Payments
Accounting
- Journal Entries
- Journal Vouchers
Controls
- Accounting periods
Reports
- Trial Balance
- General Ledger
- Customer Ledger
- Supplier Ledger
- Cash Book
- Bank Book
- Profit & Loss
- Balance Sheet
- Receivables Aging
- Payables Aging
- Inventory Valuation
- Stock Movement
The command centre
Your opening screen answers one question: what needs me today.
Figures across all clients
| Figure | Meaning |
|---|---|
| Pending review | Invoices and credit notes waiting on you now. |
| Oldest waiting | How long the longest-waiting document has sat. Your service level in one number. |
| Approved today | What you have cleared since midnight. |
| Sent back | Documents returned to clients and not yet resubmitted. |
| FBR rejected | Filed and refused. These need a decision from you. |
| Submission unknown | Awaiting automatic reconciliation. No action needed. |
| Clients | How many businesses are assigned to you, and how many are live on production. |
| Unlocked months | Closed months still open for posting. Your month-end list. |
Client table
One row per client: pending count, oldest item, FBR environment, sandbox progress, last filing, and whether their current month is locked. Click a row to work on that client.
You are notified when the queue grows past a healthy size, when a document has waited too long, and when FBR rejects something you filed.
The review queue
Review โ Review queue is where the day's work lives. It lists every sales invoice and credit note awaiting a decision, across all your clients, oldest first.
Each row shows the client, document type and number, date, customer, total, sales tax, how long it has waited, and whether FBR validation has already been run and passed.
Filters
- Client โ work one business at a time when that suits you.
- Document type โ invoices or credit notes.
- Waiting over โ 1, 2 or 7 days, to find what is going stale.
- FBR pre-check โ passed, failed, or never run. Filtering to "passed" gives you the fastest run of approvals.
- Amount over โ review the large ones first when time is short.
Approving in bulk
Select rows and use Approve and submit to clear a batch. The system still checks each one individually and files them one at a time. Anything that fails is left in the queue with its reason attached, so a bulk action can never quietly file something broken.
It suits a client you know well whose documents have already passed FBR validation. It is the wrong tool for a new client, an unusual sale type, or an unfamiliar HS code.
The review screen
Opening a document from the queue gives you everything needed to decide, on one page, without clicking away.
Seller and buyer
Both parties as they will be sent: name, NTN or CNIC, registration type, province, address.
Line items
Description, HS code, quantity, unit of measure, rate, value excluding tax, sales tax rate and amount, any further or extra tax, SRO details, and the line total.
Totals
Value excluding tax, sales tax, withholding, and the gross. Checked against the lines.
Compliance checks
A stacked list of what the system verified: buyer identification, HS codes present, sale type consistent with the tax treatment, rate matching the profile, totals arithmetically sound, period open, original invoice referenced where a credit note requires it.
FBR validation result
The last response FBR gave for this document, with its status code, error code and message where it failed.
History
Every state change with who, when and why, including earlier review comments.
Validate with FBR is available here too. Running it before you approve turns most rejections into something you fix while the client is still able to act on it.
Your four decisions
| Action | What it does | Use it when |
|---|---|---|
| Approve and submit | Approves and files with FBR in one step. The usual path. | The document is correct and ready to file. |
| Approve | Approves without filing. It waits at approved. | You want it cleared but filed later, or a batch filed together. |
| Request changes | Returns it to the client with your comment. They edit and resubmit. | Something is wrong but fixable. The common case. |
| Reject | Refuses it outright with a reason. It does not come back. | The document should never have been issued. |
A comment is mandatory on request-changes and on reject, and it is the only thing the client will read. Write what is wrong and what to do about it. "Line 2 HS code 8471.3000 is for computers; these are printer cartridges, use 8443.9990" ends the exchange. "Wrong HS code" starts another one.
What to check before approving
The system checks arithmetic and structure. You check judgement. In practice these are where filings go wrong.
Buyer
- NTN is seven digits, CNIC is thirteen. A registered buyer must carry an NTN.
- Registration type matches reality. An unregistered buyer treated as registered is a straightforward rejection.
- The province is right; it affects the applicable regime.
Lines
- The HS code matches the goods actually sold. This is the single most common FBR rejection, usually error
0052. - The sale type agrees with the tax treatment. Zero-rated goods taxed at standard rate, or the reverse, will not pass.
- Reduced-rate and exempt lines carry the SRO schedule number and serial that justify them.
- Third-schedule goods are valued at retail price, not at the sale price.
- The unit of measure comes from FBR's list, not from the client's own vocabulary.
The document as a whole
- The date falls in an open period.
- A credit note references the original invoice's FBR number and carries a reason. Without the reference FBR returns error
0026. - Withholding, where present, is at the right section and rate.
The same HS code error arriving from one client every week is a product tax profile problem, not an invoicing problem. Open the product, correct it, and mark the profile verified. The error stops.
Filing with FBR
Approving and submitting builds the payload from the document, signs it with the client's token, and posts it to the right endpoint for their environment. Sandbox and production are separate credentials and separate endpoints; the system picks from the client's configuration, never from a choice you make in the moment.
What comes back
| Outcome | Result |
|---|---|
| Accepted | An FBR invoice number, such as 7000007DI1747119701593, and a filing date. The document is final and a QR code is printed on the PDF. |
| Rejected | An error code and message, at document or line level. Nothing is filed. |
| Unknown | A timeout or unreadable response. The system will not guess, and reconciles it automatically every hour. |
Two safeguards worth knowing
Every submission carries an idempotency key, so retrying a call that already succeeded returns the original acceptance rather than filing a duplicate. And transient network failures are retried with an increasing delay, while a clear rejection from FBR is never retried.
Sandbox before production
A new client works in sandbox until they have passed the scenarios that apply to their business activity and sector. The administrator runs those scenarios from the admin panel: each one files a test invoice, approved in the administrator's name, so they do not pass through your queue. You will see the resulting documents, buyer and products in the client's lists marked Sandbox test; leave them alone โ they are purged before the client goes live. Their progress is on the command centre; the administrator makes the move to production once it is complete.
When FBR refuses
A rejection lands back on the document with FBR's own code and message. The codes you will see most:
| Code | Meaning | Fix |
|---|---|---|
0052 | Invalid HS code. | Correct the code on the product's tax profile, then reissue. |
0026 | Credit note without a valid original invoice reference. | Point the credit note at an invoice FBR has already accepted. |
0046 | Buyer registration number invalid or not registered. | Verify the NTN with the client and correct the customer record. |
0018 | Sale type not valid for this registration. | Check the client's activity and sector against the sale type used. |
0073 | Rate does not match the sale type. | Align the product's tax treatment and rate. |
Where the fix belongs to the client, send it back with the code and the plain-language cause. Where it belongs to a master record, correct the record yourself under client masters and the next invoice is already right.
Credit and debit notes
Credit notes reduce a sale and pass through your review exactly as invoices do. They are the only way to correct an invoice FBR has accepted. Check that the reason is adequate, that the quantities do not exceed the original, and that the original FBR invoice number is attached.
Debit notes are purchase returns. They affect the client's input tax and supplier balances but are not filed with FBR, so they do not enter your queue. You can view them under client purchases when reconciling input tax.
Client master records
These are the records you can edit directly, because compliance depends on them and a business owner cannot always judge them.
| Screen | Your access | Why you have it |
|---|---|---|
| Products | View and edit | HS code, sale type, tax treatment, rate, SRO details, federal excise per unit (ST mode) and the Third Schedule retail price. Mark a profile verified once you are satisfied. |
| Customers | View and edit | NTN, CNIC, registration type and province decide how FBR treats the sale. |
| Suppliers | View and edit | Registration details govern input tax recovery. |
| Chart of Accounts | View and edit | Correcting a misclassified account is accounting work, not bookkeeping. |
| Bank Accounts | View and edit | Needed when reconciling and when posting corrections. |
A verified tax profile is worth the minute it costs. It is the difference between one rejection and a pattern of them.
Client documents you can read
Purchase invoices, expenses, stock adjustments, receipts and payments are all visible to you and none of them are editable. You need them to answer questions the reports raise โ where an input tax figure came from, why a bank balance moved, whether a stock write-off was documented โ without being able to alter the client's own record of their trade.
If something is wrong in one of them, a journal voucher is the correct instrument, because it leaves both the original and your correction on the record.
Journal vouchers
Accounting โ Journal Vouchers. This is your instrument for anything no document screen covers: depreciation, accruals and prepayments, provisions, reclassifications, corrections, year-end adjustments, and writing off a bad debt.
- Choose the client and the date. The date must fall in an open period.
- Add lines: account, debit or credit, and a narration on each.
- Give the voucher a description that will still make sense to someone reading it a year from now.
- Post. The form will not accept an unbalanced voucher.
Accounting โ Journal Entries shows every entry in the client's books, automatic and manual alike, each linked to the document that produced it. Entries are never edited. A mistake is corrected by a reversal, and both remain visible.
Opening balances
When a client joins with existing books, their opening position is posted as a single dated entry. Confirm first that their chart of accounts, customers, suppliers, bank accounts and products carry the right figures โ the opening entry is assembled from exactly those records.
Any difference between total debits and total credits goes to Owner Capital, so the entry always balances. A large unexplained difference means something upstream is wrong, and is worth chasing before you post.
Opening balances are posted once per business. Correcting them afterwards means a reversal and a fresh entry, both of which stay on the record. It is cheaper to check the masters first.
Locking an accounting period
Controls โ Accounting periods. Locking is exclusively yours. A locked month cannot be posted to, amended, cancelled or reversed by anybody, including you, until it is unlocked.
Locking
- Choose the client and the month.
- The system refuses to lock while any FBR document for that month is still in flight โ pending review, approved but unfiled, submitting, or in an unknown state. Clear them first.
- Confirm. The lock is recorded with your name and the time.
Unlocking
Unlocking demands a written reason and is logged permanently. Use it when a genuine correction must land in a closed month. Prefer, where the standards allow, dating the correction in the current open month instead.
A locked month is the client's guarantee that filed figures cannot drift afterwards, and yours that the return you signed still matches the books. Lock each month as soon as you have filed for it.
Reports
You have the same twelve reports as the business, for whichever client you have selected, each with a date range and an Excel export. All are derived from the journal, so they reconcile with one another by construction.
| Report | What you use it for |
|---|---|
| Trial Balance | The first thing to open at month end. It carries a badge confirming it balances. |
| General Ledger | Tracing a single account's movement when a figure looks wrong. |
| Customer / Supplier Ledger | Settling disputes about what is owed. |
| Cash Book / Bank Book | Checking that recorded money agrees with the statements. |
| Profit & Loss | Income tax work and the client's own review. |
| Balance Sheet | The year-end position. |
| Receivables / Payables Aging | Bad debt provisions and the client's exposure. |
| Inventory Valuation | Closing stock for the accounts. |
| Stock Movement | Substantiating a write-off or an unusual cost of sales. |
A month-end routine
Per client, in this order.
- Clear the review queue. Nothing for the month should be pending, approved-but-unfiled, or in an unknown state.
- Resolve every FBR rejection. Either the corrected document is filed, or a credit note covers it.
- Open the trial balance and confirm it balances.
- Check the tax position: output tax on the ledger against what was filed, input tax against purchases and expenses.
- Confirm bank reconciliations are complete for the month.
- Post your adjusting vouchers โ depreciation, accruals, prepayments, provisions.
- Review the aging reports and provide for anything genuinely bad.
- Take the closing inventory valuation for the record.
- File the return.
- Lock the period.
What you deliberately cannot do
These are design decisions, not gaps.
- You cannot create sales invoices. Trade belongs to the business. Reviewing what you wrote yourself would not be a review.
- You cannot edit an issued invoice. Send it back, or raise a credit note.
- You cannot alter a posted journal entry. Reversals only, and both sides stay visible.
- You cannot see or set FBR credentials. Tokens are encrypted and held by the administrator; you file with them without ever reading them.
- You cannot reach a business you are not assigned to. Assignment is the administrator's to grant.
- You cannot delete anything. The audit trail is the product.
Reference
Document statuses
| Status | Where it sits |
|---|---|
| Draft | With the client. Not yet in the books. |
| Validated | Passed FBR's pre-check. Not yet filed. |
| Validation failed | FBR's pre-check refused it. With the client. |
| Pending review | In your queue. |
| Changes requested | Returned to the client with your comment. |
| Rejected | Refused by you. Closed. |
| Approved | Cleared by you, awaiting filing. |
| Submitting | In flight to FBR. |
| FBR accepted | Filed. Immutable. |
| FBR rejected | Refused by FBR with a code. |
| Submission unknown | Awaiting hourly reconciliation. |
| Cancelled | Withdrawn before filing. Accounting reversed. |
| Adjusted | Corrected by a credit note. |
Common questions
| Question | Answer |
|---|---|
| I approved something I should not have. | If it is not yet filed, cancel it. If FBR accepted it, a credit note is the correction. |
| A submission has been unknown for hours. | Leave it. Reconciliation runs hourly and settles it against FBR's own record. |
| I cannot lock a month. | Documents for that month are still in flight. The message names them. |
| A client says they cannot edit an invoice. | It has left draft. Send it back with request-changes. |
| The same error keeps arriving. | Correct the product's tax profile rather than the invoices. |
| A client is missing from my list. | Ask the administrator to assign them to you. |