Inventory Advice

Inventory Advice (846)

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

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	unknown	✓	Date the inventory report was created or snapshot was taken
partiesshow child fieldshide child fields	object		Warehouse or distribution center reporting inventory
inventoryLocationshow child fieldshide child fields	object		Warehouse or distribution center reporting inventory
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		N103: Codes 91 and 92 are specific to the direction of the transaction. Retail Example: For the 850 92 maps to sender and 91 maps to receiver. For the 856, 810 - sender maps to 91 and receiver maps to 92 Values: `sendersId` `receiversId` `duns` `plantCode` `dunsPlus4` `drugEnforcementAdmin` `telephone` `federalReserveRouting` `standardAddressSAN` `healthIndustryHIN` `warehouse` `schoolId` `memberId` `stateLicenseId` `globalLocationId`
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`
contactsshow child fieldshide child fields	array		Contact persons for this party
type	string	✓	Values: `primary` `customerRelations` `orderInquiry` `department` `shipping` `receiving` `hazmat`
name	string		Contact person name
phoneNumber	string		Contact phone number. Default source is the comm-number paired with a TE qualifier (PER03/04, PER05/06, or PER07/08). If the partner guideline note on the comm-number element labels the value as a different comm type (e.g.
faxNumber	string		Contact fax number. Default source is the comm-number paired with an FX qualifier (PER03/04, PER05/06, or PER07/08). If the partner guideline note on a comm-number element labels its value as fax even when the qualifier is TE/EM, follow the note and route the value here.
email	string		Contact email address. Default source is the comm-number paired with an EM qualifier (PER03/04, PER05/06, or PER07/08). If the partner guideline note on the comm-number element labels the value as a different comm type, follow the note and route accordingly.
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		N103: Codes 91 and 92 are specific to the direction of the transaction. Retail Example: For the 850 92 maps to sender and 91 maps to receiver. For the 856, 810 - sender maps to 91 and receiver maps to 92 Values: `sendersId` `receiversId` `duns` `plantCode` `dunsPlus4` `drugEnforcementAdmin` `telephone` `federalReserveRouting` `standardAddressSAN` `healthIndustryHIN` `warehouse` `schoolId` `memberId` `stateLicenseId` `globalLocationId`
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`
contactsshow child fieldshide child fields	array		Contact persons for this party
type	string	✓	Values: `primary` `customerRelations` `orderInquiry` `department` `shipping` `receiving` `hazmat`
name	string		Contact person name
phoneNumber	string		Contact phone number. Default source is the comm-number paired with a TE qualifier (PER03/04, PER05/06, or PER07/08). If the partner guideline note on the comm-number element labels the value as a different comm type (e.g.
faxNumber	string		Contact fax number. Default source is the comm-number paired with an FX qualifier (PER03/04, PER05/06, or PER07/08). If the partner guideline note on a comm-number element labels its value as fax even when the qualifier is TE/EM, follow the note and route the value here.
email	string		Contact email address. Default source is the comm-number paired with an EM qualifier (PER03/04, PER05/06, or PER07/08). If the partner guideline note on the comm-number element labels the value as a different comm type, follow the note and route accordingly.
suppliershow child fieldshide child fields	object		Supplier or seller providing inventory information
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		N103: Codes 91 and 92 are specific to the direction of the transaction. Retail Example: For the 850 92 maps to sender and 91 maps to receiver. For the 856, 810 - sender maps to 91 and receiver maps to 92 Values: `sendersId` `receiversId` `duns` `plantCode` `dunsPlus4` `drugEnforcementAdmin` `telephone` `federalReserveRouting` `standardAddressSAN` `healthIndustryHIN` `warehouse` `schoolId` `memberId` `stateLicenseId` `globalLocationId`
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`
contactsshow child fieldshide child fields	array		Contact persons for this party
type	string	✓	Values: `primary` `customerRelations` `orderInquiry` `department` `shipping` `receiving` `hazmat`
name	string		Contact person name
phoneNumber	string		Contact phone number. Default source is the comm-number paired with a TE qualifier (PER03/04, PER05/06, or PER07/08). If the partner guideline note on the comm-number element labels the value as a different comm type (e.g.
faxNumber	string		Contact fax number. Default source is the comm-number paired with an FX qualifier (PER03/04, PER05/06, or PER07/08). If the partner guideline note on a comm-number element labels its value as fax even when the qualifier is TE/EM, follow the note and route the value here.
email	string		Contact email address. Default source is the comm-number paired with an EM qualifier (PER03/04, PER05/06, or PER07/08). If the partner guideline note on the comm-number element labels the value as a different comm type, follow the note and route accordingly.
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	unknown		Date the inventory reporting period starts
reportEndDate	unknown		Date the inventory reporting period ends
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		General notes or comments about 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
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
drugCode	string		National Drug Code (NDC)
standardBookNumber	string		ISBN or standard book number
buyerItemIdsshow child fieldshide child fields	array		Additional buyer product identifiers
type	string	✓	Values: `catalog` `manufacturerPart` `sku` `style`
value	string	✓	Product identifier value
vendorItemIdsshow child fieldshide child fields	array		Additional vendor product identifiers
type	string	✓	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
shortDescription	string		Short product description
brand	string		Brand or label name for the product
colorCode	string		Color code identifier
colorDescription	string		Color description text
sizeCode	string		Size code identifier
sizeDescription	string		Size description text
materialCode	string		Material code identifier
materialDescription	string		Material description text
materialAttributesshow child fieldshide child fields	object		Material type or classification
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
height	string		Product height dimension
length	string		Product length dimension
width	string		Product width dimension
dimensionUOM	string		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`
itemStatus	string		Current status of the item in inventory Values: `inStock` `outOfStock` `discontinued` `hidden`
discontinueDate	unknown		Date after which the product is discontinued or expires
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` `display` `dozen` `drum` `each` `flakeTon` `foot` `gallon` `gram` `gramsPerLiter` `inch` `kilogram` `kit` `knots` `linearFoot` `liter` `meter` `milliliter` `monetaryValue` `ocularInsertSystem` `order` `ounce` `packPAK` `package` `pad` `pail` `pair` `pairInches` `palletLift` `palletUnitLoad` `person` `piece` `pint` `pound` `poundEquivalent` `poundGross` `quart` `reel` `roll` `section` `set` `sheet` `sixPack` `squareFoot` `syringe` `thousand` `threePack` `tote` `tube` `unit` `vial`
inventoryQuantitiesshow child fieldshide child fields	array	✓	Inventory quantities by location and type
locationId	string	✓	Location identifier for the warehouse, store, or distribution center
type	string	✓	Type of inventory quantity being reported Values: `Quantity Available for Sale` `Quantity on Hand` `Remaining Authorized Quantity` `Actual` `Available Quantity` `available` `Unusable Quantity` `Damaged Goods` `Quantity on Hold` `Quantity in Hold Out` `Work In Process` `Stock Transfers Out` `unavailable` `available` `Projected Available Inventory` `On Order Quantity` `In-Transit Quantity` `incoming` `allocated` `maxOrderQuantity`
quantity	string	✓	Inventory quantity value
availableDate	unknown		Date when this quantity is or will be available
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		Values: `discountAllowed` `highValuePrice` `listCost` `retail` `promotional` `purchase`
unitPrice	string		Unit price value
unitPriceBasis	string		Basis for the unit price Values: `advise` `beforeDiscount` `discount` `net` `noCharge` `perHundred` `perThousand` `perDozen` `perEach` `perFoot` `perGram` `perKilogram` `perTen` `perOunce` `perPound` `perTenThousand` `perUOM` `promotion` `standard` `suggestedRetail` `wholesale` `wholesalePerEach`
quantityPerUnitPrice	string		Quantity per unit price
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		General notes or comments about the 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
schema.csv	Schema fields in CSV format	Download