How to File a CAPE Declaration in ACE for IEEPA Refunds (Step-by-Step)

What changed: The Federal Circuit appeal (No. 26-1895, filed June 3, 2026) is now sourced to the Court of International Trade's October 8, 2026 opinion instead of a law-firm summary; description shortened.

The short answer

To file a CAPE Declaration in ACE, open the CAPE tab in the ACE Secure Data Portal, download the CAPE Upload Template, enter one 11-character entry number per row (entry numbers only, no HTS codes or duty amounts), save it as a CSV, tick the certification box, and click Upload File. One Declaration holds up to 9,999 entries. CBP recalculates the refund from its own records, assigns a CAPE claim number, and pays valid refunds by ACH within 60-90 days of acceptance. Only the Importer of Record or its filing broker can submit.

Next step:Check every deadline on one entry

In this post
  1. What is a CAPE Declaration and how do you submit one in ACE?
  2. What do you need before you can file a CAPE Declaration?
  3. Where is the CAPE tab in the ACE Portal?
  4. What goes in the CAPE CSV file?
  5. How do you certify and upload the CAPE Declaration?
  6. What happens after you upload, and how does CBP calculate the refund?
  7. How do you know if your CAPE Declaration was accepted or rejected?
  8. When do you actually get paid?
  9. What if your entries do not qualify for Phase 1?
  10. How do you file a CAPE Declaration at scale without burning the claim?
  11. Bottom line
  12. References
  13. Related resources

Your broker just handed you an ACE login and said "you can file the CAPE Declaration yourself now." You open the portal, see a CAPE tab, and freeze, because there is a seven-figure refund on the line and nobody wants to be the person who bounced a $2M claim by uploading the wrong file. The mechanics are genuinely simple once you know them, but the interface tells you nothing and CBP's own guidance is scattered across CSMS bulletins. I built the tool that sizes these claims, and the rejections trace to a short list: CBP told the Court of International Trade in October 2026 that declarations fail mainly on importer or filer mismatches, malformed entry numbers, or a CSV that does not match CBP's template. Here is the exact submission, click by click, plus how to read whether it worked.

Primary sources: CBP's IEEPA duty refunds guidance and CBP's CAPE declarations and error definitions guidance. Both are linked throughout and listed in full under References.

What is a CAPE Declaration and how do you submit one in ACE?

A CAPE Declaration is a CSV file of entry numbers you upload in the CAPE tab of the ACE Portal to request a refund of IEEPA duties, submitted by downloading CBP's template, entering your entry numbers, certifying, and clicking Upload File. CAPE stands for Consolidated Administration and Processing of Entries, the channel CBP built inside ACE after the Supreme Court struck down IEEPA tariffs on February 20, 2026. CBP launched CAPE Phase 1 on April 20, 2026, and filing a CAPE Declaration is now the only way to request an IEEPA refund. A Post Summary Correction does not trigger an IEEPA refund; CBP prohibits using a PSC for this purpose.

For a furniture portfolio, the furniture importer IEEPA refund guide distinguishes recoverable IEEPA lines from the other duty layers.

This is the how-to-submit guide, not the pre-flight checklist. If you want to validate the entry list before you upload, read How Do You File a CAPE Declaration Correctly? first. And if you do not have ACE Portal access yet, that is a different first step covered in How to Request ACE Portal Access to File an IEEPA Tariff Refund. This post starts once you are already logged in and staring at the CAPE tab.

For toys and seasonal holiday goods, the toy importer IEEPA refund guide organizes the CAPE review around the affected entry history.

What do you need before you can file a CAPE Declaration?

You need two things before a CAPE refund can reach you: an active ACE Secure Data Portal account for the Importer of Record (or a broker with portal access filing on the IOR's behalf), and ACH refund enrollment on file with CBP. Only the IOR or the filing customs broker may submit a Declaration. The ACH piece is the one people forget: CBP issues these refunds by ACH only, so if your company is not enrolled in ACH refunds, the Declaration can clear and the money still has nowhere to land. If you are the sole compliance manager at a mid-market importer, confirm ACH enrollment with your finance team this week, before you touch the CAPE tab, because enrolling after the fact only adds delay to a refund you have already earned.

Confirm why IEEPA refunds require an affirmative CAPE filing before treating an eligible entry as a submitted claim.

A quick reality check on who you are. If you are the IOR's in-house compliance manager with ACE access, you can do everything below yourself. If you are a junior broker filing for several IOR clients, the same steps apply per client, and the certification you tick attests you are legally authorized to file for that IOR. GingerControl is neither of those; its IEEPA refund service prepares the refund file, and a licensed refund partner files it.

Where is the CAPE tab in the ACE Portal?

The CAPE tab is a dedicated tab in the web-based ACE Secure Data Portal, added in the April 20, 2026 Phase 1 deployment. You reach it after logging into the ACE Portal with an account tied to the IOR whose entries you are refunding. If you do not see a CAPE tab at all, that is almost always a permissions problem on the account rather than a missing feature, and it is the access issue the ACE-access guide walks through. Once the tab is visible, everything you need sits behind its Upload button: the template download link, the Acknowledge checkbox, and the Upload File button.

What goes in the CAPE CSV file?

The CAPE CSV file holds entry numbers and nothing else, one 11-character entry number per row, under a header cell that reads Entry Number in A1. You do not put HTS codes, duty amounts, dates, or invoice values in the file. CBP pulls all of that from its own records and recalculates the refund itself; the CSV is purely a list of which entries to look at.

Here is the exact build:

  1. Download the CAPE Upload Template. Select Upload on the File Uploads subtab of the CAPE tab, then click the CAPE Upload Template link in the dialog. ACE downloads a file named ACEP_CapeEntryNumberUploadTemplate that opens in Excel with a single column headed Entry Number in cell A1 and every row below it blank. CBP's own error-definitions document describes this template.
  2. Do not touch the A1 header. If you delete or rename the Entry Number header, the file is rejected at format check. This is one of the two or three most common self-inflicted bounces.
  3. Paste your entry numbers, one per row. Each is 11 characters, alphanumeric; dashes are optional. Add nothing else. No extra columns, no notes, no duty totals.
  4. Save as CSV. Use CSV (Comma delimited) (*.csv), not .xlsx. Saving the template back out as an Excel workbook is a frequent format-check rejection.

A practical note on scale. One Declaration holds up to 9,999 entries, so if finance handed you a list of ~600 candidate entries, that is a single file. If you are past 9,999, split into multiple Declarations; there is no penalty for filing several, and each gets its own claim number.

The file is just a list, not a claim form

The single most common misread of CAPE is treating the CSV like a duty-refund worksheet. It is not. You are handing CBP a list of entry numbers and saying "recompute these without the IEEPA duty." Every HTS code, every dollar figure, every date comes from CBP's records, not your spreadsheet. If your file has more than one column, delete the extra columns before you upload.

How do you certify and upload the CAPE Declaration?

You certify and upload by ticking the certification (Acknowledge) checkbox in the Upload dialog, which enables the Upload File button, then selecting your CSV. The certification is an attestation that you are legally authorized to make the filing for that IOR, and the Upload File button stays greyed out until the box is checked, so if you cannot click Upload, look for the checkbox you have not ticked yet. After you upload, a progress bar runs and, on success, a confirmation message appears on screen. That confirmation is your first signal the file passed the format layer; it is not yet the final word on whether every entry qualifies.

For a compliance manager filing 600 entries in one shot, this whole step is under a minute. The anxiety is real but the interaction is small: check the box, pick the file, watch the bar.

What happens after you upload, and how does CBP calculate the refund?

After you upload, ACE runs two validation series and then, for the entries that pass, strips the IEEPA duty and liquidates or reliquidates. The first series is file validations, which confirm the entry numbers are complete and properly formatted, that you are authorized to submit, and that the file is intact. The second is entry-specific validations, which check each entry individually. Per CBP's current error definitions, an entry has to have a Chapter 99 IEEPA HTS line present, an acceptable liquidation status, no open or suspended protest, no reconciliation entry already on file, no drawback association, no goods value on a Chapter 99 line, and an eligible entry type (TIB type 23, duty deferral type 08, reconciliation type 09, drawback type 47 and, since July 7, 2026, warehouse types 21 and 22 are excluded), and it must be no more than 80 days past its liquidation date.

Check CAPE entry eligibility by date, code and liquidation status before including an entry in the declaration file.

If an entry fails an entry-specific validation, CBP removes that one entry from the Declaration and keeps processing the rest. For valid entries, ACE removes the dutiable IEEPA Chapter 99 code, recalculates the duty without it, and liquidates or reliquidates the entry; already-liquidated entries reliquidate the next business day. You never calculate the refund yourself, which is exactly why the CSV only needs entry numbers.

How do you know if your CAPE Declaration was accepted or rejected?

You know it was accepted when the Declaration returns a confirmation and a unique CAPE claim number, and you know an entry was rejected when ACE itemizes it and tells you why. The claim number is your tracking handle for the whole batch. Crucially, acceptance and rejection are per entry, not all-or-nothing: if you filed 600 entries and 40 fail entry-specific validation, the other 560 continue processing and only the 40 drop out, listed with their failure reasons. You do not refile the whole batch, you fix the 40 and refile just those. File-level errors are the exception: an account mismatch, a filer-code mismatch or a malformed entry number rejects the whole upload, so you fix the file and upload all of it again.

To monitor status after acceptance, CBP published a set of ACE reports specifically for tracking CAPE refund claims. Use the CAPE claim number with those reports rather than emailing your broker for updates. When an upload does bounce, do not guess at the cause; the error text is specific. The CAPE Error Decoder translates every message, and CAPE Declaration Rejected? Error Codes and How to Fix covers the re-file mechanics. Two rejections have their own dedicated fixes worth knowing about up front: FTZ Type 06 HTS mismatches (CBP split the old sequence-mismatch error into HTS RELATIONSHIP MISMATCH and INVALID HTS on June 25, 2026, CSMS #69056483) and reconciliation-flagged entries. This guide deliberately does not re-teach those; the linked posts do.

When do you actually get paid?

You generally get paid within 60-90 days after CBP accepts the Declaration, by ACH, and entries that have already liquidated often pay sooner, because they reliquidate the next business day and most deposits land 3 to 5 weeks later. CBP's guidance frames the 60-90 day window as 45 days for its own review plus Treasury processing time. The refund is ACH-only, which is why ACH enrollment is a prerequisite and not an afterthought. For a CFO who wants the money "this quarter," the honest answer is that a clean 600-entry Declaration pays out two to three months after acceptance, so one uploaded late in a quarter lands in the next one, and the single biggest accelerant is submitting a file that clears validation on the first pass instead of bouncing and restarting the clock.

The scale of what is moving is real, not theoretical. By October 2, 2026, CBP told the Court of International Trade, importers and brokers had submitted 297,887 CAPE Declarations, the 209,262 that passed the file checks covered 27.4 million entries, about $136.6 billion in refunds had been accepted for processing, and about $126 billion including interest had been certified and sent to Treasury for payment. The channel works and the people who filed clean, organized claims early are the ones getting paid.

What if your entries do not qualify for Phase 1?

If your entries do not qualify for Phase 1, the path depends on why, and for some categories CAPE is genuinely not the right channel. Let me be two-sided here, because the honest answer matters more than a clean walkthrough. Three situations fall outside the standard submission above:

One more thing worth stating plainly: the underlying refund right is not fully settled in court. The government appealed the part of the CIT's order that reliquidates all affected entries on June 3, 2026 (V.O.S. Selections, Inc. v. United States, Fed. Cir. No. 26-1895); both sides have filed their briefs, and the appeal was still pending when the CIT wrote on October 8, 2026. CBP keeps processing CAPE refunds regardless, so CAPE is the operational channel to use now, but do not assume the legal question is closed while you file.

How do you file a CAPE Declaration at scale without burning the claim?

You file at scale by getting the entry list right before you ever open the CAPE tab, because at 600 or 6,000 entries the failure mode is not the upload, it is a messy source list that bounces piecemeal and drags out the clock. The manual method above is complete and free, and for most single-Declaration filings you do not need anything else. Where it gets hard is the pre-work: pulling your ES-003 import history, isolating the entries that actually carry a Chapter 99 IEEPA code, checking each entry's liquidation status against the 80-day window, and separating the Phase 1 entries from the ones that belong in a protest or Phase 2. Do that wrong and you either miss eligible refunds or feed CBP entries that were always going to bounce.

That pre-work is where GingerControl fits, and I want to be precise about the boundary. GingerControl is trade-compliance software and consulting, not a licensed customs broker: it does not file your underlying customs entries or act as your Importer of Record. What our IEEPA refund service does is prepare the refund file: it estimates the recoverable amount from your ES-003 duty history, sorts each entry by refund route, liquidation status and protest deadline, and produces the clean entry list, and our licensed refund partner files it. It estimates the recoverable amount; it does not guarantee a refund figure or CBP acceptance, because no one honestly can. And if you want a heads-up the next time CBP changes the rules mid-stream, the way it did with the July 7 warehouse cutoff, Policy Briefings tracks CBP and Federal Register changes for you.

Try GingerControl for your IEEPA refund

If you are sitting on a stack of IEEPA entries and are not sure which ones qualify or how much you can recover, GingerControl's IEEPA refund service sizes the claim from your ES-003 history, sorts every entry by refund route and deadline and prepares the refund file, and our licensed refund partner files it. See how the IEEPA refund service works.

Bottom line

Filing a CAPE Declaration is not the hard part; getting the entry list clean is. The submission itself is a four-step build (download the template, paste entry numbers only, save as CSV, certify and upload) and CBP does the math. The real risks are the ones that quietly cost you money: an .xlsx file that bounces at format check, a renamed A1 header, an entry that finally liquidated 90 days ago and quietly aged out of Phase 1, or a company that files a perfect Declaration and then waits because it was never enrolled in ACH. Get those right, file a clean file, and a 600-entry, seven-figure claim moves through the same 60-90 day pipeline as a small one.

References

Questions people ask

How do I file a CAPE declaration in the ACE Portal, step by step?

Open the CAPE tab in your ACE Portal Importer account, select Upload on the File Uploads subtab, and download the CAPE Upload Template from the dialog. Enter one entry number per row under the Entry Number header, save the file as CSV (Comma delimited), tick the Acknowledge checkbox, then click Upload File and pick the file. Accepted plus a claim number in the CAPE File Upload History means the file passed; the Claim Status subtab then shows which entries were accepted or rejected. About 600 IEEPA entries fit in one file, since a declaration holds up to 9,999 entries.

Where is the CAPE tab in the ACE Portal, and why don't I see it in our importer account?

The CAPE tab sits in the Importer, Filer and Organizational Broker accounts of the ACE Portal, and CBP's guide notes that extra tabs can hide under the More drop-down, so check there first. If it is still missing, confirm you are in the Importer sub-account view rather than the top account, then ask your Trade Account Owner to check your user's permissions, because the TAO controls what each user can see in each sub-account. A Filer account that is not an importer filer shows the tab but says the function is not available. If your company has no Importer sub-account yet, start with our ACE Portal access guide.

Where do I get the CAPE upload template, and is it really just one column of entry numbers?

The template downloads from the CAPE Upload Template link in the Upload dialog of the CAPE tab, and yes, one column of entry numbers is by design, not a bug. CBP says it needs nothing else in the file, because ACE recalculates the duty from its own records. Keep the Entry Number header in row 1, start entries in row 2, stay within 9,999 entries and 1 MB, and save as CSV, not .xlsx. Dashes are optional. If an entry number starts with a zero, CBP says to type an apostrophe before it so the spreadsheet does not drop the zero.

I'm the importer and we used three brokers: can I file one CAPE declaration myself for all their entries?

Yes. CBP lets the importer of record file its own entries whichever broker filed them: on an Importer account ACE checks that each entry's IOR number matches the account, while the filer-code check only limits broker and filer accounts to entries they filed themselves. So 600 entries from three brokers can go on one declaration from your Importer sub-account. Two cautions. Tell all three brokers you are filing, because an entry can sit on only one accepted declaration and a repeat is rejected. And entries filed under a different IOR number or suffix need that number's own Importer sub-account.

Will the refund land in our bank account or our broker's, and do we need Form 4811?

It lands in yours unless you named someone else: CBP pays the importer of record, or the 4811 notify party the importer designated on CBP Form 4811 or in the ACE Portal and on the entry summary. You need a 4811 designation, on the form or in the portal, only if a broker or other party should receive refunds for you. Whoever receives it must enroll a refund bank account through an ACE Portal Importer sub-account, separate from the ACH setup used to pay duties. Without it CBP holds the money: as of October 2, 2026, 20,362 refunds worth about $1.1 billion were waiting on ACH details. Our Form 4811 guide covers the setup.

What do customs brokers charge to file CAPE, and is it worth doing ourselves for 600 entries?

CBP charges nothing to process an IEEPA refund, so the cost is the broker's fee. Ask whether a quote is a flat fee per entry, a flat fee per declaration, or a percentage of the refund, and compare written quotes on your own numbers: on 600 entries and about $2M of duty, a per-entry fee tracks the entry count and a percentage tracks the refund. Filing yourself mostly costs the time to build and check the list. GingerControl's IEEPA refund service sorts entries by refund route and deadline and prepares the refund file for its licensed refund partner to file, quoted for your scope, with no promised amount.

Can we just upload all our entries and let CBP work out which ones carried IEEPA duty?

You can: entries with no IEEPA line drop out with the No IEEPA HTS on Entry error while the rest keep processing. It is common. In an October 6, 2026 court declaration, CBP reported 6.2 million of 27.4 million entries failing entry checks, mainly for being past the reliquidation window, carrying no IEEPA Chapter 99 line, or being filed twice. The cost is what you cannot undo: an accepted entry cannot be removed or corrected by PSC, and reliquidation nets every other duty on it, which can produce a bill. File pending PSCs first, and leave out entries under other IOR numbers, which make ACE reject the whole file.

Our entry liquidated more than 80 days ago and CAPE rejected it: is a protest the only path now?

Not the only path, but it is the one with the shortest deadline. CAPE stops at 80 days after liquidation so CBP can reliquidate within its 90-day window (19 U.S.C. 1501), but liquidation becomes final only if no protest is filed within 180 days (19 U.S.C. 1514). File a protest by day 180 and the liquidation is not final; CBP lists protested and finally liquidated entries among those it is evaluating for later CAPE phases, without dates. CAPE Phase 3, opened October 6, 2026, covers finally liquidated entries only for Court of International Trade plaintiffs with a reliquidation order. Our CAPE vs protest vs PSC guide maps the choice.

If we file CAPE, can we still file a protest or a PSC on the same entry later?

Not a PSC, and a protest only after the entry liquidates or reliquidates. CBP's answer on PSCs or protests for entries on a CAPE declaration is no, and an accepted declaration cannot be amended, cancelled or have entries removed. So file any PSC for a non-IEEPA issue, such as a classification fix, before the entry goes on a declaration. Once the entry liquidates or reliquidates and the refund is issued, CBP says you can protest non-IEEPA issues or the refund amount, within 180 days of that liquidation. If 40 of your 600 entries have PSCs pending, hold those 40 back. Our CAPE vs protest vs PSC guide has the full decision.

Our declaration says Accepted: when does the money actually arrive?

Accepted means CAPE took the entry and removed its IEEPA duty, not that money has moved: CBP says valid refunds generally arrive within 60-90 days after acceptance. Unliquidated entries are set to liquidate 45 days after acceptance, liquidated ones reliquidate the next business day, and most deposits reach the ACH account 3 to 5 weeks after that liquidation. CBP does not email updates, so track it in ACE Reports: ES-022 links your claim, entries and refund numbers, and REV-603 moves from Sent to Treasury to Treasury Issued. Refunds are batched by liquidation date, so 600 entries can arrive as several deposits. Extended, suspended or under-review entries pay only when they liquidate.

Some entries went through and others came back 'account mismatch': what happened?

Nothing in that upload went through: account mismatch is a file-level check, so ACE rejects the whole CAPE declaration and issues no claim number, even for the entries that looked fine. It means the importer of record number on those entry summaries does not match the IOR number of the ACE Importer account that uploaded them, usually because they were filed under another IOR number or suffix, such as a subsidiary's. Download the validation result file to find them, take them out, upload the rest again as a new file, and file the removed entries from the Importer sub-account for their own IOR number. Our CAPE rejection error codes guide decodes other messages.

Does CBP pay interest on a CAPE refund, and at what rate?

Yes, interest is added automatically under 19 U.S.C. 1505, running from the day you deposited the duty to the day the entry liquidates or reliquidates. The rate is the IRS overpayment rate CBP publishes each quarter in the Federal Register: for corporations 6% through March 2026, 5% from April to June 2026 and 6% from July through December 2026, with non-corporations one point higher. It arrives inside the same deposit, not as a separate payment, and the ES-022 report splits principal from interest. At 6%, $2M of duty that sat with CBP for a year earns about $124,000, because the rate compounds daily.

Your next step

Racing a refund or protest deadline?

Hand this to GingerOS.

Get your refund claim sized and filed Check every deadline on one entry

Pick a 30-minute slot on the next page with Chen Cui, our CEO. Bring one notice or one SKU list (an ERP export, a spreadsheet or an email will do) and see what GingerOS does with it.

Reviewed by Michael Weick, LCB / CCS
Customs compliance manager with 42 years of experience (ex Subaru of America, Merck, and Motorola).

More in Trade Compliance

Our Risk-Free Promise

Full refund.

If you’re not satisfied before MVP acceptance, get a full refund of your deposit.

Click Me!

See if you qualify