v0.18.1

v0.18.1

Patch release to republish package metadata with the corrected KSeF OpenAPI target version.

Docs

• Sync README OpenAPI target version with KSeF API 2.6.1.
• Publish PyPI long description from the corrected README on current main.

v0.17.1

v0.17.1 (2026-06-16)

Docs

• document public SDK exception contracts and API docstrings

v0.17.0

v0.17.0 (2026-06-04)

Feat

• fa3: support gross unit price lines

v0.16.0

Feat

• api: support OpenAPI 2.6 compression options

Fix

• tolerate unknown auth method codes
• make pdf rendering dependencies optional

v0.15.0

Feat

• Add explicit invoice metadata pagination helpers: query_metadata_pages(...) for page-level sync logic and all_metadata(...) for item-level iteration.
• Keep query_metadata(...) as a single KSeF request while the explicit helpers follow hasMore, pageOffset, and isTruncated date-range reset mechanics.
• Allow metadata pageSize=250 to match the KSeF API contract.

v0.14.0

Feat

• models: change base model extra from forbid to ignore with warning logging — KSeFBaseModel and BaseSupp now use extra="ignore", silently ignoring unknown API fields with structlog warnings

Fix

• models: make _warn_extra_fields alias-aware to avoid false warnings on camelCase/AliasGenerator fields
• resolve pyright errors in the alias-aware validator logic

v0.13.3

Feat

• api: add support for new certificate fields introduced in the 2.5.0 API version update

v0.13.1

What's Changed

• chore: update OpenAPI spec to KSeF API 2.4.0 and regenerate models by @github-actions[bot] in #34

Full Changelog: v0.13.0...v0.13.1

v0.11.2

ksef2 v0.11.2 fixes a regression introduced in the FA(3) builder metadata work.

The regression came from a JsonDict local type annotation inside the shared builder metadata helper, which caused beartype to fail during test collection. This patch removes that problematic annotation shape while preserving the builder parameter metadata API.

Fix

• avoid beartype collection errors caused by the builder metadata helper
• keep FA(3) builder parameter annotations working as intended

v0.11.1

ksef2 v0.11.1 improves the FA(3) invoice builder with contextual parameter annotations across the public builder surface.

This release adds builder-level metadata directly to the FA(3) DSL methods, so tools that introspect builder methods can explain invoice fields in the context of the invoice being built instead of relying on lower-level domain model descriptions.

Highlights

• Added shared builder parameter metadata helper for FA(3) builders
• Annotated the main public payload-bearing builder methods across root, body, nested sections, footer, and attachment builders
• Added unit coverage to verify metadata is available through Annotated type hints
• Kept runtime builder behavior unchanged

Included In This Release

Feat

• fa3: annotate builder parameter metadata