Integracja ERP z KSeF bez zgadywania, czemu XML znowu nie przeszedł
Publiczne API walidacji XML, korekt FA-3, webhooks i analytics. Klucz API w 30 sekund, SDK TypeScript i PHP, SLA 99.9% z automatycznym creditem przy degradacji.
REST API, webhooks, SDK TS i PHP, OpenAPI 3.1, presety Trawers i Comarch. Dla integratorów z portfelem klientów dedykowany partner program z Magic Invite Trial (14 dni bez karty dla Twoich klientów).
Mniej zgłoszeń od klientów końcowych, mniej eskalacji do developerów i mniej "pilnych" poprawek robionych w ciemno.
Wygeneruj klucz, wyślij XML, dostań werdykt
Klucz API tworzysz w panelu w 30 sekund. Format nk_live_*. Idempotency keys, rate limity zgodne z RFC 6585, pełna dokumentacja błędów - wszystko w portalu developera.
curl -X POST https://api.naprawksef.pl/api/v1/validate \
-H "Authorization: Bearer nk_live_..." \
-H "Content-Type: application/xml" \
-H "Idempotency-Key: $(uuidgen)" \
--data-binary @faktura.xmlerrors[] z pozycją w XML i ścieżką XPath - logujesz, pokazujesz userowi albo blokujesz wysyłkę.Kompletny stack do integracji
Sześć rzeczy, które zwykle musisz złożyć samodzielnie. U nas są w cenie planu.
REST API v1
OpenAPI 3.1, Postman collection, idempotency keys, rate limits zgodne z RFC 6585. Endpointy: /validate, /correction, /api-keys, /webhooks.
SDK TypeScript i PHP
Oficjalne SDK z typesafe response, retry-with-backoff i webhook signature verification out of the box.
Webhooks z HMAC
Podpisany payload (X-NK-Signature), automatyczny retry z exponential backoff, dashboard deliverability z replay one-click.
SLA 99.9% z auto-creditami
Status platformy publiczny, miesięczny raport SLA per organizacja, automatyczny credit do następnej faktury Stripe przy spadku poniżej 99.9%.
Presety ERP
Pre-mapped Trawers (12 kodów VAT, JPK_V7M aliasy, advance-jpk-reclassify) i Comarch. Dodanie kolejnego ERP = jedno zgłoszenie.
Magic Invite Trial
Twój klient dostaje od Ciebie jeden link, klika i ma 14 dni planu Pro/API bez karty. Bez tickets, bez onboardingu po naszej stronie.
Najczęstsze use case'y
To nie jest teoretyczny landing. To są sytuacje, w których integracja naprawdę ma sens.
Validate before send
Zanim faktura poleci do KSeF, sprawdzasz strukturę i typowe błędy po swojej stronie. Mniej odrzuceń, mniej nerwów, mniej retry.
Webhook-driven workflow
Subskrybujesz invoice.validated, invoice.failed i correction.ready. ERP reaguje asynchronicznie, bez pollingu i bez timeoutów.
Multi-tenant dla biur i SaaS
Jedno konto, wielu klientów, oddzielne metryki SLA per organizacja. API keys z scope i IP allowlist na poziomie produkcyjnym.
Lepszy rollout KSeF u klientów końcowych
Pre-mapped presety dla popularnych ERP (Trawers, Comarch) plus własna logika przez API. Mniej edge case'ów odkrywanych dopiero na produkcji.
Jak to działa
Generujesz XML u siebie
W ERP, middleware albo w dedykowanej integracji dla klienta końcowego. Jeden HTTP POST do /api/v1/validate.
Walidujesz przed wysyłką
Pełna walidacja XSD plus reguły biznesowe FA-3 i mapowania ERP-specific (Trawers, Comarch). Response w milisekundach.
Obsługujesz wynik po swojemu
Blokujesz wysyłkę, pokazujesz user-friendly error, zlecasz autofix albo subskrybujesz webhook invoice.validated i działasz asynchronicznie.
Co zyskujesz
publiczne API gotowe do integracji - klucz w 30 sekund, bez tickets
SDK TS i PHP plus OpenAPI 3.1 do generowania klienta w dowolnym języku
SLA 99.9% z automatycznym creditem w Stripe przy degradacji platformy
webhooks z HMAC i idempotency - integracja asynchroniczna bez pollingu
presety ERP (Trawers, Comarch) skracają czas wdrożenia u klienta do minut
dedicated partner program z revenue share dla integratorów i biur
Partner program daje revenue share, white-label invite linki dla Twoich klientów i dedykowany SLA dla wdrożeń przez Twoją firmę.
FAQ
Najważniejsze pytania od zespołów technicznych i wdrożeniowych.
Czy API jest self-service?
Tak. Klucz API wygenerujesz w 30 sekund w /dashboard/api-keys (format nk_live_*). Pełna dokumentacja w /developers, quickstart z curl/TS/PHP, OpenAPI 3.1 do pobrania, Postman collection. Bez tickets, bez waitlisty.
Jakie SDK są dostępne?
Oficjalne SDK TypeScript (@naprawksef/sdk na npm) i PHP (naprawksef/sdk na Packagist). Oba mają typesafe response, retry-with-backoff, webhook signature verification i instrukcje instalacji w /developers/sdk-typescript oraz /developers/sdk-php.
Czy macie preset dla mojego ERP?
Out of the box: Trawers ERP (TRES) i Comarch ERP. Każdy preset to mapowanie kodów VAT, JPK_V7M aliasy i logika typu advance-jpk-reclassify - klient nie musi mapować ręcznie. Brakuje Twojego? Zgłoś przez /integration-partners, dodanie to dni a nie miesiące.
Jaki jest SLA i co się dzieje przy degradacji?
99.9% miesięcznie dla planów Pro/API. Status platformy publiczny na /platform-status (i /api/v1/status dla monitoringu). Spadek poniżej 99.9% w danym miesiącu = automatyczny credit w Stripe na następną fakturę, bez konieczności zgłaszania.
Czy to zastępuje integrację z KSeF?
Nie. To warstwa walidacji przed wysyłką plus narzędzia do korekt FA-3, webhooks i analytics. KSeF nadal komunikuje się bezpośrednio z Twoim ERP. NaprawKSeF eliminuje rejecty i support overhead.
Jak działa Magic Invite Trial dla moich klientów?
Z poziomu /integration-partners generujesz invite link dla klienta. Klient klika, podpisuje regulamin jednym kliknięciem i ma 14 dni planu Pro/API bez karty. Ty masz wgląd w aktywację i konwersję na płatny plan, my przejmujemy onboarding techniczny.
Mamy własny program partnerski - jak nawiązać współpracę?
Dla integratorów ERP, software house'ów i biur z portfelem klientów uruchomiliśmy Partner Program z revenue share. Szczegóły i formularz na /integration-partners. Dla pojedynczych większych deal-i (volumeny >10k dokumentów/mies., custom SLA) - przez /kontakt.
Trzy ścieżki, jedno API
Wybierz, jak chcesz wystartować. Wszystkie prowadzą do tego samego stacku Platform v1.0.
Self-serve developer
Twoim zespole wystarczy klucz API i dokumentacja. Klucz w 30 sekund, SDK i Postman collection w portalu.
Integrator z portfelem klientów
Partner program z revenue share, Magic Invite Trial (14 dni bez karty), white-label możliwości i preset dla Twojego ERP.
Custom enterprise
Volumeny >10k dokumentów/miesiąc, dedicated SLA, on-prem data residency albo custom presety. Pogadamy konkretnie.