№ 01 · Faktomat · AD MMXXVI

Polski produkt · dane w UE

B2B integracja · KSeF FA(3)

FAKTURA PDF, — prosto w twój ERP.

Faktura wpada do Faktomatu przez API, forward maila albo folder watch. Trzydzieści sekund później ustrukturyzowane dane wjeżdżają w twój system sprzedażowy, zakupowy lub magazynowy — razem z JPK_FA(4) XML i e-fakturą KSeF FA(3). Bez przepisywania ręcznego.

Zostaw kontakt → Zobacz jak działa

Wdrożenia pilotażowe na zamówienie · zostaw kontakt — odezwiemy się, gdy otworzymy kolejne miejsca

↓ realny przykład transformacji

FV-2026-05-127 · ACME → Beta · 1 512,90 PLN

FV-2026-05-127.pdf · 1 str

Faktura VAT

nr FV/2026/05/127

data wystawienia2026-05-15 data dostawy2026-05-13 termin płatności2026-05-29

Sprzedawca

ACME Sp. z o.o.

NIP 123-456-78-19

Nabywca

Beta Sp. z o.o.

NIP 987-654-32-10

netto1 230,00 VAT 23%282,90

Razem brutto 1 512,90 PLN

→ ~30 s OCR + LLM

FV-2026-05-127.xml · FA(3)

✓ XSD valid · MF schema

<?xml version="1.0"?>
<Faktura xmlns="http://crd.gov.pl/…13775/">
  <Naglowek>
    <KodFormularza>FA</>
    <WariantFormularza>3</>
    <DataWytworzeniaFa>2026-05-20T11:42:00</>
  </Naglowek>
  <Podmiot1>
    <NIP>1234567819</>
    <Nazwa>ACME Sp. z o.o.</>
  </Podmiot1>
  <Fa>
    <P_1>2026-05-15</>
    <P_2>FV/2026/05/127</>
    <P_6>2026-05-13</>
    <P_13_1>1230.00</>
    <P_14_1>282.90</>
    <P_15>1512.90</>
  </Fa>
</Faktura>

Eksport równolegle: FA(3) · JPK_FA(4) · JSON · CSV — wybierasz to, co czyta twój ERP.

Sekcja · 01

DLA KOGO.

Trzy typy klientów. Jeden problem — czas tracony na przepisywanie danych z PDF do systemu, który ma własne pola, własne ID-y towarów, własny układ kosztowy.

I Persona

FIRMA HANDLOWA · DYSTRYBUTOR

Dziesiątki faktur od dostawców miesięcznie, wszystkie do ręcznego wbijania w Subiekt, Wapro Mag albo Comarch ERP. Pozycji na fakturze — setki.

Efekt : dane gotowe do importu jednym klikiem, magazyn aktualny tego samego dnia.

II Persona

PRODUCENT · FIRMA USŁUGOWA

Surowce, podzespoły, materiały — wszystko z faktur kosztowych musi wpaść w ERP, żeby BOM się zgadzał, a koszty projektu trzymały budżet.

Efekt : koszty projektu aktualne tego samego dnia, bez czekania na koniec miesiąca.

III Persona

E-COMMERCE · HURTOWNIA

Pełny system magazynowo-sprzedażowy (enova365, Subiekt nexo, Streamsoft). Faktury kosztowe rozjeżdżają stany magazynowe, jeśli nie wpadną na czas.

Efekt : faktura od dostawcy → pozycje w magazynie w 30 sekund, bez przepisywania.

Sekcja · 02

DLACZEGO.

Nie zastępujemy twojego ERP-u, magazynu ani programu sprzedażowego — karmimy je strukturą. PDF na wejściu, dane na wyjściu w formacie, który czyta natywnie twój system.

▢ Cecha · 01

WIELE FORMATÓW WYJŚCIA

JPK_FA(4) XML, FA(3) KSeF, JSON i CSV — pobierasz to, co rozumie twój system. Bez zewnętrznych konwerterów i wtyczek.

JPK_FA(4) FA(3) JSON CSV

▢ Cecha · 02

POLSKA SPECYFIKA

Znamy realia polskich faktur — faktury korygujące, mechanizm podzielonej płatności, oznaczenia stawek VAT (NP, OO, ZW) oraz oznaczenia GTU.

▢ Cecha · 03

DANE W UNII EUROPEJSKIEJ

AWS Frankfurt + Amazon Bedrock w regionie eu-central-1. Twoje faktury nie opuszczają UE — pełna zgodność z RODO.

eu-central-1

▢ Cecha · 04

PAY-AS-YOU-GO

Rabaty wolumenowe, faktura VAT, pilotaż 30 dni i custom mapowanie pod twój ERP — wyceniamy pod twój scenariusz.

Sekcja · 03

JAK TO DZIAŁA.

Trzy kroki. Bez konfiguracji po stronie IT, bez instalowania konektorów, bez wdrożenia.

I Krok pierwszy

FAKTURA WPADA DO FAKTOMATU

API POST z twojego systemu, forward maila od dostawcy albo folder watch na wspólnym dysku. Skany papierowe i e-faktury w PDF — bez różnicy.

II Krok drugi

FAKTOMAT EKSTRAKTUJE STRUKTURĘ

NIP-y, daty, kwoty, pozycje, stawki VAT, GTU — w 30 sekund. Pola o niskiej pewności trafiają do kolejki ręcznej weryfikacji; reszta leci dalej automatycznie.

III Krok trzeci

DANE WJEŻDŻAJĄ W TWÓJ ERP

Webhook z gotowym payloadem (JSON / CSV / JPK_FA(4) / FA(3)) albo GET z twojego systemu — zależy, jaki pipeline wolisz. Bez przepisywania ręcznego.

Sekcja · 04

INTEGRACJE.

Działa z każdym programem, z którego korzystasz. Eksport JPK_FA(4) XML, FA(3) KSeF, JSON i CSV importuje się do dowolnego programu — bez integratorów, bez wtyczek, bez wdrożenia po stronie IT.

Wykaz programów · pliki Faktomatu wczytują:

12 pozycji · lista rośnie

Comarch Optima ▢ import

Comarch ERP XL ▢ import

Symfonia ▢ import

Symfonia Handel ▢ import

enova365 ▢ import

Subiekt GT ▢ import

Subiekt nexo ▢ import

Wapro Fakir ▢ import

Wapro Mag ▢ import

Rachmistrz ▢ import

Rewizor ▢ import

Streamsoft ▢ import

Faktomat nie jest powiązany z żadnym z wymienionych producentów — to standardowe formaty wymiany danych (XML / JSON / CSV). brak Twojego? napisz — dorobimy mapowanie

Sekcja · 05

API.

Dla zespołów. Wpinasz Faktomat między swoją skrzynkę a ERP. Jeśli twój zespół przetwarza setki faktur miesięcznie, panel www to za mało — REST API, webhooki, batch upload.

▢ /api/v1

REST API

POST PDF, GET JPK_FA / FA(3) / JSON / CSV — jednym wywołaniem. Klucze API per organizacja, scopes per klucz.

▢ webhooki

WEBHOOKI HMAC

Powiadomienie HTTPS w momencie zakończenia ekstrakcji. HMAC-SHA256 signature, retry z exponential backoff (do 6 prób).

▢ batch

BATCH UPLOAD

Paczka do 50 PDF-ów jednym requestem. Per-plik status zwrotny, idempotency po sha256 — bezpieczne ponawianie.

▢ audyt

AUDIT LOG

Każdy upload / eksport / webhook delivery jest logowany. Pełna ścieżka kto-co-kiedy do kontroli i compliance.

terminal · curl · /api/v1

Bearer auth · PL/EN docs

# 1/3 — wgraj PDF, dostań invoice id
curl -X POST https://faktomat.ewwesolutions.work/api/v1/invoices \
  -H "Authorization: Bearer fkm_live_..." \
  -F "[email protected]"

# 2/3 — odpytaj aż status=completed
curl -H "Authorization: Bearer fkm_live_..." \
  https://faktomat.ewwesolutions.work/api/v1/invoices/<id>

# 3/3 — wciągnij FA(3) XML prosto w swój ERP
curl -H "Authorization: Bearer fkm_live_..." \
  https://faktomat.ewwesolutions.work/api/v1/invoices/<id>/export/fa3 \
  > invoice.fa3.xml

Pełna dokumentacja API + przykłady dla Pythona/Node.js — dostępne wraz z kluczem produkcyjnym. Custom mapowanie pól pod konkretny format importu w twoim ERP — uzgadniamy w pilotażu.

Sekcja · 06

FAQ.

Najczęściej zadawane pytania — bramka MF, FA(3) vs JPK_FA, RODO, błędy modelu, API, pilotaż.

CZY PLIK JPK_FA(4) Z FAKTOMATU ZOSTANIE ZAAKCEPTOWANY PRZEZ BRAMKĘ MF? [ + ]

Tak. Eksportowany XML jest walidowany według oficjalnego schematu XSD JPK_FA(4) publikowanego przez Ministerstwo Finansów — dokładnie tego samego, którego używa bramka. Każdy plik przed pobraniem przechodzi walidację XSD; w razie niezgodności otrzymujesz konkretny komunikat i wadliwego pliku po prostu nie pobierasz.

CZYM RÓŻNI SIĘ JPK_FA(4) OD FA(3) I CZY MACIE OBA? [ + ]

Tak, oba. JPK_FA(4) to plik kontrolny — rejestr faktur, którego urząd skarbowy może zażądać w trakcie kontroli. FA(3) to format ustrukturyzowanej e-faktury używany w Krajowym Systemie e-Faktur (KSeF) i czytany natywnie przez większość polskich systemów sprzedażowych. Z tej samej faktury PDF generujesz oba formaty (oraz JSON i CSV) — wybierasz to, co czyta twój program.

CZY MOJE FAKTURY OPUSZCZAJĄ POLSKĘ LUB UNIĘ EUROPEJSKĄ? [ + ]

Nie. Pliki trafiają na serwery AWS we Frankfurcie (region eu-central-1), a model językowy pracuje w Amazon Bedrock w tym samym regionie. Żadne zapytanie nie wychodzi poza UE. Szyfrowanie zarówno przechowywanych, jak i przesyłanych danych — standardowo.

CO JEŚLI MODEL BŁĘDNIE ODCZYTA DANE? [ + ]

Przed eksportem zobaczysz stronę przeglądu — wszystkie wyodrębnione pola obok podglądu oryginalnego PDF. Pola o niskiej pewności są oznaczone kolorowym wskaźnikiem. Klikasz, poprawiasz, zatwierdzasz „✓ przejrzane" — dopiero wtedy generujemy JPK_FA. Nigdy nie eksportujesz w ciemno.

JAK WYGLĄDA ZGODNOŚĆ Z RODO? [ + ]

Faktomat działa jako podmiot przetwarzający dane na zlecenie klienta, który pozostaje administratorem. Umowa powierzenia przetwarzania (DPA) jest dostępna na żądanie — podpisujemy ją z każdym klientem. Logi audytowe przechowujemy przez 90 dni; dane faktur — do końca okresu obowiązkowej archiwizacji po stronie klienta. Prawo do usunięcia konta i wszystkich danych masz w panelu — jeden klik.

CZY FAKTOMAT ZINTEGRUJE SIĘ Z MOIM PROGRAMEM KSIĘGOWYM / SPRZEDAŻOWYM / MAGAZYNOWYM? [ + ]

W praktyce — tak, z dowolnym. Pobierasz wynik jako JPK_FA(4) XML, FA(3) KSeF, JSON albo CSV i wczytujesz w swoim programie (Comarch Optima, Symfonia, enova365, Subiekt GT/nexo, Wapro Fakir/Mag, Rachmistrz, Rewizor, Streamsoft i inne). Nie instalujemy żadnego konektora, nie wymagamy wdrożenia po stronie IT — to standardowe formaty wymiany. Jeśli twój program oczekuje specyficznego układu pól w CSV, napisz — dorobimy mapowanie.

MACIE REST API? [ + ]

Tak. POST upload, GET status, GET eksport (JPK_FA / FA(3) / JSON / CSV). Klucze API per organizacja, scope-based access. Pełna dokumentacja przy pierwszym kluczu produkcyjnym.

WEBHOOK ON COMPLETION — JAK TO DZIAŁA? [ + ]

Po zakończeniu ekstrakcji POST-ujemy JSON na twoje URL. Podpis HMAC-SHA256 w nagłówku X-Faktomat-Signature (timestamp + payload, sam-jak-Stripe). Retry exponential backoff: 1m → 5m → 30m → 2h → 12h, do 6 prób.

CZY MOGĘ WRZUCIĆ PACZKĘ FAKTUR NA RAZ? [ + ]

Tak — POST /api/v1/invoices/batch przyjmuje do 50 PDF-ów w jednym wywołaniu. Per-plik status zwrotny (ok / duplicate / error). Większe wolumeny rozbijasz na kolejne wywołania.

CUSTOM MAPOWANIE PÓL POD NASZ PROGRAM? [ + ]

Tak, dorabiamy na pilotaż. Eksport CSV trzymamy w generycznym formacie, ale każdy ERP ma swoje oczekiwania nazw kolumn / kolejności. Napisz jaki masz program — przygotujemy custom CSV preset i opublikujemy jako dodatkowy format eksportu w API.

JAK WYGLĄDA PILOTAŻ? [ + ]

Zostawiasz kontakt, ustawiamy 30-dniowy pilot z dedykowanym API key, w trakcie którego dorabiamy mapowanie pól pod twój ERP i pomagamy podpiąć webhook. Po pilocie — zwykła faktura PAYG.