runbookify
← All plans
Field Service & Dispatch / Parts & Truck Stock

Parts Cross-Reference & Supersession Lookup: Order the Right Current Part the First Time

Build a lookup that turns any OEM part number into your current SKU, follows the supersession chain (this part now replaces that one), and lists approved substitutes — so techs and buyers stop ordering dead, wrong, or out-of-date parts.

IntermediateA weekendBuilds onNext.jsSupabaseResend
What you'll build

A web tool where you type any part number — OEM, old, or yours — and it returns the matched current SKU, the full supersession chain (A→B→C), and approved substitutes marked exact vs functional. A parts lead approves every new cross-reference and supersession before it goes live, and the whole mapping table exports to CSV.

Gated download

Enter your email — the plan downloads instantly and a copy lands in your inbox.

By submitting your email you'll also receive the weekly runbookify newsletter. You can unsubscribe at any time.

Before you start

  • A Supabase account (free)
  • A Vercel account (free)
  • A Resend account (free)
  • A CSV or Google Sheet of your parts catalog, OEM cross-references, and supersession/substitute lists
  • Claude Code or any AI coding agent

The problem this kills

A tech radios in an OEM part number off a nameplate. A buyer types an old number into the PO. And nobody's quite sure: is that part still made? Did it get superseded twice? Is there an approved substitute that's actually in stock? So someone orders the number on the page — and a week later finds out it's obsolete, replaced by a different SKU, or that the "equivalent" they grabbed doesn't actually fit. The job stalls, the truck rolls twice, and the part gets returned (if you're lucky).

The cross-reference knowledge lives in a senior buyer's head, a vendor PDF, and three spreadsheets that disagree with each other. The fix is a single lookup that everyone trusts: enter any number — OEM, an old superseded one, or your own SKU — and get back the current SKU, the chain of supersessions that led to it, and the substitutes you're allowed to use. The hard part isn't the search box. It's keeping the mappings clean: following supersession chains all the way to the live part, telling an exact replacement apart from a "close enough" functional one, and making sure a human signs off before a new cross-reference goes live. You do not need to be a developer to build this.

What you'll build

A simple internal web tool for your parts team. You import your parts catalog, your OEM cross-reference data, and your supersession/substitute lists from CSVs or Google Sheets. Then anyone can type any part number into one box and get back: the matched current SKU, the full supersession chain (A→B→C, following it all the way to the part that's actually available), and the approved substitutes for that part — each marked exact or functional. Obsolete / no-longer-available parts are clearly flagged so nobody orders a dead number. Before any new cross-reference or supersession goes live in the lookup, a parts lead reviews and approves it. The whole mapping table exports to CSV in the columns your ordering system expects.

What's inside the Implementation Plan

The downloadable plan is a step-by-step file you paste into an AI coding agent. It opens by interviewing you about your business — how techs and buyers look up parts today, the systems and sheets you pull from, your real SKU and OEM part-number formats, how you record supersessions and substitutes now, your typical and peak lookup volumes, who's allowed to approve a new cross-reference, and the messy edge cases like one OEM number that maps to several of your SKUs, a supersession chain that loops or dead-ends, and parts that are superseded and obsolete. It reads a short spec back to you for a thumbs-up, then builds the tool around your catalog and rules instead of a generic template. From there it walks the agent through the data model, the import flows, the chain-following lookup engine, the exact-vs-functional substitute logic, the parts-lead approval gate, the obsolete flags, and the CSV export. Every step ends with a ready-to-copy prompt.

The governance it includes (this is the point)

This isn't a toy. The plan builds in the controls a real parts function needs: login so only your team can use it, row-level security so people only see their own organization's catalog and cross-references, a complete audit trail of every cross-reference added, superseded, substituted, approved, or exported (who, what, when), a hard human-approval gate so no new cross-reference or supersession enters the live lookup until a parts lead signs off, and duplicate guards — a unique key on (source number + catalog SKU) plus a dedupe check on every import — so the same mapping can't be entered twice or contradict itself. The tool exists to make a careful human decision easy: AI proposes the mapping and resolves the chain; a person approves it before techs can rely on it.

Who it's for

Parts coordinators, buyers, and technicians who are tired of ordering a part only to learn it's been superseded twice, and senior buyers who want the cross-reference knowledge out of their head and into a tool the whole team can trust. If you can describe how you name a SKU and how you track that one part now replaces another, you can build this.

You've got this — open the plan, paste the first prompt, and you'll be looking up your first real supersession chain by the end of the weekend.

Gated download

Enter your email — the plan downloads instantly and a copy lands in your inbox.

By submitting your email you'll also receive the weekly runbookify newsletter. You can unsubscribe at any time.