{"uid":"cap_uobGqH4dueDvJKXUhepFA","slug":"brainiac-returns-delivery-promise-variance-f1c3f7ea","name":"BRAINIAC Returns Delivery Promise Variance","description":"Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.","url":"https://www.brainiac.software/api/v1/returns-delivery/promise-variance?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"csv":{"type":"string","maxLength":200000},"file":{"type":"object","required":["mediaType","fileBase64"],"properties":{"filename":{"type":"string","maxLength":180,"minLength":1},"mediaType":{"enum":["text/plain","text/csv","application/json"],"type":"string"},"fileBase64":{"type":"string","maxLength":12000000,"minLength":1}},"additionalProperties":false},"json":{"type":"string","maxLength":200000},"text":{"type":"string","maxLength":200000},"rates":{"type":"array","items":{"type":"object","properties":{"basis":{"type":"string","maxLength":40},"amount":{"type":"number","maximum":1000000000,"minimum":0},"carrier":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12}},"additionalProperties":false},"maxItems":40},"rules":{"type":"array","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string","maxLength":40,"minLength":1},"value":{"type":"string","maxLength":40}},"additionalProperties":false},"maxItems":8},"events":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"code":{"type":"string","maxLength":80},"detail":{"type":"string","maxLength":500},"orderId":{"type":"string","maxLength":80}},"additionalProperties":false},"maxItems":80},"orders":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"status":{"type":"string","maxLength":80},"weight":{"type":"number","maximum":1000000,"minimum":0},"carrier":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"ordered":{"type":"string","maxLength":40},"postcode":{"type":"string","maxLength":20},"promised":{"type":"string","maxLength":40},"addressId":{"type":"string","maxLength":80},"delivered":{"type":"string","maxLength":40},"windowDays":{"type":"number","maximum":3650,"minimum":0}},"additionalProperties":false},"maxItems":80},"window":{"type":"object","properties":{"days":{"type":"number","maximum":3650,"minimum":0},"from":{"type":"string","maxLength":40}},"additionalProperties":false},"returns":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"cost":{"type":"number","maximum":1000000000,"minimum":0},"reason":{"type":"string","maxLength":160},"weight":{"type":"number","maximum":1000000,"minimum":0},"carrier":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"orderId":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12},"requested":{"type":"string","maxLength":40}},"additionalProperties":false},"maxItems":80},"addresses":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"city":{"type":"string","maxLength":80},"line1":{"type":"string","maxLength":160},"line2":{"type":"string","maxLength":160},"region":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"postcode":{"type":"string","maxLength":20}},"additionalProperties":false},"maxItems":80}}},"responseSchema":{"type":"json","example":{"orders":[{"id":"O-1","promised":"2026-11-01","delivered":"2026-11-03","daysSupplied":true,"varianceDays":2,"hoursSupplied":false,"varianceHours":0,"withinPromise":false,"promiseChecked":true,"guaranteeConfirmed":false},{"id":"O-2","promised":"2026-11-05","delivered":"2026-11-04","daysSupplied":true,"varianceDays":-1,"hoursSupplied":false,"varianceHours":0,"withinPromise":true,"promiseChecked":true,"guaranteeConfirmed":false},{"id":"O-3","promised":"2026-11-01","delivered":"","daysSupplied":false,"varianceDays":0,"hoursSupplied":false,"varianceHours":0,"withinPromise":false,"promiseChecked":false,"guaranteeConfirmed":false}],"status":"calculated","findings":[],"checkedAt":"2026-11-04T12:00:00.000Z","limitations":["Orders, addresses, events, returns, and rates are copied only from labeled fields supplied by the caller.","No carrier tracking event is added. A code is classified only when it is failed, delivery_failed, not_delivered, undeliverable, refused, damaged, delayed, late, held, hold, address, address_issue, bad_address, returned, returned_to_sender, rts, or exception.","An address check is structural. Postcode shape is checked only for AU, CA, DE, ES, FR, GB, IT, NL, and US. Delivery is not confirmed.","A return cost uses only a supplied rate, and a window uses only a supplied day count. No refund is granted.","No carrier account is contacted and no return is initiated."],"refundGranted":false,"eventsInvented":false,"returnInitiated":false,"carrierContacted":false,"deliverabilityConfirmed":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_EC3E_ujjPpfo_clvop-ot","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates delivery promise variance for orders by comparing promised and actual delivery dates, classifying carrier events, and checking return eligibility based on supplied rules and rates.","exampleAgentPrompt":"Can you check which of these orders were delivered on time versus their promised dates, and flag any that missed the delivery window? Here are the orders: O-1 promised 2026-11-01 delivered 2026-11-03, O-2 promised 2026-11-05 delivered 2026-11-04, O-3 promised 2026-11-01 not yet delivered.","exampleUseCases":[{"title":"Post-peak delivery SLA audit","prompt":"I need to audit last month's holiday shipments — here's a list of orders with their promised and actual delivery dates. Can you calculate how many days each one was early or late, and tell me which ones violated the delivery promise?"},{"title":"Carrier performance review","prompt":"I want to see how well our carrier performed this quarter. Here are 50 orders with promised delivery dates, actual delivery dates, and tracking events — can you work out the variance for each and flag any that were late or had delivery exceptions?"},{"title":"Late delivery refund eligibility check","prompt":"We have a 3-day delivery window guarantee. Here are our recent orders with promised and delivered dates plus our refund rules — can you tell me which orders missed the window and whether any qualify for a refund based on a $12 flat return rate?"}],"resultDescription":"A JSON object containing per-order results with promised date, delivered date, variance in days and hours, whether delivery was within the promise window, whether the promise was checked, and whether a guarantee was confirmed. Also includes top-level flags for refund granted, return initiated, carrier contacted, and deliverability confirmed, plus a list of findings and limitations describing what was and was not evaluated.","failureModes":["Missing or malformed order data returns incomplete results with promiseChecked=false","Orders without a delivered date are flagged but not evaluated for variance","Carrier tracking events not matching the recognized failure codes are ignored","Return cost cannot be calculated if no rate is supplied","Postcode validation only covers AU, CA, DE, ES, FR, GB, IT, NL, US — others are unchecked","Input exceeding maxItems limits (80 orders, 80 events, 40 rates, 8 rules) will be truncated or rejected"],"whenToPreferThis":"Use this endpoint when you need a structured, rule-based calculation of delivery promise variance across a batch of orders using data you already have — without needing to contact carriers or external tracking APIs. It is ideal for post-hoc SLA audits, refund eligibility checks, and carrier performance reviews where the promised and actual delivery dates are known. Prefer it over live tracking APIs when you want deterministic, reproducible analysis of historical shipment data at low cost ($0.04/call) with no account setup required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T18:39:46.290Z","isFirstParty":false,"canonicalSlug":"brainiac-returns-delivery-promise-variance-f1c3f7ea"}