Offerter och förslag i Buyer API
Läs leverantörsofferter med OpenWrench Buyer API: statusar, radsektioner, avgränsningsregler och hur förslag passar in i godkännandeflödet.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
- 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”.
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 efter submittedAt och paginera med limit=25, respekterande hastighetsgränsen på 10 förfrågningar per 20-sekundersfönster.