check_goods
ChatGPTUse this when the user asks whether Plain Freight can ship a product from China to the US, or what documents a product needs, before asking for a price. Records nothing. Returns instant_offer (general goods, priced at once), branded_rate (goods with a brand or trademark, priced at once on a higher rate) or person_checks_first (for example batteries, chemicals, food, cosmetics, seeds, vapes or weapons: a person reviews them before any price), with a plain explanation and what to have ready. It applies the same screen as generate_offer, so it predicts what an offer will do; it is not legal or customs advice.
check_offer_status
ChatGPTUse this after generate_offer, with its quote_id, to read the result of the second check. Returns settled (true once the check finished), possibly updated options and summary, follow-up questions whose answers change the price or customs channel, and needs_review. If needs_review is true the prices are withheld on purpose: the goods look restricted (batteries, food, chemicals) and a person must clear them first. Tell the user Plain Freight will follow up by email and do not present a number. Branded goods are never held; they are priced on the branded channel. Read-only.
estimate_price
ChatGPTUse this for a quick rough price to ship goods from China to a US address (100 g to 2,000 kg) when the user is exploring, comparing or budgeting, for example before placing a factory order. Records nothing, contacts no one and needs no email. Returns estimated door to door prices in USD for air (and sea from 10 kg chargeable weight), the chargeable weight used (the greater of actual weight and carton volume in cm3 / 6,000), transit estimates, and whether US import duty is included. Figures come from Plain Freight's pricing engine for densely packed general goods; branded goods use the branded rate, and goods that need a review get no figure. The exact ZIP code, pickup city and cartons can move the price, so when the user wants a firm number or to book, call generate_offer.
generate_offer
ChatGPTUse this when the user wants a real offer to ship goods from China to a US address, 100 g to 2,000 kg (for a rough figure while they are still exploring, use estimate_price first, which records nothing). Returns door to door prices in USD from Plain Freight's live pricing engine: each option covers freight, US customs clearance and delivery, and says whether US import duty is included (DDP) or paid at import. Provide carton dimensions when known: for light, bulky cargo the volumetric weight sets the price. Side effects: each call records a quote request with Plain Freight, and if an email is given the written offer is emailed to that address once a second check settles (at most one offer email per address per day). Call it once per shipment, not repeatedly. Nothing is booked or charged. Then call check_offer_status with the quote_id for the check's verdict.
track_shipment
ChatGPTUse this when the user has a Plain Freight tracking link and asks where their shipment is. Requires the tracking link from the booking email (https://plainfreight.com/track/<token>) or the bare token; the token is the credential, so only someone the customer shared the link with can read the record. Returns the shipment reference, the current stage on the 10-stage lifecycle (Booking through Delivered), shipment details and the dated event log. Read-only: to change a booking or ask a question, the customer emails hello@plainfreight.com with the shipment reference.
check_goods
ClaudeChecks whether Plain Freight can ship a product from China to the US, and which documents it needs. Records nothing. Input: the product description. Returns a verdict: instant_offer or branded_rate (priced at once, each on its applicable rate) or person_checks_first (for example batteries, chemicals, food, cosmetics, seeds, vapes or weapons: a person reviews the goods before any price), with a plain explanation and the documents or details to have ready. It applies the same goods screen as Plain Freight's offers; it is not legal or customs advice.
check_offer_status
ClaudeReads the result of the second check on a Plain Freight offer, by the offer's quote_id. Read-only. Returns settled (true once the check finished), possibly updated options and summary, follow-up questions whose answers change the price or customs channel, the offer email status, and needs_review. When needs_review is true, prices are withheld until a person at Plain Freight reviews the goods (for example batteries, food or chemicals), and Plain Freight follows up by email.
estimate_price
ClaudeRough price estimate for shipping goods from China to a US address, 100 g to 2,000 kg. Records nothing, contacts no one and needs no email. Inputs: total weight, and optionally the product and carton sizes or total volume. Returns estimated door to door prices in USD for air (and sea from 10 kg chargeable weight), the chargeable weight used (the greater of actual weight and carton volume in cm3 / 6,000), transit estimates, and whether US import duty is included. Figures come from Plain Freight's pricing engine for densely packed goods, priced on the applicable rate; goods that need a review get no figure. The exact ZIP code, pickup city and cartons can move the price, so the result is an estimate, not an offer.
generate_offer
ClaudePrices a real shipment from China to a US address, 100 g to 2,000 kg, on Plain Freight's live pricing engine. Returns door to door prices in USD: each option covers freight, US customs clearance and delivery, and says whether US import duty is included (DDP) or paid at import. Carton dimensions affect the price: for light, bulky cargo the volumetric weight sets it. Side effects: each call records a separate quote request with Plain Freight, and if an email is given the written offer is emailed to that address once a second check settles (at most one offer email per address per day). Nothing is booked or charged. The result carries a quote_id, by which the second check's verdict can be read.
track_shipment
ClaudeReads a booked Plain Freight shipment from its tracking link. Input: the tracking link from the booking email (https://plainfreight.com/track/<token>) or the bare token; the token is the credential, so only someone the customer shared the link with can read the record. Returns the shipment reference, the current stage on the 10-stage lifecycle (Booking through Delivered), shipment details and the dated event log. Read-only; changes to a booking go by email to info@plainfreight.com with the shipment reference.
