AccountingCustomerParty

Use this element to model the a buyer's details.

General information about Buyers is described in the Buyers topic.

Elements

Name (Path)CardinalityDescription
Buyer's Identifier
Party Identification (Party/PartyIdentification)0..nA group to provide identifiers for the BUYER.
Buyer Identifier (Party/PartyIdentification/ID)1..1The Buyer's ID.
Scheme Identifier (Party/PartyIdentification/ID @schemeID)1..0The scheme to which the Buyer's ID belongs. If this is omitted, the Customer Number scheme is used. If it is used, you must use a value from the list here.
Buyer's Trading Name
Party Name (Party/PartyName)0..1Groups information about the Buyer's trading name.
Buyer's Trading Name (Party/PartyName/Name)1..1The Buyer's trading name.
Buyer's Postal Address
Buyer's Postal Address (Party/PostalAddress)1..1Groups information about the Buyer's address.
Buyer's Address Line 1 (Party/PostalAddress/StreetName)1..1The main address line or street name.
Buyer's Address Line 2 (Party/PostalAddress/AdditionalStreetName)0..1The second address line.
Buyer's City (Party/PostalAddress/CityName)1..1The common name of the city, town or village, where the Buyer's address is.
Buyer's City Post Code (Party/PostalAddress/PostalZone)The identifier for an addressable group of properties according to the relevant postal service.
Buyer's Country Subdivision (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 (Party/PostalAddress/AddressLine/Line)0..1Additional address line.
Buyer's Country (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.
Buyer's Tax Registration
Party Tax Scheme Group (Party/PartyTaxScheme)0..1A group of information about the Buyer's tax registration.
Buyer's Tax Registration Identifier (Party/PartyTaxScheme/CompanyID)1..1The Buyer's Tax ID that is used for identification
Buyer's Tax Scheme (Party/PartyTaxScheme/TaxScheme/cID)1..1They scheme to which the Buyer's Tax ID belongs. For example VAT.
Buyer's Legal Registration
Party Legal Entity (Party/PartyLegalEntity)0..1A group of information about the Buyer's legal registrations.
Buyer's Registered Name (Party/PartyLegalEntity/RegistrationName)1..1The full formal name by which the Buyer is registered in the national registry of legal entities or as a Taxable person or otherwise trades as a person or persons.
Buyer's Legal Registration Identifier (Party/PartyLegalEntity/CompanyID)1..1An identifier issued by an official registrar that identifies the Buyer as a legal entity or person.
Buyer's Contact Details
Buyer's Contact (Party/Contact)0..1A group of the Buyer's contact information.
Buyer's Contact Point (Party/Contact/Name)0..1A contact point for a legal entity or person.
Buyer's Contact Telephone Number (Party/Contact/Telephone)0..1A phone number for the contact point.
Buyer's Contact Email Address (Party/Contact/ElectronicMail)0..1An e-mail address for the contact point.

Buyer endpoints

For certain use cases, mostly for PEPPOL, you may also need to specify the Buyer's Endpoint ID. You can use the following sub-elements to do so:

Element (Path)Description
Endpoint ID (Invoice/AccountingCustomerParty/Party/EndpointID)Specify the recipient account. This is used for routing. It is usually a PEPPOL or SMTP network.
Endpoint ID Scheme (Invoice/AccountingCustomerParty/Party/EndpointID [@schemeID])You use the @schemeID attribute to specify the type of endpoint.

Country-Specific Configuration Topics


Example

<Invoice>
    <!-- code omitted for clarity -->
    <cac:AccountingCustomerParty>
        <cac:Party>
            <cac:PartyIdentification>
                <cbc:ID schemeID="0088">7300010000001</cbc:ID> 
            </cac:PartyIdentification>
            <cac:PartyName>
                <cbc:Name>Buyer Name Ltd.</cbc:Name> 
            </cac:PartyName>
            <cac:PostalAddress> 
                <cbc:StreetName>Main street 9</cbc:StreetName>
                <cbc:AdditionalStreetName>Postbox 321</cbc:AdditionalStreetName>
                <cbc:CityName>London</cbc:CityName>
                <cbc:PostalZone>GB 123 EW</cbc:PostalZone>
                <cbc:CountrySubentity>West London district</cbc:CountrySubentity>
                <cac:AddressLine>
                    <cbc:Line>Third address line</cbc:Line>
                </cac:AddressLine>
                <cac:Country>
                    <cbc:IdentificationCode>GB</cbc:IdentificationCode>  
                </cac:Country>
            </cac:PostalAddress>
            <cac:PartyTaxScheme>
                <cbc:CompanyID>GB22334455</cbc:CompanyID>
                <cac:TaxScheme>
                    <cbc:ID>VAT</cbc:ID>  
                </cac:TaxScheme>
            </cac:PartyTaxScheme>
            <cac:PartyLegalEntity> 
                <cbc:RegistrationName>Buyer Official Name Ltd.</cbc:RegistrationName>  
                <cbc:CompanyID>GB123456</cbc:CompanyID>  
            </cac:PartyLegalEntity>
            <cac:Contact>
                <cbc:Name>John Doe</cbc:Name>
                <cbc:Telephone>9384203984</cbc:Telephone>
                <cbc:ElectronicMail>[email protected]</cbc:ElectronicMail>
            </cac:Contact>
        </cac:Party>
    </cac:AccountingCustomerParty>
    <!-- code omitted for clarity -->
</Invoice>