Fixed AssetsLink a journal line to an asset

Link a journal line to an asset

POST/firm-partners/workspace/fixed-assets/{uuid}/journal-links

Adds a posted fixed asset line that no asset holds yet to a draft's cost.

Name the record that posted the line with exactly one of `transactionUuid`, `billUuid` or `journalEntryUuid`. A journal entry can be named by its id, one of its line ids or its `journalLinkUuid`, as List journal entries returns them. Every posted fixed asset line already gets its own draft, so to combine two drafts use Merge two draft assets instead. Fixed asset postings (depreciation, disposals), unposted journals and conversion balance journals cannot be linked as cost.

HMAC signature only

Headers

count-workspace-iduuidrequired

UUID of the client workspace to act on. It must be one of your firm's client workspaces (or the firm's own workspace) and within the API key's client workspaces.

Idempotency-Keystringoptional

Client-generated key that makes the call safely retryable. Repeating a key replays the original response; reusing one with a different body is refused.

Path parameters

uuiduuidrequired

The fixed asset UUID (`id` from List fixed assets).

Request body

transactionUuiduuid

The transaction whose fixed asset line to link.

billUuiduuid

The bill whose fixed asset line to link.

journalEntryUuiduuid

The manual journal entry whose fixed asset line to link.

accountUuiduuid

The line's fixed asset account. Needed only when the record posts to more than one.

descriptionstring

Up to 500 characters.

Responses

201The asset's journal links, primary line first.
400Not exactly one source, a record with more than one fixed asset line and no `accountUuid`, a line an asset already holds, a line that is not on a fixed asset account, or a line that cannot be cost.
401Missing signing headers, an invalid HMAC signature, or a timestamp more than 5 minutes off. Troubleshoot
403The key is inactive or its scope does not allow this request, the workspace is not managed by your firm or is outside the key's client workspaces, the workspace has no active subscription, or it is portal-only and the route needs bookkeeping. Troubleshoot
404The asset or the source record is not in this workspace.
429Rate limit exceeded (100 requests per minute per firm user of each app, or 10,000 per minute per app). Troubleshoot
POSThttps://api.getcount.com/firm-partners/workspace/fixed-assets/{uuid}/journal-links
Request
import crypto from 'node:crypto';

const BASE_URL = 'https://api.getcount.com';
const CLIENT_ID = process.env.COUNT_CLIENT_ID;
const CLIENT_SECRET = process.env.COUNT_CLIENT_SECRET;

const method = 'POST';
const signingPath = '/workspace/fixed-assets/3fa85f64-5717-4562-b3fc-2c963f66afa6/journal-links';
const timestamp = Math.floor(Date.now() / 1000).toString();
const body = {
  "billUuid": "0190a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a01"
};
const bodyString = JSON.stringify(body);

const bodyHash = crypto.createHash('sha256').update(bodyString).digest('hex');
const baseString = `${method}:${signingPath}:${timestamp}:${bodyHash}`;
const signature = crypto.createHmac('sha256', CLIENT_SECRET).update(baseString).digest('hex');

const response = await fetch(`${BASE_URL}/firm-partners/workspace/fixed-assets/3fa85f64-5717-4562-b3fc-2c963f66afa6/journal-links`, {
  method,
  headers: {
    'x-client-id': CLIENT_ID,
    'x-timestamp': timestamp,
    'x-signature': signature,
    'Content-Type': 'application/json',
    'count-workspace-id': '5e4d3c2b-1a09-4f8e-8d7c-6b5a49382716',
    'Idempotency-Key': '3fa85f64-5717-4562-b3fc-2c963f66afa6',
  },
  body: bodyString,
});

console.log(await response.json());
Response · 201
{
  "status": "success",
  "message": "Success on linking journal line to fixed asset",
  "data": {
    "journalLinks": [
      {
        "id": "0194c1d2-3e4f-7a5b-8c6d-7e8f9a0b1e01",
        "sourceType": "bill",
        "billId": "0190a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a01",
        "transactionId": null,
        "jeHeaderId": "0194c1d2-3e4f-7a5b-8c6d-7e8f9a0b1f01",
        "amount": "3200.0000",
        "grossAmount": "3680.0000",
        "gstAmount": "480.0000",
        "description": "MacBook Pro 16\"",
        "isPrimaryJournalLink": true,
        "canUnlinkJournalEntry": false
      }
    ]
  }
}