Wstęp

Co to jest KSeF Pipe?

KSeF Pipe to usługa, która udostępnia API, które umożliwia wysyłanie faktur do Krajowego Systemu e-Faktur (KSeF) za pomocą jednego, prostego zapytania HTTP. API zostało zaprojektowane tak, aby maksymalnie uprościć integrację z KSeF i wyeliminować typowe problemy związane z implementacją oficjalnego interfejsu, który do najprostszych nie należy. Ponadto, ministertstwo udostępnia biblioteki tylko do niektórych języków programowania, a API jest niezależne od wykorzystywanego języka.

Zamiast pracować bezpośrednio z XML, podpisami kryptograficznymi i złożonymi procedurami komunikacji z KSeF, możesz wysłać fakturę w prostym formacie JSON przez REST API. Cała złożoność - generowanie XML zgodnego ze schemą KSeF, podpisy kryptograficzne oraz komunikacja z systemem ministerstwa - jest obsługiwana po stronie KSeF Pipe.

Dzięki temu integracja jest szybka i możliwa z dowolnego języka programowania, który potrafi tylko wysyłać zapytania HTTP. KSeF Pipe tłumaczy proste zapytania HTTP na serię skomplikowanych operacji, które trzeba wykonać "pod spodem", by skorzystać z oficjalnego API do KSeF.

Przykład - wysłanie faktury do KSeF

POST /api/v1/taxpayers/1234567819/invoices/sale

{
  "currencyCode": "PLN",
  "number": "FV 1/2026",
  "seller": {
    "baseInfo": {
      "name": "Firma sp. z o.o.",
      "nipNumber": "1234567819"
    },
    "mainAddress": {
      "line1": "Jakaśtam 1/2",
      "line2": "00-001 Warszawa",
      "countryCode": "PL"
    }
  },
  "buyer": {
    "baseInfo": {
      "name": "Ktośtam sp. z o.o.",
      "taxNumber": "1234567825",
      "countryCode": "PL"
    },
    "mainAddress": {
      "line1": "Kręta 3/4",
      "line2": "00-001 Warszawa",
      "countryCode": "PL"
    }
  },
  "issueDate": "2026-02-03",
  "items": [
    {
      "description": "Jakiś produkt",
      "unit": "szt.",
      "quantity": "1",
      "unitPriceNet": "1000",
      "taxRate": "23"
    }
  ]
}