# BRAINIAC Returns Delivery Promise Variance

> BRAINIAC Returns Delivery Promise Variance is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.04/call, status unknown (last checked 2026-11-12).

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.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/returns-delivery/promise-variance?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-returns-delivery-promise-variance-f1c3f7ea
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uobGqH4dueDvJKXUhepFA

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability brainiac-returns-delivery-promise-variance-f1c3f7ea -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
  
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-returns-delivery-promise-variance-f1c3f7ea/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
