Authentication Errors

• Error 0001 — Invalid Token: Your API token is invalid or has been rotated. Solution: Contact your admin to check and update your API token.
• Error 0002 — Token Expired: Your API token has expired. Solution: Ask your admin to generate a new token from the Token Registry.

Validation Errors

• Error 0040 — Invalid HS Code: The HS code you entered is not in FBR's master list. Solution: Use the HS Code search to find a valid code from the database.
• Error 0045 — Invalid Sale Type: The sale type doesn't match FBR's expected values. Solution: Select from the dropdown list — do not type custom values.
• Error 0058 — Self-Invoicing: The buyer NTN is the same as the seller NTN. Solution: You cannot invoice yourself. Use a different buyer NTN.

System Errors

• Error 9999 — FBR Server Error: FBR's system is temporarily unavailable. Solution: Wait 5-10 minutes and try again. If persistent, check FBR's website for maintenance notices.
• Timeout Error: The request took too long to complete. Solution: Check your internet connection. Ensure your IP is whitelisted. Try again.

Invoice Shows "Invalid"

1. Open the invoice by clicking "View"
2. Scroll to the FBR Response section
3. Read the error message — it tells you exactly what went wrong
4. Create a new invoice with the corrected data
5. You cannot edit a submitted invoice — you must create a new one