Hoppa till huvudinnehåll
När arbete behöver prissättas innan det fortsätter skickar leverantörer in förslag (offerter) mot arbetsordern. Via Buyer API är förslag skrivskyddade: du listar dem, inspekterar rader och stämmer av dem mot fakturor. Att godkänna eller avvisa ett förslag sker i OpenWrench-appen. Alla exempel förutsätter:

Förslagsstatusar

Statusar behåller gemener.

Läsa förslag

Avgränsningsregler värda att känna till:
  • Leverantörers ej inskickade utkast utesluts alltid från listor.
  • Om din API-nyckels kontakt är platsbegränsad ser du bara förslag för tillgängliga platser. En kontakt med en tom tillgänglig uppsättning får en tom sida, inte ett fel.
  • Den enskilda läsningen returnerar 404 för mjukt raderade förslag, utkast och förslag utanför ditt platsomfång. Behandla 404 som “inte synlig för dig”, inte nödvändigtvis “existerar inte”.

Filterreferens

Listan tar offset, limit (standard 10, max 25), sort_by och order, plus filtren nedan. Filter kombineras med AND och kombineras alltid med din nyckels tenant- och platsavgränsning. Det finns ingen räkningsslutpunkt: listsvarets count är det totala antalet träffar, så begär limit=1 när du bara behöver antalet.
Regler för filtervärden:
  • Sortering. sort_by stöder createdAt, updatedAt, totalAfterTax, id, workOrderId, locationId, supplierFacilityId och buyerFacilityId. Utan sort_by, eller med något annat värde, sorteras resultaten efter id stigande (äldst först). När du sätter sort_by blir order som standard asc, så skicka order=desc för nyast först.
  • Listor tar kommatecken utan mellanslag. En nyckel i singular (status) tar ett värde; nyckeln i plural tar en kommaseparerad lista. Ett mellanslag efter ett kommatecken kan få anropet att misslyckas.
  • Datum använder MM/dd/yyyy HH:mm:ss, till exempel 08/01/2026 00:00:00. Värdet är en lokal klocktid som läses i den zon du anger i timezone, eller i UTC om den saknas. Tiden är obligatorisk. Startgränsen är inkluderande från den tid du skickar. Slutgränsen täcker hela slutdagen i den zonen: OpenWrench ersätter dess tid med 23:59:59. URL-koda värdet. Lägg inte till en offset som -05:00 i värdet: OpenWrench ignorerar den.
  • Ett datum som inte kan tolkas returnerar 400 med Invalid <key>. Expected format MM/dd/yyyy HH:mm:ss. Det gäller även ISO 8601-värden (2026-10-09T00:00:00), datum utan tid (10/09/2026) och värden som bara består av mellanslag. OpenWrench läser fortfarande ett tomt värde som 1 januari 1970.
  • timezone tar ett IANA-zonnamn, som America/Chicago eller UTC. Fasta offset (-05:00, GMT-5), förkortningar (CST) och okända namn returnerar 400. Se Datumformat för sommartid.
  • Värden måste vara välformade. Ett icke-numeriskt id, eller ett booleskt värde annat än true eller false, kan få anropet att misslyckas med 500 istället för 400.
  • Okända filter ignoreras, och tenant-avgränsningen kan inte åsidosättas: buyerCompanyId sätts alltid från din API-nyckel, och utkast utesluts även om du ber om status=draft.
Om du vill matcha en lokal dag skickar du samma datum för båda gränserna tillsammans med din zon. Den här förfrågan returnerar förslag som tilldelades den 9 oktober 2026, Central time:

Inuti ett förslag

Pengarna delas in i samma sektioner som fakturor: laborLineItems, materialLineItems, travelLineItems, freightLineItems och miscLineItems, varje sektion med sin egen skattesats och ...TotalBeforeTax, som rullar upp till totalBeforeTax, tax och totalAfterTax. Monetära värden serialiseras som strängar; parsa dem som decimaler, inte flyttal, om du gör aritmetik. Andra användbara fält: workOrderId, supplierFacilityId, workOrderNTEBeforeApproval (arbetsorderns ej-överskridande-belopp vid inlämningstillfället), proposalPdfLink, attachments, submittedAt och approvedAt.

Var förslag passar in i flödet

  1. Leverantören skickar in ett förslag; arbetsordern pausar oftast i väntan på godkännande.
  2. Dina godkännare tilldelar eller avvisar det i appen. En tilldelning höjer det effektiva utgiftstaket för jobbet.
  3. När den slutliga fakturan anländer, jämför invoiceTotalAfterTax mot det tilldelade förslagets totalAfterTax innan du godkänner betalning. Flagga avvikelser över din tolerans för mänsklig granskning.
En praktisk pollningsloop för en inköpsdashboard: filtrera status=pending, sortera med sort_by=createdAt&order=desc och paginera med limit=25, respekterande hastighetsgränsen på 10 förfrågningar per 20-sekundersfönster.