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

Autorizaciones

Authorization

string

header

requerido

JWT bearer token issued by the identity provider.

Parámetros de ruta

string<uuid>

requerido

Loan product identifier.

Ejemplo:

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

Cuerpo

application/json

accountingMode

enum<string>

requerido

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.

Opciones disponibles:

accrual,

cash

Ejemplo:

"accrual"

effectiveFrom

string<date>

requerido

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.

Ejemplo:

"2026-08-01"

postingRules

object[]

requerido

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

Ejemplo:

"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

Ejemplo:

"org-abc"

Respuesta

Created

charts

object[]

requerido

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

Show child attributes

effectiveFrom

string

requerido

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

Ejemplo:

"2026-08-01"

loanProductId

string

requerido

The product whose chart changed (uuid).

Ejemplo:

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

movedPositions

object[]

requerido

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

Productos de préstamo de Brasil

Operaciones de consignado

Ciclo de vida del producto

Versiones del producto

Configuración del producto

Tablas de tasa flotante

Plantillas de documento

Solicitudes de Préstamo

Instrumentos de crédito

Divulgaciones regulatorias y riesgo

Liquidación y prepago

Resumen y auditoría de cuenta

Cargos y calendario

Pagos

Transacciones

Cuentas por cobrar de pago devuelto

Fondos de cesión

Lotes de cesión

Excepciones y registradora de la cesión

Contabilidad

Paneles de cartera

Jurisdicciones

Impuestos

Sesión

Streaming

Manejo de errores

Eventos

Supersede loan product chart of accounts

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta