Resolve Tax Integration Problems

How to Resolve Tax Integration Problems in Muhasib ERP
Overview
This guide will help you classify and resolve a tax-integration check, transport, rejection, unknown, or local/provider mismatch safely.
If this issue is stopping your work, do not worry. Follow the steps one at a time, and check the result before trying again.
One local transaction reaches one known authority state or is escalated with evidence.
Who can do this
You need access to Tax integration inquiry/retry, source-sale correction, and responsible tax approval.
Before you start
Preserve local transaction, request/reference, response code/message, timestamps, sanitized payload evidence, provider query result, tax values, and ledger state.
Before saving, check that the correct company is open and that you have permission to complete this task.
Where to find it
Open source sale, tax/FBR report/history, settings, and authorized authority query/retry tools.
Resolve Tax Integration Problems
Step 1: Confirm company, registration, connector, environment, and endpoint
Step 2: Classify local validation, authentication/network, rejected, accepted-not-stored, or unknown outcome
Step 3: Query provider status by original reference
Step 4: Correct rejected seller/buyer/item/unit/scenario/tax mappings at source
Step 5: Retry only confirmed unaccepted eligible records once
Retry only confirmed unaccepted allowed records once.
Step 6: Use official correction/cancellation/credit rules for accepted wrong invoices
Check your work
Local/provider identifiers, statuses, lines, taxable values, taxes, totals, and ledgers compare and confirm.
Take a moment to check your work before closing the window. This small check can save time later.
If something goes wrong
Never retry accepted or unknown submissions blindly.
Never delete stored responses to force submission.
Related guides
Recover from Tax Submission Failure
Review FBR Tax Transactions
Prepare Muhasib for Tax Integration
What to do next
Recover from Tax Submission Failure.