Connecting through Seller EDI - Inventory Update (846) Specification

Keith Weaver Updated by Keith Weaver

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, OT

LIN-03

Product ID

True

1

48

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

OT

Internal Number

This is the Convictional variant ID.

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 or an Price Catalog document (832).

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~

How did we do?

Connecting through Seller EDI - Advance Ship Notice (856) Specification

Connecting through Seller EDI - Invoice (810) Specification

Contact