Skip to main content

E-way bill help · 14 of 14

Common WhiteBooks and NIC error messages

What the e-way bill system's most frequent error codes mean and how to fix them.

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:

CodeWhat it meansWhat to do
108The 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.
111Your 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.
238The session with the E-Way Bill System was not accepted.BillBase refreshes it automatically; try again.
604An 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.
702The 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.
721The system has no distance for these PIN codes.Enter the actual distance in km.
437Your 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).
436The 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.
225The vehicle number format is invalid.Enter it like KA01AB1234 (no spaces).
226Neither a vehicle number nor a transport document was given.Enter the vehicle number (Road) or the transport document number (Rail/Air/Ship).
222The transporter ID is invalid.Enter the transporter's 15-character GSTIN or TRANSIN.
207The invoice date was not accepted.The invoice date cannot be in the future or more than 180 days old.
216An HSN code is invalid.Correct the HSN code on the item master and update the invoice.
724Every 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).
715Your 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 NICThe 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.

All e-way bill tutorials