# Migrate opening balances (Office-wise)

As a Head Accountant, I wish to set the opening balances for GL (General Ledger) accounts for a branch or an entire organization. This makes it easier for an organization wanting to move to Mifos to transfer GL account balances (from their existing accounting application or manual system) to Mifos X Accounting.

{% hint style="danger" %}

{% endhint %}

| Opening balances must be set before entering any journal entries in accounting system. |
| -------------------------------------------------------------------------------------- |

Beginning at the main screen, click on [**Accounting**](/mifosx/user-manual/for-administrators-mifos-x-platform/accounting.md). This will launch the **Accounting** menu.

Select **Migrate Opening Balances**

![](https://mifosforge.jira.com/wiki/download/thumbnails/90243328/migrate.jpg?version=1\&modificationDate=1505373704688\&cacheVersion=1\&api=v2\&height=400)

### Step 1: Go to "Global configuration" (Admin>>System)&#x20;

Enable "office-opening-balances-contra-account" &#x20;

![](https://mifosforge.jira.com/wiki/download/thumbnails/90243328/10.png?version=1\&modificationDate=1428753134142\&cacheVersion=1\&api=v2\&width=800)

### Step 2: Go to "Chart of accounts" (Admin>>Accounting)&#x20;

Create a Contra-account (for example. Opening Balances Contra-account, which would be an Equity account)

![](https://mifosforge.jira.com/wiki/download/thumbnails/90243328/edit%202.jpg?version=1\&modificationDate=1505373735273\&cacheVersion=1\&api=v2\&height=400)

### Step 3: Go to "Accounts linked to Financial Activities" (Admin>>Accounting)

a) Click on "Define New mapping"&#x20;

![](https://mifosforge.jira.com/wiki/download/thumbnails/90243328/12.png?version=1\&modificationDate=1428754537559\&cacheVersion=1\&api=v2\&width=650)

b) Select and update the mapping as mentioned below:-&#x20;

&#x20;   **Financial activity**: Opening Balances Transfer Contra&#x20;

&#x20;   **Account**: Opening Balances Contra -account

&#x20;   Then click on Submit.&#x20;

![](https://mifosforge.jira.com/wiki/download/thumbnails/90243328/add%20links.jpg?version=1\&modificationDate=1505373784840\&cacheVersion=1\&api=v2\&width=850)

### Step 4: Go to Migrate opening Balances (Admin>>Accounting)&#x20;

<div align="left"><img src="https://mifosforge.jira.com/wiki/download/thumbnails/90243328/14.png?version=1&#x26;modificationDate=1428757242842&#x26;cacheVersion=1&#x26;api=v2&#x26;width=368" alt=""></div>

a) Select the desired office from the drop down

<div align="left"><img src="https://mifosforge.jira.com/wiki/download/thumbnails/90243328/office.jpg?version=1&#x26;modificationDate=1505373836060&#x26;cacheVersion=1&#x26;api=v2&#x26;width=450" alt=""></div>

b) Select "**Date of Opening Balance**"&#x20;

&#x20;   Select "**Currency**"&#x20;

&#x20;   Enter **Debit balance - Amount** in the field box, with respect to your GL account.&#x20;

&#x20;   Enter **Credit balance - Amount** in the field box, with respect to your GL account.&#x20;

&#x20;   Then click on **Submit** button to pass the opening balance entries.&#x20;

![](https://mifosforge.jira.com/wiki/download/thumbnails/90243328/opening%20bal.jpg?version=1\&modificationDate=1505373961618\&cacheVersion=1\&api=v2\&height=400)

{% hint style="warning" %}
**Note:**

a) Prior to this, no transactions should occur.

b) You should follow the mentioned conditions below before you pass the Opening balance entry:

\>> Either debit or credit balance may be specified for a particular account

\>> Both debit or credit balance may NOT be specified for a particular account

\>> Total debits should be equal to Total credits.
{% endhint %}

### **What happens if Opening balances are set after entering any journal entries in accounting system:**

&#x20;  \
Be cautious that **Opening balances** are set before making any journal entry in accounting system. If you fail to do so, you won't be able to set the opening balance. Below are a few scenarios which should not be done before setting opening balance.

**Scenario 1:Don't Define a Loan Product With Accounting Enabled:**

* If you are setting up opening balances, make sure that you don't have any loan product with accounting enabled.

![](https://mifosforge.jira.com/wiki/download/thumbnails/90243328/accounting%20definition.jpg?version=1\&modificationDate=1505379319698\&cacheVersion=1\&api=v2\&height=400)

* In case you have loan product with accounting enabled and this loan product is linked with any of the clients, you won't b able to submit opening balances.\
  So make sure that while setting up opening balances you don't have any loan product with accounting enabled.

![](https://mifosforge.jira.com/wiki/download/thumbnails/90243328/error.jpg?version=1\&modificationDate=1505379341126\&cacheVersion=1\&api=v2\&height=400)

**Scenario 2: Don't Define a Savings Product With Accounting Enabled:**

* If you are setting up opening balances make sure that you don't have any savings product with accounting enabled.

![](https://mifosforge.jira.com/wiki/download/thumbnails/90243328/savings.jpg?version=1\&modificationDate=1505379634951\&cacheVersion=1\&api=v2\&height=400)

* In case you have savings product with accounting enabled and this savings product is linked with any of the clients, you won't be able to submit opening balances.\
  So make sure that while setting up opening balances you don't have any savings products with accounting enabled.

![](https://mifosforge.jira.com/wiki/download/thumbnails/90243328/error.jpg?version=1\&modificationDate=1505379341126\&cacheVersion=1\&api=v2\&height=400)

Related articles

* Page:[Migrate opening balances (Office-wise)](/mifosx/user-manual/for-administrators-mifos-x-platform/accounting/migrate-opening-balances-office-wise.md)


---

# 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.mifos.org/mifosx/user-manual/for-administrators-mifos-x-platform/accounting/migrate-opening-balances-office-wise.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.
