Skip to contentCBP PUBLISHES CAPE ERROR TABLE (April 29): CBP error table live. 80-day window risk.See every error →
Tariffs Tool

CAPE Error Codes Explained — The Complete Guide for Importers

7 min read
$250K+ Refund?

Seeing a CAPE error on a $250,000+ refund claim? Don’t guess.

The wrong resubmission routes your claim to manual CBP review — for months. Get a professional data audit before resubmitting.

Get Expert Help →

Free 15-minute consultation. Licensed customs professionals only.

CBP has now published the complete CAPE error code table for the IEEPA refund portal. Every error means something specific. Some you can fix yourself in five minutes. Some require professional data audits. Some lock entries permanently. The risk hierarchy matters: Fortune reported on April 29 that CAPE glitches "are not just delays — they are delays that can lead to ineligibility, and potentially if importers don't have appropriate counsel, can result in permanent loss of refund rights." Here is every known CAPE error, what it means, whether you can fix it yourself, and how time-sensitive each one is — with the urgency framework that decides what you do first.

Why CAPE Errors Matter More Than You Think

Quoting Fortune's reporting on April 29: CAPE glitches "are not just delays — they are delays that can lead to ineligibility, and potentially if importers don't have appropriate counsel, can result in permanent loss of refund rights."

This is not hyperbole. If your entry times out of the 80-day liquidation window while you're troubleshooting errors, that entry is gone from Phase 1. You'd need to wait for Phase 2 — which has no announced date — or sue in the Court of International Trade.

For large importers with a portfolio of entries spread across the IEEPA period, this is not a sequential queue you can work through patiently. The 80-day clock is running on every liquidated entry. Each day spent diagnosing an error is a day off that clock.

The Complete CAPE Error Code Table

CBP has published an official error message table covering every known issue surfacing in the first weeks of CAPE operation. The table below covers each error, what it actually means, whether self-fix is feasible, and how time-sensitive resolution is for Phase 1 eligibility.

Error MessageWhat It MeansCan You Fix It?Urgency
"Unable to calculate duty"Data discrepancy between your submission and CBP's original entry records — HTS mismatch, value variance, or quantity error.Requires data audit to identify exact causeHIGH
"Entry not found"Entry number doesn't exist in ACE or was entered incorrectly.Check entry number format (XX-XXXXXXX-X)Medium
"Entry already submitted"Entry appears on a previously accepted CAPE Declaration.Cannot resubmit — entry is lockedN/A
"Entry not eligible — liquidation status"Final liquidation outside the 80-day window.Wait for Phase 2 or file formal protestLow
"Entry not eligible — AD/CVD"Entry is subject to antidumping or countervailing duty order.Submit separately — manual queueHIGH
"Duplicate tax ID"ACE importer account linked to another entity's tax ID.Contact CBP directly — account issueCRITICAL
"System experiencing high volume"Portal congestion, not a data error.Retry off-peak (early AM, late PM)Low
"Declaration file format error"CSV structure issue — wrong columns, extra rows, header mismatch.Fix CSV format and resubmitMedium
"Entry not eligible — reconciliation"Entry flagged for reconciliation under 19 U.S.C. § 1484b.Excluded from Phase 1 — wait for Phase 2Low
"ACH enrollment required"Bank account not enrolled in ACE before submission.Enroll ACH in Importer sub-account, resubmitHIGH

The Errors That Kill Large Refund Claims

Three errors are most dangerous for large importers:

**"Unable to calculate duty"** — the most common error and the hardest to diagnose without ACE access. It means line-level data on your submission doesn't match CBP's original entry summary. The fix requires pulling each affected 7501 and reconciling HTS, entered value, and quantity. Self-fix without ACE visibility almost always produces another rejection or routes the claim to manual review.

**"Duplicate tax ID"** — completely blocks filing. Your importer account in ACE is linked to another entity's tax ID in CBP's backend. Resubmitting will not fix this. Resolution requires direct CBP contact and account-level remediation, often through a CBP support ticket. Until resolved, no CAPE filing of any kind is possible.

**"Entry already submitted"** — permanent. Cannot be undone. The entry appears on a previously accepted CAPE Declaration (yours or someone else's — including a broker who filed without coordination). Once an entry is on an accepted declaration, that's the only refund pathway for that entry.

What the 80-Day Clock Means for Your Errors

Every day you spend troubleshooting a CAPE error is a day off the 80-day window for liquidated entries. If an entry that was liquidated 70 days ago is showing errors and you can't fix it in 10 days, that entry falls out of Phase 1 eligibility entirely.

Urgency hierarchy:

- **Recently liquidated entries (60-80 days ago):** CRITICAL. Fix errors immediately. These are the entries most likely to age out of Phase 1 while you're troubleshooting.

- **Recently liquidated entries (1-60 days ago):** Important but with more runway. Diagnose and resolve, but you have time.

- **Unliquidated entries:** Important but more time. The 80-day window starts at liquidation, which hasn't happened yet.

- **Extended or suspended entries:** Process at liquidation, separate timeline.

For large importers with mixed liquidation timing, sort affected entries by liquidation date oldest first and fix in that order. Trying to fix all errors at once across the full portfolio is how Phase 1 entries fall through the cracks.

When to Get Professional Help

Direct guidance:

**If your refund is under $50,000 and you're seeing simple format errors** (CSV column structure, file format, ACH enrollment): fix it yourself using the CBP template. The CBP webinars on April 21 and April 28 covered these issues with concrete examples.

**If your refund is over $250,000 and you're seeing "unable to calculate duty" or "duplicate tax ID":** stop. Do not guess. Get professional help before resubmitting. The cost of a pre-resubmission audit is a tiny fraction of one percent of the refund at stake. A bad resubmission routes the claim to manual review for months and may surface compliance issues that open broader audit exposure.

**If you have entries near the 80-day window showing any errors:** treat it as an emergency. Pull those entries out of the affected declaration, prioritize them, and engage a licensed customs professional with ACE access if you don't have one in-house.

Our network specializes in CAPE error resolution for large importers. We audit your entry data, identify the exact discrepancy causing each error, and resubmit clean declarations. Free consultation for $250,000+ refund claims.

Key Takeaway

Every CAPE error means something specific. The official table is now published. Some errors are five-minute self-fixes (CSV format, ACH enrollment). Some are completely blocking until CBP intervenes ("Duplicate tax ID"). Some lock entries permanently ("Entry already submitted"). The most dangerous combination for large importers is "Unable to calculate duty" surfacing on entries close to the 80-day liquidation window — those are the entries most likely to age out of Phase 1 while troubleshooting consumes your runway. Sort by urgency, fix in order, and get professional help before any resubmission on a claim above $250,000.

Refunds this size require careful CAPE filing

CBP rejects CAPE filings for entry-mix errors, wrong tariff authority coding, bad ACH enrollment, and incorrect CSV formatting. Our network of licensed customs brokers and trade attorneys handles the entire filing — so you don't leave money on the table or get stuck behind a rejection.

Get a Free Filing Consultation →

No obligation. Licensed professionals only. Typical first-call within 1 business day.

Frequently Asked Questions

What does the CAPE "unable to calculate duty" error mean?
It means there is a data discrepancy between your CAPE submission and CBP's original entry records — typically an HTS code mismatch, entered-value variance, or quantity error at the line level. CAPE cannot automatically reconcile the difference, so the entry is pulled from automated processing. Resubmitting with the same data triggers the same error. Resolution requires pulling the original CF 7501 and reconciling each affected line, which is much faster with direct ACE access.
Can I resubmit after a CAPE declaration error?
It depends. If the entire declaration was rejected, yes — fix the discrepancy and resubmit. If the declaration was partially accepted (some entries went through, others fired errors), the accepted entries are LOCKED and cannot be resubmitted. The error entries can be filed on a new declaration after the data is corrected. "Entry already submitted" is permanent — once an entry is on an accepted declaration, that's the only refund pathway for that entry.
What happens if my CAPE errors aren't fixed before the 80-day window closes?
The affected entries fall out of Phase 1 eligibility entirely. They cannot be resubmitted under the current refund framework. Recovery options become Phase 2 (no announced date) or formal protest under 19 U.S.C. § 1514 within 180 days of liquidation. Fortune reported on April 29 that for importers without appropriate counsel, this can result in permanent loss of refund rights — particularly on entries liquidated 60-80 days ago that are about to age out.
What is the CAPE "duplicate tax ID" error?
Your importer account in ACE is linked to another entity's tax ID in CBP's backend, blocking CAPE submissions. This is an account-level issue at CBP, not a data issue you can fix in your own filing. Resolution requires opening a CBP support ticket and waiting for ACE backend reconciliation. Until resolved, no CAPE Declaration of any kind is possible. This is among the most critical errors because it gates all your filings, not just one.
How do I fix CAPE CSV format errors?
Use the official CBP CAPE Declaration CSV template, available through the ACE Portal under the CAPE tab. Common format errors: extra header rows, missing required columns, trailing whitespace, incorrect entry-number format (must be XX-XXXXXXX-X), or character encoding mismatches. Most format errors are self-fixable in minutes once you compare your file against the official template. If your template-conforming file still fires an error, the issue is data, not format.
Will CAPE errors cause me to lose my tariff refund permanently?
Possibly, on a per-entry basis. If an entry ages out of the 80-day liquidation window while you're troubleshooting an error, that entry is gone from Phase 1 — and Phase 2 has no announced date. The Court of International Trade is one alternative recovery path with its own complexity. For entries already on accepted declarations from another filer ("Entry already submitted"), the refund pathway is locked to that filer's claim. For most other errors, the refund is preserved if the discrepancy is fixed before the 80-day clock runs out.

Get alerts on CAPE portal updates and Phase 2 announcements.

We track CBP error-table updates, ACE module fixes, and Phase 2 timing so you can move at the right moment.

No spam. Unsubscribe anytime.

The CAPE refund portal is live. $166B available.

Filing has no second chances — one ineligible entry can sink an entire declaration. Estimate what you’re owed, then get help filing it cleanly.