> For the complete documentation index, see [llms.txt](https://docs.tradeqloud.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tradeqloud.com/qloud-margin-control/administrators-guide/custom-objects.md).

# Custom Objects

Qloud Margin Control (QMC) is built on a set of NetSuite **custom records, fields and lists** that work together to apply, allocate, bill and reconcile costs on your transactions. This section is the technical reference for every QMC object. Start with the data model below to understand how the pieces relate — every object name links straight to its reference — then drill into the pages that follow for field-level detail.

## How the QMC data model fits together

QMC has two parallel pillars — **Landed Cost** (costs on the buy side) and **Sales Cost** (costs on the sell side). Both follow the same lifecycle:

{% stepper %}
{% step %}

### Configuration

Shared settings define *how* costs are calculated and posted: the [Cost Calculation Method](/qloud-margin-control/administrators-guide/custom-objects/custom-records.md#fq-tradeqloud-cost-calculation-method) and [Cost Record Status](/qloud-margin-control/administrators-guide/custom-objects/custom-records.md#fq-cost-record-status) records, and — configured in the **TradeQloud Setup** app — the [PO Creation Methods](/qloud-margin-control/using-qmc/setup-guides/landed-costs-setup/po-creation-methods.md), [Variance Methods](/qloud-margin-control/using-qmc/setup-guides/landed-costs-setup/primary-landed-cost-variance-method.md) and [Sales Cost Processing Methods](/qloud-margin-control/using-qmc/setup-guides/sales-costs-setup/sales-cost-processing-methods.md). These are set once and reused everywhere.
{% endstep %}

{% step %}

### Budget

A [Landed Cost Budget](/qloud-margin-control/administrators-guide/custom-objects/custom-records.md#fq-landed-cost-budget) or [Sales Cost Budget](/qloud-margin-control/administrators-guide/custom-objects/custom-records.md#tq-sales-cost-budget) defines a cost rule — rate/percent, calculation and allocation method, the cost vendor/item, PO-creation method and variance methods. Budgets are loaded against vendors, customers and/or items and can **auto-apply** to matching transactions.
{% endstep %}

{% step %}

### Filters

[Landed Cost Filter](/qloud-margin-control/administrators-guide/custom-objects/custom-records.md#fq-landed-cost-filter) / [Sales Cost Filter](/qloud-margin-control/administrators-guide/custom-objects/custom-records.md#tq-sales-cost-filter) records — together with their [Filter Item Application](/qloud-margin-control/administrators-guide/custom-objects/custom-records.md#fq-landed-cost-filter-item-application) children — refine *which* items and transactions a budget applies to (by item, transaction body field, or transaction line field), so a single budget can target exactly the right lines.
{% endstep %}

{% step %}

### Transaction Cost

When a budget applies to a transaction, a [Transaction Landed Cost](/qloud-margin-control/administrators-guide/custom-objects/custom-records.md#fq-transaction-landed-cost) or [Transaction Sales Cost](/qloud-margin-control/administrators-guide/custom-objects/custom-records.md#tq-transaction-sales-cost) record is created, capturing budgeted vs billed amounts across transaction, source and base currencies.
{% endstep %}

{% step %}

### Allocation

A [Transaction Landed Cost Allocation](/qloud-margin-control/administrators-guide/custom-objects/custom-records.md#fq-transaction-landed-cost-allocation) / [Transaction Sales Cost Allocation](/qloud-margin-control/administrators-guide/custom-objects/custom-records.md#tq-transaction-sales-cost-allocation) record splits each Transaction Cost down to individual lines and items, giving precise cost tracking and inventory valuation.
{% endstep %}

{% step %}

### Billing & variance

As the cost is billed (vendor bill / PO), QMC compares budgeted vs actual and posts the difference using the configured [Variance Method](/qloud-margin-control/using-qmc/setup-guides/landed-costs-setup/primary-landed-cost-variance-method.md). The [Cost Record Status](/qloud-margin-control/administrators-guide/custom-objects/custom-records.md#fq-cost-record-status) tracks where each record sits in this lifecycle, and Sales Cost additionally records its realized GL impact for reconciliation.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Long-running and bulk operations (for example bulk Sales Cost processing) are queued through [Async Execution Request](/qloud-margin-control/administrators-guide/custom-objects/custom-records.md#fq-qmc-async-execution-request) records and run in the background.
{% endhint %}

## Reference

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Custom Records</strong></td><td>Every record type and its fields, grouped by feature.</td><td><a href="/pages/enica8rzMa8hqpRmX6t9">/pages/enica8rzMa8hqpRmX6t9</a></td></tr><tr><td><strong>Transaction Body Fields</strong></td><td>Header-level fields added to transactions.</td><td><a href="/pages/TbClVRdpIMCmlRj8OEk6">/pages/TbClVRdpIMCmlRj8OEk6</a></td></tr><tr><td><strong>Transaction Line Fields</strong></td><td>Line-level fields added to transactions.</td><td><a href="/pages/MbLpyhMJi5phVsSfM1lY">/pages/MbLpyhMJi5phVsSfM1lY</a></td></tr><tr><td><strong>Item Fields</strong></td><td>Fields added to item records.</td><td><a href="/pages/dACDCxo6WujpdpOX9Wyx">/pages/dACDCxo6WujpdpOX9Wyx</a></td></tr><tr><td><strong>Entity Fields</strong></td><td>Fields added to vendor/customer records.</td><td><a href="/pages/IXSoAAEPnNVdSbcyKFKG">/pages/IXSoAAEPnNVdSbcyKFKG</a></td></tr><tr><td><strong>Custom Lists</strong></td><td>Supporting value lists.</td><td><a href="/pages/GnXMGufF2dj7CXRkmBbk">/pages/GnXMGufF2dj7CXRkmBbk</a></td></tr><tr><td><strong>Workflows</strong></td><td>Automation behind QMC.</td><td><a href="/pages/BGOzfOaOqsHAoDm5ZjvP">/pages/BGOzfOaOqsHAoDm5ZjvP</a></td></tr></tbody></table>