Guides

VRBL: Buyers

Read about how to model Buyers.

Suggest Edits

You can model; information about Buyers such as: to specify information such as:

  • Name and address of the Buyer.
  • Tax schemes and registrations.
  • Legal registrations, if any.

👍

Tip

Buyer references are explained in the Buyer References topic.

Elements

Use the AccountingCustomerParty element to model this information:

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.

Country-Specific configurations

Country specific configurations are explained in the following 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>

Updated 14 days ago