What the calculator checks before you upload
From the entry type, liquidation status and date, and the optional protest and reconciliation columns, the refund calculator flags: Entry Type Not Allowed (08, 09, 23, 047 and warehouse 21/22), Protest on Entry, Recon Already Filed, Entry Summary is in Final Liquidation Status (more than 80 days), type 03 AD/CVD as a warning, and No IEEPA HTS on Entry by simply not listing entries without a 9903.01 / 9903.02 line. The CAPE File Pack then writes the CSV to the file rules: “Entry Number” header, 11 characters without dashes, apostrophe before a leading zero, no duplicates, at most 9,999 entries and under 1 MB per file.
File validation errors (CBP table)
| Error message | CBP definition | Here |
|---|---|---|
CSV content is empty or missing the header | CSV needs Entry Number header and at least 1 entry number | Our CAPE file starts with the “Entry Number” header line. |
Not a CSV file | File format must be CSV | Save as .csv, not .xlsx. |
The file size exceeds 1mb | File size cannot be more than 1mb | We split at 1 MB automatically. |
The file is deemed unsafe | Resave file and upload again | Plain text only — no formulas or macros. |
The file exceeds the maximum 10,000 allowed entry numbers per file | If you have more than 10,000 entry numbers, submit multiple CSV files uploads | We split at 9,999 entries (the CAPE Declaration limit). |
Filer Code not matching | For Filer and Organizational Broker, first 3 characters of Entry Number must match Filer Code of account | Brokers: file under the filer code that filed the entries. |
Duplicate Entry | CSV file has duplicate Entry Numbers | Duplicates are removed when the file is built. |
Not 11 characters long | Entry Number must be 11 characters without dashes | NNN-NNNNNNN-N becomes NNNNNNNNNNN; a leading zero gets an apostrophe. |
Account Mismatch | Importer of Record Number must match Importer of Record Number of Entry Summary | Only the IOR or the filing broker can file — see “Not the IOR?”. |
Entry Summary Not Found or Archived in ACE | Entry Summary must exist in ACE | Pre-ACE or archived entries are on CBP’s later-deployment list. |
Entry validation errors (CBP table)
| Error message | CBP definition | Here |
|---|---|---|
Entry on Drawback | Entry cannot be on a drawback entry | Blocked in the pre-check when a drawback flag is present; CBP lists these for a later deployment. |
Recon Already Filed for Entry Summary | Entry has Reconciliation entry on file and is currently not allowed for CAPE processing | Blocked when the recon column says a type 09 is on file (CSMS #69035485). |
Entry Summary is Cancelled/Rejected | Entry summary status must be “Accepted” | Not visible in ES-003; check the entry status with your broker. |
Entry Summary is in Final Liquidation Status | Entry summary liquidated/reliquidated more than 80 days ago | Blocked: the calculator counts days from the liquidation date to today. |
Entry Summary is in Trade Control | Control status for the entry summary must be with CBP | Not in ES-003. |
Entry Summary is Subject to Court Injunction | Entry summary cannot be flagged for injunction | Not in ES-003. |
Entry Summary Pending Liquidation or Not Liquidated and Has Suspension Record | Liquidation status “Pending” or “Not Liquidated” and has a Suspension record | Suspended entries are accepted and keep their status; a pending + suspension combination is CBP’s to resolve. |
Entry Summary Under Review | Entry cannot be in adjusted status | Not in ES-003. |
Entry Type Not Allowed | Entry type cannot be TIB (23), Duty Deferral (08), Reconciliation (09), or Drawback (047) | Blocked. Warehouse 21/22 return the same message since 2026-07-07 (CSMS #69127837); file the withdrawals 31/32/34/38 instead. |
Value Not Allowed on HTS | A goods value amount greater than $0.00 on any chapter 99 HTS code is not permitted | Fix with a PSC before the CAPE Declaration; CSMS #69056483 removed the Ch. 1-97 value check and split out the two errors below. |
No IEEPA HTS on Entry | Entry must have at least one IEEPA HTS | Entries without a 9903.01 / 9903.02 line are never placed on the CAPE file. |
Protest on Entry | Entry cannot be on an Open or Suspended protest. Entry cannot be in Denied status if AFR box is checked | Blocked when the protest column is “Open”. An IEEPA-only protest may be withdrawn and the entry refiled (CSMS #68340863). |
Statement Processing Not Complete | Entry cannot be on a statement that is authorized for payment, but the payment has not yet processed | Wait for the statement to pay. |
Invalid HTS | The line action date is not within the begin date and the end date of at least one HTS code on the entry | PSC repair per CSMS #69056483. |
HTS Relationship Mismatch | An HTS code designated as an add/replace/derived HTS code exists on the entry, but the corresponding HTS code has not been provided | PSC repair per CSMS #69056483. |
Unable to Calculate Duty-‘X’ Duty Comp Code | There is a duty comp code that is not able to be calculated | Ask your broker to review the line. |
Unexpected Error-try Again | Re upload file to try again | Retry. |
SPI or Additional HTS Required | Either a Special Program Indicator (SPI) code or an additional HTS code is required on at least one line of the entry summary | PSC before CAPE. |
Order of operations CBP asks for
- Non-IEEPA PSCs first, then the CAPE Declaration (“you should file that PSC prior to filing your CAPE Declaration”). PSCs may not be used to request the IEEPA refund itself.
- CAPE before drawback: “IORs and brokers should ensure they submit a CAPE Declaration … prior to filing a drawback claim.”
- Non-IEEPA protests after the CAPE (re)liquidation; an IEEPA-only protest within the 80-day window can be withdrawn so the entry can go on a CAPE Declaration.
- Do not include entries on which a surety paid the IEEPA duty (CSMS #68340863).
Sources
| Point | What the text says | Source · status |
|---|---|---|
| Error tables | File Validation Errors and Entry Validation Errors tables, reproduced below word for word. | CBP IEEPA Duty Refunds page, FAQ updated 7/7/2026Primary text |
| Original validation list | Eleven entry-specific checks a–k: no IEEPA HTS, recon-flagged, type 09, drawback, type 47, type 08, open/suspended protest, TIB “open/closed” status, AD/CVD pending liquidation, over 80 days past liquidation, value on an IEEPA line. | CSMS #68340863 (2026-04-13) §1Primary text |
| Warehouse entries | “Effective July 7, 2026, warehouse entries (Entry Types 21 and 22) will no longer be accepted on a CAPE Declaration … rejected with the existing ENTRY TYPE NOT ALLOWED error message. Warehouse withdrawals (Entry Types 31, 32, 34, 38) will continue to be accepted.” | CSMS #69127837 (2026-07-02)Primary text |
| Recon-flagged entries | From June 29, 2026 CAPE accepts entries flagged for reconciliation (entry types 01, 02, 06) for which the type 09 has not been filed; once a type 09 is filed the underlying entries are not eligible in this phase. | CBP page “Reconciliation” FAQ updated 6/24/2026 · CSMS #69066837Primary text |
| Value and HTS errors | The “goods value amount must be reported on the Ch 1-97” check was removed; INVALID HTS and HTS RELATIONSHIP MISMATCH were split out with PSC repair guidance. | CSMS #69056483 (2026-06-25)Primary text |