Method

job.get

A job.

Returns one job by GUID, with its owner as a kind (customer or vendor) and GUID.

Examples

Example: with a copy of the synthetic/business-editable example book open as book.gnucash.

JSON-RPC

Request:

{"jsonrpc":"2.0","id":1,"method":"job.get","params":{"job":"3048f991c36143769571bcc833015d53"}}

Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "guid": "3048f991c36143769571bcc833015d53",
    "id": "JOB-1",
    "name": "Website rebuild",
    "owner": {
      "kind": "customer",
      "guid": "5b22073fa4e34411b07c14a77147ce6b"
    },
    "reference": "PO-77",
    "…": "…"
  }
}

Command line

red-ale exec --book book.gnucash job.get '{"job":"3048f991c36143769571bcc833015d53"}'

It prints:

{
  "guid": "3048f991c36143769571bcc833015d53",
  "id": "JOB-1",
  "name": "Website rebuild",
  "owner": {
    "kind": "customer",
    "guid": "5b22073fa4e34411b07c14a77147ce6b"
  },
  "reference": "PO-77",
  "…": "…"
}

MCP tool call

Tool call:

{"name":"job.get","arguments":{"job":"3048f991c36143769571bcc833015d53"}}

Result:

{
  "structuredContent": {
    "guid": "3048f991c36143769571bcc833015d53",
    "id": "JOB-1",
    "name": "Website rebuild",
    "owner": {
      "kind": "customer",
      "guid": "5b22073fa4e34411b07c14a77147ce6b"
    },
    "reference": "PO-77",
    "…": "…"
  }
}

Effect: read.

Params

Names one job.

  • job (Guid, required): The job.

Result

A job.

  • guid (Guid, required): A GUID: 32 hexadecimal digits.
  • id (string, required)
  • name (string, required)
  • owner (OwnerInfo, required): An owner: a customer, vendor, employee or job.
  • reference (string, required)
  • rate (Amount, required): An exact amount. Read from a decimal string ("12.34"), a rational string ("1234/100") or {num, denom} with string members; written as {num, denom}. Never a JSON number.
  • active (boolean, required)