Supersede loan product chart of accounts

curl --request POST \
  --url https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/accounting-profiles/supersessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "accountingMode": "accrual",
  "effectiveFrom": "2026-08-01",
  "postingRules": [
    {
      "eventType": "disbursement",
      "legs": [
        {
          "account": "1100.10.001",
          "side": "debit",
          "component": "iof",
          "optional": true,
          "perOperation": true,
          "role": "principal"
        }
      ],
      "metadata": {}
    }
  ],
  "midazLedgerId": "ledger-def",
  "midazOrganizationId": "org-abc"
}
'

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/accounting-profiles/supersessions"

	payload := strings.NewReader("{\n  \"accountingMode\": \"accrual\",\n  \"effectiveFrom\": \"2026-08-01\",\n  \"postingRules\": [\n    {\n      \"eventType\": \"disbursement\",\n      \"legs\": [\n        {\n          \"account\": \"1100.10.001\",\n          \"side\": \"debit\",\n          \"component\": \"iof\",\n          \"optional\": true,\n          \"perOperation\": true,\n          \"role\": \"principal\"\n        }\n      ],\n      \"metadata\": {}\n    }\n  ],\n  \"midazLedgerId\": \"ledger-def\",\n  \"midazOrganizationId\": \"org-abc\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    accountingMode: 'accrual',
    effectiveFrom: '2026-08-01',
    postingRules: [
      {
        eventType: 'disbursement',
        legs: [
          {
            account: '1100.10.001',
            side: 'debit',
            component: 'iof',
            optional: true,
            perOperation: true,
            role: 'principal'
          }
        ],
        metadata: {}
      }
    ],
    midazLedgerId: 'ledger-def',
    midazOrganizationId: 'org-abc'
  })
};

fetch('https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/accounting-profiles/supersessions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/accounting-profiles/supersessions"

payload = {
    "accountingMode": "accrual",
    "effectiveFrom": "2026-08-01",
    "postingRules": [
        {
            "eventType": "disbursement",
            "legs": [
                {
                    "account": "1100.10.001",
                    "side": "debit",
                    "component": "iof",
                    "optional": True,
                    "perOperation": True,
                    "role": "principal"
                }
            ],
            "metadata": {}
        }
    ],
    "midazLedgerId": "ledger-def",
    "midazOrganizationId": "org-abc"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "charts": [
    {
      "accountingMode": "accrual",
      "createdAt": "2026-06-14T12:00:00Z",
      "effectiveFrom": "1900-01-01",
      "id": "550e8400-e29b-41d4-a716-446655440003",
      "loanProductVersionId": "550e8400-e29b-41d4-a716-446655440001",
      "postingRules": [
        {
          "eventType": "disbursement",
          "legs": [
            {
              "account": "1100.10.001",
              "optional": true,
              "perOperation": true,
              "side": "debit",
              "component": "iof",
              "role": "principal"
            }
          ],
          "metadata": {}
        }
      ]
    }
  ],
  "effectiveFrom": "2026-08-01",
  "loanProductId": "550e8400-e29b-41d4-a716-446655440000",
  "movedPositions": [
    {
      "amountCode": "principal",
      "fromAccount": "1.1.1.01",
      "toAccount": "1.1.2.01"
    }
  ]
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

Supersede loan product chart of accounts

Replaces the chart of accounts every configured version of this loan product books against, from a stated month forward. One action, one effective date, every affected version written together or none. A version with no chart is not touched: giving it a first one is the separate configure action, and this route requires its own permission because replacing a live chart moves balances on every live contract.

POST

api

loan-products

{id}

accounting-profiles

supersessions

Supersede loan product chart of accounts

curl --request POST \
  --url https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/accounting-profiles/supersessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "accountingMode": "accrual",
  "effectiveFrom": "2026-08-01",
  "postingRules": [
    {
      "eventType": "disbursement",
      "legs": [
        {
          "account": "1100.10.001",
          "side": "debit",
          "component": "iof",
          "optional": true,
          "perOperation": true,
          "role": "principal"
        }
      ],
      "metadata": {}
    }
  ],
  "midazLedgerId": "ledger-def",
  "midazOrganizationId": "org-abc"
}
'

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/accounting-profiles/supersessions"

	payload := strings.NewReader("{\n  \"accountingMode\": \"accrual\",\n  \"effectiveFrom\": \"2026-08-01\",\n  \"postingRules\": [\n    {\n      \"eventType\": \"disbursement\",\n      \"legs\": [\n        {\n          \"account\": \"1100.10.001\",\n          \"side\": \"debit\",\n          \"component\": \"iof\",\n          \"optional\": true,\n          \"perOperation\": true,\n          \"role\": \"principal\"\n        }\n      ],\n      \"metadata\": {}\n    }\n  ],\n  \"midazLedgerId\": \"ledger-def\",\n  \"midazOrganizationId\": \"org-abc\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    accountingMode: 'accrual',
    effectiveFrom: '2026-08-01',
    postingRules: [
      {
        eventType: 'disbursement',
        legs: [
          {
            account: '1100.10.001',
            side: 'debit',
            component: 'iof',
            optional: true,
            perOperation: true,
            role: 'principal'
          }
        ],
        metadata: {}
      }
    ],
    midazLedgerId: 'ledger-def',
    midazOrganizationId: 'org-abc'
  })
};

fetch('https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/accounting-profiles/supersessions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/accounting-profiles/supersessions"

payload = {
    "accountingMode": "accrual",
    "effectiveFrom": "2026-08-01",
    "postingRules": [
        {
            "eventType": "disbursement",
            "legs": [
                {
                    "account": "1100.10.001",
                    "side": "debit",
                    "component": "iof",
                    "optional": True,
                    "perOperation": True,
                    "role": "principal"
                }
            ],
            "metadata": {}
        }
    ],
    "midazLedgerId": "ledger-def",
    "midazOrganizationId": "org-abc"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "charts": [
    {
      "accountingMode": "accrual",
      "createdAt": "2026-06-14T12:00:00Z",
      "effectiveFrom": "1900-01-01",
      "id": "550e8400-e29b-41d4-a716-446655440003",
      "loanProductVersionId": "550e8400-e29b-41d4-a716-446655440001",
      "postingRules": [
        {
          "eventType": "disbursement",
          "legs": [
            {
              "account": "1100.10.001",
              "optional": true,
              "perOperation": true,
              "side": "debit",
              "component": "iof",
              "role": "principal"
            }
          ],
          "metadata": {}
        }
      ]
    }
  ],
  "effectiveFrom": "2026-08-01",
  "loanProductId": "550e8400-e29b-41d4-a716-446655440000",
  "movedPositions": [
    {
      "amountCode": "principal",
      "fromAccount": "1.1.1.01",
      "toAccount": "1.1.2.01"
    }
  ]
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

Authorizations

Authorization

string

header

required

JWT bearer token issued by the identity provider.

Path Parameters

string<uuid>

required

Loan product identifier.

Example:

"550e8400-e29b-41d4-a716-446655440000"

Body

application/json

accountingMode

enum<string>

required

Accounting recognition mode. It must match what the product already books under: the accrual basis is contract economics, frozen on the product version at origination, and only the chart of accounts is datable.

Available options:

accrual,

cash

Example:

"accrual"

effectiveFrom

string<date>

required

First civil day (YYYY-MM-DD) the new chart governs. Always a month start, and always a month that has not opened yet: a chart landing inside the open competência would change the accounts of a month already partly accrued, and one landing on a posted month could never be corrected — the ledger dedupes a replayed month on a key that does not carry which chart produced the posting, so the correction is built, sent, and dropped in silence.

Example:

"2026-08-01"

postingRules

object[]

required

The complete new chart, in the same shape the configure route admits. It must keep every borrower position booked per operation, and must keep every per-operation position the outgoing chart had: a position the new chart stops booking leaves the balance already sitting there with nowhere to go, and the double entry would never complain.

Required array length: 7 - 20 elements

Show child attributes

midazLedgerId

string

Optional per-product Midaz ledger the new chart's postings route into; both-or-neither with midazOrganizationId.

Maximum string length: 128

Example:

"ledger-def"

midazOrganizationId

string

Optional per-product Midaz organization the new chart's postings route into; both-or-neither with midazLedgerId.

Maximum string length: 128

Example:

"org-abc"

Response

Created

charts

object[]

required

The new chart written for every affected version, one per version.

Show child attributes

effectiveFrom

string

required

First civil day (YYYY-MM-DD) the new chart governs.

Example:

"2026-08-01"

loanProductId

string

required

The product whose chart changed (uuid).

Example:

"550e8400-e29b-41d4-a716-446655440000"

movedPositions

object[]

required

Every per-operation position that changes account. Each one produces a balance-transfer posting on the effective date, on every live contract of every affected version, so no contract ends with its balance split across two accounts. Empty means the change files nothing anywhere new.

Show child attributes

Brazil loan products

Consignado operations

Loan product lifecycle

Product versions

Product configuration

Floating-rate tables

Document templates

Loan Applications

Credit instruments

Regulatory disclosures and risk

Payoff and prepayment

Account overview and audit

Charges and schedule

Repayments

Transactions

Returned payment receivables

Assignment funds

Assignment sets

Assignment exceptions and registry

Accounting

Portfolio dashboards

Jurisdictions

Tax

Session

Streaming

Error handling

Events

Supersede loan product chart of accounts

Authorizations

Path Parameters

Body

Response