{"kind":"quote","title":"Quote","version":"2.0","what":"One supplier's offer: price or price breaks, MOQ, tooling, packaging, trade term, and the buyer-side costs that come on top.","status":"live","read_by":{"tool":"landed_cost","in_input":"quotes","url":"https://www.supplychain.md/api/v1/landed_cost"},"filled_by":"The agent, from the quotes suppliers send","plugs_in_later":"Supplier agents answering requests for quotes in this format (planned, not live)","schema":{"type":"object","properties":{"label":{"type":"string","maxLength":80,"description":"The agent's label for the quote, like Supplier A. Default Quote 1, Quote 2 and so on."},"unit_price":{"type":"number","minimum":0,"description":"Price per unit, quote currency. With price_breaks it applies below the smallest break."},"price_breaks":{"type":"array","maxItems":20,"items":{"type":"object","properties":{"min_qty":{"type":"number","minimum":0,"description":"Units from which this price applies."},"unit_price":{"type":"number","minimum":0,"description":"Price per unit from min_qty up, quote currency."}},"required":["min_qty","unit_price"]},"description":"Volume prices: each unit_price applies from min_qty up. Send this or unit_price, or both."},"fx_to_home":{"type":"number","minimum":0,"description":"Home-currency amount per 1 unit of the quote's currency, the person's own rate. Default 1."},"moq":{"type":"number","minimum":0,"description":"Minimum order quantity, units. Below it the tool buys the MOQ."},"tooling":{"type":"number","minimum":0,"description":"One-time tooling or setup cost, quote currency."},"packaging_per_unit":{"type":"number","minimum":0,"description":"Packaging per unit, quote currency, when it is not in the price."},"trade_term":{"type":"string","enum":["exw","fca","fas","fob","cfr","cif","cpt","cip","dap","dpu","ddp"],"description":"The trade term on the quote; it decides which costs the buyer adds. Required. One of exw, fca, fas, fob, cfr, cif, cpt, cip, dap, dpu, ddp (the 2020 trade-term codes, lowercase)."},"mode":{"type":"string","enum":["ocean_fcl","ocean_lcl","air","express","road_ftl","road_ltl","rail","intermodal","other"],"description":"Transport mode, used to flag a sea-only term on a non-ocean mode."},"origin_charges":{"type":"number","minimum":0,"description":"Loading, export clearance and origin handling the buyer pays, home currency total for this order."},"main_freight":{"type":"number","minimum":0,"description":"Main carriage the buyer pays, home currency total for this order."},"destination_charges":{"type":"number","minimum":0,"description":"Terminal handling, unloading and delivery to the door the buyer pays, home currency total for this order."},"included_freight":{"type":"number","minimum":0,"description":"Freight and insurance inside a C or D price, home currency total for this order; used only for an fob-basis duty."},"insurance_rate":{"type":"number","minimum":0,"maximum":1,"description":"Cargo insurance premium as a share of the insured value, like 0.003; 0 when not insured."},"duty_rate":{"type":"number","minimum":0,"maximum":5,"description":"Import duty as a share of the customs value, like 0.05; 0 when duty-free or not imported."},"duty_basis":{"type":"string","enum":["fob","cif"],"description":"The destination's customs value basis, fob or cif, from the person or their broker."},"import_tax_rate":{"type":"number","minimum":0,"maximum":1,"description":"VAT, GST or sales tax at import as a share, like 0.2. Left out: no import tax assumed."},"import_tax_recoverable":{"type":"boolean","description":"true (default) when the import tax is reclaimed later: cash at import, not landed cost."},"broker_fees":{"type":"number","minimum":0,"description":"Customs broker fees, home currency total for this order."},"other_costs":{"type":"number","minimum":0,"description":"Inspection, testing and anything else, home currency total for this order."},"cash_days":{"type":"number","minimum":-365,"maximum":365,"description":"Average days the money is paid before the goods arrive; negative when paid after."},"tooling_in_customs_value":{"type":"boolean","description":"true (default) when tooling is part of the customs value."}},"required":["trade_term"],"description":"Quotes to compare, 1 to 20, each in the quote format."},"example":{"label":"Supplier A","unit_price":6.6,"moq":2000,"tooling":3000,"packaging_per_unit":0.1,"trade_term":"fca","mode":"road_ftl","main_freight":4000,"destination_charges":800,"insurance_rate":0.003,"duty_rate":0.03,"duty_basis":"fob","broker_fees":300,"cash_days":30},"example_note":"Round illustrative numbers, not market data, a price or a quote; send your own.","disclaimer":"Use at your own risk. supplychain.md is provided as is, without warranty. Information here may be inaccurate, incomplete or not current, and is not verified; figures are estimates from the numbers you send and the formulas stated. Nothing here is legal, customs, trade-compliance, tax, financial, insurance, engineering or safety advice, a quote, a rate, or an offer to buy, sell, carry, store, insure or clear goods. supplychain.md never places orders, signs contracts, pays, books freight, files customs entries or gives a quote. Check everything yourself before you act on it.","terms":"https://www.supplychain.md/terms"}