/ubl:Invoice/cac:AccountingCustomerParty/cac:Party/cac:PostalAddress

Buyer Address Group

Context ID INV0433
Cardinality 0..1
Usage M

Description

The party's postal address.

A group of business terms providing information about the postal address for the Buyer.

In the KSeF FA(3) format there are no individual elements for streetname, city and postal zone. There are only two generic free-text address line elements. Therefore in inbound AP invoices also in VRBL, only two Buyer Address Line elements cbc:AddressLine can be provided and no streetname, city and postal zone are available.

Child elements

Cardinality Usage Description Element
0..1 O Buyer Street Name
The name of the street, road, avenue, way, etc. to which the number of the building is attached.
cbc:StreetName
0..1 O Buyer City Name
The name of a city, town, or village.
cbc:CityName
0..1 O Buyer Postal Zone
The postal identifier for this address according to the relevant national postal service, such as a ZIP code or Post Code.
cbc:PostalZone
0..n O Buyer Address Line Group
An unstructured address line.
cac:AddressLine
0..1 M Buyer Country Group
The country in which this address is situated.
cac:Country

Details

vrbl-invoice-pl-b2b-3p0

Example of expected Buyer Address for outbound AR invoices.

<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>

Example of Buyer Address for inbound AP invoices.

<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>

Rules

Rule ID Error Message
VRBL-INV-PL-B2B-3-112 When Buyer Address Line Group is not provided, the Buyer Street Name must exist within the Buyer Address Group.
VRBL-INV-PL-B2B-3-113 When Buyer Address Line Group is not provided, the Buyer City Name must exist within the Buyer Address Group.
VRBL-INV-PL-B2B-3-114 When Buyer Address Line Group is not provided, the Buyer Postal Zone must exist within the Buyer Address Group.
VRBL-INV-PL-B2B-3-115 The Buyer Address Line Group is expected no more than 2 times within the Buyer Address Group.