NaprawKSeF
NaprawKSeF
Wbudowany preset · Trawers 7 (TRES)

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 effort wdrożenia.

Dostań klucz APIWizard z presetem TrawersREST API quickstart

Co dostajesz w presetcie Trawers v7

Wybór presetu Trawers 7 w wizardzie korekt (lub parametr preset=trawers-v7 w REST API) włącza pełen zestaw mapowań i scenariuszy dedykowanych systemowi TRES.

Preset Trawers v7 w generatorze
Dropdown „Mój ERP" w wizardzie korekt wybiera profil mapowań Trawers - kod VAT po stronie Trawers (np. 04) zostaje przetłumaczony na wartość P_12 w FA(3) („0 KR"), a alias 10 trafia do pola JPK K_22.
Scenariusz advance-jpk-reclassify (KOR_ZAL)
Najczęstszy case Trawers: zaliczka pierwotnie ujęta jako K_13 (krajowa 0%) okazuje się eksportem (K_22) lub WDT (K_21). Generator wystawia poprawne KOR_ZAL metodą StanPrzed/StanPo - zalecaną dla Trawers 7.
Walidacja strukturalna FA(3)
Każda wygenerowana korekta przechodzi przez walidator XSD-lite - sprawdza obowiązkowe sekcje, format NIP, kwoty, kod waluty, znaczniki P_22/P_23 i numerację pozycji.
Paczka audytowa PDF
Pojedynczy ZIP z fakturą pierwotną (XML), korektą (XML), raportem audytowym w PDF i sumami kontrolnymi SHA-256. Do wpięcia w segregator audytu podatkowego bez dodatkowej obróbki.
REST API z presetem
POST /api/v1/correction/build z parametrem preset=trawers-v7 - wystawia korektę z Twojego backendu, bez konieczności klikania w wizardzie. Per-key rate-limit, idempotency, webhooks.
Webhook correction.created
Po każdej wygenerowanej korekcie wysyłamy event do Twojego endpointu z payloadem (scenario_id, delty, numer korekty). Idealne do auto-zaksięgowania KOR_ZAL w Trawers po stronie księgowej.

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.

TrawersKSeF P_12JPK_V7MOpis
0123K_19Krajowa 23%
028K_17Krajowa 8%
035K_15Krajowa 5%
040 KRK_13Krajowa 0% (dokumentacja w toku)
05zw-Zwolnienie
06np-Nie podlega
100 EXK_22Eksport (kraj spoza UE)
110 WDTK_21WDT (UE + aktywny VAT-UE)
12ooK_29Odwrotne 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 support.

Wywołanie REST API z presetem

Z poziomu backendu Trawers (lub middleware integracyjnego) 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_* ze scope correction)
  • Idempotency-Key - bezpieczne retry przy timeoutach sieciowych
  • Webhook correction.created z payloadem (scenario, delty, numer)
  • Per-key rate-limit + per-org plan quota
POST /api/v1/correction/build200 OK
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 jest opinionated i pokrywa standardowe scenariusze Trawers ERP. Case wymagające custom logiki obsługujemy przez konfigurację per-org w panelu admina.

  • 1
    Generator pokrywa scenariusze FA(3) - VAT_RR (faktury od rolnika ryczałtowego) wymagają osobnego workflow w Aplikacji Podatnika KSeF 2.0.
  • 2
    Mapowania VAT odzwierciedlają dokumentację Trawers publiczną na maj 2026 - jeśli Twoja konfiguracja używa niestandardowych kodów, preset można rozszerzyć przez panel admina.
  • 3
    Paczka audytowa renderuje PDF w domyślnej czcionce Helvetica - wszystkie polskie diakrytyki są obsługiwane, ale dla custom brandingu (logo Trawers) zostawiamy hook na osobnym ticketsku.
Partner Program dla integratorów Trawers

Wdrażasz Trawers u klientów końcowych?

Partner Program daje revenue share, 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 overhead'u onboarding po Twojej stronie.

Zostań partneremKontakt z zespołemZobacz preset Comarch Optima