Skip to content

Getting started

How to Create Your First FBR Digital Invoice

Prepare buyer and product details, validate your first invoice, test the PRAL workflow in sandbox, and review the FBR submission result step by step.

By Digital Invoice PK by Xinuty · Published · Updated

Start with one invoice you understand

For a sales-tax-registered dealer issuing 10–50 invoices a month, the best first FBR digital invoice is a straightforward sale that reflects your normal business. Keep the order, buyer information and product details beside you. A carefully checked first invoice gives you a reusable routine for the rest of the month.

This guide follows the Digital Invoice PK web workflow. Arrange your PRAL onboarding and configured connection first. Confirm which person will maintain product records and who will review an invoice when a response needs attention. Invoice submission and preparation of a sales tax return are separate tasks.

1. Check the business profile and environment

Before entering a sale, check your seller name, identifier, province and address in the business settings. Have the onboarding team confirm the active environment and connection. Use sandbox for practice; a sandbox result is a test result.

  1. Confirm that the business profile belongs to the seller issuing this invoice.
  2. Confirm sandbox mode and the sandbox connection before the first test.
  3. Choose the test scenario appropriate to your business activity and sale. Ask the onboarding team if the scenario is unclear.

2. Enter the buyer and prepare the items

In the invoice form, enter the buyer's business name, registration type, NTN/CNIC where applicable, province and address. Select the product and review its description, HS code, UOM, sale type and tax values. Product defaults help with repeated entry, but review them against this sale before saving an item.

  • Use the correct buyer registration type for sales tax; having an NTN alone does not settle that question.
  • Check quantity and sales value excluding sales tax against the order.
  • Confirm the tax treatment with the person responsible for your business's tax records. Avoid copying a demonstration rate or HS code into a real sale.

3. Check the arithmetic before validation

Review each line and the invoice total, especially when you change quantity or price. Digital Invoice PK checks invoice data and tax totals in its preparation workflow. A correct total helps identify an entry error; it does not establish the legal tax rate for the goods.

4. Validate, save and test the submission

The invoice screen provides Validate Draft, Save as POS Invoice, Validate with FBR and Post to FBR controls. It also has a Queue for FBR submission on save option. Confirm that option before saving so you know whether the record will enter the submission workflow.

  1. Use Validate Draft and read the Response panel. Correct the buyer, product or line values indicated by the feedback.
  2. For a controlled manual sandbox test, turn off Queue for FBR submission on save before saving the invoice.
  3. Use Save as POS Invoice and keep the local bill reference returned by the application.
  4. Use Validate with FBR to check the saved record, then review its response. Validation and posting are separate operations.
  5. Use Post to FBR once for the intended test submission. Record the result and returned reference before taking further action.

Official reference: FBR / PRAL: Technical Specification for DI API, version 1.12

5. Review the result and move to live invoicing deliberately

Review the environment, submission response, item results and returned FBR invoice number. An invoice that is saved, queued or validated still needs its posting result checked. If the outcome is uncertain, investigate the existing record before creating another invoice for the same sale.

When representative sandbox tests are complete, have the onboarding team confirm production settings. Review the first live result with them, then keep a daily list of unresolved records. Do not use a test reference as the FBR reference for a live sale.

Official sources and review dates

The links below support the official guidance in this article. Product instructions describe the Digital Invoice PK workflow; examples are illustrative. Check the official material for updates relevant to your business.