VRPlatformVRPlatform
General ledger

/general-ledger/opening-trial-balance

Update the manual opening trial balance. Replaces Operating values for editable non-bank ledger rows. Trust-backed rows return importable=false but remain manually editable. Bank rows and existing journal activity after the go-live date are not changed. Submitting a non-editable row returns accountId in the error context. Supports dryRun. See https://docs.vrplatform.app/guides/integrate/opening-trial-balance.

Required scope: general-ledger:write

PUT
/general-ledger/opening-trial-balance
X-API-Key<token>

API key provided in dashboard

In: header

Query Parameters

dryRun?boolean

Validate this request through the real write path, then roll back all changes. See https://docs.vrplatform.app/api/dry-run-mode.

Request Body

application/json

rows*

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://staging.api.vrplatform.app/general-ledger/opening-trial-balance" \  -H "Content-Type: application/json" \  -d '{    "rows": [      {        "accountId": "3d07c219-0a88-45be-9cfc-91e9d095a1e9",        "operatingCentTotal": -9007199254740991      }    ]  }'
{
  "glStartAt": "string",
  "openingDate": "string",
  "source": {
    "mode": "manual",
    "editable": true,
    "lastUpdatedAt": "string",
    "externalConnectionId": "8668fec7-5442-4f84-b4ee-567e9b4bf174"
  },
  "locked": true,
  "lockReasons": [
    "string"
  ],
  "rows": [
    {
      "accountId": "3d07c219-0a88-45be-9cfc-91e9d095a1e9",
      "accountName": "string",
      "classification": "asset",
      "type": "ledger",
      "combinedCentTotal": -9007199254740991,
      "trustCentTotal": -9007199254740991,
      "operatingCentTotal": -9007199254740991,
      "editable": true,
      "importable": true
    }
  ],
  "assignment": {
    "accountId": "3d07c219-0a88-45be-9cfc-91e9d095a1e9",
    "accountName": "string",
    "combinedCentTotal": -9007199254740991,
    "trustCentTotal": -9007199254740991,
    "operatingCentTotal": -9007199254740991
  }
}
{
  "code": "string",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}
{
  "code": "string",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}
{
  "code": "string",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}
{
  "code": "string",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}
{
  "code": "string",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}
{
  "code": "string",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}
{
  "code": "string",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}
{
  "code": "string",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}
{
  "code": "string",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}