fni

fni is one of the estate's 317 automotive nouns — a job a car needs done. It carries 1 capability: 0 live, 1 sandbox, 0 declared · doors fi.vin.

Identity

Events

The vocabulary this noun can append to the record — 6 past-tense, versioned event types, each linked to the capability that emits it:

• Contract.captured@1 — emitted by select
• Contract.staged@1 — emitted by select
• Contract.voided@1 — emitted by select
• FiMenu.declined@1 — emitted by select
• FiMenu.presented@1 — emitted by select
• FiMenu.selected@1 — emitted by select

More actions

select

fni.select · POST /fnis/select · gate offer · sandbox · answers FniSelection@1

The gate is a 402 OFFER — the price and a hard ceiling on the wire, with a durable intent that executes on settlement. Never a wall, never "contact sales". Price: not posted — see /pricing.

Delegated calls require a typed Mandate — { ceiling, perAction, expires, tripwires }; the ceiling is a field, not a conversation.

Door — fi.vin serves this noun on its two routes: / (the landing) · /2HKRS4H79PH405443 (the VIN lens).

Try it — sandbox: every call answers a deterministic, provenance-labeled simulated payload ({ environment, simulated } in the body). Force any documented outcome with the magic triggers. Going live is a connect, never a ballot: submit the credential at integrates.vin (dealer systems) or connects.vin (consumer accounts) — submissions enter the activation queue and rank live rollout.

Emits — Contract.captured@1 · Contract.staged@1 · Contract.voided@1 · FiMenu.declined@1 · FiMenu.presented@1 · FiMenu.selected@1.

import { fni } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await fni.select({"subject":"subject"})

curl -X POST https://apis.vin/fnis/select \
  -H 'content-type: application/json' \
  -d '{"subject":"subject"}'

Receipt — the sandbox wire answered the request above with this exact body at build time. Captured by the receipts runner (timestamped, provenance in the payload), never authored; it re-executes only when this descriptor changes.

{
  "type": "OK",
  "answers": "FniSelection@1",
  "value": {
    "type": "BLOCKED",
    "reason": "financing gap insurance but missing vehicleMSRP"
  },
  "evidence": {
    "type": "BLOCKED",
    "reason": "financing gap insurance but missing vehicleMSRP"
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "fni-rail-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  },
  "connect": {
    "type": "OFFER",
    "kind": "connect",
    "reason": "CONNECTION_ABSENT",
    "portClass": "fni-administrator",
    "state": "absent",
    "url": "https://integrates.vin/connect/fni-administrator",
    "message": "fni.select is live via connection — certified, connect to activate: complete the fni-administrator link ceremony at https://integrates.vin/connect/fni-administrator. The credential vault (auth.vin) holds the token, and the same call answers simulated:false — activation is the token, never a deploy."
  }
}

Data model

The record shape behind this noun — one entity, each property an evidence field. See the whole estate model on the data model page.

FniMenu

Modeled

The noun drawn out — its record shape, its lifecycle, and how it is exercised end to end. 2 diagrams, rendered from the estate model.

Fni · Class model

Fni · Sequence

Generated from the catalog. Every capability, answer, gate, and entity on this page is a rendered descriptor — it cannot drift from the wire.