{"schema":"https://ver.cy/schemas/card/1.0.0","id":"vr.wm-obj-021","code":"wm-obj-021-handling-unit-logistics-container","url":"https://ver.cy/models/wm-obj-021-handling-unit-logistics-container/","name":"Handling Unit / Logistics Container","alternateNames":[],"kind":"world-model","status":"todo","version":"unversioned","language":"en","classifiers":{"family":"World Models","category":"Physical world and living systems","entryKind":"standalone-mm","plane":"","domain":["PHY.OBJ.PKG"],"industry":["Cross-industry"],"navPath":"NAV.PHY.OBJ.PKG","tags":["handling","unit","logistics","container","phy.obj.pkg"],"facets":{}},"whatItIs":"A handling unit is a physical unit put together for transport and handling, such as a pallet, case, roll cage or shipping container, identified so that it can be moved and tracked as one object. It nests: a container holds pallets, a pallet holds cases, and each level has its own identity and custody history; the goods inside and the transport order are separate records.","purpose":"Nested logistics identity and custody lifecycle","scope":{"in":[],"out":[],"boundaries":[]},"distinguishingFeatures":["The handling unit is the thing that is moved and scanned; the goods inside are separate records it declares.","Units nest, and each level carries its own identifier and custody history.","A unit is built and dissolved by packing operations, so its life is shorter than that of the goods it carries.","Distinct from the reusable asset itself, such as a pallet or container, which outlives many handling units."],"structure":{"bundles":[{"id":"OBJ021-B1","name":"Unit identity and nesting","description":"What the unit is and what it contains.","layers":[{"id":"OBJ021-B1-L1","name":"Identity and type","description":"The licence plate identifier and packaging type of the unit.","findings":[{"id":"OBJ021-F01","name":"Unit identifier","description":"The identifier that makes the unit trackable.","questions":[{"text":"Which identifier marks this handling unit, and who issued it?","id":"OBJ021-Q01"},{"text":"Which packaging type and reusable asset does the unit use?","id":"OBJ021-Q02"}]},{"id":"OBJ021-F02","name":"Nesting and content","description":"Parent and child units and the goods declared inside.","questions":[{"text":"Which handling units does this unit contain, and which unit contains it?","id":"OBJ021-Q03"},{"text":"Which goods, batches or serial numbers are declared inside it?","id":"OBJ021-Q04"}]}]}]},{"id":"OBJ021-B2","name":"Movement and custody","description":"Where the unit is and who holds it.","layers":[{"id":"OBJ021-B2-L1","name":"Custody chain","description":"Transfers of physical possession between parties.","findings":[{"id":"OBJ021-F03","name":"Current custody","description":"Who holds the unit now and since when.","questions":[{"text":"Which party has physical custody of the unit now, and since when?","id":"OBJ021-Q05"},{"text":"Which scans or handover events record the last transfer?","id":"OBJ021-Q06"}]},{"id":"OBJ021-F04","name":"Condition at handover","description":"Damage, seals and temperature observed at transfer.","questions":[{"text":"Was the unit intact and sealed at the last handover, and was any damage noted?","id":"OBJ021-Q07"},{"text":"Which conditions, such as temperature, were recorded during transport?","id":"OBJ021-Q08"}]}]}]},{"id":"OBJ021-B3","name":"Lifecycle","description":"How the unit comes into being and ends.","layers":[{"id":"OBJ021-B3-L1","name":"Build and dissolution","description":"Packing, repacking and unpacking of the unit.","findings":[{"id":"OBJ021-F05","name":"Unit lifecycle","description":"When the unit was built, changed or dissolved.","questions":[{"text":"When and where was the unit packed, and by whom?","id":"OBJ021-Q09"},{"text":"Was it repacked or split, and which identifiers replaced it?","id":"OBJ021-Q10"},{"text":"Has the unit been dissolved, and has its identifier been retired or reused?","id":"OBJ021-Q11"}]}]}]}]},"agentConduct":{"may":["Create and record handling units with their identifier, type, contents and nesting.","Record scans, handovers and condition observations against a unit.","Report the current location, custody and declared contents of a unit.","Flag mismatches between declared contents and what was scanned."],"mustNot":["Reuse an identifier while the earlier unit can still appear in the supply chain.","Change the declared contents of a sealed unit without recording an inspection or repack.","Record a handover that the receiving party has not confirmed.","Omit recorded damage, broken seals or temperature excursions from the unit's history.","Declare dangerous goods wrongly or leave their declaration off the unit record."],"requiresHuman":["Breaking a seal or opening a unit for inspection.","Accepting a unit with damage or a temperature excursion.","Releasing a unit whose contents do not match the declaration."]},"ethics":{"considerations":["Wrong declarations put handlers at risk, especially where dangerous goods are involved.","Tracking data about units also reveals the movements and performance of the people handling them.","Unrecorded damage shifts loss onto the party least able to prove what happened."],"affectedParties":["Warehouse and transport workers","Shippers, carriers and consignees","Recipients of temperature sensitive goods","Customs and inspection authorities"]},"owners":{"steward":"The logistics or warehouse operations lead of the party that currently holds the unit.","roles":[],"masterSystems":["Warehouse management system","Transport management system","Container and equipment tracking system"]},"relations":[{"target":"WM-OBJ-009","type":"parent"},{"target":"WM-OBJ-001","type":"contains"}],"interaction":{"identity":{"applicability":"required","items":["Pallets and cases are usually identified by a Serial Shipping Container Code (SSCC) on a GS1 logistics label.","Intermodal containers are identified by a BIC-registered container number under ISO 6346.","Identifiers must stay unique over time, so retired numbers are not reused while units may still circulate."]},"properties":{"applicability":"required","items":["Gross and net mass in kilograms, and tare mass of the packaging.","Outer dimensions in millimetres, including height with the load.","Volume in cubic metres and, for containers, declared payload capacity in kilogrammes.","Temperature in degrees Celsius for units under controlled conditions, with the measurement point.","Count of contained units or items, with the unit of measure stated."]},"recognition":{"applicability":"required","items":["Recognised by the printed or marked identifier, barcode, RFID tag and packaging type.","Container numbers and check digits are marked on the container itself.","Easily confused with a similar unit from the same shipment when the label is damaged or missing."]},"capabilities":{"applicability":"required","items":["Units can be nested, split and merged with new identifiers recorded.","Each movement can be scanned and attributed to a party and place.","Contents can be traced from a unit to batches and serial numbers."]},"hazards":{"applicability":"required","items":["Unstable or overweight units injuring handlers or damaging equipment.","Wrong or missing dangerous goods declaration.","Broken cold chain hidden by missing temperature records.","Identifier collisions that break traceability across partners."]},"interfaces":{"applicability":"required","items":["GS1 General Specifications for SSCC and the GS1 logistic label, and GS1 EPCIS for event exchange.","ISO 6346 for freight container coding, marking and identification.","UN/CEFACT and UN/EDIFACT messages for despatch advice and transport instructions."]},"context":{"applicability":"required","items":["Used in warehousing, road, rail, sea and air transport, and in customs and retail receiving.","Dangerous goods transport rules and food traceability law apply to the declarations carried."]}},"sources":[{"title":"GS1 General Specifications, GS1","url":"https://www.gs1.org/standards/barcodes-epcis"},{"title":"ISO 6346 Freight containers - Coding, identification and marking, ISO"},{"title":"UN/CEFACT Core Component Library and supply chain messages, UNECE"}],"openQuestions":["Planned model: boundary questions, research and every section remain to be written."],"resources":{"spec":"https://ver.cy/models/wm-obj-021-handling-unit-logistics-container/spec.yaml","agents":"https://ver.cy/models/wm-obj-021-handling-unit-logistics-container/AGENTS.md"},"provenance":{"origin":"planned (registry candidate)","builtFrom":["models/runtime-index.json","ver-cy/world-models/card-supplements/wm-obj-021-handling-unit-logistics-container.json"],"providers":[],"researchStatus":"todo","generatedAt":"","builder":"tools/build_cards.py@1.0.0"},"completeness":{"sections":{"classifiers":"filled","whatItIs":"filled","purpose":"filled","distinguishingFeatures":"filled","structure":"filled","agentConduct":"filled","ethics":"filled","owners":"filled","relations":"filled","interaction.identity":"filled","interaction.properties":"filled","interaction.recognition":"filled","interaction.capabilities":"filled","interaction.hazards":"filled","interaction.interfaces":"filled","interaction.context":"filled","sources":"filled"},"notes":{"_":"Planned entry, hidden from the catalogue until researched.","_supplement":"Sections authored in card supplement 1.0.0 by Claude (Opus 5.5) (2026-10-06, unreviewed). Written from the card's existing content and established practice in the field; no new sources were read. Unreviewed."},"score":1.0}}