Solk ERP API

Send balances

Updates account balances: balance (debit − credit; positive when the customer owes), overdue, credit_limit, currency. The account is found by ext_id or code.

POST/api/erp/v1/balances

Authorization

Authorizationheaderrequired

Solk ERP API key (erp_…): shown once when a Solk ERP API connection is created under Settings → Accounting & ERP. May also be sent as the X-Solk-Erp-Key header.

Body application/json

itemsarrayrequired

Balances: ext_id (or code), balance, overdue, credit_limit, currency.

Errors

HTTP	error	Meaning
`401`	`unauthorized`	Missing, invalid, expired or revoked token.
`400`	`invalid`	Missing or invalid field (`message` explains).
`413`	`too_many`	At most 2,000 records per request.
`429`	`rate_limited`	Per-minute request limit exceeded (`Retry-After`).

Request

curl -X POST https://ornek.solk.app/api/erp/v1/balances \
  -H "Authorization: Bearer $SOLK_ERP_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "items": [
    {
      "ext_id": "120.01.045",
      "balance": 218450.5,
      "overdue": 59400,
      "credit_limit": 500000,
      "currency": "TRY"
    }
  ]
}'

const res = await fetch("https://ornek.solk.app/api/erp/v1/balances", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOLK_ERP_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "items": [
      {
        "ext_id": "120.01.045",
        "balance": 218450.5,
        "overdue": 59400,
        "credit_limit": 500000,
        "currency": "TRY"
      }
    ]
  }),
});
const data = await res.json();

import os, requests

r = requests.post(
    "https://ornek.solk.app/api/erp/v1/balances",
    headers={"Authorization": f"Bearer {os.environ['SOLK_ERP_KEY']}"},
    json={
        "items": [
            {
                "ext_id": "120.01.045",
                "balance": 218450.5,
                "overdue": 59400,
                "credit_limit": 500000,
                "currency": "TRY"
            }
        ]
    },
)
print(r.json())

Response

{
  "ok": true,
  "received": 1,
  "updated": 1
}

Example responses were captured from a v54 installation running sample data; lists are shortened to two items.