Poland KSF: Buyer's Address (FA(3))

You can model the Buyer's address.

We recommend that you use the following elements for outbound Accounts Receivable (AR) invoices:

  • Buyer's Address Line 1 (Invoice/AccountingCustomerParty/Party/PostalAddress/StreetName)
  • Buyer's City (Invoice/AccountingCustomerParty/Party/PostalAddress/CityName)
  • Buyer's City Post Code (Invoice/AccountingCustomerParty/Party/PostalAddress/PostalZone)

If you cannot use these, you can use up to 2 Buyer's Additional Address Line (Invoice/AccountingCustomerParty/Party/PostalAddress/AddressLine/Line) elements.

General information about Buyers is provided in the VRBL: Buyers topic.

For inbound Accounts Payable (AP) invoices, the KSF (FA3) format uses 2 generic free-text elements to model address lines. Therefore, you can only model these lines for inbound AP invoices.

Elements

Use the following sub-elements of the AccountingCustomerParty element to model this information:

Name (Path)CardinalityDescription
Buyer Group (Invoice/AccountingCustomerParty)1..1Groups information about the Buyer.
Buyer's Postal Address
Buyer's Postal Address (Invoice/AccountingCustomerParty/Party/PostalAddress)1..1Groups information about the Buyer's address.
Buyer's Address Line 1 (Invoice/AccountingCustomerParty/Party/PostalAddress/StreetName)1..1The main address line or street name.
Buyer's Address Line 2 (Invoice/AccountingCustomerParty/Party/PostalAddress/AdditionalStreetName)0..1The second address line.
Buyer's City (Invoice/AccountingCustomerParty/Party/PostalAddress/CityName)1..1The common name of the city, town, or village, where the Buyer's address is.
Buyer's City Subdivision (Invoice/AccountingCustomerParty/Party/PostalAddress/CitySubdivisionName)1..1The city subdivision, if any.
Buyer's City Post Code (Invoice/AccountingCustomerParty/Party/PostalAddress/PostalZone)The identifier for an addressable group of properties according to the relevant postal service.
Buyer's Country Subdivision (Invoice/AccountingCustomerParty/Party/PostalAddress/CountrySubentity)0..1The subdivision of a country, such as a region, a county, a state, a province and so on.
Buyer's Additional Address Line (Invoice/AccountingCustomerParty/Party/PostalAddress/AddressLine/Line)0..1Additional address line.
Buyer's Country (Invoice/AccountingCustomerParty/Party/PostalAddress/Country/IdentificationCode)1..1The country code that represents the Buyer's country, per their address. You must use a code from the ISO3166-1:Alpha2 list.

Examples

Outbound AR invoice

<ubl:Invoice>
    <!-- code omitted for clarity -->
    <cac:AccountingCustomerParty>
		<!-- code omitted for clarity -->
		<cac:Party>
			<cac:PostalAddress>
				<cbc:StreetName>ul. Sadowa 1 lok. 3</cbc:StreetName>
				<cbc:CityName>Poznań</cbc:CityName>
				<cbc:PostalZone>00-004 </cbc:PostalZone>
				<cac:Country>
					<cbc:IdentificationCode>PL</cbc:IdentificationCode>
				</cac:Country>
			</cac:PostalAddress>
		</cac:Party>
		<!-- code omitted for clarity -->
	</cac:AccountingCustomer>
</ubl:Invoice>

Inbound AP invoice

<ubl:Invoice>
    <!-- code omitted for clarity -->
    <cac:AccountingCustomerParty>
		<!-- code omitted for clarity -->
		<cac:Party>
            <cac:PostalAddress>
                <!-- no streetname, city and postal zone -->
                <cac:AddressLine>
                    <cbc:Line>ul. Sadowa 1 lok. 3</cbc:Line>
                </cac:AddressLine>
                <cac:AddressLine>
                    <cbc:Line>00-002 Kraków</cbc:Line>
                </cac:AddressLine>
                <cac:Country>
                    <cbc:IdentificationCode>PL</cbc:IdentificationCode>
                </cac:Country>
            </cac:PostalAddress>
        </cac:Party>
		<!-- code omitted for clarity -->
	</cac:AccountingCustomerParty>
</ubl:Invoice>