Tariff Refund Calculator

CAPE CSV guide

CAPE CSV guideGuide

CAPE Declaration CSV template for IEEPA refund prep

Use this guide to stage an entry-number-only CAPE Declaration list after your source export has been estimated, validated, and reviewed.

Open the calculatorRead related guide

Key takeaways

  • CBP says CAPE Declarations are CSV uploads that list entry numbers.
  • Each declaration can include up to 10,000 entries; use separate declarations for additional distinct entries.
  • Keep ES-003 or broker exports as source-analysis files, not as the final declaration upload.
Direct answer
What goes in the CAPE Declaration CSV?
CBP guidance says the upload lists entry numbers. Do not include the richer tariff-line detail from ES-003 or broker exports in the declaration file.
Direct answer
How many entries can one declaration include?
CBP guidance says each CAPE Declaration can list up to 10,000 entry numbers. Additional distinct entries can be submitted in separate declarations.
Direct answer
Who submits the declaration?
CBP says the importer of record or the authorized broker that filed the entry summaries submits the CAPE Declaration through ACE.
Guide details

What to decide next

Use the source file to decide whether to estimate, request better data, or move into declaration-pack prep.

Starter CSV shape
Use a simple entry-number list for preparation, then confirm the final ACE-provided template before upload.
  • One column for entry numbers
  • One entry number per row
  • No source amounts, HTS codes, notes, or importer rollups
  • No duplicate entries within the same declaration batch
Pre-upload checks
The declaration should be built only after source-file analysis has identified entries that deserve review.
  • Complete entry numbers are present
  • The submitter is tied to the IOR or filing broker role for the entries
  • Likely IEEPA Chapter 99 signals exist in the source analysis
  • Reconciliation, drawback, protest, liquidation, and surety-paid flags have been reviewed
What not to use as the declaration
A rich source export is useful for estimating and validating, but it should not be treated as the CAPE upload file.
  • Do not upload the full ES-003 line-detail export as the declaration
  • Do not include refund estimates or calculated totals in the declaration CSV
  • Do not mix rejected, unclear, and submit-ready entries without review
  • Do not assume every estimated entry is Phase 1 ready

Build a CAPE Declaration batch

  1. 1

    Analyze the source export

    Start with ES-003 or a broker export and use the calculator to estimate exposure, detect fields, and surface warnings.

  2. 2

    Filter to reviewed entry numbers

    Separate clean, submit-ready candidates from entries that still need liquidation, protest, drawback, payee, or broker review.

  3. 3

    Batch distinct entries

    Keep each CAPE Declaration at or below CBP's 10,000-entry limit and avoid duplicate entry numbers across accepted declarations.

  4. 4

    Confirm in ACE before upload

    Use the ACE CAPE tab and its current template or instructions for the final upload. This site supports preparation only.

FAQ

Common questions about cape csv guide

No. Use this page for preparation and field discipline. Confirm the final upload format against the CAPE template available in ACE.

Related guides

Related refund guides

More on tariff refund estimates, broker export quality, and first-pass exposure review.

IEEPA Refund Calculator for Broker and ACE CSV Exports

Use an IEEPA refund calculator to total likely refundable duty exposure from broker exports, ACE reports, and entry-level customs CSV files before phased claims open.

Broker Export Requirements for Tariff Refund Estimates

Learn which broker export columns and file traits are required to produce a usable tariff refund estimate and support phased-claim preparation from customs-entry data.

How to Estimate Tariff Refund Exposure Before Formal Filing Work

Follow a conservative workflow to estimate tariff refund exposure from customs-entry data before legal review, phased claim prep, or filing work begins.

Upload ES-003 to Estimate Tariff Refund Exposure

Use an ACE ES-003 Entry Summary Line Tariff Details export to estimate likely IEEPA tariff refund exposure, identify missing CAPE-prep fields, and decide what to hand to a broker or counsel.

How to Calculate Your CAPE Refund Before Filing

Estimate likely CAPE refund exposure from ACE ES-003 or broker CSV data before filing work begins, then separate estimate, validation, declaration CSV prep, and refund tracking.

IEEPA Tariff Refund Calculator for Customs CSV Files

Estimate likely refundable IEEPA tariff exposure from a broker export, ACE ES-003-style CSV, or entry-level customs file, then route the result into broker, counsel, or paid claim-prep work.

Import Duty Refund Calculator for IEEPA Exposure

Estimate likely refundable import duty exposure from a broker or ACE customs CSV. Scoped to IEEPA tariff refunds — not Section 301, Section 232, AD/CVD, or drawback.