Warehouse Shipping Advice (945)

A Warehouse Shipping Advice (945) confirms that goods have been shipped from the warehouse, serving as the response to a 940 Warehouse Shipping Order.

Schema Overview Sample Downloads

Field	Type	Required	Description
shipmentStatus	object		Indicates whether this is a complete, partial, or replacement shipment
shippingOrderNumber	string	✓	Unique identifier for the shipping order - links to the 940 shippingOrderNumber
shipmentIdentificationNumber	string		Unique identifier for this shipment assigned by the warehouse
purchaseOrderNumber	string		The originating purchase order number
shipmentSequenceNumber	string		Sequence number when a 940 is fulfilled across multiple shipments (e.g., 2 of 3)
partiesshow child fieldshide child fields	object		Ship-to location - where the goods were delivered
shipToshow child fieldshide child fields	object		Ship-to location - where the goods were delivered
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` `pantCode` `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	✓	Type of contact Values: `primary` `customerRelations` `orderInquiry` `department` `shipping` `receiving` `hazmat`
name	string		Contact person name
phoneNumber	string		Contact phone number
faxNumber	string		Contact fax number
email	string		Contact email address
shipFromshow child fieldshide child fields	object		Warehouse/ship-from location - where the goods shipped from
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` `pantCode` `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	✓	Type of contact Values: `primary` `customerRelations` `orderInquiry` `department` `shipping` `receiving` `hazmat`
name	string		Contact person name
phoneNumber	string		Contact phone number
faxNumber	string		Contact fax number
email	string		Contact email address
billToshow child fieldshide child fields	object		Bill-to party for freight charges
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` `pantCode` `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	✓	Type of contact Values: `primary` `customerRelations` `orderInquiry` `department` `shipping` `receiving` `hazmat`
name	string		Contact person name
phoneNumber	string		Contact phone number
faxNumber	string		Contact fax number
email	string		Contact email address
suppliershow child fieldshide child fields	object		Supplier/depositor - the party who owns inventory at the warehouse and sent the 940 shipping order
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` `pantCode` `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	✓	Type of contact Values: `primary` `customerRelations` `orderInquiry` `department` `shipping` `receiving` `hazmat`
name	string		Contact person name
phoneNumber	string		Contact phone number
faxNumber	string		Contact fax number
email	string		Contact email address
buyershow child fieldshide child fields	object		Buying party who placed the original order
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` `pantCode` `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	✓	Type of contact Values: `primary` `customerRelations` `orderInquiry` `department` `shipping` `receiving` `hazmat`
name	string		Contact person name
phoneNumber	string		Contact phone number
faxNumber	string		Contact fax number
email	string		Contact email address
datesshow child fieldshide child fields	object		Key dates for the shipping advice
shipDate	date		Actual date the shipment was shipped
deliveryDate	date		Estimated delivery date at destination
referencesshow child fieldshide child fields	object		Header-level reference numbers
vendorNumbershow child fieldshide child fields	object		Internal vendor or customer reference number
value	string		The reference identifier value
description	string		Additional description or context for the reference
loadPlanningNumbershow child fieldshide child fields	object		Load planning or load ID number
value	string		The reference identifier value
description	string		Additional description or context for the reference
departmentNumbershow child fieldshide child fields	object		Department number
value	string		The reference identifier value
description	string		Additional description or context for the reference
proNumbershow child fieldshide child fields	object		Progressive or PRO number from the carrier
value	string		The reference identifier value
description	string		Additional description or context for the reference
agentShipmentNumbershow child fieldshide child fields	object		Shipment identifier assigned by a third-party agent such as a freight broker or 3PL coordinator
value	string		The reference identifier value
description	string		Additional description or context for the reference
carrierDetailsshow child fieldshide child fields	object		Carrier routing information
routingshow child fieldshide child fields	array		Carrier routing information
sequenceType	string		Sequence in the routing chain Values: `origin` `1stAfterOrigin` `4thAfterOrigin` `haulage`
standardCarrierAlphaCode	string		SCAC code identifying the carrier
customCarrierCode	string		Custom carrier identifier
transportationMethod	string		Method of transportation Values: `air` `airExpress` `airFreightForward` `backhaul` `bestWay` `commonCarrier` `consolidation` `customerPickup` `expeditedTruck` `lessThanTrailerLoad` `mail` `ocean` `oceanContainerized` `parcelPost` `privateCarrier` `rail` `shipperAgent` `supplierTruck` `mutuallyDefined`
locationType	string		Type of routing location Values: `inStore` `receiversLocation` `allPoints` `portOfArrival` `portOfEmbarkation` `origin` `mutuallyDefined`
location	string		Routing location identifier or name
description	string		Description of routing details
serviceLevel	string		Service level for shipping Values: `deliveryConfirmation` `doorService` `economy` `eveningService` `expedited` `firstClass` `ground` `groundHundredWeight` `international` `metro` `morning` `nextDayAir` `nextDayHundredWeight` `nextDayEvening` `nextDayMorning1030` `nextDayMorning930` `overnight` `poBoxZipCode` `priorityMail` `priorityMailInsured` `proofOfDelivery` `sameDay` `saturdayService` `secondDay` `secondDayHundredWeight` `secondDayAir` `standard` `standardGround` `threeDay`
orderStatus	string		Order shipping status Values: `shipCompleteOnDate` `complete` `partialShipment` `shipPartialBackorderToShipOnDate` `partialShipOnDate` `shipped` `backordered` `mutuallyDefined` `availableScheduledToShip` `availableNoShipSchedule` `multiPickup` `availableToShipUnBilledQuantity` `stopOff`
transitDirectionType	string		Direction of transit Values: `buyerToSeller` `sellerToBuyer` `subcontractorToSeller` `sellerToDropShipLocation` `sellToForwarder` `sellerToSubcontractor` `mutuallyDefined`
transitTimeType	string		Unit for transit time Values: `calendarDays` `hours` `workingDays`
transitTime	string		Expected transit time value
billOfLadingNumber	string		Bill of lading number for the shipment
equipmentshow child fieldshide child fields	object		Equipment details such as trailer information
equipmentType	string		Type of transportation equipment Values: `reefer` `trailer`
equipmentId	string		Equipment identifier (e.g., trailer number)
sealNumber	string		Seal number for security verification
freeOnBoardshow child fieldshide child fields	array		FOB (Free on Board) terms and conditions
methodOfPayment	string		Freight payment method Values: `airCollect` `airPrepaid` `paidByBuyer` `collect` `mutuallyAgreed` `portOfCall` `halfPrepaid` `mixed` `serviceFreightNoCharge` `advancePrepaid` `customerPickupBackhaul` `prepaidChargeCustomer` `prepaidBySeller` `paidBySeller` `pickup` `thirdPartyPay`
locationType	string		Type of FOB location Values: `cityAndState` `country` `destination` `origin` `stateProvince` `warehouse`
locationDescription	string		Description of FOB location
titlePassageType	string		Type of title passage location Values: `cityAndState` `country` `destination` `origin` `stateProvince` `warehouse`
titlePassageDescription	string		Description of title passage location
transportationTermsSource	string		Source of transportation terms Values: `incoTerms` `tradeTerms` `mutuallyDefined`
transportationTerms	string		Incoterms or trade terms code Values: `costAndFreight` `costInsuranceAndFreight` `carriageAndInsurancePaidTo` `carriagePaidTo` `deliveredAtFrontier` `deliverDutyPaid` `deliverDutyUnpaid` `deliveredDutyUnpaid` `deliveredExQuay` `deliveredExShip` `domesticallySupplied` `exQuay` `exShip` `exWorks` `freeAlongsideShip` `freeCarrier` `freightCarriageInsurancePaidTo` `freightCarriagePaidTo` `freeOnBoard` `freeOnRail` `freeOnTruck` `nonPrivilegedForeign` `privilegedForeign` `mutuallyDefined`
riskOfLoss	string		Risk of loss transfer point Values: `toDestinationBuyer` `toFreightEqPointSeller` `toPoolPointSeller` `toDestinationSeller` `mutuallyDefined`
description	string		Additional FOB description
specialHandlingshow child fieldshide child fields	array		Special handling requirements for the shipment
handlingType	string		Type of special handling required Values: `bulkyArticle` `dangerous` `deliveryService` `domestic` `doNotFreeze` `doNotUseWaterForFire` `environmentalControlLimits` `explosiveGas` `export` `flammable` `flammablePoisonGas` `fragile` `fullContainerConsolidatorLoad` `fullContainerFactoryLoad` `hazardousMaterial` `humiditySensitive` `ice` `keepDry` `marshalingNotRequired` `noPlacardsRequired` `notifyConsigneeBeforeDelivery` `partialShip` `perHourRatesApplied` `perishable` `poisonousGas` `protectFromHeat` `radioactiveMaterial` `refrigerated` `shipperLoadCount` `signatureAndTimeRequired` `stowBelowDeck` `temperatureControl` `trailerFactoryLoad` `transitShip` `unloadAsPlacarded` `waiveInspection` `volatileOrganicCompound`
description	string		Description of special handling
materialId	string		Hazardous material identifier
materialClass	string		Hazardous material class
conditionResponse	boolean		Condition response indicator
totalsshow child fieldshide child fields	object		Shipment totals
numberOfUnitsShipped	string		Total number of units shipped
grossWeight	string		Total gross weight of the shipment (including packaging)
netWeight	string		Total net weight of the shipment (product only)
weightUOM	string		Unit of measure for weight Values: `pound` `kilogram`
volumeshow child fieldshide child fields	object		Total volume of the shipment
value	string	✓	Numeric quantity value
unitOfMeasure	string		Unit of measure for the quantity 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` `celcius` `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`
ladingQuantityshow child fieldshide child fields	object		Number of handling units such as pallets or cartons
value	string	✓	Numeric quantity value
unitOfMeasure	string		Unit of measure for the quantity 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` `celcius` `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`
lineItemsshow child fieldshide child fields	array		Line items that were shipped from the warehouse
lineNumber	string		Line item sequence number on this document
shippingOrderLineId	string		Line item identifier from the originating 940 shipping order — links this shipped item back to the requested line
status	object		Shipment status of this line item
quantityOrderedshow child fieldshide child fields	object		Original quantity ordered
value	string	✓	Numeric quantity value
unitOfMeasure	string		Unit of measure for the quantity 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` `celcius` `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`
quantityShippedshow child fieldshide child fields	object		Quantity actually shipped
value	string	✓	Numeric quantity value
unitOfMeasure	string		Unit of measure for the quantity 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` `celcius` `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`
quantityDifferenceshow child fieldshide child fields	object		Difference between ordered and shipped quantities
value	string	✓	Numeric quantity value
unitOfMeasure	string		Unit of measure for the quantity 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` `celcius` `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`
productIdsshow child fieldshide child fields	object		Product identification codes (UPC, SKU, vendor item number, etc.)
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	✓	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 characteristics and description (colour, size, material, etc.)
description	string		General product description
shortDescription	string		Short product description
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 classification
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		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`
warehouseLotNumber	string		Reference number assigned by the warehouse for inventory tracking
physicalDetailsshow child fieldshide child fields	object		Physical details for the line item (weight, volume, dimensions)
numberOfUnits	string		Number of units in the package
size	string		Size value of the package
sizeUOM	string		Unit of measure for size Values: `bag` `box` `carton` `case` `cassette` `each` `fluidOunce` `gram` `kilogram` `liter` `milliliter` `ounce` `packPAK` `package` `pair` `pound` `roll` `tote` `unit`
packageForm	string		Form of the package Values: `bag` `bottle` `box` `can` `carton` `coil` `container` `pallet` `shrinkWrap` `unit`
packageMaterial	string		Material of the package Values: `corrugated` `plastic` `plasticVacuumed` `standard` `wood`
weightUOM	string		Unit of measure for weight Values: `pound` `kilogram`
grossWeight	string		Gross weight including packaging
netWeight	string		Net weight of contents only
volumeUOM	string		Unit of measure for volume Values: `standardCubicFoot` `centiliter` `cubicDecimeter` `cubicCentimeter` `cubicFeet` `cubicInches` `cubicMeter` `cubicYard` `deciliter` `fluidOunce` `gallon` `halfGallon` `kiloliter` `kilogramsPerCubicMeter` `liter` `milliliter` `netGallons` `pint` `halfPint` `quart`
volume	string		Volume value
length	string		Length dimension
width	string		Width dimension
height	string		Height dimension
dimensionUOM	string		Unit of measure for 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`
packageId	string		Package identifier
datesshow child fieldshide child fields	object		Date information for the line item
expirationDate	date		Product expiration date
manufactureDate	date		Product manufacture date
referencesshow child fieldshide child fields	object		Reference numbers for the line item
lotNumber	string		Lot number for the product
pickUpReferenceshow child fieldshide child fields	object		Pick-up reference number
value	string		The reference identifier value
description	string		Additional description or context for the reference
vendorContractNumbershow child fieldshide child fields	object		Vendor contract number
value	string		The reference identifier value
description	string		Additional description or context for the reference
billOfLadingNumbershow child fieldshide child fields	object		Bill of lading number for this line item
value	string		The reference identifier value
description	string		Additional description or context for the reference
marksAndNumbersshow child fieldshide child fields	object		Marks and numbers identifying the shipped units
serialShippingId	string		Serial Shipping Container Code (SSCC-18) barcode identifier
caseNumber	string		Case or carton number identifier

{
  "shipmentStatus": "partial",
  "shippingOrderNumber": "WSO-2026-001234",
  "shipmentIdentificationNumber": "SHP-2026-001234-01",
  "purchaseOrderNumber": "PO-98765",
  "shipmentSequenceNumber": "1",
  "parties": {
    "shipTo": {
      "name": "Acme Retail Store #142",
      "additionalName1": "Receiving Department",
      "identificationCode": "0078742035291",
      "identificationCodeType": "globalLocationId",
      "addressLine1": "1234 Commerce Blvd",
      "addressLine2": "Suite 100",
      "city": "Dallas",
      "stateOrProvinceCode": "TX",
      "postalCode": "75201",
      "countryCode": "US",
      "contacts": [
        {
          "type": "receiving",
          "name": "John Smith",
          "phoneNumber": "214-555-1234",
          "email": "jsmith@acmeretail.com"
        }
      ]
    },
    "shipFrom": {
      "name": "National Distribution Center",
      "identificationCode": "WH-DFW-001",
      "identificationCodeType": "warehouse",
      "addressLine1": "5000 Logistics Parkway",
      "city": "Fort Worth",
      "stateOrProvinceCode": "TX",
      "postalCode": "76177",
      "countryCode": "US",
      "contacts": [
        {
          "type": "shipping",
          "name": "Maria Garcia",
          "phoneNumber": "817-555-9876",
          "email": "mgarcia@nationaldist.com"
        }
      ]
    },
    "billTo": {
      "name": "Acme Retail Corporate",
      "identificationCode": "ACME001",
      "identificationCodeType": "sendersId",
      "addressLine1": "500 Corporate Drive",
      "city": "Bentonville",
      "stateOrProvinceCode": "AR",
      "postalCode": "72712",
      "countryCode": "US"
    },
    "supplier": {
      "name": "GreenLeaf Consumer Goods",
      "identificationCode": "987654321",
      "identificationCodeType": "duns",
      "addressLine1": "200 Brand Avenue",
      "city": "Chicago",
      "stateOrProvinceCode": "IL",
      "postalCode": "60601",
      "countryCode": "US",
      "contacts": [
        {
          "type": "primary",
          "name": "David Chen",
          "phoneNumber": "312-555-7890",
          "email": "dchen@greenleaf.com"
        }
      ]
    },
    "buyer": {
      "name": "Acme Retail Purchasing",
      "identificationCode": "123456789",
      "identificationCodeType": "duns",
      "contacts": [
        {
          "type": "primary",
          "name": "Sarah Johnson",
          "phoneNumber": "479-555-4567",
          "email": "sjohnson@acmeretail.com"
        }
      ]
    }
  },
  "dates": {
    "shipDate": "2026-01-20",
    "deliveryDate": "2026-01-23"
  },
  "references": {
    "vendorNumber": {
      "value": "VND-GL-4420",
      "description": "GreenLeaf vendor account"
    },
    "loadPlanningNumber": {
      "value": "LP-2026-0120-DFW",
      "description": "DFW distribution centre load plan"
    },
    "departmentNumber": {
      "value": "DEPT-42",
      "description": "Electronics Department"
    },
    "proNumber": {
      "value": "PRO-556789012",
      "description": "FedEx progressive number"
    },
    "agentShipmentNumber": {
      "value": "3PL-NATDIST-78901"
    }
  },
  "carrierDetails": {
    "routing": [
      {
        "sequenceType": "origin",
        "standardCarrierAlphaCode": "FEDX",
        "transportationMethod": "commonCarrier",
        "serviceLevel": "ground",
        "description": "FedEx Ground Service",
        "transitTimeType": "workingDays",
        "transitTime": "3"
      }
    ],
    "billOfLadingNumber": "BOL-789012",
    "equipment": {
      "trailerNumber": "FEDX-TRL-44201",
      "sealNumber": "SEAL-88321"
    },
    "freeOnBoard": [
      {
        "methodOfPayment": "prepaidBySeller",
        "locationType": "origin",
        "locationDescription": "Fort Worth, TX",
        "transportationTermsSource": "incoTerms",
        "transportationTerms": "freeOnBoard",
        "description": "FOB Origin - Freight Prepaid"
      }
    ],
    "specialHandling": [
      {
        "handlingType": "fragile",
        "description": "Contains electronic equipment - handle with care"
      },
      {
        "handlingType": "temperatureControl",
        "description": "Maintain between 50-80°F for health supplements"
      }
    ]
  },
  "totals": {
    "numberOfUnitsShipped": "60",
    "grossWeight": "45.5",
    "weightUOM": "LB",
    "volume": {
      "value": "18.0",
      "unitOfMeasure": "squareFoot"
    },
    "ladingQuantity": {
      "value": "2",
      "unitOfMeasure": "pallet"
    }
  },
  "pallets": [
    {
      "serialShippingId": "003760001234567890",
      "physicalDetails": {
        "grossWeight": "37.5",
        "weightUOM": "pound"
      },
      "cartons": [
        {
          "serialShippingId": "003760001234567892",
          "caseNumber": "CSE-001-A",
          "physicalDetails": {
            "grossWeight": "15.5",
            "weightUOM": "pound"
          },
          "items": [
            {
              "lineNumber": "001",
              "shippingOrderLineId": "001",
              "status": "complete",
              "quantityOrdered": {
                "value": "24",
                "unitOfMeasure": "each"
              },
              "quantityShipped": {
                "value": "24",
                "unitOfMeasure": "each"
              },
              "quantityDifference": {
                "value": "0",
                "unitOfMeasure": "each"
              },
              "productIds": {
                "buyerItemNumber": "ACM-SKU-12345",
                "vendorItemNumber": "VND-WIDGET-001",
                "gtin12": "012345678901",
                "gtin14": "10012345678901",
                "caseCode": "012345678901",
                "buyerItemIds": [
                  {
                    "type": "sku",
                    "value": "SKU-WIDGET-BLK-LG"
                  },
                  {
                    "type": "style",
                    "value": "STYLE-2026-SPRING"
                  }
                ],
                "vendorItemIds": [
                  {
                    "type": "manufacturerPart",
                    "value": "MFG-PART-98765"
                  }
                ]
              },
              "productAttributes": {
                "description": "Premium Widget - Large Black",
                "sizeDescription": "Large",
                "colorDescription": "Black"
              },
              "warehouseLotNumber": "LOT-2026-01-A1",
              "physicalDetails": {
                "grossWeight": "15.5",
                "netWeight": "15.0",
                "weightUOM": "pound"
              },
              "dates": {
                "expirationDate": "2028-01-20",
                "manufactureDate": "2025-11-15"
              },
              "references": {
                "lotNumber": "LOT-2026-01-A1",
                "pickUpReference": {
                  "value": "PU-DFW-20260120-001",
                  "description": "Fort Worth DC pick-up reference"
                },
                "vendorContractNumber": {
                  "value": "VC-GL-2026-Q1",
                  "description": "GreenLeaf Q1 2026 contract"
                },
                "billOfLadingNumber": {
                  "value": "BOL-789012",
                  "description": "Shipment bill of lading"
                }
              }
            }
          ]
        },
        {
          "serialShippingId": "003760001234567893",
          "caseNumber": "CSE-002-A",
          "physicalDetails": {
            "grossWeight": "22.0",
            "weightUOM": "pound"
          },
          "items": [
            {
              "lineNumber": "002",
              "shippingOrderLineId": "002",
              "status": "partial",
              "quantityOrdered": {
                "value": "48",
                "unitOfMeasure": "each"
              },
              "quantityShipped": {
                "value": "36",
                "unitOfMeasure": "each"
              },
              "quantityDifference": {
                "value": "12",
                "unitOfMeasure": "each"
              },
              "productIds": {
                "buyerItemNumber": "ACM-SKU-67890",
                "vendorItemNumber": "VND-GADGET-002",
                "gtin12": "098765432109",
                "buyerItemIds": [
                  {
                    "type": "sku",
                    "value": "SKU-GADGET-WHT-SM"
                  }
                ]
              },
              "productAttributes": {
                "description": "Standard Gadget - Small White",
                "sizeDescription": "Small",
                "colorDescription": "White"
              },
              "warehouseLotNumber": "LOT-2026-01-B3",
              "physicalDetails": {
                "grossWeight": "22.0",
                "netWeight": "18.0",
                "weightUOM": "pound"
              },
              "dates": {
                "manufactureDate": "2025-12-01"
              },
              "references": {
                "lotNumber": "LOT-2026-01-B3"
              }
            }
          ]
        }
      ]
    },
    {
      "serialShippingId": "003760001234567891",
      "physicalDetails": {
        "grossWeight": "8.0",
        "weightUOM": "pound"
      },
      "cartons": [
        {
          "serialShippingId": "003760001234567894",
          "caseNumber": "CSE-003-A",
          "physicalDetails": {
            "grossWeight": "8.0",
            "weightUOM": "pound"
          },
          "items": [
            {
              "lineNumber": "003",
              "shippingOrderLineId": "003",
              "status": "closed",
              "quantityOrdered": {
                "value": "100",
                "unitOfMeasure": "each"
              },
              "quantityShipped": {
                "value": "0",
                "unitOfMeasure": "each"
              },
              "quantityDifference": {
                "value": "100",
                "unitOfMeasure": "each"
              },
              "productIds": {
                "buyerItemNumber": "ACM-SKU-11111",
                "gtin12": "111111111111",
                "drugCode": "12345-6789-01"
              },
              "productAttributes": {
                "description": "Health Supplement - 30 Count Bottle"
              },
              "warehouseLotNumber": "LOT-2026-01-PHARMA",
              "dates": {
                "expirationDate": "2027-06-30",
                "manufactureDate": "2025-06-30"
              },
              "references": {
                "lotNumber": "LOT-2026-01-PHARMA"
              }
            }
          ]
        }
      ]
    }
  ]
}

File	Description	Download
sample.json	Sample JSON payload	Download
schema.json	JSON Schema for validation	Download
schema.csv	Schema fields in CSV format	Download