Skip to content

Add E-Invoicing Overview + Setup pages for Poland - #95

Merged
StefanKert merged 3 commits into
mainfrom
feat-pl-e-invoicing-docs
Sep 11, 2026
Merged

StefanKert merged 3 commits into
mainfrom
feat-pl-e-invoicing-docs

Conversation

@deboragracio

Copy link
Copy Markdown
Collaborator

What

Adds a new Poland (PL) entry under Compliance Middleware → Country-Specific Guides (Poland had no prior docs), with an E-Invoicing section of two pages following the standard format:

  • Overview — regulatory status (B2B; centralised KSeF clearance; mandate live since Feb/Apr 2026; FA(3) schema), integration impact, and the expected four-step flow (status polled until KSeF returns the clearance number).
  • Setup & testing — expected prerequisites, a "What you can test today" section (KSeF government demo available; fiskaltrust sandbox pending), and an illustrative target-state /sign → /issue → poll → /journal example.

Adds a new Poland (PL) category to poscreators/toc.js (between Italy and Portugal), containing the E-Invoicing sub-section.

Notes for reviewers

  • Poland is a new country build — the fiskaltrust adapter has NOT shipped. Unlike DE/FR/IT, these pages describe the target state and are prominently marked "build in progress / not yet available". The regulation is live (KSeF), but integration via fiskaltrust is pending.
  • The API is request/response — no webhook; status is polled (until KSeF returns the clearance number).
  • All not-yet-final values (endpoint/parameter names, PL case codes) are marked TBC inside :::caution callouts.
  • Folder middleware-pl-ksef, slugs under /poscreators/middleware-doc/poland/e-invoicing/…. No Poland appendix exists yet, so the Overview omits that link.
  • Verified locally: toc.js parses and the dev build reports 0 broken links / 0 broken anchors.

🤖 Generated with Claude Code

@deboragracio
deboragracio requested a review from a team as a code owner September 1, 2026 12:18
@deboragracio deboragracio changed the title docs(pl): add E-Invoicing Overview + Setup pages for Poland Add E-Invoicing Overview + Setup pages for Poland Sep 1, 2026
deboragracio added a commit that referenced this pull request Sep 9, 2026
Add a market-agnostic E-Invoicing overview under Compliance Middleware (before
Country-Specific Guides): the shared /sign + /issue model, the no-webhook /
poll invariant, what varies by market, and a per-market summary table. Plus a
build-excluded internal authoring template documenting the standard.

Per-market pages (AT/FR/DE/IT/PL) live in their own PRs (#92–#95); this PR is
the generic hub only.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
StefanKert pushed a commit that referenced this pull request Sep 11, 2026
Add a market-agnostic E-Invoicing overview under Compliance Middleware (before
Country-Specific Guides): the shared /sign + /issue model, the no-webhook /
poll invariant, what varies by market, and a per-market summary table. Plus a
build-excluded internal authoring template documenting the standard.

Per-market pages (AT/FR/DE/IT/PL) live in their own PRs (#92–#95); this PR is
the generic hub only.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Apply the approved standard (Germany) to Poland, adapted to its specifics, and
place the pages under the now-merged middleware-pl folder (its existing
Country-Specific Guides block):
- Overview: slimmed to market-specific (regulatory status, terminology), links
  the generic page. Centralised KSeF clearance, FA(3), mandate live since
  Feb/Apr 2026, KSeF number.
- Setup: prerequisites (incl. the PLN-currency requirement — Poland is not a
  euro market), Portal enablement (draft), and a real /sign -> /issue example
  (B2B invoice case codes, PL buyer, VAT 23, Currency PLN top-level and per
  item), status polled via GET /issue/{queueId}/{queueItemId} until cleared by
  KSeF. Marked as preview, with developer-platform Try-it links.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
deboragracio and others added 2 commits September 11, 2026 12:53
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Rename the Poland "E-Invoicing" category to "eInvoicing" to match the
agreed spelling used across the docs (also flips the shared DE label).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@StefanKert
StefanKert merged commit e1c8b7d into main Sep 11, 2026
3 checks passed
@StefanKert
StefanKert deleted the feat-pl-e-invoicing-docs branch September 11, 2026 13:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants