Skip to content

FA(3) builder: Seller

Set the seller party from address and identifier fields.

Called on builder
Source src/ksef2/services/builders/fa3/root.py:93 Authored source
builder.seller
builder.seller(*, name: Annotated[str, builder_param('Seller name shown on the invoice.', examples=['ACME sp. z o.o.'])], country_code: Annotated[str, builder_param('Two-letter country code for the seller address.', examples=[PL, DE], format=(country - code))], address_line_1: Annotated[str, builder_param('First seller address line, typically street and building number.', examples=['ul. Przykladowa 10'])], tax_id: Annotated[str | None, builder_param('Seller tax identifier, usually the NIP for Polish entities.', examples=[1234567890])] = None, address_line_2: Annotated[str | None, builder_param('Second seller address line, typically postal code and city.', examples=['00-001 Warszawa'])] = None, gln: Annotated[str | None, builder_param('Seller GLN identifier when the seller is identified in logistics systems.', examples=[5901234123457], priority=advanced)] = None, vat_prefix: Annotated[str | None, builder_param('Seller VAT prefix used together with domestic tax identifiers.', examples=[PL], priority=advanced)] = None, eu_vat_id: Annotated[str | None, builder_param('Seller EU VAT identifier used for intra-EU transactions.', examples=[PL1234567890], priority=advanced)] = None, other_id: Annotated[str | None, builder_param('Alternative seller identifier when tax_id or eu_vat_id is not used.', examples=[REG - 445566], priority=advanced)] = None, eori_number: Annotated[str | None, builder_param('Seller EORI number for customs-related invoice scenarios.', examples=[PL123456789000000], priority=advanced)] = None, customer_number: Annotated[str | None, builder_param('Seller customer number used by the trading parties.', examples=['CUS-0001'], priority=advanced)] = None, email: Annotated[str | None, builder_param('Seller contact email included in invoice party details.', examples=[billing @ example.com], priority=advanced)] = None, phone: Annotated[str | None, builder_param('Seller contact phone number included in invoice party details.', examples=['+48 123 456 789'], priority=advanced)] = None) -> Self

Returns

Self

Parameters

name str

Seller name shown on the invoice.

required / keyword-only
country_code str

Two-letter country code for the seller address.

required / keyword-only
address_line_1 str

First seller address line, typically street and building number.

required / keyword-only
tax_id str | None

Seller tax identifier, usually the NIP for Polish entities.

default None / keyword-only
address_line_2 str | None

Second seller address line, typically postal code and city.

default None / keyword-only
gln str | None

Seller GLN identifier when the seller is identified in logistics systems.

default None / keyword-only
vat_prefix str | None

Seller VAT prefix used together with domestic tax identifiers.

default None / keyword-only
eu_vat_id str | None

Seller EU VAT identifier used for intra-EU transactions.

default None / keyword-only
other_id str | None

Alternative seller identifier when tax_id or eu_vat_id is not used.

default None / keyword-only
eori_number str | None

Seller EORI number for customs-related invoice scenarios.

default None / keyword-only
customer_number str | None

Seller customer number used by the trading parties.

default None / keyword-only
email str | None

Seller contact email included in invoice party details.

default None / keyword-only
phone str | None

Seller contact phone number included in invoice party details.

default None / keyword-only