Official references

Master code references for e-Way Bill and e-Invoice workflows

This page brings together the master-code lists commonly needed during GST API integration, especially when your team is mapping request payloads, document types, transport modes, and validation rules inside product or ERP flows.

Supply type mapping e-Way Bill codes e-Invoice codes

Source 1

e-Way Bill master codes list

Official NIC reference for e-Way Bill API master codes, transport metadata, unit codes, status codes, and vehicle formats.

Source 2

e-Way Bill sub docType mapping

Official NIC reference for transaction type, transaction sub-type, and document type combinations used in e-Way Bill flows.

Source 3

e-Invoice master codes list

Official NIC sandbox reference for e-Invoice transaction types, document types, e-Way Bill fields, cancellation reasons, and vehicle formats.

e-Way Bill mapping

Supply type and document type mapping for e-Way Bill workflows

This table is useful when your implementation team needs to validate which document type should be used for a transaction type and sub-type combination before generating or updating an e-Way Bill payload.

Official e-Way Bill sub docType mapping

Use this mapping when your team needs to confirm which document type fits a given transaction type and sub-type combination, along with the expected From GSTIN and To GSTIN pattern in the NIC flow.

28 mappings

Transaction Type	Transaction Sub-Type	Document Type	From GSTIN (Supplier)	To GSTIN (Buyer)
Outward	Supply	Tax Invoice	Self	Other GSTIN / URP
Outward	Supply	Bill of Supply	Self	Other GSTIN / URP
Outward	Export	Tax Invoice	Self	Other GSTIN / URP
Outward	Export	Bill of Supply	Self	Other GSTIN / URP
Outward	Job Work	Delivery Challan	Self	Other GSTIN / URP
Outward	SKD / CKD / Lots	Tax Invoice	Self	Other GSTIN / URP
Outward	SKD / CKD / Lots	Bill of Supply	Self	Other GSTIN / URP
Outward	SKD / CKD / Lots	Delivery Challan	Self	Other GSTIN / URP
Outward	Recipient Not Known	Delivery Challan	Self	Self
Outward	Recipient Not Known	Others	Self	Self
Outward	For Own Use	Delivery Challan	Self	Self
Outward	Exhibition or Fairs	Delivery Challan	Self	Self
Outward	Line Sales	Delivery Challan	Self	Self
Outward	Others	Delivery Challan	Self	Self / Other GSTIN / URP
Outward	Others	Others	Self	Self / Other GSTIN / URP
Inward	Supply	Tax Invoice	Other GSTIN / URP	Self
Inward	Supply	Bill of Supply	Other GSTIN / URP	Self
Inward	Import	Bill of Entry	Other GSTIN / URP	Self
Inward	SKD / CKD / Lots	Bill of Entry	URP	Self
Inward	SKD / CKD / Lots	Tax Invoice	Other GSTIN / URP	Self
Inward	SKD / CKD / Lots	Bill of Supply	Other GSTIN / URP	Self
Inward	SKD / CKD / Lots	Delivery Challan	Other GSTIN / URP	Self
Inward	Job Work Returns	Delivery Challan	Other GSTIN / URP	Self
Inward	Sales Return	Delivery Challan	Other GSTIN / URP	Self
Inward	Exhibition or Fairs	Delivery Challan	Self	Self
Inward	For Own Use	Delivery Challan	Self	Self
Inward	Others	Delivery Challan	Self / Other GSTIN / URP	Self
Inward	Others	Others	Self / Other GSTIN / URP	Self

e-Way Bill reference

e-Way Bill API master codes

Use these tables when you need the accepted codes for supply types, document types, transportation modes, transaction types, status codes, and other values commonly used in e-Way Bill API payloads.

Supply Type

2 entries

Code	Description
I	Inward
O	Outward

Sub Supply Type

12 entries

Code	Description
1	Supply
2	Import
3	Export
4	Job Work
5	For Own Use
6	Job Work Returns
7	Sales Return
8	Others
9	SKD/CKD/Lots
10	Line Sales
11	Recipient Not Known
12	Exhibition or Fairs

Document Type

5 entries

Code	Description
INV	Tax Invoice
BIL	Bill of Supply
BOE	Bill of Entry
CHL	Delivery Challan
OTH	Others

Transportation Mode

5 entries

Code	Description
1	Road
2	Rail
3	Air
4	Ship
5	In Transit

Consignment Status

2 entries

Code	Description
M	In Movement
T	In Transit

Vehicle Update and CEWB Regeneration Reasons

4 entries

Code	Description
1	Due to Break Down
2	Due to Transshipment
3	Others (Please Specify)
4	First Time

Mode of Generation

5 entries

Code	Description
API	Application Programming Interface
Exc	Bulk Upload
SMS	SMS Facility
APP	Mobile App
WEB	Web Based System

e-Way Bill Status

3 entries

Code	Description
ACT	Active
CNL	Cancelled
DIS	Discarded

Cancellation Reason Codes

4 entries

Code	Description
1	Duplicate
2	Order Cancelled
3	Data Entry Mistake
4	Others

Vehicle Type

2 entries

Code	Description
R	Regular
O	ODC (Over Dimensional Cargo)

Reasons for Extension of Validity

5 entries

Code	Description
1	Natural Calamity
2	Law and Order Situation
4	Transshipment
5	Accident
99	Others

Transaction Types

4 entries

Code	Description
1	Regular
2	Bill To - Ship To
3	Bill From - Dispatch From
4	Combination of 2 and 3

Unit Codes

Reference unit codes used across item and quantity payloads.

45 entries

Code	Description
BAG	Bags
BAL	Bale
BDL	Bundles
BKL	Buckles
BOU	Billion of Units
BOX	Box
BTL	Bottles
BUN	Bunches
CAN	Cans
CBM	Cubic Meters
CCM	Cubic Centimeters
CMS	Centi Meters
CTN	Cartons
DOZ	Dozens
DRM	Drums
GGK	Great Gross
GMS	Grammes
GRS	Gross
GYD	Gross Yards
KGS	Kilograms
KLR	Kilolitre
KME	Kilometre
LTR	Litres
MTR	Meters
MLT	Mililitre
MTS	Metric Ton
NOS	Numbers
OTH	Others
PAC	Packs
PCS	Pieces
PRS	Pairs
QTL	Quintal
ROL	Rolls
SET	Sets
SQF	Square Feet
SQM	Square Meters
SQY	Square Yards
TBS	Tablets
TGM	Ten Gross
THD	Thousands
TON	Tonnes
TUB	Tubes
UGS	US Gallons
UNT	Units
YDS	Yards

Valid Vehicle Number Formats

10 entries

Code	Description
AB121234	First 2 characters are state code
AB12A1234	First 2 characters are state code
AB12AB1234	First 2 characters are state code
ABC1234	Standard registration pattern
AB123A1234	First 2 characters are state code
AB12ABC1234	First 2 characters are state code
DFXXXXXX	Defence vehicle
TMXXXXXXXXXXXXX	Temporary RC, at least 7 characters
BPXXXXXXXXXXXXX	Bhutan vehicle, at least 7 characters
NPXXXXXXXXXXXXX	Nepal vehicle, at least 7 characters

e-Invoice reference

e-Invoice API master codes

These are the common master-code values used for e-Invoice API transaction types, document types, cancellation reasons, transport modes, vehicle types, and valid vehicle-number formats.

Type of Transaction

6 entries

Code	Description
B2B	Business to Business
SEZWP	SEZ with Payment
SEZWOP	SEZ without Payment
EXPWP	Export with Payment
EXPWOP	Export without Payment
DEXP	Deemed Export

Document Type

3 entries

Code	Description
INV	Invoice
CRN	Credit Note
DBN	Debit Note

e-Way Bill Transport Mode Details

4 entries

Code	Description
1	Road
2	Rail
3	Air
4	Ship

e-Way Bill Vehicle Type Details

2 entries

Code	Description
O	ODC
R	Regular

Cancellation Reason

2 entries

Code	Description
1	Duplicate
2	Data Entry Mistake

Valid Vehicle Number Formats

10 entries

Code	Description
AB121234	First 2 characters are state code
AB12A1234	First 2 characters are state code
AB12AB1234	First 2 characters are state code
ABC1234	Standard registration pattern
AB123A1234	First 2 characters are state code
AB12ABC1234	First 2 characters are state code
DFXXXXXX	Defence vehicle
TMXXXXXXXXXXXXX	Temporary RC, at least 7 characters
BPXXXXXXXXXXXXX	Bhutan vehicle, at least 7 characters
NPXXXXXXXXXXXXX	Nepal vehicle, at least 7 characters

How teams usually use this page

Payload mapping

Match dropdown values or internal enums to the accepted code values before your workflow moves to production.

Validation rules

Use the vehicle-number patterns and document-type references to reduce avoidable request failures.

Operator support

Keep a readable reference for finance, dispatch, or support teams who need to understand the code behind a field.

Always validate production-critical code usage against the latest official NIC reference if the upstream documentation changes.

Master codes list for e-Way Bill and e-Invoice API workflows

Master code references for e-Way Bill and e-Invoice workflows

e-Way Bill master codes list

e-Way Bill sub docType mapping

e-Invoice master codes list

Supply type and document type mapping for e-Way Bill workflows

Official e-Way Bill sub docType mapping

e-Way Bill API master codes

Supply Type

Sub Supply Type

Document Type

Transportation Mode

Consignment Status

Vehicle Update and CEWB Regeneration Reasons

Mode of Generation

e-Way Bill Status

Cancellation Reason Codes

Vehicle Type

Reasons for Extension of Validity

Transaction Types

Unit Codes

Valid Vehicle Number Formats

e-Invoice API master codes

Type of Transaction

Document Type

e-Way Bill Transport Mode Details

e-Way Bill Vehicle Type Details

Cancellation Reason

Valid Vehicle Number Formats

How teams usually use this page

Payload mapping

Validation rules

Operator support