ATIORAAudit requirements
Business requirements · plain English

An AI assistant that audits US customs entries, scores them and shows why

This page explains what the four files in the Nawal folder ask for: who it is for, what it must do, how the score is calculated, what is already built, and which decisions are still open.

CBP Form 750127 audit checksSteel & aluminumHuman sign-off
Start with the 60-second version → Try the score calculator
27
Audit checks per entry
Grouped into 3 categories
100
Points per entry
Classification 35 · Valuation 30 · Records 35
9 / 49
Entries listed / worksheet slots
No entry has been scored yet
7 / 9
ATIORA modules in the app
2 are still placeholders
8
Issues found in the worksheet
2 high · 3 medium · 2 low · 1 info
4
Conflicts between documents
N/A scoring is the big one
1
Out-of-date fee in the app
MPF min/max changed 1 Oct 2026
9
Open decisions to make
Needed before build starts
02 · THE ASK

What is being asked, in 60 seconds

If you read only one part of this page, read this.

Today, entries are audited by hand in Excel.An auditor opens each US customs entry, checks 27 things (tariff code, origin, value, duties, documents) and puts an "X" under Correct, Incorrect or Not Applicable. The sheet adds up points out of 100.
The ask: let AI do the reading and the first pass.Drop in the customs form (CBP 7501) and its paperwork (invoice, packing list, bill of lading, certificates). AI pulls out the facts, matches them with the invoice and an approved product list, and pre-fills the 27 checks.
A person always decides.A licensed customs broker or auditor reviews every finding. The AI never certifies compliance, never changes a filing, and flags anything it is unsure about as "Needs Review".
Every entry gets a weighted score, with the reasons.The score uses the worksheet's point weights. It shows exactly which checks failed, the evidence (document and page), and a portfolio view across all entries, exportable to Excel/PDF.
It sits inside a bigger app called ATIORA.ATIORA Trade Journey also manages product master data, answers trade questions, suggests tariff codes, works out landed cost and explores tariff engineering. The audit is step 8 of 9.

How the four files fit together

Each file plays a different role: today's method, what to build, and the prototype.

Today · manual method

Audit Metrics Worksheet

Excel sheet with 27 checks, point weights and formulas for up to 49 entries. It is the source of the scoring rules.

CHB RS&C Audit Metrics Spreadsheet.xlsxLabelled "Privileged Internal"
Target · what to build

AI Audit Tool Overview

Word spec: how the AI audit should work, scoring rules, master data, screens, controls, rollout and open decisions.

AI_Customs_Entry_Audit_Tool_Overview.docx
Prototype · already built

ATIORA Trade Journey

A web app built with Claude, with 9 tabs. The PDF and Markdown files are exports of it; the PDF shows only the first tab.

ATIORA Trade Journey (Copy) (1).md · …#master.pdf
03 · GLOSSARY

Words you will see, explained simply

Customs work is full of acronyms. Search or filter below.

04 · PROBLEM & GOALS

Why this is being built

The problem today

  • Each entry is checked by hand against piles of PDFs, which is slow and depends on the auditor.
  • The worksheet records only an X per check, with no evidence, page reference or reason.
  • Formula errors mean some scores never appear (see Review findings).
  • There is no audit trail of who changed what, and no link to an approved product/tariff list.
  • Tariff rules change often (2026 alone saw IEEPA tariffs struck down, Section 122 come and go, and new Section 301 duties), so manual checks go stale fast.

What success looks like

1
Faster audits
AI reads and groups documents, so auditors only review.
2
Every check answered or flagged
All 27 checks are either decided with evidence or marked "Needs Review". Missing evidence never counts as correct.
3
One agreed scoring rule
The same weights and N/A handling everywhere: sheet, spec and app.
4
Traceable findings
Each error shows the 7501 value, the document value, the master-data value and the page it came from.
5
Portfolio insight
Error totals per check and score trends across all entries and importers.
05 · WHO IS INVOLVED

Users and stakeholders

Roles inferred from the spec. Names and owners still need to be assigned.

06 · SCOPE

The ATIORA journey: 9 modules

Status is based on the exported page text. The live app was not tested. The highlighted module is the audit this spec is about.

In scope

  • Auditing US formal entries (CBP 7501) and their entry packets
  • All 27 worksheet checks with their point weights
  • Matching lines to an approved product / HTS master file
  • Entry and portfolio scoring, findings, export
  • Planning modules: trade chat, HTS finder, landed cost, tariff engineering

Out of scope (for now)

  • Filing or amending entries with CBP automatically
  • Binding classification decisions or legal advice
  • Live tariff-database lookups inside the chat (the app says Claude doesn't do this)
  • Generating shipping documents and customs declarations (placeholders, future)
07 · HOW AN AUDIT WORKS

From upload to report in six steps

From section 2 of the spec. Teal steps are done by the system; gold steps need a person.

Upload the entry packet

The 7501 plus invoice, packing list, bill of lading, PO, certificates and agency documents. Several entries at once, by drag-and-drop or ZIP.

Auditor

Extract the facts

Document recognition reads the 7501 fields and packet details. Text PDFs and scans both work. The original document, page number and extracted evidence are kept.

AI

Group & reconcile

Files are grouped by entry number, invoice, PO, shipment reference, importer and line item. Missing or unclear matches are flagged for the user to resolve.

AI Auditor resolves doubts

Compare against the 27 checks

Each check is compared with the documents, validated tariff and agency reference data, and the approved product master file. Fixed rules handle arithmetic, exact HTS matches, field presence and dates; AI handles reading, matching and explaining.

Rules + AI

Mark each check

Correct Incorrect Not applicable Needs review, each with a confidence level. Low confidence shows an amber border.

AI proposes Reviewer confirms

Score, review, report

The weighted score is calculated, a person reviews it, corrective actions are recorded, and the audit report is exported. Hard or low-confidence cases go to a licensed broker.

Licensed broker / auditor
08 · SCORING MODEL

How an entry is scored. Try it.

All 27 checks with their real point weights from the worksheet. Mark each one and watch the score change under both rules that exist today.

Why two scores? The worksheet and the app give "Not applicable" its full points. The Word spec instead removes it from the total. In the spec's own example (10 points N/A, 10 points wrong) that is 90.0 vs 88.9. Someone needs to pick one (see Open decisions).
—
Worksheet & app rule
N/A = full points, ÷ 100
—
Word spec rule
N/A removed from total
Status—
—
What is driving the score

The spec says the exact failures must always be shown next to the number.

09 · FUNCTIONAL REQUIREMENTS

What the system must do

Gathered from the Word spec, the ATIORA app and the worksheet, then given IDs and priorities. Priorities are a proposal (MoSCoW) to agree with the owner.

10 · NON-FUNCTIONAL

How well it must do it

Quality, safety and compliance rules. Most come from section 6 of the spec. Items marked gap are not visible in the current app.

11 · DATA REQUIREMENTS

What information the system keeps

Product master record

One approved, versioned row per importer + item. Used as the "expected answer" for classification.

importersku / item_nodescriptionsupplier / manufacturercountry_of_originhts_10_digit (approved)effective_from / toruling / referencetrade_programagency_attributesapproval_statusversionvalue (app)

The app's upload currently asks for: item number, country of origin, manufacturer, value, description, HTS code.

Entry packet (input)

What is read from the 7501 and its supporting documents.

entry_numberentry_typelive_indicatorimporter_of_recordcountry_of_exportcountry_of_originmidhts_linesch99_linesentered_valuecurrencyndc / additionsduty / mpf / hmfadcvd_caseinvoice_nopo / shipment_refdoc + page refs

Finding record (output)

Saved for every exception, with full traceability.

criterionweightentry / linevalue_on_7501value_on_documentvalue_in_masterevidence_citationconfidencereviewer_decisioncorrective_actionownertimestampstariff_version_used
Audit header fields from the worksheet: Auditor and branch name, Audit month and date, and Auditor feedback / comments per entry. The app's AI Audit tab already captures the first two.
12 · SCREENS

The five portal screens in the spec

Compared with what the app export shows today.

13 · ROADMAP

Rollout in phases

Phases 1–3 come from the spec. Phase 0 is added so the open decisions are made first.

PHASE 0 · DECIDE

Agree the rules

  • Pick the N/A rule and category weights
  • Set minimum evidence for Correct / N/A
  • Name the master-data owner
  • Fix worksheet formulas so the baseline is right
  • Update MPF defaults
PHASE 1 · PILOT

Audit end to end

  • Upload many 7501s + packets
  • Extract data, reconcile lines
  • Apply all 27 checks and weights
  • Provisional and final scores
  • Export findings
PHASE 2 · MASTER DATA

Approved product list

  • Approved product / HTS records
  • Effective-date controls
  • Classification exception workflow
  • Importer-specific rules
PHASE 3 · SCALE

Automate & analyse

  • Automatic intake from brokerage systems
  • Batch processing, reviewer assignment
  • Dashboards and trend analytics
  • Continuous checks against current tariff sources
14 · REVIEW FINDINGS

What I found checking the files

From reading every formula in the worksheet and comparing the three documents.

15 · OPEN DECISIONS

What needs an answer before building

The first four come from section 8 of the spec; the rest come from this review.

16 · SOURCES

Where this comes from

Files in the Nawal folder

  • CHB RS&C Audit Metrics Spreadsheet.xlsx: one sheet, 27 criteria, 49 entry blocks, last modified 4 Nov 2026
  • AI_Customs_Entry_Audit_Tool_Overview.docx: functional overview and scoring method
  • ATIORA Trade Journey (Copy) (1).md: text export of all 9 app tabs
  • https-claude.aiartifact…#master.pdf: print of the app's Master Data tab

External checks

Sheet —Spec ——Details ↓