Supplier Bridge v1 · quote API

Connect your factory with one HTTPS endpoint.

KernelCAD sends a reviewed manufacturing file, process, material, quantity and delivery country. Your system returns an exact quote or declines the job. KernelCAD keeps supplier selection internal and never invents a price.

Read the contract Download JSON Schema
TransportHTTPS POST + bearer token
InputSTEP, STL or DXF + job facts
OutputExact USD quote, expiry, checkout URL
Side effectsQuote only; no automatic order

A small, deterministic contract.

KernelCAD calls only configured, allowlisted suppliers. A supplier failure or decline affects only that supplier; other quote routes continue. Files are sent only after the buyer asks for a manufacturing price.

What KernelCAD sends

  • Destination country as ISO 3166-1 alpha-2.
  • Exact process, material and quantity.
  • Reviewed part dimensions and mass where available.
  • One manufacturing file, SHA-256 bound to the request.
  • A stable idempotency key for safe retries.

What the supplier returns

  • A positive integer total in USD cents.
  • The same process, material and quantity.
  • A supplier quote reference and future expiry.
  • An optional HTTPS supplier-hosted checkout URL.
  • Or a clean decline with no effect on other providers.

Request

Schema ↗
POST /v1/quotes
Authorization: Bearer <supplier-key>
Content-Type: application/json
Idempotency-Key: <64-character SHA-256>

{
  "schema": "kernelcad.manufacturing.quote.v1",
  "requestId": "64-character SHA-256",
  "destinationCountry": "DE",
  "process": "cnc",
  "material": "aluminum-6061",
  "quantity": 4,
  "part": {
    "item": 1,
    "name": "motor bracket",
    "bboxMm": { "min": [0, 0, 0], "max": [80, 50, 8] },
    "massGPerUnit": 96.2,
    "thicknessMm": null
  },
  "file": {
    "name": "motor-bracket.step",
    "kind": "step",
    "sha256": "64-character SHA-256",
    "contentBase64": "..."
  }
}

Accepted quote

HTTP/1.1 200 OK
Content-Type: application/json

{
  "accepted": true,
  "quoteId": "Q-1001",
  "totalCents": 12500,
  "currency": "USD",
  "process": "cnc",
  "material": "aluminum-6061",
  "quantity": 4,
  "expiresAt": "2026-11-18T12:00:00.000Z",
  "pricedAt": "2026-11-11T12:00:00.000Z",
  "checkoutUrl": "https://factory.example/checkout/Q-1001"
}

Decline or manual review

HTTP/1.1 200 OK
Content-Type: application/json

{ "accepted": false, "reason": "manual_review" }

Strict by design.

KernelCAD rejects ambiguous or stale supplier responses. This keeps the customer price reproducible and prevents silent material or process substitution.

01 / EXACT MATCH

No substitutions

The response must match the requested process, material and quantity exactly. Quote alternatives separately.

02 / BOUNDED

15-second deadline

A slow or unavailable supplier does not block the other providers in the quote fan-out.

03 / SAFE

Quote before order

Bridge v1 never creates an order or charges a buyer. Order and tracking access require a separate tested contract.

Onboarding

Connect a test endpoint.

  1. Send KernelCAD your HTTPS quote URL, supported processes, countries and a test bearer token.
  2. We run one quote-only test with a known STEP or STL model.
  3. We compare the response with your own quotation and confirm material mapping.
  4. After a clean test, we enable the supplier only for matching jobs.
  5. Native ordering and tracking are enabled only after a separate end-to-end test order.
Send a test endpoint Book a technical call