Inventory Update (846) Specification
If you integrated with EDI earlier, refer to these docs.
In this guide, we walkthrough our basic EDI specification for Inventory Update (846) files. You can read through the full guide here.
Segment Summary
ID | Name | Loop ID | Required by Modern Dropship |
ST | Transaction Set Header | Mandatory | |
BIA | Beginning Segment for Inventory Inquiry/Advice | Mandatory | |
LIN | Item Identification | LIN | Mandatory |
QTY | Quantity | QTY | Mandatory |
CTT | Transaction Totals | Mandatory | |
SE | Transaction Set Trailer | Mandatory |
Segment Specifications
ST
ID | Name | Required | Min | Max | Notes |
ST-01 | Transaction Set Identifier Code | True | 3 | 3 | Accepted Values: 846 |
ST-02 | Transaction Set Control Number | True | 4 | 9 | Ex. 0001 |
BIA
ID | Name | Required | Min | Max | Notes |
BIA-01 | Transaction Set Purpose Code | True | 2 | 2 | Accepted Values: 00 |
BIA-02 | Report Type Code | True | 2 | 2 | Accepted Values: MB |
BIA-03 | Reference Identification | True | 1 | 30 | Ex. 123961 |
BIA-04 | Date | True | 8 | 8 | Ex. 20211231 |
BIA-05 | Time | False | 4 | 4 | Ex. 14:05, 00:03, 11:23 |
BIA-01
Code | Name | Notes |
00 | Original |
BIA-02
Code | Name | Notes |
MB | Manufacturer Distributor Inventory |
BIA-03
This value is only used for debugging purposes but should still be unique.
BIA-04
Expecting date in format YYYYMMDD .
If BIA-04 date is older than the previously processed Inventory Update (846) document, we will not process the document and wait for the next version. This avoids inventory updating with old information. It is encourage to share inventory updates every 5 to 15 minutes to keep data at highest quality. The date value should not be in the future. Our servers run on UTC timezone.
BIA-05
Expecting time in format HHMM.
If BIA-05 is not provided, it defaults to being midnight.
LIN
ID | Name | Required | Min | Max | Notes |
LIN-01 | Assigned Identification | True | 1 | 20 | Ex. 1, 2, 3 |
LIN-02 | Product ID Qualifier | True | 2 | 2 | Accepted Values: VC |
LIN-03 | Product ID | True | 1 | 48 | The Variant Code: Ex. 896668000045, 896668000038, 896668000120 |
LIN-01
Each line item should be unique and not conflict with another LIN segment. It's easiest to use a basic counter.
LIN-02
Code | Name | Notes |
VC | Variant Code |
You can find more details about our variant ID with our developer documentation.
QTY
ID | Name | Required | Min | Max | Notes |
QTY-01 | Quantity Qualifier | True | 2 | 2 | Accepted Values: 33 |
QTY-02 | Quantity | True | 1 | 15 | Ex. 0, 15 |
QTY-03 | Unit of Measure | True | 2 | 2 | Accepted Values: EA |
QTY-01
Code | Name | Notes |
33 | Quantity Available for Sale (Stock Quantity) |
QTY-02
The current inventory amount. This value should be not be a negative number. If you do not want a product available to a partner, either mark it as inactive, or remove it from your price list. Your price list can be updated through the Modern Dropship application.
QTY-03
Code | Name | Notes |
EA | Each |
CTT
ID | Name | Required | Min | Max | Notes |
CTT-01 | Number of Line Items | True | 1 | 6 | Ex. 16 |
SE
ID | Name | Required | Min | Max | Notes |
SE-01 | Number of Included Segments | True | 1 | 10 | Ex. 70 |
SE-02 | Transaction Set Control Number | True | 4 | 9 | Ex. 0001. This should align with ST-02. |
Samples
ISA*00* *00* *01*117522184 *ZZ*SAMPLEISAID *210720*1700*U*00401*000000564*1*P*>~
GS*IB*117522184*SAMPLEISAID*20210720*1700*1530*X*004010~
ST*846*0001~
BIA*00*MB*123961*20210720~
LIN*1*VC*896668000045~
QTY*33*0*EA~
LIN*2*VC*896668000038~
QTY*33*0*EA~
LIN*3*VC*896668000120~
QTY*33*15*EA~
CTT*6~
SE*10*0001~
GE*1*1530~
IEA*1*000000564~
