Skip to content
Every charge traces to a tariff line in a dated contract, or the document does not render

Settlement · Documentation · Customs

A shipment system of record for
freight forwarders

Legosphere Logistics computes every charge in exact decimals against the rate contract in force on the day, cross-foots every document before a word is drafted, and refuses to render one whose figures do not tie. Tariffs, surcharges, free-time rules and duty rates are effective-dated data, so a lane is never quietly rated from an expired sheet.

  • The model writes no amounts
  • Nothing renders if it does not tie
  • Tariffs are data, not code
  • A draft until it is issued

Three surfaces

An engine, a workspace, and the regulated work beside them

One record underneath all three: it holds the shipment and its documents, the engine rates against it without being able to write prose, and the console is where a person applies judgement and issues.

The engine

The rating and settlement engine

Deterministic arithmetic, with the drafting kept outside it. Chargeable weight, tariff application, surcharge formulas, demurrage slabs and duty are computed in Python against exact decimals, and an arithmetic gate cross-foots the result before anything downstream runs. Nothing in this path is a language model, which is what makes a charge defensible when a carrier disputes it.

  • Chargeable weight by the rule the mode actually uses — 6000 on air, 5000 on courier, weight-or-measure on LCL, per box on FCL
  • Tariffs resolved by lane, mode, container type, commodity and date, with minimums and break points applied
  • Demurrage and detention as slab arithmetic over the port calendar, so free days end on the right day
  • Three exchange rates on one shipment without contradiction — the carrier tariff, the bank, and the rate notified for customs
  • Every charge records the tariff line and the dated contract that produced it

Operations managers · finance · anyone who has argued a freight invoice

The rating and settlement engine
The workspace

The shipment console

Where the judgement is applied and the document is issued. Shipments, imports with every rejected row on screen, the expected-versus-invoiced grid, the shipment file with every charge traceable to its tariff, review notes against a document, and an issuance gate that will not open early.

  • The invoice-audit grid where the variance walks to zero as a coordinator clears lines
  • Rejected import rows listed exactly as the file wrote them, with the reason each was refused
  • Click any amount on a document and see the charge line, the tariff, the contract and the row beneath it
  • Review notes raised against a document, assigned, answered and closed before anything is issued
  • A disputed surcharge that reappears on next month’s invoice is surfaced with its history

Coordinators · operations managers · customs brokers · a customer

The shipment console
The regulated half

Customs and documentation

The work that carries legal weight rather than commercial weight. Assessable value under the valuation rules, duty head by head with its notification, declarations prepared for a broker to file, and bills of lading treated as what they are — documents of title with per-original state rather than a status field.

  • Assessable value on the CIF basis, with air freight capped at 20% of FOB and insurance at 1.125% where it cannot be ascertained
  • Duty computed head by head — BCD, the surcharge on it, IGST, cess and AIDC — each carrying its notification reference
  • A classification the software proposed cannot reach a declaration until a named person confirms it
  • Issuing a bill of lading mints its originals; a second issuance is refused while any remains outstanding
  • Denied-party and vessel screening blocks a booking rather than reporting on it afterwards

Customs brokers · documentation teams · anyone whose name goes on a declaration

Customs and documentation

The specification

What it is, and what it is not

The questions that actually decide this purchase are specification questions. They are answered here rather than on a second call.

What this is

A system of record for the shipment file: customers, bookings, containers, cargo, milestones, charges, carrier invoices, declarations and the documents produced from them — with a deterministic rating engine over the top and a drafting layer that is only allowed to write prose. It is built to the way Indian forwarding and customs work actually runs, which is what fixes the rules the rest of this site describes.

What this is not

Not a customs broker, not a carrier, and not a freight rate. It does not file with the customs system, it does not issue a bill of lading on a carrier’s behalf, and it does not decide a classification — it produces the working, ties it, shows where every amount came from, and leaves the filing and the signature with the licensed person whose name goes on the document.

DomainFreight settlement, documentation and customs preparation across ocean, air, road and rail — the shipment file behind them, not the cargo itself
ArithmeticExact decimals end to end, in the database and in the browser. No floating-point number touches a charge, a weight or a duty figure at any point
TariffsRate contracts, surcharge formulas, free-time rules and duty rates are effective-dated rows from reviewed, checksummed sources. A lane with no contract in force is refused
CurrencyEvery amount carries its currency and every conversion carries its rate, its source and its effective date. An implicit conversion raises rather than resolving
The gateEvery document is cross-footed before it is drafted. A manifest whose weights do not sum, or a container whose declared mass disagrees with the computed one, is refused naming both figures
ProvenanceEvery rendered amount comes from a charge line; every line carries the tariff line and the dated contract it was rated from
IngestionParsed plus rejected plus duplicate must equal the rows submitted. Every rejected row is kept exactly as the file wrote it, with its reason
ClassificationThe software proposes a tariff heading with its reasoning and the competing headings. Nothing it proposed reaches a declaration until a named person confirms it
TenancyThe organisation is the tenant, enforced where the query is built. A read across organisations answers as though the record does not exist
IssuanceA bill of lading mints its originals when issued. A second issuance is refused while any original is neither surrendered nor voided, and the chain is auditable
EventsFree time, arrival estimates and exceptions are computed from when a thing happened, not from when the message about it arrived. The two differ by days
IntegrationThe console is one client of the API. Status messages arrive as EDI or as carrier events, and completion callbacks are signed so a receiving system can verify them

Why it is built this way

A wrong figure here is not caught at the end. It is caught at the cut-off.

Freight has an unusual property among the domains this company builds for: the deadline is physical. A manifest whose weights do not sum is rejected by the carrier’s system hours before a vessel sails, and there is no version of that problem that gets fixed next week. A container without a verified gross mass does not load. A classification that turns out to be wrong is an offence under the Customs Act rather than a correction. The software is therefore written to fail early and loudly, because the alternative is failing late and physically.

The expensive failures are quiet ones. A volumetric divisor applied to the wrong mode misprices every light, bulky consignment and looks exactly like a correct invoice. A demurrage calculation that counts a port holiday as a working day is out by one day on forty boxes. A shipment converted at "the" exchange rate produces a customs value that disagrees with the invoice it was built from, because customs assesses at a rate notified fortnightly and the bank settled at a different one. Each of those produces a number in the right shape and the wrong amount.

So the architecture is aimed at those specifically. Amounts may only reach a rendered document from a charge line, and a figure appearing in prose without one blocks the render rather than shipping. Chargeable weight is resolved by the mode’s own rule rather than by a single divisor constant. Every conversion records which rate it used and where that rate came from, so one shipment can carry the carrier’s, the bank’s and the notified rate without any of them being wrong. A lane with no contract in force on the day is refused outright instead of being rated from an expired sheet.

And a bill of lading is treated as what it is. It is a document of title: whoever surrenders an original takes the cargo. Reissuing one while a prior original is still outstanding is the oldest fraud in the trade, so originals are rows with their own state rather than a status field on a document, and the software refuses the second issuance rather than logging it.

None of that makes the shipment correct. It makes it reviewable, which is the only property software can actually give an operation this fast. The filing and the signature stay with the licensed person whose name is on the declaration.

How it works

What happens to a shipment

Five stages between a booking and an issued document, each with a rule attached. The rules are the interesting part — most exist because of a way freight work fails quietly.

  1. 01

    Take the booking

    A customer, a lane, a mode and an Incoterm, none of them defaulted. The Incoterm then decides which party bears each charge, so a cost cannot later land on the wrong invoice. Consignee, notify party and vessel are screened before the booking is accepted rather than after it moves.

  2. 02

    Ingest, and reject loudly

    Packing lists, commercial invoices, carrier invoices, gate logs and EDI status messages are parsed row by row. An unreadable row is an error naming the segment and the position, never an empty result — parsed plus rejected plus duplicate has to equal what arrived, and the rejected list is a screen rather than a log.

  3. 03

    Weigh and rate

    Chargeable weight is resolved by the mode’s own rule. The tariff is resolved by lane, container type, commodity and the date, minimums and break points applied, surcharges layered by formula. A lane with no contract in force on that date is refused rather than rated from an expired sheet.

  4. 04

    Cross-foot, or stop

    Every document is cross-footed before it is drafted. Charge lines have to sum to the stated total, cargo weights to the manifest gross, and tare plus cargo to the declared verified gross mass. If it does not tie, the job ends naming the container and the amount it is out by.

  5. 05

    Draft, review, issue

    What renders carries only amounts from charge lines. Review notes are raised against a document and have to be closed, and issuing a bill of lading mints its originals — a second issuance is refused while any is outstanding. It is watermarked a draft until it is issued.

The engine, stage by stage

What it has to satisfy

Twelve rules that constrain the software

Each one is a constraint rather than a capability, and each is written so a customer can hold the software to it. Most of them describe something it refuses to do.

  • The model never produces an amount

    A figure reaches a rendered document from a charge line or it does not appear. A number a drafting model wrote into a cargo description is a blocking error rather than a paragraph to proofread, which is the only version of this rule that survives a cut-off.

  • Nothing renders if it does not tie

    The arithmetic gate cross-foots every document and has no bypass — not a parameter, not a setting, not an exemption for one mode. A manifest that does not add up is rejected by the carrier hours before sailing, when there is no time left to fix it.

  • A document of title has per-original state

    Issuing a bill of lading mints its originals as rows with their own state. A second issuance is refused while any remains neither surrendered nor voided, and an amendment voids the prior set explicitly and audibly.

Read all twelve

Questions

What people ask first

Mostly one question in several forms: does the software decide or file anything? It does neither, and these are the mechanisms that keep it that way.

No to both, and it is built so that it cannot quietly start to. Filing a declaration is a licensed activity under the customs broker regulations, and issuing transport documents is the carrier’s act. The software prepares: it computes the assessable value and the duty head by head, produces the declaration with every figure traceable, and hands it to the licensed person who files it. The same applies to a bill of lading — it drafts and controls the document, and the issuance is a person’s decision recorded against their name.

Point it at a carrier invoice somebody signed off without reading

The useful conversation starts from a real shipment rather than from a deck: which lane you argue about most, what your last demurrage bill looked like, and how a carrier invoice actually gets checked today. Tell us that and we will tell you plainly whether this fits.

Get in touch

Talk to the people building it

No chatbot and no ticket queue. Tell us what your operation actually looks like — the modes you move, whether you clear your own customs, and roughly how many shipments a month — and someone who works on the software will reply.

info@legosphere.com

Please keep customer names, IECs, GSTINs, container numbers and commercial invoices out of this box — it is an ordinary enquiry form, not a channel for a live shipment.