A hypothetical, and a common one: a container is opened in a yard outside Jakarta at four in the afternoon. Eleven cartons of a twelve-carton line are sound. The twelfth is crushed along its lower edge, the tape split, and something inside moves when the pallet is lifted. The receiver has a phone, a packing list and a delivery receipt with a signature line still blank.

That is the hour in which a cargo damage claim is made or lost — not the hour in which the claim letter is written, three weeks later, when nobody remembers whether the carton was photographed before it was moved.

Nothing on this page is a quotation. No rate, tax figure, percentage, compensation amount or promised timeline appears in it, and every situation described is hypothetical: these are not client cases and they are not quotations. Whether a particular shipment gives rise to a claim, and what it is worth, is settled by the contract of carriage, the bill of lading and the insurer's policy — not by this page. Nor is this legal advice: carriage liability and time bars are decided under Indonesian law and by your own contract, and the statutory points below are stated as at November 2026 — confirm them with Indonesian counsel before you rely on them.

Three failures, three different claim files

The word "claim" hides three different arguments, and they fail for different reasons.

Damage is a condition argument. The cargo arrived, and it arrived altered: crushed, wet, bent, corroded, hot, contaminated. What has to be proved is the difference between the condition at handover and the condition at receipt, and the proof is almost entirely photographs, a survey, and the exception written on the delivery document.

Shortage is a counting argument. Something did not arrive. The pieces in the container do not match the pieces on the packing list, and no photograph of a carton can settle that — only a tally, a seal number and a comparison of documents can.

Non-delivery is a contract argument. The cargo did not arrive at all, or arrived so late that its value is gone. There is no crate to photograph. What matters is who holds the bill of lading, what the carrier contracted to do, and what happened to the goods between the two.

Comparison

What went wrong

What the file has to establish

The document that usually carries it

Damage

Condition changed between handover and receipt

Delivery receipt notation, photographs, survey report

Shortage

Piece count fell between stuffing and devanning

Tally sheet, seal number, packing list

Non-delivery

The carrier never delivered what it contracted to carry

Bill of lading, carrier's delivery record, written notice

Damage

What the file has to establish

Condition changed between handover and receipt

The document that usually carries it

Delivery receipt notation, photographs, survey report

Shortage

What the file has to establish

Piece count fell between stuffing and devanning

The document that usually carries it

Tally sheet, seal number, packing list

Non-delivery

What the file has to establish

The carrier never delivered what it contracted to carry

The document that usually carries it

Bill of lading, carrier's delivery record, written notice

A shipper who files a damage claim for a shortage, or a shortage claim for goods that are simply sitting in a customs channel, spends the same effort and gets nowhere. The first decision is which of the three you actually have.

The claim is decided at the point of delivery

Almost every claim that dies, dies because of something that was not done in the first hour. The pattern repeats across carrier claim procedures, and it is worth taking in order.

Inspect before signing. A clean signature on a delivery receipt is treated as evidence that the goods arrived in good order, and at the bill-of-lading end that presumption is statutory: under Article 514 of the Indonesian Commercial Code, where the bill of lading does not state the condition of the goods, the carrier is deemed to have received them in apparent good order unless the contrary is proved. Both HMM's claim procedure and ONE's import cargo claims guidelines put the instruction in the imperative: note the loss or damage on the receipt before signing it. Once the receipt is clean, the burden shifts onto you for everything discovered later. The six steps are collected as a sheet at the end of this page, for the person who actually meets the truck.

Write a description, not a verdict. "Damaged" is not an exception. "Two of twelve cartons crushed on the lower right edge, strapping broken, contents audible when lifted" is. The specific version tells a claims handler, a surveyor and eventually a judge what was seen; the general version tells them only that somebody was unhappy. Vague safety phrases are worse than nothing. "Subject to inspection" tells the claims handler that nothing was inspected; it does not preserve an exception, and in practice it is read as the same thing as accepting the cargo.

Count every piece against the packing list. Shortage is decided by arithmetic, and the arithmetic has to happen while the cargo is still where it landed. A count taken after the cartons have been distributed to three sites is not a count.

Read the seal before breaking it. The seal number is the strongest single link between the container that was stuffed and the container that was opened. Photograph the seal in place, compare the number against the documents, and only then cut. If the seal is missing, mismatched or was replaced, that fact matters more than the damage inside.

Photograph the failure, not just the victim. The carton is the easy picture. The ones that decide cases are wider: the container interior, the voids where cargo should have been, the packaging as it was found, the position of the load, the floor, the water line, the delivery document itself with its handwritten exception. Photograph before anything is moved, and keep photographing as each layer is opened.

Ask for a joint survey, and do not assume it will happen. A joint survey — your surveyor and the carrier's, at the same time, on the same cargo — is the single most useful thing that can happen to a damaged consignment, because it removes the later argument about condition. Both carrier procedures describe it as something the claimant requests and the carrier may attend, subject to surveyor availability; ONE is explicit that a survey it orders serves its own interest and that a cargo interest should appoint its own surveyor. Request it in writing, with the address and the receiving contact, and if nobody comes, record that fact and document the cargo yourself.

Two people at an open container, one photographing the interior with a phone and one holding a blank form, illustrating discovery of damage

The same discipline applies at the origin end. Custody changes hands at the consolidation warehouse, and that is where the record of "as received" begins — see what happens inside a China consolidation warehouse.

What a cargo damage claim has to prove

Strip away the procedure and a cargo damage claim rests on three propositions, each with its own document:

  1. The carrier received the goods in good order. Normally the bill of lading, or a clean dock receipt where the handover happened at a warehouse. A bill of lading that says the contents, quantity or weight are unknown is a weak opening — more on that below.
  2. The goods were damaged when you received them. The delivery receipt with its exception, the tally, photographs, and the survey report if there was one.
  3. The loss has a value you can evidence. Commercial invoice, packing list with weights and piece counts, and proof that the goods were paid for. A repair estimate or a replacement quotation converts "damaged" into a figure.

Fail any one and the claim does not travel, whatever the photographs show. This is the part that surprises shippers: a phone full of images proves the second proposition beautifully and does nothing for the first or third.

Indonesia adds a wrinkle that is genuinely useful to the claimant. Under Article 468 of the Indonesian Commercial Code, the contract of carriage obliges the carrier to safeguard the goods from the time they are received until the time they are handed over, and to compensate for non-delivery or damage unless it proves that this was caused by a calamity that could not reasonably be prevented or avoided, by an inherent defect of the goods, or by the fault of the consignor. The burden is the carrier's, not yours: liability is presumed once the carrier has taken charge, so the party arguing that the loss was unavoidable, or caused by the goods themselves, has to establish it. But the presumption only engages once the claimant has shown what was handed over and what came back. The mechanism rewards a clean document trail and does nothing for a clean photograph.

Who the claim is actually against

The question shippers ask first — "who do I claim against?" — has no single answer, because a container of export cargo passes through several pairs of hands, and each stretch of the journey is governed by a different document.

Comparison

Stage or contract

Who holds the cargo

The document that proves it, or names that party

Origin warehouse or CFS (container freight station)

Consolidator, forwarder or their warehouse operator

Warehouse receipt, dock receipt, origin tally

Ocean or air leg

The carrier named on the transport document — the cargo is on its ship or aircraft, under its bill or air waybill

Bill of lading or air waybill

Indonesian customs control or temporary storage

The appointed warehouse operator, under customs supervision

PIB (import declaration) and SPPB (release), plus the warehouse receiving record or tally

Destination warehouse or CFS

The deconsolidating warehouse operator

Devanning tally, warehouse receiving record

Final delivery

The delivering vehicle's operator

Delivery receipt or proof of delivery

Not a custody stage — the forwarder's own contract, running alongside the ocean leg

Nobody separately: if the issuer is an NVOCC (a forwarder that issues its own bill and carries under it) it is answerable for the leg as carrier, but the cargo is still on the ship named above

House bill of lading

Not a custody stage — the value, not the cargo

Your insurer, under a separate contract

Cargo insurance policy

Origin warehouse or CFS (container freight station)

Who holds the cargo

Consolidator, forwarder or their warehouse operator

The document that proves it, or names that party

Warehouse receipt, dock receipt, origin tally

Ocean or air leg

Who holds the cargo

The carrier named on the transport document — the cargo is on its ship or aircraft, under its bill or air waybill

The document that proves it, or names that party

Bill of lading or air waybill

Indonesian customs control or temporary storage

Who holds the cargo

The appointed warehouse operator, under customs supervision

The document that proves it, or names that party

PIB (import declaration) and SPPB (release), plus the warehouse receiving record or tally

Destination warehouse or CFS

Who holds the cargo

The deconsolidating warehouse operator

The document that proves it, or names that party

Devanning tally, warehouse receiving record

Final delivery

Who holds the cargo

The delivering vehicle's operator

The document that proves it, or names that party

Delivery receipt or proof of delivery

Not a custody stage — the forwarder's own contract, running alongside the ocean leg

Who holds the cargo

Nobody separately: if the issuer is an NVOCC (a forwarder that issues its own bill and carries under it) it is answerable for the leg as carrier, but the cargo is still on the ship named above

The document that proves it, or names that party

House bill of lading

Not a custody stage — the value, not the cargo

Who holds the cargo

Your insurer, under a separate contract

The document that proves it, or names that party

Cargo insurance policy

The house bill is the row that is not a leg. It is a second contract running alongside the ocean leg, and during that leg the cargo is on the carrier's ship under the master bill whatever the house bill names. Read it as the answer to "who is answerable to me for this leg", not as a record of who was holding the cargo.

Two things follow from that table.

You claim against whoever your contract names, and there may be two of them. A forwarder that issues its own house bill of lading is, for that contract, the carrier — and the ocean carrier underneath is a separate counterparty under its own bill. Filing against the wrong one consumes the notice window without producing a decision. Who is responsible for what across broker, forwarder, NVOCC and carrier is the map for this; the short version is that you read the document you were given, not the logo on the container.

Risk and claim are not the same thing. Under an Incoterm, risk passes at a defined point, and the party carrying the risk at the moment of loss is the party with the loss to recover. That is why the choice of Incoterm changes who files, and why a claim filed by the wrong party is usually answered with a request for the contract rather than a payment.

The evidence file, document by document

A claim file is not a folder of everything. It is a small set of documents, each of which answers one question. The lists published by carriers and insurers converge on the same core, and each item is there because its absence has defeated a real claim.

Comparison

Document

What it proves

What breaks it

Bill of lading or air waybill

The contract, the parties, and the cargo as declared at handover

A clause saying contents, quantity or weight are unknown

Delivery receipt or proof of delivery, with the exception written on it

That the loss was visible at receipt and was not accepted

A clean signature; a vague "subject to inspection"

Tally sheet or devanning record

The piece count at the moment of devanning, per shipper

A count taken after the cargo was distributed

Photographs

Condition, before anything moved

Pictures taken after the cargo was re-stacked or wrapped

Survey report

An independent statement of cause and extent

A survey commissioned only by one side, unchallenged

Commercial invoice

The value of the goods

Retail or replacement pricing rather than the transaction value

Packing list with weights

Which items, how many, how heavy

A packing list that does not match the invoice line by line

Proof of payment or ownership

That the claimant actually bore the loss

A claim filed by a party without title to the goods

Repair estimate or replacement quotation

The size of the loss, in money

An estimate produced after the goods were repaired

Salvage receipt or destruction certificate

That the damaged goods were disposed of and no value was recovered

Goods sold or scrapped before the carrier could inspect

Written notice and the correspondence around it

That the claim was made in time, to the right party

Notice given by phone, or to a party with no contract

Subrogation letter

That the insurer, not the cargo owner, is now the claimant

A recovery attempt by an insurer without it

Bill of lading or air waybill

What it proves

The contract, the parties, and the cargo as declared at handover

What breaks it

A clause saying contents, quantity or weight are unknown

Delivery receipt or proof of delivery, with the exception written on it

What it proves

That the loss was visible at receipt and was not accepted

What breaks it

A clean signature; a vague "subject to inspection"

Tally sheet or devanning record

What it proves

The piece count at the moment of devanning, per shipper

What breaks it

A count taken after the cargo was distributed

Photographs

What it proves

Condition, before anything moved

What breaks it

Pictures taken after the cargo was re-stacked or wrapped

Survey report

What it proves

An independent statement of cause and extent

What breaks it

A survey commissioned only by one side, unchallenged

Commercial invoice

What it proves

The value of the goods

What breaks it

Retail or replacement pricing rather than the transaction value

Packing list with weights

What it proves

Which items, how many, how heavy

What breaks it

A packing list that does not match the invoice line by line

Proof of payment or ownership

What it proves

That the claimant actually bore the loss

What breaks it

A claim filed by a party without title to the goods

Repair estimate or replacement quotation

What it proves

The size of the loss, in money

What breaks it

An estimate produced after the goods were repaired

Salvage receipt or destruction certificate

What it proves

That the damaged goods were disposed of and no value was recovered

What breaks it

Goods sold or scrapped before the carrier could inspect

Written notice and the correspondence around it

What it proves

That the claim was made in time, to the right party

What breaks it

Notice given by phone, or to a party with no contract

Subrogation letter

What it proves

That the insurer, not the cargo owner, is now the claimant

What breaks it

A recovery attempt by an insurer without it

Two obligations run through the whole file. Mitigate: damaged cargo has to be separated, stabilised, repacked or sold, and the cost of doing so is part of the claim, while the failure to do so reduces it. Preserve: the packaging, the damaged goods and the container should stay available for inspection until the claim is settled, which means resisting the urge to tidy the yard.

A file is also only read if it arrives from somebody entitled to submit it. UPS's cargo claims guidance states the rule in one line — the shipper, the consignee, or a third party with claim or title to the goods — and adds the practical consequence: insufficient documentation is treated as grounds for denial, not as a request for more.

A collapsed, torn pallet of cartons beside an intact pallet on a warehouse floor, illustrating the separation of damaged cargo

Segregating the affected pieces from the sound ones is the physical form of the evidence rule: it protects the survey, the count and the mitigation claim at the same time.

If the cargo is insured, the insurer's own documentation list is the one to build to, because the same file usually serves both recoveries. The IUMI guide to marine cargo insurance is a useful reference for what an underwriter expects, including the point that the delivery document should be claused so that it carries the protest rather than merely recording a signature.

Time windows: where claims are actually lost

This is the section where most English-language guides answer a question a shipper heading for Indonesia is not asking, because they describe a legal framework that does not apply.

Indonesia has not ratified the Hague Rules, the Hague-Visby Rules, the Hamburg Rules or the Rotterdam Rules. Cargo claims are resolved under Indonesian law — principally the Indonesian Commercial Code, the Civil Code and the Shipping Law — and the framework has features that matter operationally:

  • The burden of the defense sits with the carrier. Under Article 468, liability is presumed from the moment the carrier takes charge until the goods are handed over, so the party arguing that the loss was unavoidable, or caused by the goods themselves, has to establish it.
  • A bill of lading that declares contents, quantity or weight unknown gives the carrier a strong answer. Under Article 513, where the bill carries an "contents, condition, quantity or measurement unknown" clause, its statements on those points do not bind the carrier — unless it knew or ought to have known the nature and condition of the goods, or the goods were counted, weighed or measured in its presence. That last limb is the only one you can create yourself, and it is the reason to ask the carrier or its agent to tally what you hand over. The description on the document is therefore not paperwork; it is the foundation of the right to claim.
  • The prescription period is one year, and it does not start when the cargo reaches your gate. Under Article 741 of the Commercial Code, the one-year period for claims against the carrier runs from the vessel's arrival — or, where the vessel never arrives at the place where the goods are to be handed over, from the commencement of the carriage. A customs hold, a survey or a settlement discussion does not pause it.

Those articles are the Commercial Code itself; for how they are applied in practice the two useful commentaries are ARMA Law's analysis of cargo claims under Indonesian shipping law and the Indonesia chapter of SSEK's shipping law guide. Neither is a substitute for reading your own contract.

The complication is that a bill of lading can import convention wording by agreement, even though the conventions are not in force in Indonesia. So the same shipment can be governed by two clocks at once: the statutory one-year prescription, and a much shorter contractual notice period written into the transport document. ONE's North America claims guideline states the pattern that appears in many ocean bills — written notice at or before delivery, or within three days where the loss is not apparent — and HMM's procedure states the same shape for damage that is not visible at the door. Neither document is your contract, and neither is written for a shipment bound for Jakarta: the window that binds an Indonesia-bound cargo is the one printed in your own bill of lading.

Practical translation: the statutory window is not the one that decides your case. The one that decides it is the notice requirement in your bill of lading, and the operational version of that requirement is "same day, in writing, with photographs". A cargo damage claim filed inside the prescription period but outside the contractual notice window is answered with the contract, not with a settlement.

Concealed damage deserves its own warning. If the cartons looked sound and the contents were broken, you are arguing that the damage happened in transit while the cargo was in someone else's custody, against a document that says you accepted it in good order. That argument is winnable, but only with evidence created immediately on discovery: the packaging as found, the position of the load, photographs at the moment of opening, and written notice to the counterparty the same day.

Shortage and total loss are not damage claims

Shortage looks like the easy case and is usually the harder one, because nothing is broken and everything depends on counting.

The chain that decides a shortage is short and unforgiving: seal number → container tally at devanning → piece count against the packing list and invoice line → a written exception at the point where the count changed. Break the chain anywhere and the answer becomes "the cartons were probably short-loaded", which is a conversation with your supplier, not with a carrier.

Consolidated cargo makes this sharper. When several suppliers' cartons travel in one container, the container-level count is the only count anyone witnesses, and the per-shipper split exists only on paper. That is why consolidating cargo from multiple suppliers is really a documentation exercise: the tally taken when each supplier's cartons were received is the only record that will let a shortage be attributed to a leg rather than to a supplier.

Total non-delivery is different again. There is no condition to inspect and no count to take; the question is whether the carrier delivered what it contracted to deliver, to the party entitled to receive it, and what the bill of lading says about that. It is a contract argument from beginning to end, which is why a non-delivery claim without the original transport document, or without the party holding title, tends to stall immediately.

And one case that is neither: a customs hold is not a loss. Cargo sitting in a red channel, waiting for a document, an appraisal or a permit, is still your cargo — the customs-control row in the chain above is a change of custodian, not a disappearance. Filing a claim for it wastes the notice window and damages the relationship with the party you will need when the goods are released. Why cargo gets held at Indonesian customs covers the release path; the claim file should stay closed until there is an actual loss to describe.

The same logic applies at the last mile. A consignment delivered to a site outside Jakarta changes vehicle, changes custodian and often changes who unloads, and the delivery receipt at that gate is the document that closes the chain — or opens the gap. The difference between a Jakarta delivery and an outside-Jakarta delivery is, among other things, a difference in who signs.

What insurance changes — and what it does not

A cargo insurance policy is a second, independent contract, and it changes the cash flow of a loss without changing the evidence.

What it changes. If the cargo is insured, the insurer is the counterparty for the value, and it will handle recovery against the carrier afterwards by subrogation. That is usually faster and less adversarial than pursuing a carrier directly, and it means the file you build is read by an underwriter rather than by a claims department defending a limitation clause. Notify the insurer early — before the cargo is moved, if possible — and expect it to appoint or approve a surveyor.

What it does not change. The insurer applies its own policy: insured value, exclusions, the duty to mitigate, the treatment of salvage, and its own notice requirements. It does not accept a claim just because a carrier might be liable, and it does not remove the obligation to document. A policy also cannot conjure evidence that was never created: an insurer facing a clean delivery receipt and no photographs is in the same position as the shipper.

Running both at once is normal, and it is not double recovery — the two claims have different tests, different clocks and different defendants. The comparison between carrier liability and insurance cover — which one responds to which kind of loss — is a separate question from this page.

What to fix before the next shipment

Everything above is reactive. Most of it can be made cheap in advance, because the evidence that decides a claim is created before the claim exists.

Describe the cargo properly on the transport document. Marks, numbers, kind of package, quantity, weight — the actual figures, not a generic commodity name. This is the line on the page that matters most: it is what makes the carrier's presumption of liability bite, and it is what a clause declaring the contents unknown takes away. There is one way to defeat that clause from your side: if the carrier, or its agent, counts, weighs or measures the cargo in front of you at receipt, the unknown clause stops protecting the carrier (art. 513). Ask for it, and write down that it happened.

Pack and mark for the argument you may have to make. A carton that survives handling is also a carton that can be identified after damage, and a pallet that can be photographed and counted is a pallet whose shortage can be proved. The practical standard is in packing and palletizing cargo for sea and air freight — including the marking that lets a stranger match a carton to an invoice line.

Write down who may sign, and who may not. A receiving clerk who signs a clean receipt to get the truck out of the gate has just destroyed the claim. Name the authority, put it in the delivery instructions, and give that person the receiving sheet below.

Photograph the delivery document itself. The written exception and the signature are the evidence; a photograph of the page, taken at the dock, ends most later disputes about what was written and when.

Open one file per bill of lading. One claim, one transport document, one set of documents, one counterparty, one notice date. Mixing two shipments into one claim letter is how a clean case becomes a correspondence exercise.

The receiving sheet mentioned above is short enough to print, and it belongs in the delivery instructions rather than in a folder:

Receiving sheet — hand this to whoever meets the truck. >1. Inspect the cargo before signing anything.2. Write the exception as a description of what you can see — how many pieces, where, what condition — not as the word "damaged".3. Count every piece against the packing list while the cargo is still where it landed.4. Photograph the seal, read the number and compare it with the documents before the seal is cut.5. Photograph the cargo, the container interior and the delivery document before anything is moved.6. Sign only what you have already written, and photograph the page you signed.

What we coordinate, and what we do not

Yanchao arranges and coordinates the movement: consolidation at origin, booking, the documents that travel with the cargo, and liaison with the parties who handle clearance and delivery on the Indonesian side. We publish no claims procedure of our own, because the procedure that governs a shipment comes from the contract, the carrier and the insurer, not from the forwarder. What we can do is coordinate: tell you which party holds the contract for each leg, help the written notice reach that party, assemble the documents you already hold, and keep the Indonesian-side contacts in play while a survey or a release is being arranged. The survey, the assessment and any payment are decided by the carrier, the surveyor and the insurer — not by us.

What we do not do is decide liability, set compensation, or stand in for the carrier or the insurer. The standard that applies to a particular shipment depends on the clearance route and on the contract for each leg, which is why a figure quoted in a chat message before the documents are read is worth very little. If your question is what a specific shipment is worth, the honest answer is that it belongs to the contract, the bill of lading and the insurer — and to the scope of the service you booked, which determines which party was holding the cargo when it went wrong.

The hour at the dock is cheap. Inspect, count, photograph, write the exception, ask for the survey, and keep the packaging. Everything after that is correspondence — and correspondence is decided by what the documents said before anyone started arguing.