Inventory Advice

Inventory Advice (846)

An Inventory Advice (846) is sent by a supplier to communicate current inventory levels to a trading partner.

The simplified INVENTORY_ADVICE schema can be used for relationships with partners that trade the 846_INVENTORY_INQUIRY_ADVICE document type.

Schema Overview Sample Downloads

Field	Type	Required	Description
purpose	string	✓	Purpose of the inventory report Values: `full` `incremental` `change`
reportType	string	✓	Type of inventory report being sent Values: `sellerInventory`
reportNumber	string	✓	Unique identifier for this inventory report
reportDate	string	✓	Date the inventory report was created and sent. Often the same day as the reporting period, but not guaranteed to be — the period is carried in dates Formats: `date` `date-time`
partiesshow child fieldshide child fields	object		Parties involved in the inventory report
inventoryLocationshow child fieldshide child fields	object		The single location this entire report covers. Send it when the report is for one location; omit it when the report spans multiple locations, which are identified per quantity instead
name	string		Party name or company name
additionalName1	string		Additional name line 1
additionalName2	string		Additional name line 2
identificationCode	string		Party identification code value
identificationCodeType	string		Type of identification code Values: `sendersId` `receiversId` `duns` `plantCode` `dunsPlus4` `drugEnforcementAdmin` `telephone` `federalReserveRouting` `standardAddressSAN` `healthIndustryHIN` `warehouse` `schoolId` `memberId` `stateLicenseId` `globalLocationId` `standardCarrierAlphaCode` `url` `cage` `activityAddressCode`
addressLine1	string		Street address line 1
addressLine2	string		Street address line 2
addressLine3	string		Street address line 3
addressLine4	string		Street address line 4
city	string		City name
stateOrProvinceCode	string		State or province code
postalCode	string		Postal or ZIP code
countryCode	string		Country code (ISO)
zoneType	string		Address zone type Values: `residential` `commercial`
deliveryPoint	string		Specific delivery point within this location, such as a dock, door or bay, identifying where goods should be presented on arrival
contactsshow child fieldshide child fields	array		Contact persons for this party
type	string	✓	Type of contact — the role this person or office serves for the party they belong to Values: `primary` `customerRelations` `orderInquiry` `department` `shipping` `receiving` `hazmat` `certifier` `contracting` `advisor` `pricing` `investigator` `acceptingOfficial` `reportAuthorizer` `reportPreparer`
name	string		Contact person name
phoneNumber	string		Contact phone number
phoneExtension	string		Extension of the contact phone number
faxNumber	string		Contact fax number
email	string		Contact email address
contactReference	string		Reference that clarifies the contact — e.g. an organizational unit, department/role, or partner-assigned code
buyershow child fieldshide child fields	object		Buyer or retailer receiving the inventory report
name	string		Party name or company name
additionalName1	string		Additional name line 1
additionalName2	string		Additional name line 2
identificationCode	string		Party identification code value
identificationCodeType	string		Type of identification code Values: `sendersId` `receiversId` `duns` `plantCode` `dunsPlus4` `drugEnforcementAdmin` `telephone` `federalReserveRouting` `standardAddressSAN` `healthIndustryHIN` `warehouse` `schoolId` `memberId` `stateLicenseId` `globalLocationId` `standardCarrierAlphaCode` `url` `cage` `activityAddressCode`
addressLine1	string		Street address line 1
addressLine2	string		Street address line 2
addressLine3	string		Street address line 3
addressLine4	string		Street address line 4
city	string		City name
stateOrProvinceCode	string		State or province code
postalCode	string		Postal or ZIP code
countryCode	string		Country code (ISO)
zoneType	string		Address zone type Values: `residential` `commercial`
deliveryPoint	string		Specific delivery point within this location, such as a dock, door or bay, identifying where goods should be presented on arrival
contactsshow child fieldshide child fields	array		Contact persons for this party
type	string	✓	Type of contact — the role this person or office serves for the party they belong to Values: `primary` `customerRelations` `orderInquiry` `department` `shipping` `receiving` `hazmat` `certifier` `contracting` `advisor` `pricing` `investigator` `acceptingOfficial` `reportAuthorizer` `reportPreparer`
name	string		Contact person name
phoneNumber	string		Contact phone number
phoneExtension	string		Extension of the contact phone number
faxNumber	string		Contact fax number
email	string		Contact email address
contactReference	string		Reference that clarifies the contact — e.g. an organizational unit, department/role, or partner-assigned code
suppliershow child fieldshide child fields	object		Supplier or seller providing inventory information. Header PER with contactFunctionCode=IC merges into supplier.contacts (the supplier is the 846 sender, so a generic 'Information Contact' defaults to the supplier). If the partner's guideline notes route IC elsewhere, follow the notes — they override this default.
name	string		Party name or company name
additionalName1	string		Additional name line 1
additionalName2	string		Additional name line 2
identificationCode	string		Party identification code value
identificationCodeType	string		Type of identification code Values: `sendersId` `receiversId` `duns` `plantCode` `dunsPlus4` `drugEnforcementAdmin` `telephone` `federalReserveRouting` `standardAddressSAN` `healthIndustryHIN` `warehouse` `schoolId` `memberId` `stateLicenseId` `globalLocationId` `standardCarrierAlphaCode` `url` `cage` `activityAddressCode`
addressLine1	string		Street address line 1
addressLine2	string		Street address line 2
addressLine3	string		Street address line 3
addressLine4	string		Street address line 4
city	string		City name
stateOrProvinceCode	string		State or province code
postalCode	string		Postal or ZIP code
countryCode	string		Country code (ISO)
zoneType	string		Address zone type Values: `residential` `commercial`
deliveryPoint	string		Specific delivery point within this location, such as a dock, door or bay, identifying where goods should be presented on arrival
contactsshow child fieldshide child fields	array		Contact persons for this party
type	string	✓	Type of contact — the role this person or office serves for the party they belong to Values: `primary` `customerRelations` `orderInquiry` `department` `shipping` `receiving` `hazmat` `certifier` `contracting` `advisor` `pricing` `investigator` `acceptingOfficial` `reportAuthorizer` `reportPreparer`
name	string		Contact person name
phoneNumber	string		Contact phone number
phoneExtension	string		Extension of the contact phone number
faxNumber	string		Contact fax number
email	string		Contact email address
contactReference	string		Reference that clarifies the contact — e.g. an organizational unit, department/role, or partner-assigned code
referencesshow child fieldshide child fields	object		Reference numbers associated with the inventory report
vendorNumbershow child fieldshide child fields	object		Vendor or supplier identifier
value	string		The reference identifier value
description	string		Additional description or context for the reference
batchNumbershow child fieldshide child fields	object		Batch number for inventory report grouping
value	string		The reference identifier value
description	string		Additional description or context for the reference
departmentNumbershow child fieldshide child fields	object		Department number within the organization
value	string		The reference identifier value
description	string		Additional description or context for the reference
datesshow child fieldshide child fields	object		Date ranges for the inventory reporting period
reportStartDate	string		Date the inventory reporting period starts — the date from which the reported inventory position is effective Formats: `date` `date-time`
reportEndDate	string		Date the inventory reporting period ends Formats: `date` `date-time`
sellersCurrencyshow child fieldshide child fields	object		Currency used by the seller for pricing information
currencyCode	string	✓	ISO currency code (e.g., USD, EUR)
exchangeRate	string		Exchange rate for currency conversion
notesshow child fieldshide child fields	object		Notes and comments for the inventory report
generalshow child fieldshide child fields	object		General notes or comments about the inventory report
description	string		Brief description or title of the note
text	array of string		Array of text lines for the note content
lineItemsshow child fieldshide child fields	array	✓	Inventory line items being reported
lineNumber	string		Sequential line item number for referencing specific items
productIdsshow child fieldshide child fields	object	✓	Product identification codes such as UPC, SKU, or vendor item number
buyerItemNumber	string		Buyer-assigned item number
vendorItemNumber	string		Vendor-assigned item number (EDIFACT LIN/PIA supplier's item number)
uniqueItemIdentifier	string		Department of Defense Unique Item Identifier (UII) — the globally unique identifier marked on one physical unit of the item. Distinct from a manufacturer serial number.
gtin8	string		GTIN-8 (EAN-8) barcode, used on items too small for a full-length barcode
gtin12	string		GTIN-12 (UPC-A) barcode
gtin13	string		GTIN-13 (EAN) barcode
gtin14	string		GTIN-14 (ITF-14) case code barcode
caseCode	string		Case code identifier
moduleCode	string		U.P.C./EAN module code (2-5-5 format)
drugCode	string		National Drug Code (NDC)
standardBookNumber	string		ISBN or standard book number
priceLookupNumber	string		Price Look-Up (PLU) code used at point of sale, typically for loose or variable-weight retail goods
buyerItemIdsshow child fieldshide child fields	array		Additional buyer product identifiers
type	string	✓	Type of product identifier Values: `catalog` `manufacturerPart` `sku` `style`
value	string	✓	Product identifier value
vendorItemIdsshow child fieldshide child fields	array		Additional vendor product identifiers
type	string	✓	Type of product identifier Values: `catalog` `manufacturerPart` `sku` `style`
value	string	✓	Product identifier value
productAttributesshow child fieldshide child fields	object		Product descriptions and attributes
description	string		General product description. Sourced from X12 PID05 when PID02="08" (Product Description, general) or when PID02 is absent. In EDIFACT, sourced from EVERY IMD composite for this line item where itemDescriptionCode="SP" (Product) — there may be MULTIPLE matching IMD repetitions per line item, and ALL of them must be included. Within each matching IMD, concatenate itemDescription + itemDescription_1 (the continuation field) with a single space; then $join those per-IMD strings across ALL matching IMDs with a single space separator. Do NOT pick only the first matching IMD — partners commonly split a long description across multiple IMD segments because each itemDescription element is capped at 35 characters. The qualifier code "SP" (or X12 "08") is positional — it identifies which IMDs carry the product description, and must NOT be reported as a schema gap.
shortDescription	string		Short product description
federalSupplyClassification	string		Federal Supply Classification (FSC) code — the four-digit U.S. government supply class the item belongs to
commodityName	string		Name of the commodity the item belongs to
endItemDescription	string		The end item — the equipment or system — the ordered part is used in, such as the vehicle or weapon system a spare part is for
brand	string		Brand or label name for the product
colorCode	string		Color code identifier
colorDescription	string		Color description text
patternCode	string		Pattern code or number identifying the design pattern of the product
sizeCode	string		Size code identifier
sizeDescription	string		Size description text
prepackType	string		Prepack assortment or configuration type
widthClassification	string		Width classification for the product, such as a footwear width (e.g. "M", "W", "N"). Not a measurement — see width for the physical dimension.
gender	string		The gender(s) for which this product is intended
materialCode	string		Material code identifier
materialDescription	string		Material description text
materialAttributesshow child fieldshide child fields	object
type	string		Material type or classification
grade	string		Material grade or quality tier (e.g., prime, excessPrime, waste)
annealMethod	string		Annealing method applied to the material
temper	string		Heat treatment or mechanical processing state of the material
finish	string		Surface finish or texture applied to the material
outerCoating	string		Outer surface coating or plating
innerCoating	string		Inner surface coating or plating
surfaceProtection	string		Surface protection method or specification
treatment	string		Chemical or mechanical treatment applied to the material
weld	string		Welding specification or classification for the material
processCode	string		Process code identifier
processDescription	string		Process description text
specificationsshow child fieldshide child fields	array		Buyer-defined product specifications carried as name/value pairs — the customization detail accompanying made-to-order or special-order items. Only for characteristics that have no named field on this schema; colour, size, material and the physical dimensions each have their own field.
type	string		Name of the product characteristic being specified, as defined by the buyer’s specification (e.g. flex, loft, length, hand)
value	string		Value supplied for that characteristic
height	string		Product height dimension
length	string		Product length dimension
width	string		Product width dimension
dimensionUOM	string		Unit of measure for product dimensions Values: `standardCubicFoot` `boardFeet` `hundredBoardFeet` `cubicDecimeter` `cubicCentimeter` `cubicFeet` `cubicInches` `centimeter` `cubicMeter` `cubicYard` `decimeter` `foot` `hundredFeet` `hundredFeetLinear` `hundredSquareFeet` `hundredYards` `inch` `linearFoot` `linearMeter` `linearYard` `millimeter` `meter` `squareFoot` `squareInches` `squareMeter` `squareYard` `thousandSquareInches` `thousandFeetLinear` `thousandFeetBoard` `tenSquareFeet` `thousandSquareFeet` `yard`
vehicleFitmentshow child fieldshide child fields	object		The vehicle the ordered part is an application for (automotive fitment)
vin	string		Vehicle Identification Number (VIN) of the specific vehicle the part fits
make	string		Vehicle manufacturer / make the part is an application for (e.g., Honda, Toyota)
model	string		Vehicle model the part is an application for (e.g., Civic, Camry)
itemStatus	string		Current status of the item in inventory Values: `inStock` `outOfStock` `discontinued` `hidden`
discontinueDate	string		Date after which the product is discontinued or expires Formats: `date` `date-time`
unlimitedAvailability	boolean		Indicates supplier guarantees fulfillment regardless of stock levels
unitOfMeasure	string		Unit of measure for inventory quantities Values: `assembly` `assortment` `bag` `bale` `ball` `bar` `barrel` `belt` `bin` `block` `boardFeet` `bolt` `book` `bottle` `box` `bulk` `bundle` `bushel` `cake` `can` `card` `carton` `cartridge` `case` `cassette` `celsius` `cell` `centigram` `centiliter` `centimeter` `coil` `combo` `cone` `container` `count` `cover` `deal` `display` `dozen` `drum` `each` `eightPack` `fivePack` `flakeTon` `foot` `fourPack` `gallon` `gram` `gramsPerLiter` `halfDozen` `hundredweight` `inch` `innerPackage` `jar` `kilogram` `keg` `kit` `knots` `linearFoot` `liter` `meter` `metricGrossTon` `milliliter` `monetaryValue` `ninePack` `ocularInsertSystem` `order` `ounce` `packPAK` `package` `pad` `pail` `pair` `pairInches` `palletLift` `palletUnitLoad` `person` `piece` `pint` `pound` `poundEquivalent` `poundGross` `quart` `reel` `roll` `section` `set` `sevenPack` `sheet` `shipment` `sixPack` `sleeve` `squareFoot` `syringe` `thousand` `threePack` `tin` `tote` `truckload` `tube` `twelveDozen` `unit` `vial`
inventoryQuantitiesshow child fieldshide child fields	array	✓	Inventory quantities, each reported for a specific location and quantity type. Locations are identified here whether the report covers one location or many, so the shape is the same either way
locationId	string	✓	Location this quantity is reported for. Required on every entry — when the whole report covers a single location, repeat that location identifier here
lotNumber	string		Lot or batch number of the stock this quantity counts
type	string	✓	Type of inventory quantity being reported Values: `available` `unavailable` `incoming` `allocated` `maxOrderQuantity`
quantity	string	✓	Inventory quantity value
availableDate	string		Date when this quantity is or will be available Formats: `date` `date-time`
unitCostPrice	string		Default wholesale unit cost price for the item
additionalPricingshow child fieldshide child fields	array		Additional pricing information such as retail, list cost, or promotional pricing
priceType	string		Type of price Values: `discountAllowed` `highValuePrice` `listCost` `orderUnitPrice` `retail` `promotional` `discountPrice` `purchase` `alternatePrice` `net` `governmentPrice` `quantityBreakStart` `quantityBreakThrough` `quantityBreakMaximum`
unitPrice	string		Unit price value
unitPriceBasis	string		Basis for the unit price Values: `advise` `adjustable` `beforeDiscount` `discount` `net` `noCharge` `perHundred` `perThousand` `perDozen` `perEach` `perFoot` `perGram` `perKilogram` `perTen` `perOunce` `perPound` `perTenThousand` `perUOM` `promotion` `retail` `standard` `suggestedRetail` `wholesale` `wholesalePerEach`
quantityPerUnitPrice	string		Quantity the price is stated for, read with priceType — the number of units one price covers, or for a step-ladder price the quantity where its tier starts or ends
quantityPerUnitPriceUOM	string		Unit of measure of the quantity per unit price Values: `assembly` `assortment` `bag` `bale` `ball` `bar` `barrel` `belt` `bin` `block` `boardFeet` `bolt` `book` `bottle` `box` `bulk` `bundle` `bushel` `cake` `can` `card` `carton` `cartridge` `case` `cassette` `celsius` `cell` `centigram` `centiliter` `centimeter` `coil` `combo` `cone` `container` `count` `cover` `deal` `display` `dozen` `drum` `each` `eightPack` `fivePack` `flakeTon` `foot` `fourPack` `gallon` `gram` `gramsPerLiter` `halfDozen` `hundredweight` `inch` `innerPackage` `jar` `kilogram` `keg` `kit` `knots` `linearFoot` `liter` `meter` `metricGrossTon` `milliliter` `monetaryValue` `ninePack` `ocularInsertSystem` `order` `ounce` `packPAK` `package` `pad` `pail` `pair` `pairInches` `palletLift` `palletUnitLoad` `person` `piece` `pint` `pound` `poundEquivalent` `poundGross` `quart` `reel` `roll` `section` `set` `sevenPack` `sheet` `shipment` `sixPack` `sleeve` `squareFoot` `syringe` `thousand` `threePack` `tin` `tote` `truckload` `tube` `twelveDozen` `unit` `vial`
discountMultiplier	string		Discount multiplier factor applied to the unit price to derive the net cost (e.g., 0.57 means a 43% discount). The actual discount percent is 1 minus this value.
referencesshow child fieldshide child fields	object		Reference numbers for this line item
productTypeshow child fieldshide child fields	object		Product type classification for the trading partner
value	string		The reference identifier value
description	string		Additional description or context for the reference
notesshow child fieldshide child fields	object		Notes and comments for the line item
generalshow child fieldshide child fields	object		General notes or comments about the item
description	string		Brief description or title of the note
text	array of string		Array of text lines for the note content

{
  "purpose": "full",
  "reportType": "sellerInventory",
  "reportNumber": "INV-2024-001234",
  "reportDate": "2024-01-15",
  "parties": {
    "inventoryLocation": {
      "name": "West Coast Distribution Center",
      "identificationCode": "WH001",
      "identificationCodeType": "warehouse",
      "addressLine1": "1234 Logistics Way",
      "city": "Los Angeles",
      "stateOrProvinceCode": "CA",
      "postalCode": "90001",
      "countryCode": "US"
    },
    "buyer": {
      "name": "Retail Partner Inc",
      "identificationCode": "RETAILPARTNER",
      "identificationCodeType": "receiversId"
    },
    "supplier": {
      "name": "Acme Products LLC",
      "identificationCode": "ACMEPRODUCTS",
      "identificationCodeType": "sendersId",
      "contacts": [
        {
          "type": "primary",
          "name": "John Smith",
          "email": "[email protected]",
          "phoneNumber": "555-123-4567"
        }
      ]
    }
  },
  "references": {
    "vendorNumber": {
      "value": "VN-98765"
    },
    "departmentNumber": {
      "value": "DEPT-100"
    }
  },
  "dates": {
    "reportStartDate": "2024-01-01",
    "reportEndDate": "2024-01-15"
  },
  "sellersCurrency": {
    "currencyCode": "USD"
  },
  "notes": {
    "general": {
      "description": "Weekly inventory snapshot",
      "text": ["Full inventory count as of January 15, 2024"]
    }
  },
  "lineItems": [
    {
      "lineNumber": "1",
      "productIds": {
        "buyerItemNumber": "SKU-ABC-001",
        "vendorItemNumber": "ACME-WIDGET-100",
        "gtin12": "012345678901"
      },
      "productAttributes": {
        "description": "Premium Widget - Blue",
        "colorDescription": "Blue",
        "sizeDescription": "Large"
      },
      "itemStatus": "inStock",
      "unitOfMeasure": "each",
      "inventoryQuantities": [
        {
          "locationId": "WH001",
          "type": "available",
          "quantity": "500",
          "availableDate": "2024-01-15"
        },
        {
          "locationId": "WH001",
          "type": "allocated",
          "quantity": "75"
        },
        {
          "locationId": "WH001",
          "type": "incoming",
          "quantity": "200",
          "availableDate": "2024-01-22"
        }
      ],
      "unitCostPrice": "12.50"
    },
    {
      "lineNumber": "2",
      "productIds": {
        "buyerItemNumber": "SKU-ABC-002",
        "vendorItemNumber": "ACME-WIDGET-200",
        "gtin12": "012345678902"
      },
      "productAttributes": {
        "description": "Premium Widget - Red",
        "colorDescription": "Red",
        "sizeDescription": "Medium"
      },
      "itemStatus": "inStock",
      "unitOfMeasure": "each",
      "inventoryQuantities": [
        {
          "locationId": "WH001",
          "type": "available",
          "quantity": "1250"
        },
        {
          "locationId": "WH001",
          "type": "unavailable",
          "quantity": "25"
        }
      ],
      "unitCostPrice": "10.00"
    },
    {
      "lineNumber": "3",
      "productIds": {
        "buyerItemNumber": "SKU-XYZ-001",
        "vendorItemNumber": "ACME-GADGET-50"
      },
      "productAttributes": {
        "description": "Deluxe Gadget"
      },
      "unlimitedAvailability": true,
      "unitOfMeasure": "each",
      "inventoryQuantities": [
        {
          "locationId": "WH001",
          "type": "available",
          "quantity": "9999"
        }
      ],
      "unitCostPrice": "45.00",
      "references": {
        "productType": {
          "value": "dropship"
        }
      }
    }
  ]
}

File	Description	Download
sample.json	Sample JSON payload	Download
schema.json	JSON Schema for validation	Download