{"schema":"https://ver.cy/schemas/card/1.0.0","id":"vr.tr.demurrage","code":"thing-demurrage","url":"https://ver.cy/models/thing/demurrage/","name":"demurrage","alternateNames":[],"kind":"thing","status":"published","version":"0.2.0-wave.1","language":"en","classifiers":{"family":"Thing Registry","category":"Society, people and institutions","entryKind":"noun.possession","plane":"SOC","domain":["SOC.ECO"],"industry":[],"navPath":"","tags":[],"facets":{"substance":"social","origin":"conceptual","agency":"inert","mobility":"not-applicable","scale":"not-applicable","affordances":["observable"]}},"whatItIs":"A charge payable as compensation for delaying a ship, railway wagon, container or other cargo equipment beyond the agreed free time for loading or unloading, set by charter parties, carrier tariffs and railway rules; demurrage is a major cost issue in shipping and logistics, and the term also describes a negative interest charge on holding money.","purpose":"Let an agent explain demurrage in shipping, rail and container logistics, help calculate and dispute charges in general terms, and separate the monetary sense.","scope":{"in":[],"out":[],"boundaries":[]},"distinguishingFeatures":["Delay compensation","Contractual free time","Daily or hourly rates","Shipping, rail and container contexts"],"structure":{"bundles":[{"id":"understand","name":"Understand","description":"How it works.","layers":[{"id":"mechanism","name":"Mechanism","description":"When it applies.","findings":[{"id":"mechanism-finding","name":"Mechanism","description":"Mechanism.","questions":[{"text":"When does demurrage start under this contract or tariff, and at what rate?","kind":"provenance"},{"text":"How is free time defined?","kind":"definition"}]}]},{"id":"versus","name":"Versus","description":"Demurrage and detention.","findings":[{"id":"versus-finding","name":"Versus","description":"Demurrage versus detention.","questions":[{"text":"Is this charge demurrage, detention or storage?","kind":"definition"},{"text":"Who is liable under the contract?","kind":"provenance"}]}]}]},{"id":"calculate","name":"Calculate","description":"Amounts.","layers":[{"id":"laytime","name":"Laytime","description":"Ship laytime.","findings":[{"id":"laytime-finding","name":"Laytime","description":"Laytime.","questions":[{"text":"How is laytime counted and demurrage calculated under this charter party?","kind":"action"},{"text":"Which exceptions such as weather apply?","kind":"provenance"}]}]},{"id":"container","name":"Container","description":"Container charges.","findings":[{"id":"container-finding","name":"Container","description":"Container charges.","questions":[{"text":"How much demurrage has accrued on this container, given free days and tariff?","kind":"measurement"},{"text":"Can it still be reduced by acting now?","kind":"action"}]}]}]},{"id":"manage","name":"Manage","description":"Reducing and disputing.","layers":[{"id":"reduce","name":"Reduce","description":"Avoiding charges.","findings":[{"id":"reduce-finding","name":"Reduce","description":"Avoiding charges.","questions":[{"text":"How can demurrage be avoided or reduced through planning and documentation?","kind":"action"},{"text":"Can free time be negotiated?","kind":"provenance"}]}]},{"id":"dispute","name":"Dispute","description":"Challenging charges.","findings":[{"id":"dispute-finding","name":"Dispute","description":"Disputes.","questions":[{"text":"On what grounds can a demurrage charge be disputed, in general terms?","kind":"provenance"},{"text":"Is the user asking for legal advice on a specific claim?","kind":"boundary"}]}]}]},{"id":"senses","name":"Senses","description":"Other meaning.","layers":[{"id":"money","name":"Money","description":"Monetary demurrage.","findings":[{"id":"money-finding","name":"Money","description":"Monetary sense.","questions":[{"text":"Is demurrage meant as a carrying cost on money or currency?","kind":"boundary"},{"text":"Which entry fits?","kind":"action"}]}]},{"id":"history","name":"History","description":"Origins.","findings":[{"id":"history-finding","name":"History","description":"History.","questions":[{"text":"Where does the term come from, and how has practice changed?","kind":"provenance"},{"text":"Which regulatory reforms are recent?","kind":"provenance"}]}]}]}]},"agentConduct":{"may":["Calculate demurrage from the contract terms, laytime records and stated rates.","Report free time remaining for ships, containers or wagons the user is responsible for."],"mustNot":["Alter laytime records, timestamps or statements of facts to change a claim.","Present a demurrage charge as owed without the contract or tariff that supports it.","Hide delays from a party who will be charged for them.","Advise a party on a specific dispute as if giving legal advice."],"requiresHuman":["Paying, waiving or disputing a demurrage claim.","Agreeing a settlement with a counterparty."]},"ethics":{"considerations":["Opaque charges can fall unfairly on small shippers who cannot contest them.","Delays often arise from causes outside a party's control, such as congestion or strikes."],"affectedParties":["Shippers and consignees","Shipowners and carriers","Port and terminal operators"]},"owners":{"steward":"The parties to the charter or carriage contract; the carrier issues the tariff.","roles":[],"masterSystems":[]},"relations":[{"target":"oewn-13327892-n","type":"parent","note":"registry parent class"},{"target":"charge","type":"related","note":"category"},{"target":"ship","type":"related","note":"shipping"},{"target":"costs","type":"related","note":"other charges"},{"target":"detention","type":"related","note":"related charge"}],"interaction":{"identity":{"applicability":"required","items":["Vercy registry: vr.tr.demurrage","Open English WordNet: oewn-13345449-n"]},"properties":{"applicability":"not-applicable","items":[]},"recognition":{"applicability":"optional","items":["Charges after free time expires","Daily rates in contracts","Detention applies to equipment outside the terminal","Not physical; invoices and charter party clauses."]},"capabilities":{"applicability":"required","items":["explain how demurrage arises and is calculated","distinguish demurrage from detention and storage","outline steps to reduce or dispute charges","separate the monetary sense"]},"hazards":{"applicability":"required","items":["Unexpected charges","Disputes over free time","Confusing senses"]},"interfaces":{"applicability":"required","items":["Charter party terms such as laytime clauses","Carrier tariffs and port rules","Regulatory rules on detention and demurrage such as the US OSRA 2022"]},"context":{"applicability":"required","items":["Compensating equipment owners for delay.","ship demurrage under charter parties","container demurrage at ports","railway wagon demurrage","detention (related)","monetary demurrage (separate sense)"]}},"sources":[{"title":"Open English WordNet 2024, synset oewn-13345449-n","url":"https://en-word.net/id/oewn-13345449-n","note":"sense and gloss of the concept"},{"title":"Wiktionary: demurrage","url":"https://en.wiktionary.org/wiki/demurrage","note":"word senses and usage"}],"openQuestions":["Should detention be a separate entry?","How should tariffs be linked?","How should regulations be localised?"],"resources":{"spec":"/models/things/publications/thing-demurrage/spec.json"},"provenance":{"origin":"thing registry research (pass 2)","builtFrom":["models/things/publications/thing-demurrage/spec.json"],"providers":["Claude"],"researchStatus":"unreviewed","generatedAt":"2026-09-11T15:52:29Z","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":"not-applicable","interaction.recognition":"filled","interaction.capabilities":"filled","interaction.hazards":"filled","interaction.interfaces":"filled","interaction.context":"filled","sources":"filled"},"notes":{"_gate":"Published through the thing publication gate 1.0 on 2026-10-07T12:16:27+00:00: completeness 1.00; sense: WordNet gloss; 2 live sources; review by codex: pass","interaction.properties":"Plane SOC: no invented physical properties."},"score":1.0}}