List KSeF purchase invoices

Invoices that suppliers sent to you in KSeF and you have not booked yet.

MCP tool ifirma_read → list_ksef_purchase_invoices

read

Downloads new purchase invoices from KSeF into the "Faktury z KSeF" list and returns them. Each item has the seller document number, KSeF number, document type, seller NIP, issue date, and net and gross amounts. The date is the seller issue date, not the date sent to KSeF. Documents already booked are not returned.

Parameters

Parameters: list_ksef_purchase_invoices
NameTypeDescription
issued_from string required string YYYY-MM-DD, the first seller issue date to download.

tools/call

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ifirma_read",
    "arguments": {
      "operation": "list_ksef_purchase_invoices",
      "arguments": {
        "issued_from": "issued from"
      }
    }
  }
}

Example response

JSON

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "invoices": [
      {
        "ksef_number": "7010003987-20261012-AB12CD34EF56-7A",
        "seller_number": "FV 118/2026",
        "type": "vat",
        "seller_nip": "7010003987",
        "issue_date": "2026-10-12",
        "net": 650.41,
        "gross": 800
      },
      {
        "ksef_number": "5252248481-20261010-9F8E7D6C5B4A-12",
        "seller_number": "ZAL 7/2026",
        "type": "advance",
        "seller_nip": "5252248481",
        "issue_date": "2026-10-10",
        "net": 2000,
        "gross": 2460
      }
    ]
  },
  "isError": false
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.