{
  "sessionId": "sample-importer-co-pack",
  "packageName": "CAPE Declaration Pack",
  "sourceFileName": "sample-importer-co-ieepa-export.csv",
  "createdAt": "2026-04-26T00:00:00.000Z",
  "purchasedAt": "2026-04-26T00:00:00.000Z",
  "summary": {
    "entryCount": 6,
    "totalEstimatedRefund": 303550,
    "confidence": 0.96,
    "readyScore": 0.7777777777777778,
    "phaseReadinessScore": 0.7583333333333333
  },
  "warnings": [
    "2 entries show refund payee or documentation signals that should be reviewed before the paid CAPE Declaration Pack workflow continues.",
    "1 entries are missing enough phase-critical data that \"what can you submit first?\" remains incomplete."
  ],
  "detectedFields": {
    "entryNumber": "Entry Number",
    "entryDate": "Entry Date",
    "importerName": "Importer Name",
    "ieepaAmount": "IEEPA Duty Amount",
    "entryType": "Entry Type",
    "liquidationDate": "Liquidation Date",
    "liquidationStatus": "Liquidation Status",
    "suspendedOrUnderReviewFlag": "Suspended or Under Review",
    "extendedFlag": "Extended Flag",
    "warehouseOrWithdrawalFlag": "Warehouse or Withdrawal",
    "actualOwnerName": "Actual Owner",
    "refundNotifyPartyName": "Refund Notify Party",
    "port": "Port",
    "broker": "Broker"
  },
  "capePreflight": {
    "source": {
      "title": "ACE Portal - CAPE Declarations Quick Reference Guide",
      "publicationDate": "April 2026",
      "publicationNumber": "5514-0426"
    },
    "formatInitialValidationRisks": [
      {
        "id": "upload-file-not-empty",
        "rule": "Upload file cannot be empty",
        "status": "pass",
        "detail": "The generated CAPE declaration CSV contains 3 entry numbers, so the upload file is not empty."
      },
      {
        "id": "upload-file-entry-limit",
        "rule": "Upload file cannot exceed 10,000 entries",
        "status": "pass",
        "detail": "The generated CAPE declaration CSV stays within the current 10,000-entry CAPE upload limit."
      },
      {
        "id": "header-title-row",
        "rule": "Header title row cannot be missing",
        "status": "pass",
        "detail": "The generated CAPE declaration CSV always includes the required \"Entry Number\" header row."
      },
      {
        "id": "upload-file-format",
        "rule": "Upload file format must be .csv",
        "status": "pass",
        "detail": "The generated CAPE declaration artifact is emitted as a CSV file for ACE upload."
      },
      {
        "id": "entry-number-format",
        "rule": "Entry numbers must normalize to 11 alphanumeric characters",
        "status": "pass",
        "detail": "All included CAPE declaration entry numbers normalize to 11 alphanumeric characters."
      },
      {
        "id": "duplicate-entry-numbers",
        "rule": "No duplicate entry numbers",
        "status": "pass",
        "detail": "No duplicate entry references were detected in the analyzed data."
      }
    ],
    "batchClaimValidationRisks": [
      {
        "id": "account-mismatch",
        "rule": "IOR number of importer account must match the submitted entry summary",
        "status": "reviewNeeded",
        "detail": "This artifact does not preserve ACE account context, so account mismatch risk must be confirmed in ACE or with the filing broker."
      },
      {
        "id": "missing-entry",
        "rule": "Entry number must exist",
        "status": "reviewNeeded",
        "detail": "The current analysis snapshot cannot confirm ACE existence for each entry number, so missing-entry failures remain review-needed."
      },
      {
        "id": "entry-summary-status",
        "rule": "Entry Summary Status must be Accepted",
        "status": "reviewNeeded",
        "detail": "A status-like source column was detected, but this artifact does not preserve ACE-authoritative Entry Summary Status values for a conclusive pass/fail check."
      },
      {
        "id": "control-status",
        "rule": "Control Status must be CBP",
        "status": "reviewNeeded",
        "detail": "Control Status is not part of the current analysis snapshot, so this ACE claim validation remains review-needed."
      },
      {
        "id": "missing-ieepa-hts",
        "rule": "Entry must have at least one IEEPA HTS",
        "status": "reviewNeeded",
        "detail": "The current analysis estimates IEEPA exposure but does not retain ACE HTS declarations per entry, so missing-IEEPA-HTS failures remain review-needed."
      },
      {
        "id": "excluded-entry-types",
        "rule": "Entry Type cannot be Duty Deferral (08), Recon (09), TIB (23), or Drawback (47)",
        "status": "reviewNeeded",
        "detail": "A source entry-type field was detected and obvious excluded entry types are removed from the CAPE candidate CSV; confirm remaining entry types in ACE."
      },
      {
        "id": "reconciliation-flag",
        "rule": "Entry cannot be flagged for Reconciliation",
        "status": "reviewNeeded",
        "detail": "Reconciliation flags are not captured in the current analysis snapshot, so this CAPE claim validation remains review-needed."
      },
      {
        "id": "over-80-days-past-liquidation",
        "rule": "Liquidated entries over 80 days past liquidation can fail claim validation",
        "status": "reviewNeeded",
        "detail": "A liquidation-date field was detected in the source analysis, but this artifact does not retain ACE-authoritative liquidation timing needed for a conclusive over-80-days determination."
      }
    ]
  },
  "phaseBucketSummaries": [
    {
      "bucket": "warehousePriority",
      "label": "Warehouse or withdrawal priority bucket",
      "entryCount": 1,
      "estimatedRefund": 128300,
      "blockers": []
    },
    {
      "bucket": "likelyEarlyPhase",
      "label": "Likely early phase",
      "entryCount": 3,
      "estimatedRefund": 27840,
      "blockers": [
        "Missing liquidation date"
      ]
    },
    {
      "bucket": "laterOrUnclear",
      "label": "Later phase or unclear",
      "entryCount": 1,
      "estimatedRefund": 111200,
      "blockers": []
    },
    {
      "bucket": "unknownMissingData",
      "label": "Unknown because key phase fields are missing",
      "entryCount": 1,
      "estimatedRefund": 36210,
      "blockers": [
        "Missing liquidation date",
        "Missing liquidation status or review flag"
      ]
    }
  ],
  "payeeDocumentationSummaries": [
    {
      "bucket": "possibleOwnerScenario",
      "label": "Possible owner or consignee documentation scenario",
      "entryCount": 1,
      "documents": [
        "Entry-level support showing importer, owner, or consignee names together",
        "Any owner declaration or similar routing support already on file",
        "Broker or counsel review before assuming who should receive the refund"
      ],
      "note": "Owner or consignee names do not line up cleanly with the importer field, so refund-routing support should be gathered before pack prep continues."
    },
    {
      "bucket": "possibleNotifyPartyScenario",
      "label": "Possible notify-party or third-party payee scenario",
      "entryCount": 1,
      "documents": [
        "Existing refund-recipient or notify-party instructions already on file",
        "CBP Form 4811 or equivalent broker record if refunds route to a third party",
        "Current contact details for the authorized recipient"
      ],
      "note": "A third-party payee or notify-party name appears in the file, so refund mailing or routing instructions should be confirmed before paid prep starts."
    }
  ],
  "payeeDocumentationChecklist": [
    "Entry-level support showing importer, owner, or consignee names together",
    "Any owner declaration or similar routing support already on file",
    "Broker or counsel review before assuming who should receive the refund",
    "Existing refund-recipient or notify-party instructions already on file",
    "CBP Form 4811 or equivalent broker record if refunds route to a third party",
    "Current contact details for the authorized recipient"
  ],
  "refundsReadyChecklist": [
    {
      "id": "ace-portal-access",
      "title": "Confirm ACE Portal access for each importer in this file",
      "status": "review",
      "detail": "This file spans 3 importer entities, so the paid workflow should verify which ACE account can receive refund activity for each one."
    },
    {
      "id": "ach-authorization",
      "title": "Confirm ACH refund authorization in ACE Portal",
      "status": "actionNeeded",
      "detail": "Track completion as a workflow step only. Do not store bank account numbers in this product."
    },
    {
      "id": "payee-routing",
      "title": "Review refund payee routing before pack generation",
      "status": "review",
      "detail": "2 entries show owner, notify-party, payee, or surety signals that should be documented before refund routing is assumed."
    }
  ],
  "capeDeclarationExport": {
    "header": "Entry Number",
    "includedEntryCount": 3,
    "uniqueValidEntryCount": 3,
    "invalidEntryCount": 0,
    "excludedEntryCount": 3,
    "includedEntries": [
      {
        "entryNumber": "110-5501987-2",
        "normalizedEntryNumber": "11055019872",
        "importer": "Northshore Components",
        "estimatedRefund": 128300,
        "bucket": "warehousePriority",
        "label": "Warehouse or withdrawal priority bucket",
        "reviewReasons": [
          "No IEEPA Chapter 99 HTS field was detected for this entry; ACE must confirm the entry has an IEEPA HTS line.",
          "ACE must confirm entry existence, IOR or broker account match, Entry Summary Status, and Control Status."
        ]
      },
      {
        "entryNumber": "485-7716123-1",
        "normalizedEntryNumber": "48577161231",
        "importer": "Harborline Home Goods",
        "estimatedRefund": 18420,
        "bucket": "likelyEarlyPhase",
        "label": "Likely early phase",
        "reviewReasons": [
          "No IEEPA Chapter 99 HTS field was detected for this entry; ACE must confirm the entry has an IEEPA HTS line.",
          "ACE must confirm entry existence, IOR or broker account match, Entry Summary Status, and Control Status."
        ]
      },
      {
        "entryNumber": "485-7716124-9",
        "normalizedEntryNumber": "48577161249",
        "importer": "Harborline Home Goods",
        "estimatedRefund": 9420,
        "bucket": "likelyEarlyPhase",
        "label": "Likely early phase",
        "reviewReasons": [
          "No IEEPA Chapter 99 HTS field was detected for this entry; ACE must confirm the entry has an IEEPA HTS line.",
          "ACE must confirm entry existence, IOR or broker account match, Entry Summary Status, and Control Status."
        ]
      }
    ],
    "excludedEntries": [
      {
        "entryNumber": "998-2200342-4",
        "normalizedEntryNumber": "99822003424",
        "importer": "Elm Ridge Retail",
        "estimatedRefund": 0,
        "bucket": "likelyEarlyPhase",
        "label": "Likely early phase",
        "reasons": [
          "No positive IEEPA duty amount was detected for this entry in the source file."
        ]
      },
      {
        "entryNumber": "110-5501988-0",
        "normalizedEntryNumber": "11055019880",
        "importer": "Northshore Components",
        "estimatedRefund": 111200,
        "bucket": "laterOrUnclear",
        "label": "Later phase or unclear",
        "reasons": [
          "The source data does not show this entry as a strong CAPE Phase 1 candidate."
        ]
      },
      {
        "entryNumber": "998-2200341-6",
        "normalizedEntryNumber": "99822003416",
        "importer": "Elm Ridge Retail",
        "estimatedRefund": 36210,
        "bucket": "unknownMissingData",
        "label": "Unknown because key phase fields are missing",
        "reasons": [
          "Key liquidation or status fields are missing, so this entry needs review before CAPE upload."
        ]
      }
    ],
    "duplicateEntryCount": 0,
    "omittedEntryCount": 0,
    "maxEntriesPerDeclaration": 10000
  }
}