Think Build Implement Repeat
London, UK +44 7367 067226
WhatsApp FOLLOW f in X
  1. Home
  2. Blog
  3. How Do We Keep Track of Green Coffee Contracts, Shipments and Arrival Dates Across Importers?
Problems We Solve

How Do We Keep Track of Green Coffee Contracts, Shipments and Arrival Dates Across Importers?

Roasters lose track of forward green contracts, shipment dates and releases. We build a contracts tracker that shows what is coming and when to call it off.

Updated 3 min readBy SpiderHunts Technologies

Free estimateNo obligation

Get a free estimate

Tell us what you need. A senior engineer reads every enquiry.

Takes under a minute. We never share your details.

  • Free consultation
  • No commitment
  • NDA on request

Prefer to talk? Book a free 30-minute call →

Quick answer — TL;DR

Green coffee is bought months ahead on contracts with different importers, held in their warehouses and released as needed, and the details live in emails and PDFs. We build a contracts tracker that records each contract, its bags, position and price, reads importer updates, and warns you when it is time to call off stock so your roast plan never waits on a delivery.

Where is the Colombian?

You bought three origins for the year from two importers back in the spring. One is sitting in the importer's UK warehouse waiting for you to call bags off. One is on the water with an arrival date that has moved twice. One is a spot purchase you forgot was only partly delivered. The details are in email threads, contract PDFs and the importer's online portal, each with its own format.

Then the house blend runs low, and the question "do we have more of this coming?" takes half an hour to answer.

Contracts live in someone's inbox

Green buying is a long cycle, and the information arrives in pieces over months: the offer, the contract, the shipping advice, the arrival notice, the release, the invoice. Each importer sends these in their own way. A small roastery has no system for this, because the volume never seemed to justify one, so it sits in the inbox of whoever does the buying.

  • Contract terms, prices and bag counts are in PDFs.
  • Shipment and arrival dates change and the update is an email.
  • Bags held at the importer are not visible alongside your own stock.
  • Warehouse storage periods and release lead times are remembered, not recorded.
  • The person who buys green is the only one who knows the position.

Surprises in the roast plan

When contracts are invisible, the roast plan gets surprises. A blend component runs out because nobody called off more bags in time. A lot sits at the importer longer than planned and picks up extra storage charges. Two contracts of similar coffees overlap and one ages in the warehouse. And the business depends on one person's inbox, which is a real problem when they are away during harvest season or at a trade show.

How the tracker works

  1. Each contract is recorded with importer, origin, lot, bag count, bag weight, price and terms. Contract PDFs are read by an extraction step and a person checks the fields before saving.
  2. Contracts carry a status: offered, contracted, shipped, landed, at importer, released, delivered.
  3. Importer emails such as shipping advice and arrival notices are forwarded to a tracker address and matched to the right contract, updating dates without retyping.
  4. Bags held at the importer are shown next to the green stock on your own floor, so the total position per coffee is one view.
  5. Using the roast plan's usage rate, the tracker estimates when each coffee will run low on your floor and prompts a call off with enough time for the importer's release and delivery lead time.
  6. Delivered bags pass straight into the green stock ledger by lot, so the contract, the arrival and the stock are the same record.
StageWhere the detail sits nowIn the tracker
ContractPDF in emailFields extracted and checked
ShipmentShipping advice emailStatus and dates updated
At importerImporter portal or memoryShown with your own stock
Call offWhen someone noticesPrompted from usage and lead time
DeliveryDelivery noteBooked into stock by lot

A buying position you can see

Anyone in the business can see what green is owned, where it is and when it is expected. The buyer spends less time chasing and more time cupping offers. Call offs happen on time. Planning next year's buying starts from a clear record of what was bought, how much was used and when it arrived, rather than a reconstruction from old emails.

Does this sound familiar?

  • Green contracts are PDFs in one person's inbox.
  • You have run low because a call off was late.
  • You are not sure how many bags you still have at each importer.
  • Arrival dates change and the roast plan finds out late.
  • Storage charges have surprised you.

FAQ

Frequently asked questions

The questions readers ask us after this guide.

Still have a question?

Ask us directly — a senior engineer will get back to you.

Ask about your project

Can it read every importer's paperwork?

It reads the common formats, and anything it is unsure of is shown to a person to confirm. We test it on a sample of your real contracts before relying on it.

Do importers need to change anything?

No. You forward what they already send, or it is picked up from a dedicated address you give them.

Does it handle currency and price fixing?

It records the contract price and currency as written. Hedging, fixing and financial decisions stay with you and your advisers.

Will it place orders with importers for us?

No. It prompts you when a call off is due. The request to the importer is still yours to send, though we can draft the email.

What affects the cost?

How many importers and contracts you run a year and whether it needs to connect to your stock and roast planning.

Keep reading

More on Problems We Solve

Start here

Tell us where the roastery admin is slowing you down

Describe how orders reach you, what you roast on and what the shop, subscriptions and wholesale side run on today. We will tell you what we would build and what we would leave alone, and if a setting in Shopify or your roast logging software would fix it, we will say so.

  1. You tell us what you needTwo minutes on the form, or a message on WhatsApp.
  2. A senior engineer reviews itAnd comes back with questions, a realistic range and an honest view on fit.
  3. Free 30-minute scoping callWe talk through scope, options and a realistic estimate — with no obligation.
Free estimateNo obligation

Talk to someone who builds this

Send a short brief and we will come back with an honest view and a realistic range.

Takes under a minute. We never share your details.

  • Free consultation
  • No commitment
  • NDA on request

Prefer to talk? Book a free 30-minute call →