# Settlements

## What it is

The Settlements page shows payment deposits received from your external system (such as Shopify payouts) alongside their processing status in NetSuite. From here you can generate the matching financial records, reconcile deposits, and track whether everything has been posted correctly.

![The Settlements page showing the table with Settlement ID, Deposit, Fees, Date, and status columns](/files/mcyGBzvZo2cDeOp9kXq1)

## When you'd use it

Use this when you want to:

* Check whether a payout has been processed and matched to a NetSuite record.
* Generate the vendor bill, payment, or journal for a settlement.
* Reconcile a deposit by running the matching process.
* Correct or dismiss a settlement with an unexpected status.

## Before you start

* Viewing the Settlements page requires IDC access.
* Generating transactions and running the matching process requires integration admin access.
* The page is specific to payment integrations (such as Shopify). If you don't see any data, your app may not include a settlements feature — check with your integration admin.

## Step by step

### Read the settlements table

1. Click **Settlements** in the left menu. The table loads all settlements for your integration.
2. Each row is one payout. The most important columns to read across are:

   | Column                   | What it shows                                                            |
   | ------------------------ | ------------------------------------------------------------------------ |
   | **Settlement Report Id** | The reference number from your external system (e.g. Shopify)            |
   | **Deposit**              | The amount deposited                                                     |
   | **Fees**                 | Fees deducted by the payment processor                                   |
   | **Date**                 | When the payout was issued                                               |
   | **Payout Status**        | Whether the payout is complete or still pending from the external system |
   | **Processing Status**    | Whether IDC has finished processing the settlement                       |
   | **App Transaction**      | The IDC transaction record linked to this settlement                     |
   | **NetSuite Transaction** | The matching NetSuite record, once generated                             |
3. Click **Details** on any row to see the full breakdown of that settlement.

   ![The Details view for a single settlement showing the full breakdown](/files/DLufZTHp06oWyEftFveO)

### Generate NetSuite records for a settlement

4. Find a settlement whose **Processing Status** is not already **Processing** and whose NetSuite records have not yet been generated.
5. Click **Generate Transactions** at the top of the page. IDC will create the financial records (vendor bill, payment, and journal) in NetSuite for settlements that are ready.

   > **Note:** This runs for all eligible settlements in the current view. Already-processed settlements are skipped automatically.

### Run the matching process

6. Once transactions have been generated, click **Process Summary & Transactions + Match** to reconcile the deposits against the NetSuite records. The **Processing Status** column will update as each settlement is matched.
7. Click **Refresh** to reload the table and see the latest statuses if they haven't updated yet.

### Update a settlement's status manually

8. In any row, click the dropdown under **Processing Status** to set the status manually — for example, choose **Ignore** for a settlement you don't need to action, or **Pending** to queue it for reprocessing.

## What success looks like

* **Payout Status** shows **Success**.
* **Processing Status** shows **Success**.
* The **Vendor Bill**, **Bill Payment**, and **Journal Entry** columns each contain a link to the corresponding record in NetSuite.

## Common issues

* **Processing Status shows Error.** Click **Details** on that row to read the error message. Common causes are missing NetSuite configuration or a mismatched currency. Contact your integration admin with the error text.
* **Processing Status stays on Pending or Processing for a long time.** Click **Refresh** to check whether it has moved. If it's still stuck after several minutes, click **Process Summary & Transactions + Match** again or contact your admin.
* **Generate Transactions produces no change.** All visible settlements may already be processed or in a terminal status. Check the **Processing Status** column — if everything already shows a status, there's nothing left to generate.
* **You see no settlements at all.** Your integration may not include a settlements feature, or no payouts have been issued yet. Check with your integration admin.

## Related

* [Logs](/idc/idc-core/logs.md) — for detailed error information if settlements consistently fail.
* [Apps & Marketplace](/idc/idc-core/apps.md) — verify your payment integration is active.
* [Support](/idc/idc-core/support.md) — if settlement errors persist and you need In8Sync's help to investigate.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.in8sync.com/idc/idc-core/settlements.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.