[{"data":1,"prerenderedAt":320},["ShallowReactive",2],{"article-cargowise-consol-master-house-bills-one-sync":3},{"id":4,"title":5,"author":6,"body":7,"category":300,"description":301,"extension":302,"featured":303,"image":304,"meta":305,"navigation":306,"path":307,"publishedAt":308,"readingTime":228,"seo":309,"stem":310,"tags":311,"updatedAt":315,"videoCaptions":316,"videoPoster":317,"videoUrl":318,"__hash__":319},"articles\u002Farticles\u002Fcargowise-consol-master-house-bills-one-sync.md","Building a CargoWise Consol From a Master and House Bills in One Sync","Dil",{"type":8,"value":9,"toc":292},"minimark",[10,14,19,22,88,91,95,98,101,104,108,111,114,125,128,132,135,138,266,269,273,276,280,288],[11,12,13],"p",{},"Consols are where keying errors concentrate. One master bill covers the whole move. Underneath it sit several house bills, each tied to a different shipper, each with its own containers, cartons and weights. Get one container under the wrong house bill and you've declared the wrong goods against the wrong consignee. The demo above shows a master B\u002FL, three house B\u002FLs and a packing list dropped in as they arrived, with every box landing under its own house bill before a single sync builds the consol in CargoWise. This article walks through why that structure is fragile by hand, and what the sync actually does.",[15,16,18],"h2",{"id":17},"master-bill-house-bill-what-each-one-is-for","Master bill, house bill: what each one is for",[11,20,21],{},"A master bill of lading is issued by the carrier for the full container-level movement, origin to destination. It doesn't care who the actual shippers are, only that the boxes get from A to B. The house bills sit underneath it, one per shipper, each referencing the cargo that belongs to that shipper specifically.",[23,24,25,40],"table",{},[26,27,28],"thead",{},[29,30,31,34,37],"tr",{},[32,33],"th",{},[32,35,36],{},"Master bill",[32,38,39],{},"House bill",[41,42,43,55,66,77],"tbody",{},[29,44,45,49,52],{},[46,47,48],"td",{},"Issued by",[46,50,51],{},"Carrier (or NVOCC)",[46,53,54],{},"Freight forwarder",[29,56,57,60,63],{},[46,58,59],{},"Covers",[46,61,62],{},"The whole container-level movement",[46,64,65],{},"One shipper's cargo within that movement",[29,67,68,71,74],{},[46,69,70],{},"Consignee",[46,72,73],{},"The forwarder or consol agent",[46,75,76],{},"The actual customer",[29,78,79,82,85],{},[46,80,81],{},"Quantity per consol",[46,83,84],{},"One",[46,86,87],{},"Several",[11,89,90],{},"The job of building a consol is reconciling these two layers: taking the master bill's container and routing data, and correctly splitting it across however many house bills are riding inside it.",[15,92,94],{"id":93},"why-container-to-house-bill-assignment-is-the-failure-point","Why container-to-house-bill assignment is the failure point",[11,96,97],{},"A consol with three house bills and eight containers doesn't mean each house bill gets a clean third. Cargo from different shippers gets stuffed across containers unevenly. One house bill might span two containers, another might share a container with a third. The packing list is usually the only document that tells you precisely which cartons, and therefore which containers, belong to which house bill.",[11,99,100],{},"When this is keyed by hand, the sequence is: read the master bill for container numbers, read each house bill for shipper and cargo description, cross-reference the packing list to work out which cartons sit in which container, then enter all of it into CargoWise house by house. Do that across several consols a week and the chance of a container landing under the wrong house bill climbs with every manual cross-reference.",[11,102,103],{},"Here's the arithmetic worth running on your own numbers. Say you handle 40 consols a month, averaging 4 house bills each. That's 160 master-to-house links to get right every month, before you count containers. If each consol carries 8 containers on average, that's 40 x 8 = 320 container-to-house-bill assignments a month, each one needing to match the packing list exactly. One wrong assignment means a customs declaration against the wrong consignee and a scramble to correct it before cut-off.",[15,105,107],{"id":106},"what-the-demo-shows","What the demo shows",[11,109,110],{},"The documents go in as they arrive, not reformatted or pre-sorted: the master bill, the three house bills, and the packing list. From there, every box on the packing list is read against its house bill reference and assigned to it.",[11,112,113],{},"A simplified version of that assignment logic looks like this:",[115,116,121],"pre",{"className":117,"code":119,"language":120},[118],"language-text","for carton in packing_list.cartons:\n    house_bill = find_house_bill(carton.house_bill_reference)\n    house_bill.cartons.append(carton)\n\n    if carton.container_number not in house_bill.containers:\n        house_bill.containers.append(carton.container_number)\n","text",[122,123,119],"code",{"__ignoreMap":124},"",[11,126,127],{},"Once every carton has been matched to its house bill, and every house bill has its correct set of containers, you have the full picture: one master bill, three house bills, each with the right containers and cargo underneath it. That structure is what gets synced.",[15,129,131],{"id":130},"one-sync-one-consol","One sync, one consol",[11,133,134],{},"With the house bills built and their containers assigned, the sync pushes the whole structure into CargoWise through eAdapter: the master shipment, each house shipment, and the container-to-house links, in one pass. You're not opening CargoWise three times to key three house bills separately and hoping the container splits line up. The structure you built from the documents is the structure that lands.",[11,136,137],{},"A rough shape of what gets synced, for a consol with three house bills:",[115,139,143],{"className":140,"code":141,"language":142,"meta":124,"style":124},"language-yaml shiki shiki-themes github-light","consol:\n  master_bill: \u003Cmaster B\u002FL number>\n  house_bills:\n    - number: HBL-001\n      containers: [MSKU1234567, MSKU7654321]\n    - number: HBL-002\n      containers: [TEMU1111111]\n    - number: HBL-003\n      containers: [TGHU2222222, MSKU1234567]\n","yaml",[122,144,145,158,171,179,193,214,226,238,250],{"__ignoreMap":124},[146,147,150,154],"span",{"class":148,"line":149},"line",1,[146,151,153],{"class":152},"shJU0","consol",[146,155,157],{"class":156},"sgsFI",":\n",[146,159,161,164,167],{"class":148,"line":160},2,[146,162,163],{"class":152},"  master_bill",[146,165,166],{"class":156},": ",[146,168,170],{"class":169},"sYBdl","\u003Cmaster B\u002FL number>\n",[146,172,174,177],{"class":148,"line":173},3,[146,175,176],{"class":152},"  house_bills",[146,178,157],{"class":156},[146,180,182,185,188,190],{"class":148,"line":181},4,[146,183,184],{"class":156},"    - ",[146,186,187],{"class":152},"number",[146,189,166],{"class":156},[146,191,192],{"class":169},"HBL-001\n",[146,194,196,199,202,205,208,211],{"class":148,"line":195},5,[146,197,198],{"class":152},"      containers",[146,200,201],{"class":156},": [",[146,203,204],{"class":169},"MSKU1234567",[146,206,207],{"class":156},", ",[146,209,210],{"class":169},"MSKU7654321",[146,212,213],{"class":156},"]\n",[146,215,217,219,221,223],{"class":148,"line":216},6,[146,218,184],{"class":156},[146,220,187],{"class":152},[146,222,166],{"class":156},[146,224,225],{"class":169},"HBL-002\n",[146,227,229,231,233,236],{"class":148,"line":228},7,[146,230,198],{"class":152},[146,232,201],{"class":156},[146,234,235],{"class":169},"TEMU1111111",[146,237,213],{"class":156},[146,239,241,243,245,247],{"class":148,"line":240},8,[146,242,184],{"class":156},[146,244,187],{"class":152},[146,246,166],{"class":156},[146,248,249],{"class":169},"HBL-003\n",[146,251,253,255,257,260,262,264],{"class":148,"line":252},9,[146,254,198],{"class":152},[146,256,201],{"class":156},[146,258,259],{"class":169},"TGHU2222222",[146,261,207],{"class":156},[146,263,204],{"class":169},[146,265,213],{"class":156},[11,267,268],{},"Note that a container can appear under more than one house bill, that's normal when cargo from different shippers shares space. The sync carries that correctly, rather than forcing a one-container-one-house assumption that doesn't match how consols actually get packed.",[15,270,272],{"id":271},"duplicate-house-bills-get-blocked-not-overwritten","Duplicate house bills get blocked, not overwritten",[11,274,275],{},"A house bill number that already exists on another job is blocked rather than silently created a second time. This matters more than it sounds: house bill numbers get reused across jobs more often than anyone would like, usually from a template or a copy-paste further up the chain. Catching the duplicate before it enters CargoWise is cheaper than finding it after the consol has shipped.",[15,277,279],{"id":278},"try-it-on-your-own-documents","Try it on your own documents",[11,281,282,283,287],{},"If you run several house bills per consol and you're still cross-referencing packing lists by eye, this is the part of the workflow to fix first, it's where the keying volume and the error cost both peak. Watch the demo at the top of this page for the full walkthrough, or read more on how eAdapter moves data into CargoWise at ",[284,285,286],"a",{"href":286},"\u002Feadapter",".",[289,290,291],"style",{},"html pre.shiki code .shJU0, html code.shiki .shJU0{--shiki-default:#22863A}html pre.shiki code .sgsFI, html code.shiki .sgsFI{--shiki-default:#24292E}html pre.shiki code .sYBdl, html code.shiki .sYBdl{--shiki-default:#032F62}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}",{"title":124,"searchDepth":160,"depth":160,"links":293},[294,295,296,297,298,299],{"id":17,"depth":160,"text":18},{"id":93,"depth":160,"text":94},{"id":106,"depth":160,"text":107},{"id":130,"depth":160,"text":131},{"id":271,"depth":160,"text":272},{"id":278,"depth":160,"text":279},"product","How CargoMode turns a master bill, several house bills and a packing list into a correct CargoWise consol, container by container, in one sync.","md",false,"\u002Fimages\u002Farticles\u002Fcargowise-consol-master-house-bills-one-sync.jpg",{},true,"\u002Farticles\u002Fcargowise-consol-master-house-bills-one-sync","2026-11-12",{"title":5,"description":301},"articles\u002Fcargowise-consol-master-house-bills-one-sync",[312,313,314],"CargoWise","Consolidation","eAdapter",null,"\u002Fvideos\u002Fcargomode-consol-20261003.vtt","https:\u002F\u002Fkbfplorwdlxjdcqfthvo.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fmarketing\u002Fselected-demo\u002Ffc6806f666-cargomode-consol-poster.jpg","https:\u002F\u002Fkbfplorwdlxjdcqfthvo.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Fmarketing\u002Fselected-demo\u002F79c2df987f-cargomode-consol.mp4","wHn-eK6csbVVJV--9XVFZiPBA3wU2jL7COSxyja9Q3I",1795097920815]