v1

latestOpenAPI 3.0.02026-07-2418630310.7 KB
Sync Company-Specific

Submit Bookkeeping Transactions

Allows you to submit, modify, or delete bookkeeping transactions in Silverfin using an incremental approach. This means you must only perform one request at a time per company. Based on the action type, you can add new transactions, update existing ones, or remove them. There is a limit of 500 actions per request. <b>Required scope(s):</b> financials:transactions:sync

post/api/v4/f/{firm_id}/syncs/companies/{company_id}/transactions

Path parameters

firm_idnumber required

The unique identifier of the firm.

company_idnumber required

The unique identifier of the company.

Request body

sync_pointstring required

A unique string representing a sync point used to track sync states.

extra_field_labelsstring[]

Array of labels for extra fields, with a maximum of 10 items.

Example request

{
  "sync_point": "f9a7c6df341325822e3ea264cfe39e5ef8c73aa4",
  "actions": [
    {
      "upsert": {
        "id": "17653417362",
        "account_number": "1234567890",
        "value": 123.45,
        "journal_id": "J-2026-001",
        "journal_type": "Sales",
        "analytical_dimensions": [
          "one",
          "two",
          "three"
        ],
        "extra_fields": [
          "field1",
          "field2"
        ],
        "open_transaction": {
          "value": 42.12
        }
      }
    }
  ],
  "accounts": [
    {
      "number": "1234567890",
      "name": "John Doe"
    }
  ],
  "extra_field_labels": [
    "label1",
    "label2"
  ]
}

Response

Transactions have been successfully processed and accepted.

sync_pointstring required

A unique string representing a sync point used to track sync states.

Example response

{
  "sync_point": "f9a7c6df341325822e3ea264cfe39e5ef8c73aa4"
}