> ## Documentation Index > Fetch the complete documentation index at: https://mcp.klark.app/llms.txt > Use this file to discover all available pages before exploring further. # Factures, BC & BL > 27 outils — Factures, devis, bons de commande, bons de livraison et paiements ## list\_invoices `Lecture seule` List invoices and quotes with pagination and filters Page number Items per page (max 50) Filter by status — Valeurs : draft | sent | partially\_paid | paid | overdue | cancelled Filter by type — Valeurs : invoice | quote ## get\_invoice `Lecture seule` Get full details of an invoice or quote by ID The invoice ID ## create\_invoice `Écriture` Create a new invoice or quote and generate its PDF. Use get\_client first to retrieve the client's address IDs (client.addresses\[].\_id). Client ID Billing address ID — one of client.addresses\[].\_id. Use get\_client to retrieve the address list first. Document type — Valeurs : invoice | quote Line items Remises/frais au niveau document (offre -X%, frais de préparation, envoi suivi, points fidélité…) Delivery address ID (optional) Due date (ISO format) Public notes on the document Payment terms text ## get\_invoice\_payments `Lecture seule` Get all recorded payments for a specific invoice The invoice ID ## record\_payment `Écriture` Record a payment (partial or full) on an invoice. Automatically updates amountPaid, balanceDue and invoice status. The invoice ID Payment amount (in the invoice currency) Payment method (must match the invoice model enum) — Valeurs : bank\_transfer | card | cash | check | other Payment date (ISO format, defaults to today) Optional note about this payment ## delete\_payment `Écriture — destructif` Delete a recorded payment from an invoice and recalculate the balance The invoice ID The payment ID to delete (from invoice.payments\[].\_id) ## schedule\_invoice\_reminder `Écriture` Schedule an email reminder for an invoice (e.g. before or after due date) The invoice ID Date to send the reminder (ISO format, e.g. "2025-12-01T09:00:00Z") Reminder type — Valeurs : before\_due | after\_due Notification channel — Valeurs : email | sms ## update\_invoice\_status `Écriture` Update the status of an invoice or quote The invoice ID New status. L'envoi (« sent ») et l'annulation (« cancelled ») se font manuellement dans Klark après vérification — non disponibles via l'assistant. — Valeurs : draft | partially\_paid | paid | overdue ## delete\_invoice `Écriture — destructif` Delete a draft invoice and its PDF The invoice ID to delete ## send\_e\_invoice `Écriture — service externe` Send an invoice electronically via SuperPDP (e-invoicing) The invoice ID to send electronically ## get\_e\_invoice\_status `Lecture seule` Get the e-invoicing status of an invoice from SuperPDP The invoice ID ## download\_invoice\_pdf `Lecture seule` Get the PDF download URL for an invoice The invoice ID ## list\_purchase\_orders `Lecture seule` List purchase orders (BC) received from clients. A purchase order is a document the user RECEIVES from one of their clients (not sent). Use this to count pending POs, find a specific one, or summarize unprocessed orders. Filter by status: received (default), in\_progress, invoiced (converted to invoice), cancelled. Filter by status. Omit to get all. — Valeurs : draft | received | in\_progress | invoiced | cancelled Filter by client ## get\_purchase\_order `Lecture seule` Get full details of a purchase order by ID (including items, totals, client snapshot, and optional OCR source info). Purchase order ID ## create\_purchase\_order `Écriture` Create a purchase order received from a client (manual data entry, no OCR). For OCR-extracted data from a scanned PO, use create\_purchase\_order\_from\_ocr instead. Use get\_client first to retrieve client.addresses\[].\_id, and get products via list\_products. Client ID Billing address ID (one of client.addresses\[].\_id) Delivery address ID (optional) Line items Date the PO was issued by the client (ISO) Client's internal reference (e.g. "PO-2026-042") Custom fields (numéro client, code avantage, remise, coloris, taille, etc.) Remises/frais au niveau document (offre -X%, frais de préparation, envoi suivi, points fidélité…) ## create\_purchase\_order\_from\_ocr `Écriture` Create a purchase order from OCR-extracted data. Use this tool when YOU (the LLM) have scanned a PO document via your own vision capabilities (Claude vision, Gemini multimodal, etc.) and extracted the structured data. Pass `extractedBy` to track which tool was used (e.g. "claude", "gemini", "openai"). The `ocrSource.fileUrl` should point to the original scanned file if available (e.g. Wasabi or any public URL). Client ID — use search\_clients if not sure Billing address ID — from client.addresses Extracted date the client emitted the PO Extracted reference from the scanned document Custom fields (numéro client, code avantage, remise, coloris, taille, etc.) Remises/frais au niveau document (offre -X%, frais de préparation, envoi suivi, points fidélité…) OCR metadata for traceability ## update\_purchase\_order `Écriture` Update an existing purchase order (status, notes, items, etc.). Cannot update if the PO has already been converted to an invoice — in that case modify the invoice instead. Valeurs : draft | received | in\_progress | invoiced | cancelled Custom fields (numéro client, code avantage, remise, coloris, taille, etc.) ## delete\_purchase\_order `Écriture — destructif` Permanently delete a purchase order. Refused if the PO has been converted to an invoice (the invoice must be deleted first, or mark the PO as cancelled via update\_purchase\_order). ## convert\_purchase\_order\_to\_invoice `Écriture` Transform a purchase order into an official invoice. Creates a new Invoice with the PO's items, generates the PDF, and marks the PO as `invoiced` with a link to the new invoice. Idempotent: if the PO was already converted, returns the existing invoice. Returns the invoice with its PDF URL for download. Override billing address (default: same as PO) Invoice due date (ISO). Default: 30 days from now. ## list\_delivery\_notes `Lecture seule` List delivery notes (bons de livraison) with pagination and filters. Filter by sourcePurchaseOrderId to get all delivery notes of a given purchase order. Valeurs : draft | delivered | cancelled Filter by source purchase order ## get\_delivery\_note `Lecture seule` Get full details of a delivery note by ID (items with delivered quantities, addresses, carrier, link to source purchase order). Delivery note ID ## create\_delivery\_note `Écriture` Create a delivery note (bon de livraison) — quantities only, no prices. Pass sourcePurchaseOrderId to attach it to a purchase order: this enables partial delivery tracking (delivered quantity must be \<= remaining; over-delivery is blocked). Without it, the delivery note is standalone. Use get\_purchase\_order to read remaining quantities (orderedQuantity - deliveredQuantity) per line. Client ID Billing address ID (one of client.addresses\[].\_id) Delivery address ID (optional) Delivered line items Source purchase order ID (enables partial delivery tracking) Delivery date (ISO) Initial status (default 'delivered') — Valeurs : draft | delivered ## update\_delivery\_note `Écriture` Update a delivery note metadata (status draft|delivered, notes, delivery date, carrier, tracking number). To cancel, use cancel\_delivery\_note instead. Valeurs : draft | delivered ## cancel\_delivery\_note `Écriture` Cancel a delivery note. Restores the delivered quantities back to the remaining-to-deliver of the source purchase order (if any). ## get\_delivery\_note\_pdf `Écriture` Generate (or return) the stored PDF of a delivery note and return its URL. Pass regenerate=true to force regeneration. ## convert\_delivery\_note\_to\_invoice `Écriture` Invoice a delivery note (facturation au bon de livraison): generates an invoice with the DELIVERED quantities and the unit prices taken from the source purchase order. Idempotent (a delivery note can only be invoiced once). Not available for standalone delivery notes (no source prices). Override billing address (defaults to the delivery note one) Invoice due date (ISO) ## send\_delivery\_note `Écriture` Send a delivery note by email with the PDF attached (e.g. to a warehouse or subcontractor). Recipient email Optional custom message