# Customer Import

### Short description

This interface describes which customer information is sent from the ERP system to Vendisto.

### Customer information includes:

* Shop Specific Debtor Number&#x20;
* Billing address details&#x20;
* Name1&#x20;
* Name2 (e.g. Attn.)&#x20;
* Address&#x20;
* Postal code&#x20;
* City&#x20;
* Country&#x20;
* Standard shipping address information&#x20;
* Name1&#x20;
* Name2 (e.g. Attn.)&#x20;
* Address&#x20;
* Postal code&#x20;
* Town&#x20;
* Country&#x20;
* Additional information (e.g. port number, exit number, etc.)&#x20;
* Delivery instruction (e.g. "Leave behind in a box...")&#x20;
* Name contact person&#x20;
* E-mail address contact person&#x20;
* Payment method (on account, cash, etc.)
* Payment condition
* DeliverySchedule
* DivisionCode
* ApplyEqualizationTax
* MinimumOrderValue

### How to submit

**Update Frequency:** Batch at least 1x per day&#x20;

**Incremental or Full Set:** Incremental&#x20;

**File Type**: Zipped XML

**Bestandsbenaming: \[SHOPNAME]\_**&#x63;ustomers\_**\[INDEXNUMBER]**.xml\
**Transport:** over FTPS, FTPS Vendisto server is hosted by INTEGRACE, file is put on FTPS server by ERP party.

**Location within FTP root:** \Vendisto\Integration\\

## Customer XML Structure

This XML structure can be used for batch import of Customer data. All optional elements can be omitted from the import. Omitted elements that represent customer information will not update existing information. E.G. if \<FirstName> is not present in the XML but is in the database, the field will not be updated. If \<FirstName /> is present as an empty XML element, the FirstName in the database will be made empty. If \<CustomerAddresses> is not present, the CustomerAddresses will not be updated. If \<CustomerAddresses /> is present as empty XML element, all existing customer’s addresses will be removed from the database.

The ImportSettings element can be used to set the default behavior of import.

### Changes from Customer XML 2.0 to 2.1

* The ImportSettings node is now required as well as the 'Importer' setting.
* The PartialUserImport setting is no longer available.
* StreetAddressType is a new import setting  with values: Combined and Separated
* StreetAddres1 and StreetAddress2 are renamed to AddressLine1 and AddressLine2
* AddressLine1 contains Street and housenumber when StreetAddressType is set to Combined&#x20;
* The new fields Street, HouseNumber and HouseNumberAddition are to be used when StreetAddressType is set to Separated
* AddressLine2: May contain an additional address line
* UserType and UserRights are new elements on the User level
* ExternalId can be filled with the address id of the ERP system

### Changes from Customer XML 2.1 to 2.2

* The PriceGroup element was removed from the XML definition
* A new PriceList element was added to the definition
* An optional Currency element was added.\
  This element can be used by the shop to predefine the users currency in the shop.
* An optional Incoterm element was added.\
  The incoterm is used to show to the user in the account section of the user portal.
* An optional ShippingCostType element was added. The ShippingCostType is used for the shipment API. With this information the api can calculate the correct shipment costs.
* An optional InvoiceTo element was added.\
  If this field is filled, the shop will show the invoice addresses of the invoice debtor in the user portal and in the checkout process.
* An optional DivisionCode element was added. \
  We are able to configure the WebService to pass this field along with requests to a Shoxl rest implementation.
* An optional attribute "ignoreElements" was added to the "Validation" element. \
  It can be used to ignore certain XML elements in the validation process. \
  Currently only supports "PostalCode"\
  **Usage**:

  ```xml
  <?xml version="1.0" encoding="utf-8"?>
  <ImportSettings>
      <Validation ignoreElements="PostalCode,...">...</Validation>
      ...
  </ImportSettings>
  ```
* An optional ApplyEqualizationTax element was added.\
  If this field contains the value **“true”**, it means that this customer is eligible for **an equalization tax**. The shop can use this information to show **a detailed breakdown** of how a price is made up.
* An optional CreateUnknownAuthorizationProfiles element was added to the import settings.\
  If this field is true, non-existing authorization profiles are automatically created in Vendisto. This is useful when exporting pricelists as authorization profiles.&#x20;
* An optional PaymentCondition element was added.\
  This element contains a debtor's payment condition code and -description.
* An optional MinimumOrderValue element was added.\
  This element contains the customer's minimum order value.

```markup
<?xml version="1.0" encoding="utf-8"?>
<Import>
    <ImportSettings>
        <Importer>CustomerData</Importer>
        <Version>2.2</Version>
        <PartialImport></PartialImport>
        <Validation></Validation>
        <CreateUnknownAuthorizationProfiles></CreateUnknownAuthorizationProfiles>
        <StreetAddressType></StreetAddressType>
    </ImportSettings>
    <Customers>
        <Customer>
            <DebtorNumber></DebtorNumber>
            <Company></Company>
            <CompanyVatNumber></CompanyVatNumber>
            <Gln></Gln>
            <Gender></Gender>
            <FirstName></FirstName>
            <MiddleName></MiddleName>
            <LastName></LastName>
            <Email></Email>
            <PhoneNumber></PhoneNumber>
            <MobilePhoneNumber></MobilePhoneNumber>
            <DefaultReference></DefaultReference>
            <DateOfBirth></DateOfBirth>
            <Iban></Iban>
            <BuyOnCredit></BuyOnCredit>
            <PriceList></PriceList>
            <State></State>
            <PreferredBranche></PreferredBranche>
            <Currency></Currency>
            <Incoterm></Incoterm>
            <ShippingCostType></ShippingCostType>
            <InvoiceTo></InvoiceTo>
            <DeliverySchedule></DeliverySchedule>
            <DivisionCode></DivisionCode>
            <EqualizationTax></EqualizationTax>
            <MinimumOrderValue></MinimumOrderValue>
            <PaymentCondition>
                <Code></Code>
                <Description></Description>
            </PaymentCondition>
            <Authorization>
                <Profile></Profile>
                <Profile></Profile>
            </Authorization>
            <CustomerAddresses>
                <CustomerAddress>
                    <AddressType></AddressType>
                    <Company></Company>
                    <Gender></Gender>
                    <FirstName></FirstName>
                    <MiddleName></MiddleName>
                    <LastName></LastName>
                    <AddressLine1></AddressLine1>
                    <Street></Street>
                    <HouseNumber></HouseNumber>
                    <HouseNumberAddition></HouseNumberAddition>
                    <AddressLine2></AddressLine2>
                    <PostalCode></PostalCode>
                    <City></City>
                    <Country></Country>
                    <ExternalId></ExternalId>
                    <IsDefaultAddress></IsDefaultAddress>
                </CustomerAddress>
            </CustomerAddresses>
            <Users>
                <User>
                    <Username></Username>
                    <FirstName></FirstName>
                    <MiddleName></MiddleName>
                    <LastName></LastName>
                    <Email></Email>
                    <PreferredLanguage></PreferredLanguage>
                    <BuyOnCredit></BuyOnCredit>
                    <State></State>
                    <Authorization>
                        <Profile></Profile>
                        <Profile></Profile>
                    </Authorization>
                    <UserType></UserType>
                    <UserRights>
                        <Right></Right>
                        <Right></Right>
                    </UserRights>
                </User>
            </Users>
        </Customer>
    </Customers>
</Import >

```

## Velden customer XML

**Import element:**

<table data-header-hidden><thead><tr><th width="183">Name</th><th>Description</th><th width="182.06957708049114">Type</th><th>Required/Optional</th></tr></thead><tbody><tr><td>Name</td><td>Description</td><td>Type</td><td>Required/Optional</td></tr><tr><td>ImportSettings</td><td>Container element for importsettings</td><td>Element</td><td>Required</td></tr><tr><td>Customers</td><td>Container element for Customer data</td><td>Element</td><td>Required</td></tr></tbody></table>

**ImportSettings element:**

<table data-header-hidden><thead><tr><th width="194.7228260869565">Name</th><th>Description</th><th width="208">Type</th><th>Required/Optional</th></tr></thead><tbody><tr><td>Name</td><td>Description</td><td>Type</td><td>Required/Optional</td></tr><tr><td>Importer</td><td>Name of the importer.<br>Should be CustomerData.</td><td><p>Text,</p><p>default CustomerData</p></td><td>Required</td></tr><tr><td>Version</td><td>Version of the import xml. Value must be set to 2.2</td><td>Text</td><td>Required</td></tr><tr><td>PartialImport</td><td>Defines if import is full or partial import.</td><td>Boolean,<br>default Y</td><td>Optional</td></tr><tr><td>Validation</td><td><p>Defines the validation type. Strict validation requires FirstName and LastName fields of Customer Address. Loose validation doesn’t. </p><p></p><p>Also contains attribute "ignoreElements" which holds comma seperated element names which are ignored during the validation process.</p></td><td>Validation,<br>default Loose</td><td>Optional</td></tr><tr><td>CreateUnknownAuthorizationProfiles</td><td>If this field is true, non-existing authorization profiles are automatically created in Vendisto</td><td>default N</td><td>Optional</td></tr><tr><td>StreetAddressType</td><td>Setting to make the distinction between 'Combined' and 'Separated' address lines. ERP systems that store the housenumber in a separate field should set the type to 'Separated'. Those that don't to 'Combined'.</td><td><p>StreetAddressType,</p><p>default Separated</p></td><td>Optional</td></tr></tbody></table>

**Customer element:**

<table data-header-hidden><thead><tr><th width="222">Name</th><th width="168">Description</th><th width="150">Type</th><th>Required/Optional</th></tr></thead><tbody><tr><td>Name</td><td>Description</td><td>Type</td><td>Required/Optional</td></tr><tr><td>DebtorNumber</td><td>Debtor number</td><td>Text</td><td>Required if Vendisto setting ‘Customer identification type’ is set to ‘Debtor number’, else Optional.</td></tr><tr><td>Company</td><td>Name of the company</td><td>Text</td><td>Optional</td></tr><tr><td>CompanyVatNumber</td><td>Vat number</td><td>Text</td><td>Optional</td></tr><tr><td>Gln</td><td>Global location number</td><td>GLN</td><td>Optional</td></tr><tr><td>Gender</td><td>Gender of the customer contact person</td><td>Gender</td><td>Optional</td></tr><tr><td>FirstName</td><td>of the contact person</td><td>Text</td><td>Optional</td></tr><tr><td>MiddleName</td><td>of the contact person</td><td>Text</td><td>Optional</td></tr><tr><td>LastName</td><td>of the contact person</td><td>Text</td><td>Optional</td></tr><tr><td>Email</td><td>of the contact person</td><td>Text,<br>must be a valid email address</td><td>Required</td></tr><tr><td>PhoneNumber</td><td>of the contact person</td><td>Text</td><td>Optional</td></tr><tr><td>MobilePhoneNumber</td><td>of the contact person</td><td>Text</td><td>Optional</td></tr><tr><td>DateOfBirth</td><td>of the contact person</td><td>Date</td><td>Optional</td></tr><tr><td>DefaultReference</td><td>Depricated</td><td>Text</td><td>Optional</td></tr><tr><td>Iban</td><td>For future use</td><td>Text</td><td>Optional</td></tr><tr><td>BuyOnCredit</td><td>Enables the BuyOnCredit payment method, if this is available in the shop</td><td>Boolean, default N</td><td>Optional</td></tr><tr><td>PriceList</td><td>Vendisto pricelist name</td><td>PriceList</td><td>Optional</td></tr><tr><td>State</td><td>State of the customer:<br>Active or Blocked</td><td>CustomerState,<br>default Active</td><td>Optional</td></tr><tr><td>PreferredBranche</td><td>A preferred location or branche where the order will be handled</td><td>Text</td><td>Optional</td></tr><tr><td>Currency</td><td>Must contain the ISO 4217 three-letter currency code</td><td>Char[3]</td><td>Optional</td></tr><tr><td>Incoterm</td><td>Trade term</td><td>Text</td><td>Optional</td></tr><tr><td>ShippingCostType</td><td>The shipment cost type</td><td>ENUM: ShippingCostApplied, ShippingCostFree, ShippingCostPostCalculation</td><td>Optional</td></tr><tr><td>InvoiceTo</td><td>Account Number of the Invoice debtor. If this field is filled, the shop will show the invoice addresses of the invoice debtor in the user portal and in the checkout process </td><td>Text</td><td>Optional</td></tr><tr><td>DeliverySchedule</td><td>The name of the DeliverySchedule that the customer  needs to be set to</td><td>Text</td><td>Optional</td></tr><tr><td>DivisionCode</td><td>Indicates the division a customer belongs to</td><td>Text</td><td>Optional</td></tr><tr><td>EqualizationTax</td><td>Indicates a customer is eligible for equalization tax</td><td>Boolean,<br>default N</td><td>Optional</td></tr><tr><td>MinimumOrderValue</td><td>The minimum order value amount for the customer</td><td>Decimal</td><td>Optional</td></tr><tr><td>Authorization</td><td>Container for list of Profiles</td><td>Authorization element</td><td>Optional</td></tr><tr><td>CustomerAddresses</td><td>List of addresses of the customer (Invoice or Delivery)</td><td>CustomerAddress elements</td><td>Optional</td></tr><tr><td>Users</td><td>List of users for the customer</td><td>User elements</td><td>Optional</td></tr><tr><td>PaymentCondition</td><td>A debtor's payment condition</td><td>CustomerPaymentConditionElement</td><td>Optional</td></tr></tbody></table>

**Authorization element:**

<table data-header-hidden><thead><tr><th width="162">Name</th><th>Description</th><th width="152">Type</th><th>Required/Optional</th></tr></thead><tbody><tr><td>Name</td><td>Description</td><td>Type</td><td>Required/Optional</td></tr><tr><td>Profile</td><td>Code of authorization profile</td><td>Char[3]</td><td>Optional</td></tr></tbody></table>

**CustomerAddress element:**

<table data-header-hidden><thead><tr><th width="178">Name</th><th width="195">Description</th><th width="169.69261744966443">Type</th><th>Required/Optional</th></tr></thead><tbody><tr><td>Name</td><td>Description</td><td>Type</td><td>Required/Optional</td></tr><tr><td>AddressType</td><td>Defines the type of the address: Invoicing or Delivery</td><td>AddressType</td><td>Required</td></tr><tr><td>CompanyName</td><td>Name of the company</td><td>Text</td><td>Optional</td></tr><tr><td>Gender</td><td>Gender of the customer address contact person</td><td>Gender,<br>default Undefined</td><td>Optional</td></tr><tr><td>FirstName</td><td>of the address contact person</td><td>Text</td><td>Required if Validation is Strict</td></tr><tr><td>MiddleName</td><td>of the address contact person</td><td>Text</td><td>Optional</td></tr><tr><td>LastName</td><td>of the address contact person</td><td>Text</td><td>Required if Validation is Strict</td></tr><tr><td>AddressLine1</td><td>of the address contact person</td><td>Text</td><td>Only imported if StreetAddressType is Combined and in that case Required</td></tr><tr><td>Street</td><td>of the address contact person</td><td>Text</td><td>Only imported if StreetAddressType is Separated and in that case Required</td></tr><tr><td>HouseNumber</td><td>of the address contact person</td><td>Text</td><td>Only imported if StreetAddressType is Separated and in that case Required</td></tr><tr><td>HouseNumberAddition</td><td>of the address contact person</td><td>Text</td><td>Only imported if StreetAddressType is Separated and in that case Optional</td></tr><tr><td>AddressLine2</td><td>of the address contact person</td><td>Text</td><td>Optional</td></tr><tr><td>PostalCode</td><td>of the address contact person</td><td>Text</td><td>Required</td></tr><tr><td>City</td><td>of the address contact person</td><td>Text</td><td>Required</td></tr><tr><td>Country</td><td>of the address contact person</td><td>Text</td><td>Required</td></tr><tr><td>ExternalId</td><td>Address ID of the external (ERP) system</td><td>Text</td><td>Optional</td></tr><tr><td>IsDefaultAddress</td><td>In case of multiple addresses of the given Type this property indicates the default</td><td>Boolean,<br>default N</td><td>Optional</td></tr></tbody></table>

**User element:**

<table data-header-hidden><thead><tr><th width="208">Name</th><th width="179">Description</th><th width="157">Type</th><th>Required/Optional</th></tr></thead><tbody><tr><td>Name</td><td>Description</td><td>Type</td><td>Required/Optional</td></tr><tr><td>Username</td><td>User’s username</td><td>Text</td><td>Required</td></tr><tr><td>FirstName</td><td>User's firstname</td><td>Text</td><td>Optional</td></tr><tr><td>MiddleName</td><td>User's middlename</td><td>Text</td><td>Optional</td></tr><tr><td>LastName</td><td>User's lastname</td><td>Text</td><td>Optional</td></tr><tr><td>Email</td><td>User’s email address</td><td>Text,<br>must be a valid email address</td><td>Optional</td></tr><tr><td>PreferredLanguage</td><td>Indicates preferred language on website</td><td>LCID</td><td>Optional</td></tr><tr><td>BuyOnCredit</td><td>Enables the BuyOnCredit payment method, if this is available in the shop</td><td>Boolean, overrides customer’s BuyOnCredit setting</td><td>Optional</td></tr><tr><td>State</td><td>State of the user:<br>Inactive, Active or Blocked</td><td>UserState,<br>default Active</td><td>Optional</td></tr><tr><td>Authorization</td><td>Container for list of Profiles, overrides customer authorization profiles</td><td>Authorization element</td><td>Optional</td></tr><tr><td>UserType</td><td>The type of the user. Can be used to indicate the superuser who is able to manage the Rights per user.</td><td>UserType,<br>default User</td><td>Optional</td></tr><tr><td>UserRights</td><td>Container for a list of Rights</td><td>UserRights element</td><td>Optional</td></tr></tbody></table>

**UserRights element:**

<table data-header-hidden><thead><tr><th width="152">Name</th><th>Description</th><th width="162">Type</th><th>Required/Optional</th></tr></thead><tbody><tr><td>Name</td><td>Description</td><td>Type</td><td>Required/Optional</td></tr><tr><td>Right</td><td>Specifies a right that the user has</td><td>Right</td><td>Required</td></tr></tbody></table>

**CustomerPaymentConditionElement:**

<table><thead><tr><th>Name</th><th>Description</th><th>Type</th><th data-type="checkbox">Required</th></tr></thead><tbody><tr><td>Code</td><td>Identifier of a Payment Condition</td><td>string</td><td>false</td></tr><tr><td>Description</td><td>Description of a Payment Condition</td><td>string</td><td>false</td></tr></tbody></table>

**Types**:

| Type                   | Values                                                                                              |
| ---------------------- | --------------------------------------------------------------------------------------------------- |
| AddressType            | Invoicing, Delivery                                                                                 |
| Boolean                | Y, N                                                                                                |
| Date                   | yyyy-MM-dd                                                                                          |
| CustomerIdentification | DebtorNumber, Email                                                                                 |
| CustomerState          | Active, Blocked                                                                                     |
| Gender                 | Undefined, Male, Female                                                                             |
| GLN                    | Must be a valid GLN number                                                                          |
| LCID                   | Windows decimal LCID                                                                                |
| PriceList              | Name of in Vendisto existing PriceList                                                              |
| Right                  | OrderHistory, InvoiceHistory, BackOrderOverview, RestrictedOrderList, FavoritesList, UserManagement |
| StreetAddressType      | Combined, Separated                                                                                 |
| UserState              | Inactive, Active, Blocked                                                                           |
| UserType               | User, SuperUser                                                                                     |
| Validation             | Strict, Loose                                                                                       |

## Structuur Customer XML (Legacy)

\
De informatie in deze sectie beschrijft het legacy formaat voor de Customer XML import. Dit formaat wordt nog ondersteund maar zal worden uitgefaseerd. Nieuwe implementaties dienen hier geen gebruik meer van te maken.

```markup
<?xml version="1.0" encoding="utf-8"?>
<customers>
        <customer>
                <accountNumber></accountNumber>
                <defaultBillingAddress>
                        <name1></name1>
                        <name2></name2>
                        <address1></address1>
                        <address2></address2>
                        <postalCode></postalCode>
                        <city></city>
                        <country></country>
                </defaultBillingAddress>
                <defaultShipmentAddress>
                        <name1></name1>
                        <name2></name2>
                        <address1></address1>
                        <address2></address2>
                        <postalCode></postalCode>
                        <city></city>
                        <country></country>
                        <transportInstructionText></transportInstructionText>
                </defaultShipmentAddress>
                <projects>
                        <project>
                                <projectAccountNumber></projectAccountNumber>
                                <name></name>
                                <description></description>
                                <defaultShipmentAddress>
                                        <name1></name1>
                                        <name2></name2>
                                        <address1></address1>
                                        <address2></address2>
                                        <postalCode></postalCode>
                                        <city></city>
                                        <country></country>
                                        <transportInstructionText></transportInstructionText>
                                </defaultShipmentAddress>
                        </project>
                </projects>
                <ContactName></ContactName>
                <ContactEmailAddress></ContactEmailAddress>
                <CompanyVatNumber></CompanyVatNumber>
                <FirstName></FirstName>
                <MiddleName></MiddleName >
                <LastName></LastName >
                <GLN></GLN>
                <priceListNumber></priceListNumber>
                <paymentOnAccountAllowed></paymentOnAccountAllowed>
                <showPrices></showPrices>
                <showStock></showStock>
        </customer>
</customers>

```

## Velden customer XML (Legacy)

<table data-header-hidden><thead><tr><th width="224">Name</th><th width="163">Description</th><th width="150">Type</th><th>Required / Optional</th></tr></thead><tbody><tr><td>Name</td><td>Description</td><td>Type</td><td>Required / Optional</td></tr><tr><td>accountNumber</td><td>The identifier of a customer.</td><td>Text</td><td>Required</td></tr><tr><td>defaultBillingAddress / name1</td><td>Name of the billing address (department).</td><td>Text</td><td>Required</td></tr><tr><td>defaultBillingAddress / name2</td><td>A second name row of the billing address (attn)</td><td>Text</td><td>Optional</td></tr><tr><td>defaultBillingAddress / address1</td><td>Street and house number of the billing address</td><td>Text</td><td>Required</td></tr><tr><td>defaultBillingAddress / address2</td><td>An extra address row for the billing address</td><td>Text</td><td>Optional</td></tr><tr><td>defaultBillingAddress / postalcode</td><td>The postal code of the billing address</td><td>Text</td><td>Required</td></tr><tr><td>defaultBillingAddress /city</td><td>The city of the billing address</td><td>Text</td><td>Required</td></tr><tr><td>defaultBillingAddress /country</td><td>The country of the billing address</td><td>Text</td><td>Required</td></tr><tr><td>defaultShippingAddress / name1</td><td>Name of the shipping address (department).</td><td>Text</td><td>Required</td></tr><tr><td>defaultShippingAddress / name2</td><td>A second name row of the shipping address (attn)</td><td>Text</td><td>Optional</td></tr><tr><td>defaultShippingAddress / address1</td><td>Street and house number of the shipping address</td><td>Text</td><td>Required</td></tr><tr><td>defaultShippingAddress / address2</td><td>An extra address row for the shipping address</td><td>Text</td><td>Optional</td></tr><tr><td>defaultShippingAddress / postalcode</td><td>The postal code of the shipping address</td><td>Text</td><td>Required</td></tr><tr><td>defaultShippingAddress /city</td><td>The city of the Shipping address</td><td>Text</td><td>Required</td></tr><tr><td>defaultShippingAddress /country</td><td>The country of the Shipping address</td><td>Text</td><td>Required</td></tr><tr><td><p>defaultShippingAddress</p><p>/transportInstructionText</p></td><td>Transport and delivery instruction for the shipping address</td><td>Text</td><td>Optional</td></tr><tr><td>project / projectAccountNumber</td><td>The identifier of a project</td><td>Text</td><td>Required</td></tr><tr><td>project / name</td><td>The name of the project</td><td>Text</td><td>Required</td></tr><tr><td>project / description</td><td>A description of the project</td><td>Text</td><td>Optional</td></tr><tr><td>project / defaultShippingAddress / name1</td><td>Name of the shipping address (department).</td><td>Text</td><td>Required</td></tr><tr><td>project / defaultShippingAddress / name2</td><td>A second name row of the shipping address (attn)</td><td>Text</td><td>Optional</td></tr><tr><td>project / defaultShippingAddress / address1</td><td>Street and house number of the shipping address</td><td>Text</td><td>Required</td></tr><tr><td>project / defaultShippingAddress / address2</td><td>An extra address row for the shipping address</td><td>Text</td><td>Optional</td></tr><tr><td>project / defaultShippingAddress / postalcode</td><td>The postal code of the shipping address</td><td>Text</td><td>Required</td></tr><tr><td>project / defaultShippingAddress /city</td><td>The city of the Shipping address</td><td>Text</td><td>Required</td></tr><tr><td><p>project / defaultShippingAddress</p><p>/country</p></td><td>The country of the Shipping address</td><td>Text</td><td>Required</td></tr><tr><td>project /defaultShippingAddress /transportInstructionText</td><td>Transport and delivery instruction for the shipping address</td><td>Text</td><td>Optional</td></tr><tr><td>ContactName</td><td>The name of the contact. Can be replaced by FirstName, MiddleName and LastName</td><td>Text</td><td>Optional</td></tr><tr><td>ContactEmailAddress</td><td>The contacts emailaddress</td><td>Text</td><td>Required</td></tr><tr><td>FirstName</td><td>First name of the contact person</td><td>Text</td><td>Optional</td></tr><tr><td>MiddleName</td><td>Middle name of the contact person</td><td>Text</td><td>Optional</td></tr><tr><td>LastName</td><td>Last name of the contact person</td><td>Text</td><td>Optional</td></tr><tr><td>CompanyVatNumber</td><td>Vat number</td><td>Text</td><td>Optional</td></tr><tr><td>GLN</td><td>Global location number</td><td>GLN</td><td>Optional</td></tr><tr><td>priceListNumber</td><td>The pricelist reference</td><td>Text</td><td>Required</td></tr><tr><td>paymentOnAccountAllowed</td><td><p>Is the customer allowed to pay on account? (yes</p><p>= true, no = false)</p></td><td>Boolean</td><td>Required</td></tr><tr><td>showPrices</td><td>Can the customer see price information? (yes = true, no = false)</td><td>Boolean</td><td>Required</td></tr><tr><td>showStock</td><td><p>Can the customer see stock information? (yes</p><p>= true, no = false)</p></td><td>Boolean</td><td>Required</td></tr></tbody></table>

**Types:**

| **Name** | **Values**                 |
| -------- | -------------------------- |
| Boolean  | yes, no                    |
| GLN      | Must be a valid GLN number |
