When the e-way bill system (run by NIC) refuses a request, BillBase shows the code with a plain explanation and highlights the field to fix. The most common ones:
| Code | What it means | What to do |
|---|---|---|
| 108 | The E-Way Bill API username or password is wrong. | Check the API credentials in Settings > E-Way Bill. They are different from your portal login. |
| 111 | Your GSTIN is not registered with the GST Suvidha Provider BillBase uses. | On the e-way bill portal go to Registration > For GSP, choose BillBase's provider and create the API user again. |
| 238 | The session with the E-Way Bill System was not accepted. | BillBase refreshes it automatically; try again. |
| 604 | An e-way bill already exists for this invoice. | BillBase looks it up and links it to the invoice without charging. If it cannot, record its number under "Already generated on the portal?" on the Generate e-way bill page. |
| 702 | The distance is more than 10% above the distance between the two PIN codes. | Enter a distance close to the system's PIN-to-PIN distance, or 0 to use it. |
| 721 | The system has no distance for these PIN codes. | Enter the actual distance in km. |
| 437 | Your dispatch PIN code does not belong to your dispatch state. | Correct the PIN code or the state of the dispatch address on your E-Way Bill connection (or of the "dispatch from" address on this e-way bill). |
| 436 | The delivery PIN code does not belong to the delivery state. | Correct the customer's PIN code or state, or the "deliver to" address on this e-way bill. |
| 225 | The vehicle number format is invalid. | Enter it like KA01AB1234 (no spaces). |
| 226 | Neither a vehicle number nor a transport document was given. | Enter the vehicle number (Road) or the transport document number (Rail/Air/Ship). |
| 222 | The transporter ID is invalid. | Enter the transporter's 15-character GSTIN or TRANSIN. |
| 207 | The invoice date was not accepted. | The invoice date cannot be in the future or more than 180 days old. |
| 216 | An HSN code is invalid. | Correct the HSN code on the item master and update the invoice. |
| 724 | Every line on this invoice is a service. | An e-way bill is for goods: at least one line needs an HSN code of goods (not starting with 99). |
| 715 | Your GSTIN is blocked from e-way bills because returns were not filed for two months. | File the pending returns; generation is unblocked afterwards. |
| Provider could not reach NIC | The provider could not reach the government E-Way Bill System just now. | Nothing was generated or charged. Try again in a few minutes. |
Codes about BillBase's own provider account (for example 103, 104, 110) are BillBase's to fix; nothing is generated or charged when they occur.