runbookify
← All plans
Order Management & Fulfillment / Order Exceptions, Holds & Fraud

Address Verification & Deliverability Check: Stop the Failed Deliveries and Reships

Import your orders, standardize and screen every ship-to address, flag incomplete, undeliverable, and PO-box cases plus residential-vs-commercial — then a clerk approves the fixes before anything ships.

BeginnerAn afternoonBuilds onNext.jsSupabaseResend
What you'll build

A web tool where you import orders, AI standardizes each ship-to address and flags incomplete, undeliverable, PO-box, and residential-vs-commercial cases, a clerk reviews and approves the corrections, and the tool exports a clean ship-to list and CSV ready to ship.

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)
  • An orders CSV with ship-to addresses
  • Your address-standardization rules / lookup table
  • Claude Code or any AI coding agent

The problem this kills

A single bad shipping address is quietly expensive. The order goes out, the carrier can't deliver it, the package bounces back, and now someone's chasing the customer, re-keying the address, paying for a reship, and eating the surcharge. Multiply that across a busy week and your "failed delivery" pile becomes a real cost — and a real headache for your CSRs and shipping team.

Most of these are preventable. The address was missing a unit number, the ZIP didn't match the city, it was a PO box on an order that ships by freight, or it was a residential address billed as commercial (so the carrier slaps on a surcharge you never quoted). Today your team eyeballs these one at a time, or finds out the hard way when the package comes back. You don't need to live like that, and you don't need to be a developer to fix it.

What you'll build

A simple internal web tool. You import your orders CSV, and the tool standardizes every ship-to address against your rules / lookup table — fixing capitalization, abbreviations, state codes, and ZIPs into a consistent format. It then screens each one and raises clear flags: incomplete (missing unit, city, state, or ZIP), undeliverable (the address doesn't resolve), PO box (a problem if the order ships by a carrier that won't deliver to one), and residential vs commercial (so you can apply the right freight surcharge before it ships, not after). Your clerk opens a worklist, reviews each flagged order, approves the corrected address or marks it undeliverable, and only then does the order move to ship. The tool exports a clean ship-to list and CSV in the exact columns your shipping 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 — which system your orders come from, exactly what your address columns are named, the standardization rules and abbreviations you use, which carriers and services you ship by (and which reject PO boxes), how you decide residential vs commercial, your typical and peak order volumes, and your messy edge cases — and then it tailors the data model, the validations, and every later step to your answers. This is not a generic template; the agent reflects a short spec back to you and waits for your thumbs-up before it builds anything. From there it walks the agent through the import, the standardize-and-flag logic, the clerk review-and-approve screen, and the clean ship-to export — each step with a ready-to-copy prompt. There's also a fallback so you can build the whole thing today even with no API to your order or shipping system.

The governance it includes (this is the point)

This is real fulfillment tooling, so it ships with the controls a shipping team needs: login so only your team can use it, row-level security so you only ever see your own organization's orders, a complete audit trail of who reviewed and approved which address changes and when, a hard human-approval gate so no corrected address is committed to your ship-to list until a clerk signs off, and duplicate guards keyed on order ID so the same order can't be processed twice. Undeliverable addresses are held and flagged for follow-up instead of silently shipping into a bounce.

Who it's for

Shipping coordinators and customer-service reps who own order exceptions and are tired of paying for reships caused by addresses that should have been caught at the door. If you can describe how your shop standardizes an address and decides what's deliverable, you can build this.

You've got this — start with the plan, paste the first prompt, answer the interview, and you'll see your flagged-order worklist take shape the same afternoon.

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.