Förslagsstatusar
Statusar behåller gemener.
Läsa förslag
- 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
404för mjukt raderade förslag, utkast och förslag utanför ditt platsomfång. Behandla404som “inte synlig för dig”, inte nödvändigtvis “existerar inte”.
Filterreferens
Listan taroffset, 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_bystödercreatedAt,updatedAt,totalAfterTax,id,workOrderId,locationId,supplierFacilityIdochbuyerFacilityId. Utansort_by, eller med något annat värde, sorteras resultaten efteridstigande (äldst först). När du sättersort_byblirordersom standardasc, så skickaorder=descfö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 exempel08/01/2026 00:00:00. Värdet är en lokal klocktid som läses i den zon du anger itimezone, 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:00i värdet: OpenWrench ignorerar den. - Ett datum som inte kan tolkas returnerar
400medInvalid <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. timezonetar ett IANA-zonnamn, somAmerica/ChicagoellerUTC. Fasta offset (-05:00,GMT-5), förkortningar (CST) och okända namn returnerar400. Se Datumformat för sommartid.- Värden måste vara välformade. Ett icke-numeriskt id, eller ett booleskt värde annat än
trueellerfalse, kan få anropet att misslyckas med500istället för400. - Okända filter ignoreras, och tenant-avgränsningen kan inte åsidosättas:
buyerCompanyIdsätts alltid från din API-nyckel, och utkast utesluts även om du ber omstatus=draft.
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
- Leverantören skickar in ett förslag; arbetsordern pausar oftast i väntan på godkännande.
- Dina godkännare tilldelar eller avvisar det i appen. En tilldelning höjer det effektiva utgiftstaket för jobbet.
- När den slutliga fakturan anländer, jämför
invoiceTotalAfterTaxmot det tilldelade förslagetstotalAfterTaxinnan du godkänner betalning. Flagga avvikelser över din tolerans för mänsklig granskning.
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.