CAPE Portal Troubleshooting: Fix Rejected Claims, CSV Errors & ACH Issues

CBP has rejected roughly 15% of all CAPE tariff refund claims since the portal went live on April 20, 2026. That's about 8,300 rejected filings out of 55,000+ submissions in the first 10 days — representing billions of dollars in delayed refunds.

If your CAPE Declaration was rejected, or you haven't filed yet and want to get it right the first time, this guide covers every known error and how to fix it. I've compiled this from CBP's official error definitions document, the CSMS bulletins, and reports from importers and brokers who've been through the process.

Haven't started yet? Read our step-by-step CAPE filing guide first, then come back here if you hit a wall. Already know you qualify? Check your refund eligibility.

By VatCheck Research Team. Sources: CBP CAPE Declarations Error Definitions (April 2026), CSMS #68315804, CBS News, Benzinga, Baker Tilly, Future Forwarding.

The Three Validation Levels: What Happens After You Upload

When you submit a CAPE Declaration through ACE, CBP runs your file through two rounds of validation before it enters the processing queue. Understanding this pipeline saves hours of guesswork.

Round 1 — File-Level Validation The system checks the file itself: format, encoding, structure. If this fails, your entire file is rejected. You'll see errors coded with "VAL-F" (file-level fatal). Nothing in the file gets processed.

Round 2 — Entry-Level Validation If the file passes Round 1, CBP validates each entry number individually. Errors here are coded "VAL-E" (entry-level error) or "VAL-I" (entry-level informational warning). Only the affected entries fail — the rest of your Declaration can still process.

Key distinction: A file-level failure means starting over. An entry-level failure means fixing specific rows and resubmitting just those entries in a new Declaration.

File-Level Errors: Your Entire Upload Was Rejected

These kill the whole submission. Fix these first before worrying about individual entry problems.

Wrong File Format

Error: Your upload isn't recognized as a valid CSV.

Cause: Excel formatting, wrong encoding, or extraneous data.

Fix:

• File must be UTF-8 encoded CSV with no BOM (byte order mark). If you saved from Excel, this is probably your problem. Open the file in a plain text editor (Notepad++, VS Code, Sublime Text) and re-save as "UTF-8 without BOM."
• Line endings must be LF (\n), not CRLF (\r\n). Windows Excel adds CRLF by default. Most text editors can convert this — look for "EOL Conversion" in the status bar.
• The header row must match CBP's CAPE Upload Template exactly. Don't rename columns, don't add columns, don't reorder them.

File Exceeds 9,999 Entry Limit (VAL-F-004)

Error: "Declaration exceeds maximum entry count."

Cause: Your CSV has more than 9,999 entry numbers.

Fix: Split into multiple Declarations. Each CAPE Declaration file is capped at 9,999 entries. If you have 25,000 entries to claim, you'll need three separate Declarations. Each gets its own Declaration number and processes independently.

Pro tip: Group entries by liquidation status. Put your unliquidated entries in one file and your recently-liquidated-within-80-days entries in another. This makes tracking easier and lets you prioritize the entries most at risk of falling outside the 80-day window.

Missing or Invalid Header Row

Error: File validation fails immediately on upload.

Cause: The first row doesn't match the expected template headers.

Fix: Download a fresh copy of the CAPE Upload Template from CBP and use it as your starting point. Don't try to build the CSV from scratch.

Entry-Level Errors: Specific Rows Were Rejected

These are the more common problems. Your file was accepted, but individual entry numbers failed validation.

Entry Number Format Errors

Error: "Invalid entry number format."

Cause: Entry numbers that don't match the required 11-character format.

Fix:

• Format must be exactly 11 alphanumeric characters: 3-character filer code + 7-digit serial number + 1 check digit
• A single dash is optional (e.g., ABC-1234567-8 is fine, as is ABC12345678), but no other special characters
• Leading zeros matter — don't let Excel strip them. Format the column as "Text" before pasting entry numbers
• The first 3 characters must match your account's filer code. If you're filing as a broker, the filer code is yours, not the importer's

Common gotcha: Pasting entry numbers from a spreadsheet where the column is formatted as "Number" instead of "Text." Excel silently drops leading zeros and can interpret the entry number as a numeric value. Always format the entry number column as Text first.

Duplicate Tax ID Error

Error: "Duplicate tax ID — account tied to another entity."

This is the most reported error since launch, and it's the most confusing because it's not really your fault.

Cause: Your Employer Identification Number (EIN) is linked to a different ACE account than the one you're filing from. This happens when:

• A customs broker previously set up an importer sub-account using your EIN
• Your company has multiple ACE accounts (common after mergers or broker changes)
• A prior broker relationship created a ghost account tied to your EIN

Fix:

1. Log into ACE and check your account's IOR (Importer of Record) number
2. The IOR number on your account must match the IOR on the entry summaries you're claiming
3. If there's a mismatch, contact CBP's ACE Help Desk at 1-866-530-4172 (option 1) to have the duplicate resolved
4. CBP may need to merge accounts or reassign your EIN — this can take 3-5 business days
5. If you used a broker for the original entries, contact them too. They may need to file the CAPE Declaration on your behalf instead

Critical context: CBP confirmed they're actively investigating Duplicate Tax ID errors and working to resolve backend conflicts. But you shouldn't wait for a system-wide fix — call the help desk and get your specific case resolved.

Entry Not Found or Not Eligible

Error: "Entry number not found" or "Entry not eligible for CAPE Phase 1."

Cause: The entry number you submitted either:

• Doesn't exist in CBP's system (typo or wrong filer code)
• Was liquidated more than 80 days ago (outside Phase 1 window)
• Doesn't contain IEEPA duty lines (HTS 9903.01 codes)
• Is a drawback or in-bond entry type not covered by Phase 1

Fix:

• Double-check entry numbers against your customs records or your broker's entry summary reports
• Verify the entry has Chapter 99 subheading codes starting with 9903.01 — those are the IEEPA tariff lines
• If the entry was liquidated more than 80 days ago, you'll need to wait for Phase 2 (protest-based) or file a traditional protest
• Unliquidated entries and entries liquidated within 80 days are your Phase 1 targets — prioritize these

Wrong Tariff Authority Coding

Error: Entry rejected for incorrect tariff program identifier.

Cause: The entry summary references a tariff authority code that doesn't align with IEEPA duties.

Fix: CAPE specifically targets entries with IEEPA-based Chapter 99 HTS codes (subheadings beginning with 9903.01). If your entries were coded under a different tariff authority (Section 301, Section 232, etc.), they're not eligible for CAPE refunds. Those tariffs are still in effect — only IEEPA duties were struck down by the Supreme Court.

If you're unsure which tariffs applied to your shipments, use our tariff calculator to look up the current rate structure for your HTS codes. It shows which tariff layers (Section 122, Section 301, Section 232) apply to each product.

ACH and Payment Issues

Your Declaration was accepted, entries validated — but your refund isn't arriving. These are the payment-side problems.

ACH Enrollment Not on File

Error: No error shown at filing — but refund payment sits in limbo.

Cause: CBP doesn't have your banking information to send the ACH payment.

Fix:

1. Log into the ACE Secure Data Portal
2. Navigate to your Importer sub-account
3. Under "Payment Information," verify that ACH refund bank details are on file
4. If missing, add your US bank account information (routing number, account number)
5. Allow 5-7 business days for ACH enrollment to activate

Non-resident importers: This is especially common for foreign-owned businesses. You must have a US bank account for ACH refunds. CBP won't wire funds internationally. If you don't have a US banking relationship, work with your customs broker — they may be able to receive funds on your behalf (though this creates complexity around who holds the money).

ACH Payment Rejected by Bank

Cause: Closed account, incorrect routing number, or account type mismatch (trying to send to a savings account that doesn't accept ACH credits).

Fix: Update your ACH details in ACE. Most banks accept commercial ACH credits to business checking accounts. If your bank rejected the payment, CBP will typically retry once — but you should update your details proactively rather than waiting.

Timing and Expectations: When Will My Refund Actually Arrive?

The refund timeline depends on when you filed and how quickly CBP validates your Declaration.

| Filing Window | Validation Period | Processing | Expected Refund | |---|---|---|---| | April 20-30 | 2-4 weeks | 60-90 days after acceptance | Mid-July to mid-August 2026 | | May 1-15 | 1-2 weeks (less congestion) | 60-90 days after acceptance | Late July to September 2026 | | May 15+ | ~1 week | 60-90 days after acceptance | August to October 2026 |

Why the wide range? Two factors: (1) launch-week congestion pushed validation times to the longer end, and (2) CBP's "60-to-90-day" processing estimate starts after validation completes — not from the date you uploaded.

The first refunds from April 20 filings are expected to hit bank accounts around May 11, 2026. That's for importers who filed on day one, passed validation immediately, and had clean ACH enrollment.

Interest: You do earn interest on your refund. The Q2 2026 rate is approximately 5-6% annualized, compounded daily from the date you originally paid the duties. On a $500,000 refund for duties paid in mid-2025, that's roughly $25,000-30,000 in interest. CBP calculates and adds interest automatically — you don't need to request it.

What to Do If You've Been Rejected

Step-by-step recovery plan:

1. Download your validation report from ACE. It lists every entry that failed and the specific error code.
2. Sort errors by type. File-level? Fix the format and resubmit everything. Entry-level? Fix only the failing rows.
3. Create a new Declaration for the corrected entries. You can't edit a submitted Declaration — you submit a new one.
4. Resubmit promptly. There's no penalty for resubmission, but the 80-day liquidation window keeps ticking. Entries that were inside the window when you first filed could fall outside it by the time you resubmit.
5. Track your Declarations in ACE under the CAPE tab. Each gets a status: Submitted → Under Review → Accepted/Rejected → Processing → Completed.

Phase 2: What's Coming for Entries That Don't Qualify Now

Phase 1 covers unliquidated entries and those liquidated within 80 days. But what about the rest?

Phase 2 will handle entries that were fully liquidated more than 80 days ago. CBP hasn't published the Phase 2 timeline yet, but it will likely involve a protest-based process or a Post-Summary Correction (PSC) mechanism.

If your entries fall outside Phase 1 eligibility, your options right now:

• File a protest through the standard 19 USC 1514 process (180-day window from liquidation)
• Wait for Phase 2 guidance from CBP
• Consult a customs attorney if your refund exceeds $100,000 — the procedural complexity may warrant professional help

For a full breakdown of refund options beyond CAPE, see our IEEPA tariff refund filing guide.

Avoid Paying Someone 25-40% for What You Can Do Yourself

A cottage industry of "tariff refund services" has popped up since the Supreme Court ruling. Some charge 25-40% of your refund amount for what's essentially CSV formatting and ACE account navigation.

Here's the reality: if you've ever filed an entry summary or worked with a customs broker, the CAPE process is straightforward. The CSV is a single column of entry numbers. The portal is a standard ACE interface.

When professional help IS worth it:

• Your entries span multiple filer codes or broker relationships
• You have Duplicate Tax ID issues requiring CBP account reconciliation
• Your refund involves AD/CVD entries with complex duty calculations
• You're a non-resident importer without US banking
• Your total refund exceeds $1 million and the procedural risk justifies professional oversight

When it's NOT worth it:

• You have a clean ACE account, a list of entry numbers, and basic spreadsheet skills
• Your broker can pull entry numbers from their system and file on your behalf as part of their existing service
• You have fewer than 100 entries (this takes maybe 30 minutes to file yourself)

Frequently Asked Questions

Can I resubmit a rejected CAPE Declaration?

Yes. Create a new CAPE Declaration with the corrected entries. There's no limit on resubmissions and no penalty. But watch your liquidation windows — entries can fall outside the 80-day window while you're fixing errors.

What does "Duplicate Tax ID" mean in CAPE?

It means your EIN is linked to more than one ACE account. This usually happens when a customs broker set up a sub-account using your EIN. Call the ACE Help Desk at 1-866-530-4172 to resolve it. Takes 3-5 business days.

Why was my entry marked "not eligible" even though I paid IEEPA duties?

Most likely the entry was liquidated more than 80 days ago, putting it outside Phase 1's scope. Check the liquidation date in ACE. If it's outside the window, you'll need to file a protest or wait for Phase 2.

How long does CAPE refund processing take?

Validation takes 1-4 weeks depending on volume. Processing takes 60-90 days after acceptance. First refunds from April 20 filings are expected around May 11, 2026.

Do I need a customs broker to file through CAPE?

No. If you have an ACE account with the correct IOR designation, you can file yourself. The process involves uploading a CSV of entry numbers — no broker required. However, brokers can file on your behalf and may already have your entry numbers ready.

What happens if my ACH information is wrong?

Your refund will be held until correct banking information is on file. Update your ACH details in the ACE Secure Data Portal under your Importer sub-account. Allow 5-7 business days for activation.

---

Last updated: May 2026. This guide reflects CAPE Phase 1 procedures. Phase 2 guidance is expected from CBP later in 2026. For the latest official information, visit CBP's IEEPA Duty Refunds page.