---
title: Customer module
slug: hyper-portal/customer-module
docTags: 
createdAt: 2021-02-22T09:12:43.000Z
---

The customer module can be used to export organizations from HyperPortal to XDMS customers. Organization import can be configured in the XDMS tab in the [settings](https://app.archbee.io/docs/ffeACTZ47_Cw3ctxvLLBM/_qF1OW_4T6OP_qLlJh0WP). The XDMS customers are stored in the 'Relations' tab in XDMS.

![](https://api.archbee.com/api/optimize/5goaGPkGyPYxtK7K75CEC/GbHHvB4DjBO4UucfCE_rK_image.png)



### Mappings

Some properties in this module have unique mappings. The CDcust field(customer type) should receive a code (for example 10). To get the list of the possible codes open any XDMS customer, then go to the 'Genera' tab - 'Accounting', then click on the icon near the 'cust. type' field.

![](https://api.archbee.com/api/optimize/5goaGPkGyPYxtK7K75CEC/syJxbnACP2epfdx_RcqL8_image.png)

The customer type then will be displayed depending on the code. It\`s recommended to have a separate entity in HyperPortal to store customer types, the codes should be stored in the xdmsExternalRef property of this entity.

This is how the mapping will look like - CDcust = customerType.xdmsExternalRef

![](https://api.archbee.com/api/optimize/5goaGPkGyPYxtK7K75CEC/Z58PL88mPnGD4cqaak8Fo_image.png)

The 'CDcnty' field should be referred to by its code. Countries in XDMS are stored with the two-letter code

::Image[]{src="https://api.archbee.com/api/optimize/5goaGPkGyPYxtK7K75CEC/VRltgwsAT1QTegDHlCNbz_image.png" size="52" width="272" height="362" position="center" showCaption="false"}



In HyperPortal those codes are stored in the 'entityId' property of the country entity. The mapping will look like this - CDcnty = country.entityId 

![](https://api.archbee.com/api/optimize/5goaGPkGyPYxtK7K75CEC/52omdXXBUoklPliah5jRf_image.png)



Example of correct mappings - [https://volodymyro.hyper1.net/settings/integrations/xdmsIntegration/xdmsCustomerModule](https://volodymyro.hyper1.net/settings/integrations/xdmsIntegration/xdmsCustomerModule)