HTS 2026 Rev 23 · rules checked 2026-11-15 · MPF FY2027See what changed →

Guide · CAPE error codes

Every CAPE error message, what CBP means by it, and what the pre-check catches first

CBP publishes two tables of CAPE rejections — file-level and entry-level. The calculator runs the ones that can be read from an ES-003 export before you upload anything to ACE.

Sources re-read 2026-11-15 · every figure carries its document

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 messageCBP definitionHere
CSV content is empty or missing the headerCSV needs Entry Number header and at least 1 entry numberOur CAPE file starts with the “Entry Number” header line.
Not a CSV fileFile format must be CSVSave as .csv, not .xlsx.
The file size exceeds 1mbFile size cannot be more than 1mbWe split at 1 MB automatically.
The file is deemed unsafeResave file and upload againPlain text only — no formulas or macros.
The file exceeds the maximum 10,000 allowed entry numbers per fileIf you have more than 10,000 entry numbers, submit multiple CSV files uploadsWe split at 9,999 entries (the CAPE Declaration limit).
Filer Code not matchingFor Filer and Organizational Broker, first 3 characters of Entry Number must match Filer Code of accountBrokers: file under the filer code that filed the entries.
Duplicate EntryCSV file has duplicate Entry NumbersDuplicates are removed when the file is built.
Not 11 characters longEntry Number must be 11 characters without dashesNNN-NNNNNNN-N becomes NNNNNNNNNNN; a leading zero gets an apostrophe.
Account MismatchImporter of Record Number must match Importer of Record Number of Entry SummaryOnly the IOR or the filing broker can file — see “Not the IOR?”.
Entry Summary Not Found or Archived in ACEEntry Summary must exist in ACEPre-ACE or archived entries are on CBP’s later-deployment list.

Entry validation errors (CBP table)

Error messageCBP definitionHere
Entry on DrawbackEntry cannot be on a drawback entryBlocked in the pre-check when a drawback flag is present; CBP lists these for a later deployment.
Recon Already Filed for Entry SummaryEntry has Reconciliation entry on file and is currently not allowed for CAPE processingBlocked when the recon column says a type 09 is on file (CSMS #69035485).
Entry Summary is Cancelled/RejectedEntry summary status must be “Accepted”Not visible in ES-003; check the entry status with your broker.
Entry Summary is in Final Liquidation StatusEntry summary liquidated/reliquidated more than 80 days agoBlocked: the calculator counts days from the liquidation date to today.
Entry Summary is in Trade ControlControl status for the entry summary must be with CBPNot in ES-003.
Entry Summary is Subject to Court InjunctionEntry summary cannot be flagged for injunctionNot in ES-003.
Entry Summary Pending Liquidation or Not Liquidated and Has Suspension RecordLiquidation status “Pending” or “Not Liquidated” and has a Suspension recordSuspended entries are accepted and keep their status; a pending + suspension combination is CBP’s to resolve.
Entry Summary Under ReviewEntry cannot be in adjusted statusNot in ES-003.
Entry Type Not AllowedEntry 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 HTSA goods value amount greater than $0.00 on any chapter 99 HTS code is not permittedFix 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 EntryEntry must have at least one IEEPA HTSEntries without a 9903.01 / 9903.02 line are never placed on the CAPE file.
Protest on EntryEntry cannot be on an Open or Suspended protest. Entry cannot be in Denied status if AFR box is checkedBlocked when the protest column is “Open”. An IEEPA-only protest may be withdrawn and the entry refiled (CSMS #68340863).
Statement Processing Not CompleteEntry cannot be on a statement that is authorized for payment, but the payment has not yet processedWait for the statement to pay.
Invalid HTSThe line action date is not within the begin date and the end date of at least one HTS code on the entryPSC repair per CSMS #69056483.
HTS Relationship MismatchAn HTS code designated as an add/replace/derived HTS code exists on the entry, but the corresponding HTS code has not been providedPSC repair per CSMS #69056483.
Unable to Calculate Duty-‘X’ Duty Comp CodeThere is a duty comp code that is not able to be calculatedAsk your broker to review the line.
Unexpected Error-try AgainRe upload file to try againRetry.
SPI or Additional HTS RequiredEither a Special Program Indicator (SPI) code or an additional HTS code is required on at least one line of the entry summaryPSC 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

PointWhat the text saysSource · status
Error tablesFile 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 listEleven 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 entriesFrom 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 errorsThe “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