bukku_create_contact

WRITE: create a contact (customer, supplier and/or employee) in Bukku. The contact code must be unique (A-Z, 0-9, _ and -, max 15 characters). POST /contacts.

Argument	Type	Description
email	string
types*	array	Contact types; a contact can be several.
reg_no	string	Registration number. Required for MALAYSIAN_COMPANY (with reg_no_type); individuals need it or tax_id_no.
remarks	string
phone_no	string
tax_id_no	string	Malaysian TIN / tax id (11-14 characters). Required for MALAYSIAN_COMPANY; individuals need it or reg_no.
legal_name*	string	Legal name of the contact.
other_name	string	Trading or display name.
entity_type*	string	Entity type (used for MyInvois).
reg_no_type	string	Registration number type; send together with reg_no.
contact_code*	string	Unique code, for example C-A0001.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "legal_name",
    "contact_code",
    "entity_type",
    "types"
  ],
  "properties": {
    "email": {
      "type": "string",
      "maxLength": 200,
      "minLength": 3
    },
    "types": {
      "type": "array",
      "items": {
        "enum": [
          "customer",
          "supplier",
          "employee"
        ],
        "type": "string"
      },
      "maxItems": 3,
      "minItems": 1,
      "description": "Contact types; a contact can be several."
    },
    "reg_no": {
      "type": "string",
      "maxLength": 30,
      "minLength": 1,
      "description": "Registration number. Required for MALAYSIAN_COMPANY (with reg_no_type); individuals need it or tax_id_no."
    },
    "remarks": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1
    },
    "phone_no": {
      "type": "string",
      "maxLength": 40,
      "minLength": 3
    },
    "tax_id_no": {
      "type": "string",
      "maxLength": 14,
      "minLength": 11,
      "description": "Malaysian TIN / tax id (11-14 characters). Required for MALAYSIAN_COMPANY; individuals need it or reg_no."
    },
    "legal_name": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Legal name of the contact."
    },
    "other_name": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Trading or display name."
    },
    "entity_type": {
      "enum": [
        "MALAYSIAN_COMPANY",
        "MALAYSIAN_INDIVIDUAL",
        "FOREIGN_COMPANY",
        "FOREIGN_INDIVIDUAL",
        "EXEMPTED_PERSON"
      ],
      "type": "string",
      "description": "Entity type (used for MyInvois)."
    },
    "reg_no_type": {
      "enum": [
        "NRIC",
        "BRN",
        "PASSPORT",
        "ARMY"
      ],
      "type": "string",
      "description": "Registration number type; send together with reg_no."
    },
    "contact_code": {
      "type": "string",
      "pattern": "^[A-Z0-9_-]+$",
      "maxLength": 15,
      "minLength": 1,
      "description": "Unique code, for example C-A0001."
    }
  }
}

bukku_create_sales_invoice

WRITE: create a sales invoice for a customer. status defaults to draft (nothing posted to the ledger), status ready finalizes it and affects the books. payment_mode credit needs term_items, cash needs deposit_items. Companies with MyInvois submission switched on must pass myinvois_action when status is ready: NORMAL (not sent), EXTERNAL (already validated elsewhere) or VALIDATE (submits the invoice to LHDN MyInvois, which cannot be taken back). Look up contact, account, term and tax code ids first. POST /sales/invoices.

Argument	Type	Description
date*	string	Invoice date, yyyy-mm-dd.
items*	array	Invoice lines.
title	string
number	string	Invoice number, blank uses the default number format.
status	string	draft (default) or ready.
number2	string	Reference number.
remarks	string
tax_mode*	string	Whether unit prices include tax.
contact_id

bukku_get_account

One ledger account by id. GET /accounts/{id}.

read-only

Argument	Type	Description
account_id*	integer	Bukku account id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "account_id"
  ],
  "properties": {
    "account_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Bukku account id.",
      "exclusiveMinimum": 0
    }
  }
}

bukku_get_bank_transaction

One money in, money out or transfer transaction in full. GET /banking/{incomes|expenses|transfers}/{id}.

read-only

Argument	Type	Description
type*	string	Transaction type.
transaction_id*	integer	Bukku transaction id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "type",
    "transaction_id"
  ],
  "properties": {
    "type": {
      "enum": [
        "money_in",
        "money_out",
        "transfer"
      ],
      "type": "string",
      "description": "Transaction type."
    },
    "transaction_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Bukku transaction id.",
      "exclusiveMinimum": 0
    }
  }
}

bukku_get_contact

One contact with its persons, addresses, tax and registration numbers, default accounts and credit limit. GET /contacts/{id}.

read-only

Argument	Type	Description
contact_id*	integer	Bukku contact id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "contact_id"
  ],
  "properties": {
    "contact_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Bukku contact id.",
      "exclusiveMinimum": 0
    }
  }
}

bukku_get_journal_entry

One journal entry with its debit and credit lines. GET /journal_entries/{id}.

read-only

Argument	Type	Description
transaction_id*	integer	Bukku transaction id of the journal entry.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "transaction_id"
  ],
  "properties": {
    "transaction_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Bukku transaction id of the journal entry.",
      "exclusiveMinimum": 0
    }
  }
}

bukku_get_lookup_lists

Reference data needed to fill in documents: tax codes, payment terms, payment methods, currencies, countries, accounts, contact groups, product groups, price levels, tag groups, number formats, custom fields and company settings. Read-only (POST /v2/lists is a read endpoint).

read-only

Argument	Type	Description
lists*	array	Which lists to return, for example ["tax_codes", "terms"].

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "lists"
  ],
  "properties": {
    "lists": {
      "type": "array",
      "items": {
        "enum": [
          "accounts",
          "classification_code_list",
          "contact_groups",
          "countries",
          "currencies",
          "fields",
          "number_formats",
          "payment_methods",
          "price_levels",
          "product_groups",
          "settings",
          "tag_groups",
          "tax_codes",
          "terms"
        ],
        "type": "string"
      },
      "maxItems": 14,
      "minItems": 1,
      "description": "Which lists to return, for example [\"tax_codes\", \"terms\"]."
    }
  }
}

bukku_get_product

One product with its units, prices, accounts and tax settings. GET /products/{id}.

read-only

Argument	Type	Description
product_id*	integer	Bukku product id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "product_id"
  ],
  "properties": {
    "product_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Bukku product id.",
      "exclusiveMinimum": 0
    }
  }
}

bukku_get_purchase_document

One purchase document in full (lines, taxes, terms, payments, status): a bill, order, goods received note, credit note, payment or refund. GET /purchases/{type}/{id}.

read-only

Argument	Type	Description
type*	string	Document type.
transaction_id*	integer	Bukku transaction id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "type",
    "transaction_id"
  ],
  "properties": {
    "type": {
      "enum": [
        "bill",
        "order",
        "goods_received_note",
        "credit_note",
        "payment",
        "refund"
      ],
      "type": "string",
      "description": "Document type."
    },
    "transaction_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Bukku transaction id.",
      "exclusiveMinimum": 0
    }
  }
}

bukku_get_sales_document

One sales document in full (lines, taxes, terms, payments, status): an invoice, quote, order, delivery order, credit note, payment or refund. GET /sales/{type}/{id}.

read-only

Argument	Type	Description
type*	string	Document type.
transaction_id*	integer	Bukku transaction id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "type",
    "transaction_id"
  ],
  "properties": {
    "type": {
      "enum": [
        "invoice",
        "quote",
        "order",
        "delivery_order",
        "credit_note",
        "payment",
        "refund"
      ],
      "type": "string",
      "description": "Document type."
    },
    "transaction_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Bukku transaction id.",
      "exclusiveMinimum": 0
    }
  }
}

bukku_list_accounts

List ledger accounts from the chart of accounts, optionally by category. Account ids are used on invoice lines. GET /accounts.

read-only

Argument	Type	Description
search	string	Keywords to search for in the accounts (max 100 characters).
category	string
sort_dir	string	Sort direction.
is_archived	boolean	true to show deactivated accounts instead of active ones (default false).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "search": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Keywords to search for in the accounts (max 100 characters)."
    },
    "category": {
      "enum": [
        "assets",
        "liabilities",
        "equity",
        "income",
        "expenses"
      ],
      "type": "string"
    },
    "sort_dir": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "description": "Sort direction."
    },
    "is_archived": {
      "type": "boolean",
      "description": "true to show deactivated accounts instead of active ones (default false)."
    }
  }
}

bukku_list_bank_transactions

List banking transactions: money in (incomes), money out (expenses) or transfers between accounts. contact_id and sort_by do not apply to transfers. GET /banking/{incomes|expenses|transfers}.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
type*	string	Which banking transactions to list.
search	string	Keywords in the number, reference, title, remarks, description or contact.
status	string	Only transactions with this status. Without it every status except void is returned.
date_to	string	A date, yyyy-mm-dd.
sort_by	string	Money in / money out only.
sort_dir	string	Sort direction.
date_from	string	A date, yyyy-mm-dd.
page_size	integer

bukku_list_contact_groups

List the contact groups; use their ids to filter bukku_list_contacts. GET /contacts/groups.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

bukku_list_contacts

List contacts (customers, suppliers, employees) with name, code, type, receivable and payable balances. Search matches the name, receivable, payable and created date. GET /contacts.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
type	string	Only this contact type.
search	string	Keywords in the name, receivable, payable or created date (max 100 characters).
status	string	ACTIVE (default), INACTIVE (archived) or ALL contacts.
sort_by	string
group_id	integer	Only contacts in this contact group (see bukku_list_contact_groups).
sort_dir	string	Sort direction.
page_size	integer	Results per page, 1-100 (default 30).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "type": {
      "enum": [
        "customer",
        "supplier",
        "employee"
      ],
      "type": "string",
      "description": "Only this contact type."
    },
    "search": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Keywords in the name, receivable, payable or created date (max 100 characters)."
    },
    "status": {
      "enum": [
        "ALL",
        "ACTIVE",
        "INACTIVE"
      ],
      "type": "string",
      "description": "ACTIVE (default), INACTIVE (archived) or ALL contacts."
    },
    "sort_by": {
      "enum": [
        "name",
        "receivable",
        "payable",
        "created_at"
      ],
      "type": "string"
    },
    "group_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only contacts in this contact group (see bukku_list_contact_groups).",
      "exclusiveMinimum": 0
    },
    "sort_dir": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "description": "Sort direction."
    },
    "page_size": {
      "type": "integer",
      "maximum": 100,
      "description": "Results per page, 1-100 (default 30).",
      "exclusiveMinimum": 0
    }
  }
}

bukku_list_journal_entries

List manual journal entries by date, status or keywords. GET /journal_entries.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
search	string	Keywords in the number, reference, title, remarks or description.
status	string	Only transactions with this status. Without it every status except void is returned.
date_to	string	A date, yyyy-mm-dd.
sort_dir	string	Sort direction.
date_from	string	A date, yyyy-mm-dd.
page_size	integer	Results per page, 1-100 (default 30).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "search": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Keywords in the number, reference, title, remarks or description."
    },
    "status": {
      "enum": [
        "draft",
        "pending_approval",
        "ready",
        "void"
      ],
      "type": "string",
      "description": "Only transactions with this status. Without it every status except void is returned."
    },
    "date_to": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "A date, yyyy-mm-dd."
    },
    "sort_dir": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "description": "Sort direction."
    },
    "date_from": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "A date, yyyy-mm-dd."
    },
    "page_size": {
      "type": "integer",
      "maximum": 100,
      "description": "Results per page, 1-100 (default 30).",
      "exclusiveMinimum": 0
    }
  }
}

bukku_list_product_groups

List the product groups. GET /products/groups.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

bukku_list_products

List products and bundles (sales and purchase details, SKU, stock). GET /products.

read-only

Argument	Type	Description
mode	string	Only products sold or only products purchased.
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
type	string
search	string	Keywords in the name, SKU, sale or purchase description or remarks (max 60 characters).
sort_dir	string	Sort direction.
page_size	integer	Results per page, 1-100 (default 30).
include_archived	boolean	true to include archived products.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "mode": {
      "enum": [
        "sale",
        "purchase"
      ],
      "type": "string",
      "description": "Only products sold or only products purchased."
    },
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "type": {
      "enum": [
        "product",
        "bundle"
      ],
      "type": "string"
    },
    "search": {
      "type": "string",
      "maxLength": 60,
      "minLength": 1,
      "description": "Keywords in the name, SKU, sale or purchase description or remarks (max 60 characters)."
    },
    "sort_dir": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "description": "Sort direction."
    },
    "page_size": {
      "type": "integer",
      "maximum": 100,
      "description": "Results per page, 1-100 (default 30).",
      "exclusiveMinimum": 0
    },
    "include_archived": {
      "type": "boolean",
      "description": "true to include archived products."
    }
  }
}

bukku_list_purchase_bills

List purchase bills with number, date, supplier, amount, balance and payment status. Filter by date, supplier, payment status (PAID, OUTSTANDING, OVERDUE) or keywords. GET /purchases/bills.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
search	string
status	string	Only transactions with this status. Without it every status except void is returned.
date_to	string	Bills dated on or before this day, yyyy-mm-dd.
sort_dir	string	Sort direction.
date_from	string	Bills dated on or after this day, yyyy-mm-dd.
page_size	integer	Results per page, 1-100 (default 30).
contact_id	integer	Only bills of this supplier.
payment_mode	string

bukku_list_purchase_documents

List purchase orders, goods received notes, supplier credit notes, supplier payments or refunds (bills have their own tool, bukku_list_purchase_bills). payment_status applies to credit notes, payments and refunds only. GET /purchases/{orders|goods_received_notes|credit_notes|payments|refunds}.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
type*	string	Which purchase document to list.
search	string
status	string	Only transactions with this status. Without it every status except void is returned.
date_to	string	A date, yyyy-mm-dd.
sort_dir	string	Sort direction.
date_from	string	A date, yyyy-mm-dd.
page_size	integer	Results per page, 1-100 (default 30).
contact_id

bukku_list_sales_documents

List quotes, sales orders, delivery orders, credit notes, customer payments or refunds (invoices have their own tool, bukku_list_sales_invoices). payment_status applies to credit notes, payments and refunds only. GET /sales/{quotes|orders|delivery_orders|credit_notes|payments|refunds}.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
type*	string	Which sales document to list.
search	string
status	string	Only transactions with this status. Without it every status except void is returned.
date_to	string	A date, yyyy-mm-dd.
sort_dir	string	Sort direction.
date_from	string	A date, yyyy-mm-dd.
page_size	integer	Results per page, 1-100 (default 30).
contact_id	integer

bukku_list_sales_invoices

List sales invoices with number, date, contact, amount, balance and payment status. Filter by date, customer, payment status (PAID, OUTSTANDING, OVERDUE) or keywords. GET /sales/invoices.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
search	string	Keywords in the number, reference, title, remarks, description, contact or billing/shipping party.
status	string	Only transactions with this status. Without it every status except void is returned.
date_to	string	Invoices dated on or before this day, yyyy-mm-dd.
sort_by	string
sort_dir	string	Sort direction.
date_from	string	Invoices dated on or after this day, yyyy-mm-dd.
page_size	integer	Results per page, 1-100 (default 30).
contact_id	integer

bukku_list_tags

List the tags (labels) that can be put on transactions. GET /tags.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

bukku_set_contact_archived

WRITE: archive (is_archived true) or restore (false) a contact. Archiving hides it from active lists; nothing is deleted. PATCH /contacts/{id}.

Argument	Type	Description
contact_id*	integer	Bukku contact id.
is_archived*	boolean	true to archive, false to unarchive.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "contact_id",
    "is_archived"
  ],
  "properties": {
    "contact_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Bukku contact id.",
      "exclusiveMinimum": 0
    },
    "is_archived": {
      "type": "boolean",
      "description": "true to archive, false to unarchive."
    }
  }
}

Bukku MCP by usefulapi

Try it

bukku_create_contact

Bukku MCP by usefulapi

Try it

bukku_create_contact

Tools (23)