Skip to main content
Glama

Taokeh MCP server

File a pending correction draft for a posted invoice (human approves in Taokeh)

update_invoice_draft

FILES A PENDING DRAFT ONLY — NOTHING CHANGES UNTIL A HUMAN REVIEWS AND APPROVES IT IN TAOKEH. Propose a correction to an invoice ALREADY POSTED in Taokeh — the door for an invoice that went onto the books with a wrong line, a wrong date or the wrong payment method. This does NOT change anything: it files a pending DRAFT an ADMIN reviews as a DIFF (current → proposed) and approves; only that tap rewrites the invoice, and it keeps the SAME invoice number, the original attached document and any payment-reminder history. Pass saleId, the invoice's REAL id from search_documents — an invoice number is refused, because two documents can carry the same printed number and correcting the wrong one is worse than asking. ROUTING — three different mistakes, three different doors, and picking the wrong one is expensive. (1) THE SALE NEVER HAPPENED (keyed twice, entered on the wrong company, cancelled before delivery): the owner VOIDS it — Sales → the invoice → Void, in Taokeh. There is deliberately NO AI lane for voiding; erasing a document from the books is a person's decision at the screen. Tell them where to click. (2) THE SALE HAPPENED BUT THE INVOICE IS WRONG (a wrong line, a wrong quantity or price, the wrong date, the wrong payment method): THIS tool. (3) SOMETHING CHANGED AFTER THE SALE (goods came back, a price was renegotiated, a discount was agreed later): create_credit_note_draft — a real event that belongs on the books as its own document, not an erasure of history. WHAT YOU CAN CHANGE: saleDate, paymentMethod ('CASH' or 'CREDIT'), refNo (the customer's own reference / PO number), term (the payment term, stored as written — changing an on-account invoice to one of the five presets, Due on Receipt / Net 7 / Net 14 / Net 30 / Net 60, re-derives the due date from the invoice date unless you also send dueDate, and the admin sees the resulting due date before approving), dueDate (only when the due date ITSELF is wrong — correcting just the invoice date already moves the due date by the same number of days, so the agreed credit period survives), and lines — the FULL REPLACEMENT SET, so send every line the invoice should have, including the ones that were already right. ON A MEASUREMENT COMPANY, do NOT send the small negative rounding line the engine adds under a per-foot line: it is Taokeh's own line, not one of the invoice's, it is preserved untouched by a header-only correction, and it is re-derived from whatever timber line you do send. You cannot mark a line as one either — that is a fact Taokeh reads off the document, never something a caller asserts. WHAT YOU CANNOT, each refused by name: the CUSTOMER (a different customer is a different document — credit this one and raise a new invoice to the right party); the INVOICE NUMBER (preserved across an edit; Taokeh's own Edit screen cannot change it either); and the lines of an invoice that spreads its revenue over time under MFRS 15 (which new line inherits which schedule is a guess, and a guess about deferred revenue is not something a reviewer can check on a diff — header-only corrections still work WHILE the schedule is only part-way through, and keep it intact). On a deferred invoice whose revenue has ALREADY been recognised — any period posted, up to and including a finished schedule — the invoice is closed to edits altogether, header fields included, because rewriting it would re-state revenue in periods that may already be closed and filed; the remedy is a credit note, and the refusal says so. THESE BLOCK AN EDIT OUTRIGHT, checked when you file and again when the admin taps, and each refusal names the real next step: the document is not an invoice; it is validated on MyInvois; it has been submitted to LHDN; it was consolidated from delivery orders; a payment has been allocated to it; it was reversed from a Shopee, TikTok or Shopify Returns page (its reversing journal entry already takes it out of the books, so it can be neither edited nor voided). A LIVE CREDIT OR DEBIT NOTE against the invoice blocks only a lines change: a header-only correction (date, payment method, refNo, term, due date) still files and approves, and the note keeps its number and is re-linked to the corrected invoice. It still refuses if that note has gone to LHDN, or if the new date would fall after the note's date. AND A LOCKED PERIOD BLOCKS THE APPROVAL (2026-09-19): an edit reposts the invoice and removes the original entry, and removing a line from a month the company has already locked and filed is refused — so if the invoice is dated on or before the lock date, the admin's tap is refused by name, even when your proposal re-dates the invoice into an open month. It is checked at APPROVAL, not at filing, so a draft can still be filed against a locked invoice; do not do it — tell the owner instead that the correction has to be a credit note dated today (create_credit_note_draft), which leaves the filed months as filed, or that an admin has to unlock in Opening balances → Review & lock first. A field the invoice already agrees with is dropped, and a proposal that changes nothing is refused rather than filed as an empty diff for a human to tap. If the invoice is edited by someone else after you read it, the admin is shown BOTH versions and the one-tap approval is refused — that is by design; call revise_draft (kind 'invoice_update') to re-read and re-propose. An edit in Taokeh re-books the invoice under a NEW id with the same number: a pending draft FOLLOWS it (it shows as changed since you read it, and revise_draft on the draft still works), and calling this tool with the old id is refused with the new id named — re-read the invoice before proposing against it.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
notesNoA SHORT reviewer note in the reviewer's language: what was wrong, what you changed, and anything they should double-check before they approve a rewrite of a posted document.
saleIdYesREQUIRED — the posted invoice's real id, from search_documents. An invoice number is refused: correcting the wrong document silently is worse than asking which one they mean.
proposedYesONLY what you want changed. An unknown or not-patchable key is refused by name; a proposal the invoice already agrees with is refused rather than filed.
needsReviewNoSet true when something gave you pause — a quantity you inferred, a price the user was unsure about. It flags the draft for the reviewer.
printedTotalNoThe grand total the corrected invoice should show, if the user told you one — cross-checked against the server's own derivation and flagged on the review screen. Reconcile a disagreement in chat; never quietly average the two.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / proposed / properties / lines / description
      Previous value: -"The FULL replacement line set — every line the corrected invoice should have, not only the one that was wrong. Same shape as create_invoice_draft. Omit it entirely when you are only correcting header fields. ⛔ LINE KEYS ARE STRICT, exactly as on create_invoice_draft: a key this schema does not list is REFUSED BY NAME and NOTHING is filed — the EDIT door and the CREATE door judge a line the same way (memory: erp-draft-lane-shared-rules)."New value: +"The FULL replacement line set — every line the corrected invoice should have, not only the one that was wrong. Same shape as create_invoice_draft. Omit it entirely when you are only correcting header fields. A line Taokeh converted from a per-foot or per-piece price prints in tons at a whole-ringgit rate under a note like \"(150' @ RM 0.50/feet)\": send such a line in its FILED form — thickness, width, tally, unit 'feet' or 'pcs', the per-foot or per-piece price (on a purchase, the supplier's cost) and only the grade as the description, never the printed note. On a correction, a PURCHASE line may instead be sent back exactly as it stands on the document; a SELLING line sent back exactly as it stands is read back into its filed form only when its note's price reproduces it (otherwise keep it with { keep: <lineNo> } where offered, or correct the header only); any other line carrying the note follows the rule for a new line — a selling line read back only at its own tons and rate with no discount, a purchase line refused. ⛔ LINE KEYS ARE STRICT, exactly as on create_invoice_draft: a key this schema does not list is REFUSED BY NAME and NOTHING is filed — the EDIT door and the CREATE door judge a line the same way (memory: erp-draft-lane-shared-rules)."
  2. Changed1 schema field changed
    • addedInput schema / properties / proposed / properties / lines / items / properties / unitPrice / description
      Added value: +"Two decimals at most (whole sen, or whole cents in another currency); put a discount or tax in its own field, never folded into the price."
  3. Changed2 schema fields changed
    • changedInput schema / properties / proposed / properties / lines / items / properties / tally / description
      Previous value: -"The piece tally (dimensional lines)."New value: +"The tally as pieces/length_ft pairs — '10/10 12/14' is 10 pieces of 10 ft and 12 of 14 ft — OR the total running feet like 400' when the paper gives no cut list. Never invent a cut list (no '1/400'). With thickness and width this is what the quantity is derived FROM. Every token must be a pieces/length pair — a tally with anything else in it (a grade word, a stray number, '=') is refused; put grade words in the description. A total-feet tally needs thickness and width (or a named size) to work out the tons, and has no pieces, so it cannot carry a per-piece price — both are refused."
    • addedInput schema / properties / proposed / properties / lines / items / properties / unit / description
      Added value: +"The unit the PRICE is quoted in. On a timber company: 'feet' = per running foot, 'pcs' = per piece, 'ton' or omitted = per ton. A per-foot/per-piece price is converted to the per-ton rate from thickness/width/tally, or from a cut list in the description ('2x2 = 10/10 12/14'); a description cut list the server cannot read cleanly is refused — send thickness/width/tally instead."
  4. Changed1 schema field changed
    • changedInput schema / properties / proposed / properties / term / description
      Previous value: -"The payment term as it should read ('Due on Receipt', 'Net 7', 'Net 14', 'Net 30', 'Net 60', or whatever this business actually agreed — it is stored as written, so do not round a real term to the nearest familiar one). Pass null to clear it. ON A POSTED INVOICE THE TERM IS A PRINTED LABEL AND NOTHING MORE: correcting it does NOT move the due date, because the document has already been out of the building and its due date is what the customer was told. If the due date is wrong too, propose `dueDate` explicitly alongside it."New value: +"The payment term as it should read ('Due on Receipt', 'Net 7', 'Net 14', 'Net 30', 'Net 60', or whatever this business actually agreed — it is stored as written, so do not round a real term to the nearest familiar one). Pass null to clear it. On an ON-ACCOUNT invoice, changing to one of the five preset terms re-derives the due date from the invoice date (invoice date + 0/7/14/30/60 days), and the reviewer sees the new due date before approving; a term Taokeh does not recognise moves nothing. To change the term but KEEP the current due date, send `dueDate` alongside it — a stated dueDate always wins."
  5. Changed4 schema fields changed
    • changedInput schema / properties / proposed / properties / lines / description
      Previous value: -"The FULL replacement line set — every line the corrected invoice should have, not only the one that was wrong. Same shape as create_invoice_draft. Omit it entirely when you are only correcting header fields."New value: +"The FULL replacement line set — every line the corrected invoice should have, not only the one that was wrong. Same shape as create_invoice_draft. Omit it entirely when you are only correcting header fields. ⛔ LINE KEYS ARE STRICT, exactly as on create_invoice_draft: a key this schema does not list is REFUSED BY NAME and NOTHING is filed — the EDIT door and the CREATE door judge a line the same way (memory: erp-draft-lane-shared-rules)."
    • addedInput schema / properties / proposed / properties / lines / items / additionalProperties
      Added value: +false
    • addedInput schema / properties / proposed / properties / lines / items / properties / description / description
      Added value: +"The line text as PRINTED on the document, when it says more than the product name does — a size, a grade, a job reference, a period covered. It rides onto the posted line and prints on the customer's copy, so send what the paper says rather than a tidier phrasing of your own. Leave it out when the product name already says it. This is TEXT, not a field: Taokeh has no column for a dimension, a grade or a variant, so anything of that kind belongs here."
    • addedInput schema / properties / proposed / properties / lines / minItems
      Added value: +1
  6. Changed1 schema field changed
    • changedInput schema / properties / proposed / properties / lines / items / properties / quantity / description
      Previous value: -"The corrected line quantity. On a measurement-profile workspace OMIT it whenever you give thickness/width/tally, or write the measure detail into the description ('2x2 = 10/10 12/14') — the server derives the authoritative quantity, and a quantity sent alongside a parseable tally is kept as advisory only, never used to compute."New value: +"The corrected line quantity. On a measurement-profile company OMIT it whenever you give thickness/width/tally, or write the measure detail into the description ('2x2 = 10/10 12/14') — the server derives the authoritative quantity, and a quantity sent alongside a parseable tally is kept as advisory only, never used to compute."
  7. Changed1 schema field changed
    • addedInput schema / properties / proposed / properties / lines / items / properties / quantity / description
      Added value: +"The corrected line quantity. On a measurement-profile workspace OMIT it whenever you give thickness/width/tally, or write the measure detail into the description ('2x2 = 10/10 12/14') — the server derives the authoritative quantity, and a quantity sent alongside a parseable tally is kept as advisory only, never used to compute."
  8. Changed2 schema fields changed
    • addedInput schema / properties / proposed / properties / dueDate
      Added value: +{
      +  "anyOf": [
      +    {
      +      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "The due date as it should read, YYYY-MM-DD. Pass null to clear it, and the invoice date becomes the due date. Send this ONLY when the due date itself is what is wrong — if you are only correcting the INVOICE DATE, leave it out and Taokeh moves the due date by the same number of days, which keeps the agreed credit period intact (Net 30 stays 30 days)."
      +}
    • addedInput schema / properties / proposed / properties / term
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maxLength": 100,
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "The payment term as it should read ('Due on Receipt', 'Net 7', 'Net 14', 'Net 30', 'Net 60', or whatever this business actually agreed — it is stored as written, so do not round a real term to the nearest familiar one). Pass null to clear it. ON A POSTED INVOICE THE TERM IS A PRINTED LABEL AND NOTHING MORE: correcting it does NOT move the due date, because the document has already been out of the building and its due date is what the customer was told. If the due date is wrong too, propose `dueDate` explicitly alongside it."
      +}
  9. Added

TDQS

A4.7/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations (readOnlyHint=false, destructiveHint=false, idempotentHint=false) only sketch the safety profile; the description goes far beyond by disclosing that nothing is applied until an admin taps, that a diff is shown, that the invoice number/document/reminder history are preserved, that new ids are issued on edit, and that locked periods block at approval rather than filing. It also enumerates every refusal class and the cross-checks performed at filing and at approval.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The critical constraint is front-loaded in the first sentence, which is good. However the body is extremely long and repetitive for a 5-parameter tool — ALL-CAPS emphasis throughout, and the filing-vs-approval check and refusal list are restated multiple times. Much of it is justified by genuine complexity, but the volume is well past what an agent needs and dilutes the routing signal.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a nested-schema mutation tool with no output schema and many server-side refusal paths, the description covers the prerequisites (real saleId from search_documents), the editable and non-editable surfaces, the interaction with credit notes, deferred revenue and locked periods, and the recovery path (revise_draft) when the invoice changes underneath. Nothing an agent needs to call this correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and each field is already richly documented, so the baseline is 3; the description still adds value by tying fields together (term vs. dueDate derivation, saleDate moving the due date to preserve the credit period) and by flagging line-level rules absent from the schema, such as omitting the engine's negative rounding line on a measurement company and the full-replacement-set requirement for `lines`. It repeats some schema content, which keeps it short of a 5.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource — files a pending correction DRAFT against an ALREADY POSTED invoice — and immediately scopes what it is not ('NOTHING CHANGES UNTIL A HUMAN REVIEWS AND APPROVES'). It explicitly distinguishes itself from the void path (a person at the screen) and from create_credit_note_draft, so an agent can route correctly without opening any schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides an explicit three-way routing rule (sale never happened → void by hand; sale happened but invoice wrong → this tool; something changed after the sale → create_credit_note_draft), plus named refusal conditions each with the real next step (credit note dated today, admin unlock, revise_draft on a changed draft). When-not-to-use is spelled out as thoroughly as when-to-use.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources