Connecting through Seller EDI for Dropship - Inventory Update (846) Specification
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 Convictional |
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: UP, EN |
LIN-03 | Product ID | True | 1 | 48 | The barcode value: 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 |
UP | UPC Code | |
EN | European Article Number |
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 Convictional 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*UP*896668000045~
QTY*33*0*EA~
LIN*2*UP*896668000038~
QTY*33*0*EA~
LIN*3*UP*896668000120~
QTY*33*15*EA~
CTT*6~
SE*10*0001~
GE*1*1530~
IEA*1*000000564~
