builder src/ksef2/services/builders/fa3/root.py:221 Authored source builder.buyer(*, name: Annotated[str | None, builder_param('Buyer name shown on the invoice. Leave empty only when the invoice scenario allows it.', examples=['XYZ GmbH'])], country_code: Annotated[str | None, builder_param('Two-letter country code for the buyer address.', examples=[PL, DE], format=(country - code))], address_line_1: Annotated[str | None, builder_param('First buyer address line, typically street and building number.', examples=['ul. Odbiorcza 20'])], tax_id: Annotated[str | None, builder_param('Buyer tax identifier, usually the NIP for domestic invoices.', examples=[9876543210])] = None, address_line_2: Annotated[str | None, builder_param('Second buyer address line, typically postal code and city.', examples=['00-950 Warszawa'])] = None, gln: Annotated[str | None, builder_param('Buyer GLN identifier used in logistics or EDI processes.', examples=[5901234123457], priority=advanced)] = None, vat_prefix: Annotated[str | None, builder_param('Buyer VAT prefix used together with domestic identifiers.', examples=[PL], priority=advanced)] = None, eu_vat_id: Annotated[str | None, builder_param('Buyer EU VAT identifier for intra-EU transactions.', examples=[DE123456789], priority=advanced)] = None, other_id: Annotated[str | None, builder_param('Alternative buyer identifier used when tax_id or eu_vat_id is not available.', examples=[CUST - 7788], priority=advanced)] = None, eori_number: Annotated[str | None, builder_param('Buyer EORI number for customs-related invoice scenarios.', examples=[DE123456789000000], priority=advanced)] = None, customer_number: Annotated[str | None, builder_param('Buyer customer number used by the trading parties.', examples=['BUY-0004'], priority=advanced)] = None, buyer_id: Annotated[str | None, builder_param('Internal buyer identifier used in some FA(3) scenarios.', examples=[buyer - 42], priority=advanced)] = None, jst_subordinate_unit: Annotated[bool, builder_param('Set to true when the buyer is a subordinate unit of a Polish local government entity.', examples=[False], priority=advanced)] = False, vat_group_member: Annotated[bool, builder_param('Set to true when the buyer belongs to a VAT group.', examples=[False], priority=advanced)] = False, email: Annotated[str | None, builder_param('Buyer contact email included in invoice party details.', examples=[ap @ example.com], priority=advanced)] = None, phone: Annotated[str | None, builder_param('Buyer contact phone number included in invoice party details.', examples=['+49 30 123456'], priority=advanced)] = None) -> SelfReturns
Self Parameters
name str | None Buyer name shown on the invoice. Leave empty only when the invoice scenario allows it.
required / keyword-onlycountry_code str | None Two-letter country code for the buyer address.
required / keyword-onlyaddress_line_1 str | None First buyer address line, typically street and building number.
required / keyword-onlytax_id str | None Buyer tax identifier, usually the NIP for domestic invoices.
default None / keyword-onlyaddress_line_2 str | None Second buyer address line, typically postal code and city.
default None / keyword-onlygln str | None Buyer GLN identifier used in logistics or EDI processes.
default None / keyword-onlyvat_prefix str | None Buyer VAT prefix used together with domestic identifiers.
default None / keyword-onlyeu_vat_id str | None Buyer EU VAT identifier for intra-EU transactions.
default None / keyword-onlyother_id str | None Alternative buyer identifier used when tax_id or eu_vat_id is not available.
default None / keyword-onlyeori_number str | None Buyer EORI number for customs-related invoice scenarios.
default None / keyword-onlycustomer_number str | None Buyer customer number used by the trading parties.
default None / keyword-onlybuyer_id str | None Internal buyer identifier used in some FA(3) scenarios.
default None / keyword-onlyjst_subordinate_unit bool Set to true when the buyer is a subordinate unit of a Polish local government entity.
default False / keyword-onlyvat_group_member bool Set to true when the buyer belongs to a VAT group.
default False / keyword-onlyemail str | None Buyer contact email included in invoice party details.
default None / keyword-onlyphone str | None Buyer contact phone number included in invoice party details.
default None / keyword-only