Add

[POST] .../v1/accountoperationcategory/add

Creates a new income or expense category. Create an income or expense category before it is referenced by payment documents or finance reports. It returns new_id and validates parent_id, name and positive; parent_id must not be negative, name is required and must not exceed 150 characters and positive determines whether the category is income or expense. The caller must have account operation category add permission; missing body, invalid required fields, denied access, hierarchy or duplicate validation failures and storage errors are returned as HTTP 200 ErrorResult.

Request Parameters

Name Type Required Description
name String Required Income or expense category name.
parent_id Int64 Optional Parent income or expense category ID. If not specified, 0 is used.
positive Boolean Required Category type: true - income category, false - expense category.

Request Example

{
  "name": "string",
  "parent_id": 1,
  "positive": true
}

Response Parameters

Name Type Description
ok Boolean Indicates whether the request completed successfully.
result Insert Created record result.

Response Example

{
  "ok": true,
  "result": {
    "new_id": 1
  }
}