Trawers ERP 7 ↔ KSeF FA(3): preset, REST API i paczka audytowa
Natywna integracja warstwy walidacji i korekt KSeF z systemem Trawers 7 - preset mapuje wewnętrzne kody VAT i aliasy pól JPK, scenariusz advance-jpk-reclassifywystawia KOR_ZAL metodą StanPrzed/StanPo, a REST API z SDK TypeScript/PHP pozwala zautomatyzować całość z poziomu backendu Trawers. Część Platform v1.0 - klient z Trawersem ma zerowy nakład pracy konfiguracyjnej.
Co dostajesz w presetcie Trawers v7
Wybór presetu Trawers 7 w kreatorze korekt (lub parametr preset=trawers-v7 w REST API) włącza pełen zestaw mapowań i scenariuszy dedykowanych systemowi TRES.
Mapowanie kodów VAT (preset trawers-v7)
Każdy kod VAT po stronie Trawers jest tłumaczony na wartość P_12 zgodną z FA(3) oraz na pole JPK_V7M w korektach reklasyfikujących.
| Trawers | KSeF P_12 | JPK_V7M | Opis |
|---|---|---|---|
| 01 | 23 | K_19 | Krajowa 23% |
| 02 | 8 | K_17 | Krajowa 8% |
| 03 | 5 | K_15 | Krajowa 5% |
| 04 | 0 KR | K_13 | Krajowa 0% (dokumentacja w toku) |
| 05 | zw | - | Zwolnienie |
| 06 | np | - | Nie podlega |
| 10 | 0 EX | K_22 | Eksport (kraj spoza UE) |
| 11 | 0 WDT | K_21 | WDT (UE + aktywny VAT-UE) |
| 12 | oo | K_29 | Odwrotne obciążenie |
Źródło mapowań: publiczna dokumentacja Trawers KSeF 2.3. Synchronizujemy się z wydaniami TRES; jeśli wykryjesz różnicę, daj znać przez kontakt.
Wywołanie REST API z presetem
Z poziomu backendu Trawers (lub warstwy pośredniczącej) wystarczy pojedynczy POST: przekazujesz XML faktury pierwotnej, scenariusz i listę zmian, a w odpowiedzi otrzymujesz gotową korektę FA(3) wraz z walidacją i pełną historią.
- Autoryzacja Bearer (klucz API typu
nk_live_*z uprawnieniemcorrection) - Nagłówek Idempotency-Key - bezpieczne ponowienie próby przy przekroczeniu czasu odpowiedzi sieci
- Webhook
correction.createdz danymi zdarzenia (scenario, delty, numer) - Limit zapytań naliczany per klucz oraz miesięczny limit planu per organizacja
curl -X POST https://naprawksef.pl/api/v1/correction/build \
-H "Authorization: Bearer $NK_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: trawers-kor-2026-05-001" \
-d '{
"preset": "trawers-v7",
"source_xml": "<Faktura xmlns=...>...</Faktura>",
"scenario_id": "advance-jpk-reclassify",
"changes": [
{ "path": "Fa/FaWiersz/P_12", "new_value": "preset:vat:10" },
{ "path": "Fa/P_22", "new_value": "1" },
{ "path": "Podmiot2/Adres/KodKraju", "new_value": "US" }
],
"przyczyna_korekty": "Skompletowano IE-599 - zaliczka stanowi eksport",
"numer_faktury_kor": "KOR/ZAL/2026/05/001",
"desired_jpk_field": "preset:jpk:10"
}'Granice presetu
Preset trawers-v7 dostarczamy z konkretnymi domyślnymi decyzjami - pokrywa standardowe scenariusze Trawers ERP. Przypadki wymagające niestandardowej logiki obsługujemy konfiguracją per organizacja w panelu administratora.
- 1Generator pokrywa scenariusze FA(3) - VAT_RR (faktury od rolnika ryczałtowego) wymagają osobnej ścieżki w Aplikacji Podatnika KSeF 2.0.
- 2Mapowania VAT odzwierciedlają dokumentację Trawers publiczną na maj 2026 - jeśli Twoja konfiguracja używa niestandardowych kodów, preset można rozszerzyć przez panel administratora.
- 3Paczka audytowa renderuje PDF w domyślnej czcionce Helvetica - wszystkie polskie diakrytyki są obsługiwane, ale dla własnej identyfikacji wizualnej (np. logo Trawers) zostawiamy punkt rozszerzenia do uruchomienia na osobne zgłoszenie.
Wdrażasz Trawers u klientów końcowych?
Program partnerski daje podział przychodów, Magic Invite Trial dla Twoich klientów (14 dni Pro/API bez karty z jednego linku) i dedykowany SLA dla wdrożeń przez Twoją firmę. Preset Trawers działa identycznie dla każdego klienta - zero dodatkowych prac wdrożeniowych po Twojej stronie.