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"
  }
}

Autorizações

Authorization

string

header

obrigatório

JWT bearer token issued by the identity provider.

Parâmetros de caminho

string<uuid>

obrigatório

Loan product identifier.

Exemplo:

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

Corpo

application/json

accountingMode

enum<string>

obrigatório

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.

Opções disponíveis:

accrual,

cash

Exemplo:

"accrual"

effectiveFrom

string<date>

obrigatório

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.

Exemplo:

"2026-08-01"

postingRules

object[]

obrigatório

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

Exemplo:

"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

Exemplo:

"org-abc"

Resposta

Created

charts

object[]

obrigatório

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

Show child attributes

effectiveFrom

string

obrigatório

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

Exemplo:

"2026-08-01"

loanProductId

string

obrigatório

The product whose chart changed (uuid).

Exemplo:

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

movedPositions

object[]

obrigatório

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

Produtos de empréstimo do Brasil

Operações de consignado

Ciclo de vida do produto

Versões do produto

Configuração do produto

Tabelas de taxa flutuante

Modelos de documento

Solicitações de Empréstimo

Instrumentos de crédito

Informações regulatórias e risco

Quitação e pré-pagamento

Visão geral e auditoria da conta

Encargos e cronograma

Pagamentos

Transações

Recebíveis de pagamento devolvido

Fundos de cessão

Lotes de cessão

Exceções e registradora da cessão

Contabilidade

Painéis da carteira

Jurisdições

Impostos

Sessão

Streaming

Tratamento de erros

Eventos

Supersede loan product chart of accounts

Autorizações

Parâmetros de caminho

Corpo

Resposta