# Insert customer

Endpoint: POST /enrichment/customers
Version: 2.51.0
Security: OAuth2

## Request fields (application/json):

  - `externalId` (string, required)
    External id of the customer that is globally unique across the provided customer data
    Example: "0000100000"

  - `externalClientId` (string)
    Identifier of the client entity in the source system which can be used to separate data
    Example: "EXTERNAL_CLIENT_ID"

  - `code` (string)
    Code of the customer in the source system (not unique across clients)
    Example: "CODE1"

  - `name` (string, required)
    Name of the customer
    Example: "Acmne Corp."

  - `nameAlternative1` (string)
    Alternative name of the customer
    Example: "Acmne Corp."

  - `nameAlternative2` (string)
    Alternative name of the customer
    Example: "Acmne Corp."

  - `nameAlternative3` (string)
    Alternative name of the customer
    Example: "Acmne Corp."

  - `nameAlternative4` (string)
    Alternative name of the customer
    Example: "Acmne Corp."

  - `street` (string)
    Street and street number where the customer is located
    Example: "Hauptstr. 1"

  - `addressAdditional` (string)
    Additional address data (e.g. apartment or suite)
    Example: "Eingang B"

  - `postcode` (string)
    Postcode where the customer is located
    Example: "10001"

  - `city` (string)
    City where the customer is located
    Example: "Berlin"

  - `countryCode` (string,null)
    Two letter country code as defined in ISO 3166-1 alpha-2
    Enum: "AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "BR", "IO", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "CI", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KP", "KR", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "SS", "ES", "LK", "SD", "SR", "SJ", "SZ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "US", "UM", "UY", "UZ", "VU", "VE", "VN", "VG", "VI", "WF", "EH", "YE", "ZM", "ZW", null

  - `vatIds` (array)
    List of VAT IDs assigned to the customer
    Example: [{"id":"DE123456789","countryCode":"DE"}]

  - `vatIds.id` (string)

  - `taxIds` (array)
    List of Tax IDs assigned to the customer
    Example: [{"id":"123-456-789","type":"TIN"}]

  - `taxIds.type` (string)

  - `blockedForPosting` (boolean)
    Indicator if the customer is blocked for posting

  - `blockedForPayment` (boolean)
    Indicator if the customer is blocked for payment

  - `blockedForOrdering` (boolean)
    Indicator if the customer is blocked for ordering globally

  - `blockedForDelivery` (boolean)
    Indicator if the customer is blocked for delivery globally

  - `customerSubsidiaries` (array)

  - `customerSubsidiaries.defaultAccountAssignment` (object)

  - `customerSubsidiaries.defaultAccountAssignment.glAccountCode` (string)
    Default general ledger account that is assigned to the supplier
    Example: "0000100GL1"

  - `customerSubsidiaries.defaultAccountAssignment.costCenterCode` (string)
    Default cost center account that is assigned to the supplier
    Example: "0000100CC1"

  - `customerSubsidiaries.defaultAccountAssignment.externalApproverId` (string)
    Default external approver ID that is assigned to the supplier
    Example: "MMUSTERMANN"

  - `customerSubsidiaries.defaultAccountAssignment.externalProjectId` (string)
    Default external project ID that is assigned to the supplier
    Example: "PROJ1234"

  - `customerSubsidiaries.defaultAccountAssignment.externalOrderId` (string)
    Default external order ID that is assigned to the supplier
    Example: "ORDER1234"

  - `customerSubsidiaries.externalCompanyId` (string, required)
    External unique id of the company that the subsidiary is assigned to
    Example: "DE01"

  - `customerSubsidiaries.paymentTerms` (object)

  - `customerSubsidiaries.paymentTerms.paymentTermKey` (string)
    Key of the payment term as defined in the source system
    Example: "T10"

  - `customerSubsidiaries.paymentTerms.descriptions` (array)
    Descriptions of the payment terms in different languages
    Example: [{"text":"Please pay us","language":"en"}]

  - `customerSubsidiaries.paymentTerms.descriptions.text` (string)
    Text content
    Example: "Fish & Chips"

  - `customerSubsidiaries.paymentTerms.descriptions.language` (string,null)
    Two letter language code as defined in ISO 639-1
    Enum: "aa", "ab", "ae", "af", "ak", "am", "an", "ar", "as", "av", "ay", "az", "ba", "be", "bg", "bh", "bi", "bm", "bn", "bo", "br", "bs", "ca", "ce", "ch", "co", "cr", "cs", "cu", "cv", "cy", "da", "de", "dv", "dz", "ee", "el", "en", "eo", "es", "et", "eu", "fa", "ff", "fi", "fj", "fo", "fr", "fy", "ga", "gd", "gl", "gn", "gu", "gv", "ha", "he", "hi", "ho", "hr", "ht", "hu", "hy", "hz", "ia", "id", "ie", "ig", "ii", "ik", "io", "is", "it", "iu", "ja", "jv", "ka", "kg", "ki", "kj", "kk", "kl", "km", "kn", "ko", "kr", "ks", "ku", "kv", "kw", "ky", "la", "lb", "lg", "li", "ln", "lo", "lt", "lu", "lv", "mg", "mh", "mi", "mk", "ml", "mn", "mr", "ms", "mt", "my", "na", "nb", "nd", "ne", "ng", "nl", "nn", "no", "nr", "nv", "ny", "oc", "oj", "om", "or", "os", "pa", "pi", "pl", "ps", "pt", "qu", "rm", "rn", "ro", "ru", "rw", "sa", "sc", "sd", "se", "sg", "si", "sk", "sl", "sm", "sn", "so", "sq", "sr", "ss", "st", "su", "sv", "sw", "ta", "te", "tg", "th", "ti", "tk", "tl", "tn", "to", "tr", "ts", "tt", "tw", "ty", "ug", "uk", "ur", "uz", "ve", "vi", "vo", "wa", "wo", "xh", "yi", "yo", "za", "zh", "zu", null

  - `customerSubsidiaries.blockedForPosting` (boolean)
    Indicator if the subsidiary is blocked for posting

  - `customerSubsidiaries.blockedForPayment` (boolean)
    Indicator if the subsidiary is blocked for payment

  - `customerSubsidiaries.enabledForAutoPosting` (boolean)
    Indicator if the subsidiary is enabled for auto posting
    Example: true

  - `customerSubsidiaries.withholdingTaxInfo` (array)

  - `customerSubsidiaries.withholdingTaxInfo.key` (string)
    Key that the source system uses to clearly identify the type of withholding tax that needs to be paid
    Example: "WHT-432"

  - `customerSubsidiaries.withholdingTaxInfo.descriptions` (array)
    Descriptions of the type of withholding tax
    Example: [{"text":"Some very deep description of the type of withholding tax","language":"en"}]

  - `customerBankAccounts` (array)

  - `customerBankAccounts.externalId` (string, required)
    External id of the bank account that is globally unique across the provided bank account data
    Example: "12341234"

  - `customerBankAccounts.bankAccountNumber` (string)
    Bank account number of the bank account
    Example: "78090"

  - `customerBankAccounts.bankAccountHolder` (string)
    Name of the bank account holder
    Example: "Maximilian Mustermann"

  - `customerBankAccounts.iban` (string)
    IBAN of the bank account
    Example: "DE91100000000123456789"

  - `customerBankAccounts.bic` (string)
    Bank identifier code
    Example: "CHASUS33XXX"

  - `customerBankAccounts.bankName` (string)
    Name of the bank where the bank account is held
    Example: "Deutsche Bank"

  - `customerBankAccounts.bankStreet` (string)
    Street and street number where the bank is located
    Example: "Hauptstr. 1"

  - `customerBankAccounts.bankPostcode` (string)
    Postcode where the bank is located.
    Example: "10001"

  - `customerBankAccounts.bankCity` (string)
    City where the bank is located.
    Example: "Berlin"

  - `customerBankAccounts.isActive` (boolean)
    Example: true

  - `customerBankAccounts.type` (string)
    Type of bank account.
    Example: "SAVINGS"

  - `customerBankAccounts.bankKey` (string)
    Unique key of the bank.
    Example: "60-16-13"

  - `customFields` (object)
    List of key value pairs containing custom fields from the source system

  - `customMetadata` (object)
    Any nested structure with metadata that source system needs to send
    Example: {"someTopLevelProperty":"value1","someNestedProperty":{"nestedProperty":"value2"},"someArrayProperty":["value3","value4"]}

  - `salesOrganizationInfo` (array)

  - `salesOrganizationInfo.externalSalesOrganizationId` (string)
    External identifier for the sales organization
    Example: "1000"

  - `salesOrganizationInfo.distributionChannel` (string)
    Distribution channel for sales
    Example: "2000"

  - `salesOrganizationInfo.division` (string)
    Division under which the sales organization operates
    Example: "3000"

  - `salesOrganizationInfo.salesGroup` (string)
    Sales group associated with the contract
    Example: "4000"

  - `salesOrganizationInfo.salesOffice` (string)
    Sales office responsible for the contract
    Example: "5000"

  - `salesOrganizationInfo.blockedForOrdering` (boolean)
    Indicator if the customer is blocked for ordering in a sales organization
    Example: true

  - `salesOrganizationInfo.blockedForDelivery` (boolean)
    Indicator if the subsidiary is blocked for delivery

  - `salesOrganizationInfo.shippingAddresses` (array)
    List of external id of the related shipping addresses
    Example: ["ADDR001","ADDR002"]

  - `salesOrganizationInfo.billingAddresses` (array)
    List of external id of the related billing addresses
    Example: ["ADDR003"]

  - `salesOrganizationInfo.salesOrganizationCode` (string)
    Code of the sales organization in the source system (not unique across clients)
    Example: "SO001"

  - `salesOrganizationInfo.salesUnit` (object)

  - `salesOrganizationInfo.salesUnit.unitOfMeasure` (string)
    Unit in which the product is sold, different from base unit
    Example: "PK"

  - `salesOrganizationInfo.salesUnit.conversionFactorToBaseUnit` (number)
    Number of base units per sales unit (e.g., 10 means 1 PK = 10 PC)
    Example: 1000

  - `salesOrganizationInfo.salesUnit.description` (string)
    Description of the sales unit packaging
    Example: "Package of 10 units"

## Response 200 fields (application/json):

  - `id` (string, required)
    Example: "3a429dc8-56d4-42ef-a4cf-2ebc9ad1ef38"

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)

  - `detail.type` (string, required)


## Response 429 fields