---
type: index
title: Antom Settlement Report Reconciliation Knowledge Base - Scenario Index
description: Documentation navigation organized by use case, LLM query entry point
last_updated: 2026-05-08
version: 2.0.0
---

# Antom Settlement Report Reconciliation Knowledge Base

> **Usage Guide**: Navigate to the relevant document link based on your specific scenario. Each document is self-contained and can be understood independently.

> **LLM Query Rules**:
> - 📌 **Read at most 3 documents**: index.md (required) → primary document (required) → supplementary document (optional, at most 1)
> - 📌 **Related Documents are suggestions**: The "Related Documents" section at the end of each document does not need to be fully read
> - 📌 **Self-contained design**: Each document contains the core information needed to answer questions without depending on other documents

## Scenario Index

### Settlement Report Retrieval & Download
- [Download Settlement Report files](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/procedures/reconciliation-guide.md): Steps to obtain settlement report files
- [Identify empty batches](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/procedures/empty-batch-handling.md): Handling CSV files with only headers or END markers

### Field Lookup & Understanding
- [Query settlementAmountValue (Net Settlement Amount)](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/entities/amount-fields.md): Net deposit amount after deducting fees
- [Query transactionAmountValue (Transaction Amount)](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/entities/amount-fields.md): Actual amount paid by the consumer
- [Query all fee fields](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/entities/amount-fields.md): Definitions, currencies, and applicable scenarios for 17 fee fields
- [Query transactionId/settlementBatchId](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/entities/id-fields.md): Unique identifiers for batches and transactions
- [Query transactionType enumerations](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/entities/transaction-types.md): Meanings and amount signs of 17 transaction types
- [Query payment method information](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/entities/payment-methods.md): Parsing rules for card brands, wallets, issuing countries, etc.

### Settlement Report Reconciliation Operations
- [Validate batch total settlement amount](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/procedures/reconciliation-guide.md): Aggregate settlementAmountValue across all rows
- [Validate per-transaction settlement](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/procedures/reconciliation-guide.md): Link all records for the same transaction and sum them
- [View transaction cost breakdown](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/procedures/reconciliation-guide.md): Validate each transaction using the balance formula
- [Three reconciliation scenarios explained](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/concepts/reconciliation-scenarios.md): Batch summary, per-transaction, cost breakdown

### Balance Formula Validation
- [Same-currency balance formula](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/synthesis/balance-formula.md): settlementAmountValue = transactionAmountValue + Σ(fees)
- [Cross-currency balance formula](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/synthesis/balance-formula.md): settlementAmountValue = transactionAmountValue / quotePrice + Σ(fees)
- [Formula applicability validation](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/synthesis/balance-formula.md): SETTLEMENT_FEE and ADJUSTMENT_FEE are not subject to the formula

### Pricing Model Understanding
- [IC++ vs. Blended Rate comparison](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/concepts/billing-modes.md): Characteristics and fee field differences between the two pricing models
- [IC++ fee breakdown](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/synthesis/ic-plus-plus-analysis.md): Interchange Fee + Scheme Fee + Acquirer Markup
- [Blended Rate fee composition](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/entities/fee-fields-catalog.md): paymentMethodFee includes all fees
- [Delayed IC Fee settlement](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/synthesis/ic-plus-plus-analysis.md): IC Fees may be settled separately in subsequent batches

### Settlement Period & Rules
- [Settlement Period concepts](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/concepts/settlement-cycle.md): T+1/T+2 settlement, batch bundling rules
- [Holiday settlement rules](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/concepts/settlement-cycle.md): Weekends and holidays are deferred to the next business day
- [Report generation timeline](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/procedures/reconciliation-guide.md): Transaction Details at T+1, Settlement Details after batch completion

### Troubleshooting
- [Balance formula validation failure](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/synthesis/balance-formula.md): Check currency, fee field completeness, and transaction type
- [Brazil transaction balance validation anomaly](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/synthesis/brazil-tax-special-cases.md): IOF tax embedded in FX spread causing 3–5% variance
- [Batch summary discrepancy](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/procedures/bill-verification.md): Check file integrity and batch uniqueness
- [Missing transaction records](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/procedures/bill-verification.md): Confirm settlement status, transaction final state, and multi-batch search
- [Fee field anomalies](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/procedures/bill-verification.md): Confirm pricing model, delayed IC Fee, and contracted fee items
- [IC++ fee validation](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/synthesis/ic-plus-plus-analysis.md): paymentMethodFee should be 0; the three fee components should have values

### Payment Method Parsing
- [Card payment parsing](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/entities/payment-methods.md): Read cardBrand + issuingCountry + fundingSource
- [Multi-region wallet parsing](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/entities/payment-methods.md): Extract country code from suffix (e.g., GRABPAY_SG)
- [Single-region wallet list](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/entities/payment-methods.md): GCASH, MAYA, PAYPAY, and 20+ other wallets
- [Apple Pay/Google Pay](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/entities/payment-methods.md): Essentially card payments — must read cardBrand

### Transaction Lifecycle
- [Complete transaction type enumeration](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/entities/transaction-types.md): 17 transaction types and their amount signs
- [Transaction chain linking](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/entities/id-fields.md): PAYMENT → REFUND → REFUND_REVERSAL, etc.
- [ID field null value rules](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/entities/id-fields.md): Required/optional rules for ID fields by transaction type
- [originalTransactionRequestId linking](https://cdn.marmot-cloud.com/page/antom_bill_reconciliation_doc/wiki/entities/id-fields.md): Derived transactions point to the original transaction

## Document Type Description

| Type | Description | Applicable Scenario |
|------|-------------|---------------------|
| **Concept** | Concept page — what it is and why | Understanding business concepts and rules |
| **Entity** | Entity page — fields, types, objects | Looking up specific field definitions |
| **Procedure** | Procedure page — how to do it | Executing operational steps |
| **Synthesis** | Synthesis page — cross-document analysis | In-depth analysis and complex problems |