Update to Solibo Home

{
  "description": "Suppliers (leverandører) of a housing community in Solibo Home: find a supplier in the shared catalogue or by organisation number, see which suppliers a company uses with their categories and comments, add or remove a supplier for a company, maintain supplier contacts, import suppliers that appear in the accounting entries, and the supplier-invoice notification settings. Use when the user mentions suppliers, vendors, leverandører, contractors, a company's supplier list, or supplier contacts.",
  "included_files": [
    {
      "relative_path": "references/tool-notes.md",
      "size_in_bytes": 3205
    }
  ],
  "name": "supplier-register",
  "skill_md_contents": "---\nname: supplier-register\ndescription: \"Suppliers (leverandører) of a housing community in Solibo Home: find a supplier in the shared catalogue or by organisation number, see which suppliers a company uses with their categories and comments, add or remove a supplier for a company, maintain supplier contacts, import suppliers that appear in the accounting entries, and the supplier-invoice notification settings. Use when the user mentions suppliers, vendors, leverandører, contractors, a company's supplier list, or supplier contacts.\"\n---\n\n# Supplier register\n\nTwo ids exist: the catalogue supplier id, which every company-supplier tool takes as `supplierId`, and the\nrelationship id (`items[].id` of `search_company_suppliers`), which none of them takes. The `supplierId` in\naccounting entries is a third, company-local id and does not work here either.\n\n## Find\n\n1. Resolve the company; `set_working_company` for a session about one company.\n2. `search_company_suppliers` with `companyId` and `search` lists the company's suppliers:\n   `items[].supplierId` (pass this onward), `name`, `orgNr`, `serviceCategories`.\n3. `get_company_supplier` with `supplierId` adds `comments[]` (each with `id`, `content`, `emoticon`).\n4. The shared catalogue: `search_suppliers` by name, `search_suppliers_by_orgnr` with `orgNrs`; both\n   return `items[].id` (the catalogue id), `name`, `orgNr`. A permission error means the account may not\n   browse the catalogue; say so.\n5. `search_organizations` and `get_organization` find organisations that are not suppliers yet.\n\n## Add, change, remove\n\n- `create_company_supplier` needs `companyId`, `name` and `orgNr`, all three. Find the organisation\n  number first with `search_suppliers_by_orgnr`, `search_suppliers` or `search_organizations`; never guess\n  it. With a working company set, omit `companyId`. Preview, user approval, then `confirm_pending_write`\n  with `previewId` and `confirmed` true.\n- `update_company_supplier_categories` with either `serviceCategories` (the final list; an empty list\n  clears) or `addServiceCategories` and `removeServiceCategories`, not both.\n- `add_supplier_comment` (`content`, optional `emoticon` such as THUMBS_UP) and\n  `set_supplier_comment_emoticon` (`commentId` from `get_company_supplier`; omit `emoticon` to clear).\n- `delete_company_supplier` removes the company's link to the supplier (destructive; confirm).\n\n## Contacts\n\n`list_company_supplier_contacts` with `companyId` and `supplierId` (keep paging even when a page returns\nzero rows for that supplier); contact details appear only with `includeFields`. `create_supplier_contact`\nneeds `name` and `email` or `mobile`, from values the user supplied; `update_supplier_contact` keeps\nomitted fields and refuses to clear both email and mobile; `delete_supplier_contact` is destructive.\n\n## Import from the accounting entries\n\n1. `search_accounting_entries` with the period and the company (integer id) gives `supplierName` per line;\n   collect the distinct names, and the amounts if the user wants a ranking.\n2. For each name, find the organisation number: `search_suppliers` or `search_suppliers_by_orgnr`.\n   Names without a match go to the user as a list to resolve; do not create a supplier without an\n   organisation number.\n3. Compare with `search_company_suppliers` to skip suppliers already linked.\n4. Create the rest with `create_company_supplier`, one preview and one confirmation each, and tell the user\n   how many confirmations to expect before starting. Stop and ask if a preview is refused.\n\n## Notifications\n\n`get_supplier_invoice_notification_settings` (`futureInvoice`, `notifyIds`) and\n`update_supplier_invoice_notification_settings` with `notifyIds` (person ids from\n`list_available_company_administrators`; an empty list clears) or `futureInvoice`.\n\n## Answer shape\n\nA table of suppliers with organisation number and categories; for an import, three lists: linked already,\nto create, and unresolved names. Report a supplier as added only from an executed confirmation.\n\n`references/tool-notes.md` lists the arguments and result fields of every tool named here.\n"
}