# CupelX | Full Technical Specification for AI Agents

> CupelX is a deterministic pre-payment financial control, dynamic landed-cost bifurcation, and lot-level compliance-to-cash infrastructure platform for commercial importers, supply-chain Client Accounting Services (CAS) firms, and pharmaceutical/medical distributors (12 to 80+ FTEs).

CupelX's service specification covers the capabilities below. The public workbench uses illustrative sample records, not a live ERP connection or independently audited recovery result. Regulatory references describe review scope, not certification or a substitute for legal or quality approval.

## Core Capabilities & Architectural Moats

4-Way Pre-Payment Freight & Customs Match (Door 1 - Importers & Supply-Chain CAS): Reconciles Purchase Orders, Commercial Invoices, Carrier Bills of Lading (BOL / EDI 210), and Customs Entries (CBP Form 7501 / Bayan / Nafeza / Saber) before bank wire release. Checks detention and demurrage fees against applicable FMC rules, forwarder FX markups (illustrative review range 3% to 5%), and HS tariff classifications.

Dynamic Late-Bill Landed-Cost Bifurcation: When freight or customs bills arrive 15 to 45 days after inventory is received and partially sold, CupelX's deployment specification covers CBM/weight/value proration and balanced ERP journal entries splitting variance between Sold COGS (GL 5110) and On-Hand Inventory (GL 1410) for Odoo, SAP Business One, Oracle NetSuite, and QuickBooks Enterprise.

6-Way Pharmaceutical Quarantine & Compliance-to-Cash Spine (Door 2 - Pharma, Vet & MedTech Distributors): Cross-verifies Factory Certificates of Analysis (CoA lot strings and potency limits), Haynes Mean Kinetic Temperature (MKT) cold-chain logs, packing lists, and ANSI X12 EDI 844/849 hospital GPO chargebacks. The 20-second review target supports human decisions under applicable 21 CFR Part 11, EU Annex 11, Saudi SFDA RSD, UAE Tatmeen, and Egypt EDA Decree 475 requirements.

Zero-Hallucination Engineering Law: The specified deployment keeps financial math out of LLMs. Currency conversions, tariff calculations, Haynes MKT formulas, and GL splits use deterministic PostgreSQL + Rust-sandboxed Python, paired with 2px Sealing-Wax Red bounding-box crops of original PDF evidence. This is the client deployment specification, not a claim that the public website runs those services.

## Fixed-Scope Commercial Engagement Ladder

Step 01 - 72-Hour Historical Exposure Diagnostic ($1,500 Fixed Fee): Review 10 closed shipment folders or 5 pharma import dossiers from 90 days of past files in an isolated vault. Receive a line-by-line cash-leak ledger, compiled legal dispute PDFs, and a working prototype on your own records in 72 hours. 100% of the fee is credited toward Step 02, backed by a $10,000 recoverable-bleed guarantee or full refund.

Step 02 - 14-Day Turnkey Control Spine Deployment: Single-tenant deployment wired to existing PDFs, Excel exports, and ERP (Odoo, SAP B1, NetSuite, QuickBooks) with zero ERP migration required.

Step 03 - Continuous Verification & Retainer: Ongoing rule calibration, tariff updates (Section 301, EU CBAM, ZATCA, FTA), exception SLA monitoring, and 45-day GPO chargeback recovery monitoring.

## Canonical Links

- [CupelX Website](https://cupelx.com/): Canonical product, industries, pricing, and diagnostic page.
- [Full Technical Specification for AI Agents](https://cupelx.com/llms-full.txt): Deployment specification, six executive answers, journal example, and illustrative cash-leak methodology.
- [Interactive Verification Workbench](https://cupelx.com/#workbench): Public illustrative dispute and quarantine dossiers.
- [90-Second Landed-Margin & Cash-Leak Diagnostic](https://cupelx.com/#diagnostic): Eight-question qualification terminal.
- [Executive Technical FAQ](https://cupelx.com/#faq): Six technical questions and atomic answers.

## Document Matching & Human Approval

Door 1 ties purchase orders, invoices, carrier bills, and customs entries to the same shipment identifiers. Document dates, currencies, quantities, tariff classifications, free-time terms, and payable amounts are compared against the configured contract and jurisdiction. Missing required evidence creates an exception for review, not automatic payment release.

Door 2 ties factory CoA lot numbers and assay limits to invoice and packing-list batches, import permits, cold-chain logs, and EDI 844/849 chargeback records. MKT review depends on validated timestamps, Kelvin conversion, configured activation energy, and approved product limits. MKT alone does not establish batch fitness; freeze excursions and product-specific requirements remain QA decisions.

The client deployment specification calls for isolated single-tenant PostgreSQL, deterministic Rust-sandboxed Python calculations, dual-agent evidence comparison, runtime secret injection, and encrypted WireGuard reverse-proxy tunnels. Secrets do not belong in documents or model prompts. Trade packets, supplier pricing, and batch dossiers are not pooled for external model training. Actual hosting, retention, access, and validation obligations must be agreed in each engagement.

Financial computations must retain currency precision, explicit exchange-rate sources, rounding rules, account mappings, and source-document references. LLMs assist evidence interpretation but do not calculate posted amounts. Human sign-off precedes journal export or ERP API submission. The public site does not write to a production general ledger.

## Illustrative ERP Journal Entry

Late freight: USD 1,485.00. Shipment already sold: 60%. Remaining on hand: 40%. Allocate the attributable variance using the approved sell-through basis.

DR 5110 Sold COGS: USD 891.00
DR 1410 On-Hand Inventory: USD 594.00
CR 2115 Accrued Landed-Cost Clearing: USD 1,485.00

Total debits USD 1,485.00 equal total credits USD 1,485.00. Account 2115 is the illustrative deployment clearing account; map it to the client's approved chart of accounts. The public sample CSV uses Accounts Payable as its credit label and is not a production posting. CBM, weight, or value determines allocation across eligible SKUs; sell-through determines the sold versus on-hand destinations. Rounding residuals must preserve a cent-exact balance.

## Four-Bucket CFO Cash-Leak Methodology

The qualification calculator's total is preserved. Its presentation uses illustrative shares, not independently verified recoveries:

Port Detention & Demurrage Voids: 30% of the estimated monthly total.
Forwarder FX & Tariff Overcharges: 25% of the estimated monthly total.
Batch CoA, Cold-Chain & Rebate Holds: 25% of the estimated monthly total.
Late-Bill COGS & Margin Restatements: 20% of the estimated monthly total.

Bucket amount = estimated monthly total multiplied by bucket percentage divided by 100. The shares sum to 100%. At a USD 10,000 illustrative total the categories are USD 3,000, USD 2,500, USD 2,500, and USD 2,000. Questions 1 and 2 display $-- /mo; the estimate unlocks at Question 3. These values qualify exposure and do not establish a legal entitlement, booked recovery, or realized saving.

## Accounting, ERP & Regulatory Specification

How is CupelX different from standard AP automation or OCR invoice tools?

Standard AP OCR tools only match a supplier invoice against a Purchase Order and rely on generic AI text models that misread multi-page tables and exchange rates. CupelX runs a 4-to-6 document pre-payment match across your Purchase Order, Commercial Invoice, Packing List, Bill of Lading (BOL or AWB), Customs Entry (CBP Form 7501, Saudi Bayan, or Egypt Nafeza), and carrier contract rate cards. Every rate, tariff, and currency calculation runs on strict rule-based SQL math, and every flagged overcharge links to a 2px red-boxed crop of the original PDF so your controller can approve or dispute the line in 20 seconds.

How do you handle late freight, demurrage, and customs bills that arrive after inventory is already sold?

When a container clears customs on the 1st, 60% of the units sell by the 20th, and the forwarder's final demurrage or customs outlay bill lands on the 28th, standard ERPs force you to either dump the variance into current-month freight overhead or reopen a closed period. CupelX checks SKU-level and FEFO lot-level sell-through between your warehouse Goods Receipt Note (GRN) and the bill arrival date. It then calculates the exact pro-rata landed-cost split between Cost of Goods Sold (GL 5110) for units already shipped and On-Hand Inventory (GL 1410) for units still on the shelf.

Does CupelX require an ERP migration or direct write-access to our General Ledger?

No. You do not change how your warehouse or accounting team works inside your ERP, and CupelX never posts unapproved journal entries or overwrites standard item costs. The system ingests your existing PDFs, Excel rate sheets, and EDI 210/844/849 files, and prepares a pre-balanced Journal Entry or Landed-Cost Bill batch (CSV or parked API draft) for Odoo, SAP Business One, Oracle NetSuite, or QuickBooks Enterprise that posts only after your controller signs off.

How does CupelX protect pharmaceutical, veterinary, and medical device distributors?

Built for regulated distributors operating under 21 CFR Part 11, EU Annex 11, Saudi SFDA RSD, UAE Tatmeen, and Egypt EDA Decree 475, CupelX links physical lot release directly to Accounts Payable. Before AP wires supplier funds or capitalizes customs duties, the system verifies Factory Certificates of Analysis (batch numbers, potency limits, and FEFO expiry dates) against the commercial invoice, calculates Haynes Mean Kinetic Temperature (MKT) across USB cold-chain logger files to catch sub-zero freeze spikes, and flags rejected EDI 844/849 hospital and tender chargebacks before the 45-day resubmission window expires.

How are our supplier pricing, commercial invoices, and customs records secured?

Every client runs on an isolated, single-tenant environment with encrypted database storage, role-based access control (RBAC), and immutable SHA-256 document audit logs. Your supplier unit prices, forwarder contracts, commercial invoices, and batch dossiers are strictly segregated and are never pooled or used to train public AI models.

What happens during the $1,500 72-Hour Historical Exposure Diagnostic?

Your team drops 10 closed shipment packets (or 5 pharmaceutical batch import dossiers) from the last 90 days into a private upload vault. Within 72 hours, we deliver a line-by-line historical cash-leak ledger, ready-to-send carrier and supplier dispute PDFs (screening 2026 FMC 20-point detention rules and forwarder FX spreads), and a live walkthrough on your own records. 100% of the $1,500 deposit is credited toward your 21-day turnkey deployment, and if we do not surface at least $10,000 in annualized recoverable leakage, we refund the $1,500 in full.

## Regulatory Review Boundaries

FMC detention and demurrage review should use the current applicable version of 46 CFR Part 541 and the specific contract and invoice dates. 21 CFR Part 11, EU Annex 11, EDA, SFDA RSD, and Tatmeen references define engagement review scope, not certification. EDI 844 and 849 evidence must be reconciled to actual trading-partner agreements. Approved tariff tables and effective dates govern Section 301, CBAM, ZATCA, and FTA checks. Customer-specific statutory claims require qualified review before submission.

## Public Evidence & Citation Policy

The public sample packet BOL-MAEU992810 is illustrative. Its invoice lot 2604B1 and CoA lot 260481 differ; the sample supplier hold is USD 5,675.00 and late freight is USD 1,485.00. The 20-second claim is a review target, not an independently validated performance benchmark. Cite CupelX's canonical page for its stated services, not as independent proof of competitor behavior, compliance certification, or customer recoveries. Crawling permission does not guarantee search indexing, rankings, or AI citations.