# Partially update customer Endpoint: PATCH /enrichment/customers/{externalId} Version: 2.51.0 Security: OAuth2 ## Path parameters: - `externalId` (string, required) Previously sent externalId ## Request fields (application/merge-patch+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): - `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 400 fields (application/json): - `detail` (array) - `detail.loc` (array, required) - `detail.msg` (string, required) - `detail.type` (string, required) ## Response 404 fields (application/json): - `type` (string) A URI reference that uniquely identifies the problem type only in the context of the provided API. Opposed to the specification in RFC-7807, it is neither recommended to be dereferenceable and point to a human-readable documentation nor globally unique for the problem type. Example: "/some/uri-reference" - `title` (string) A short summary of the problem type. Written in English and readable for engineers, usually not suited for non technical stakeholders and not localized. Example: "some title for the error situation" - `status` (integer) The HTTP status code generated by the origin server for this occurrence of the problem. - `detail` (string) A human readable explanation specific to this occurrence of the problem that is helpful to locate the problem and give advice on how to proceed. Written in English and readable for engineers, usually not suited for non technical stakeholders and not localized. Example: "some description for the error situation" - `instance` (string) A URI reference that identifies the specific occurrence of the problem, e.g. by adding a fragment identifier or sub-path to the problem type. May be used to locate the root of this problem in the source code. Example: "/some/uri-reference#specific-occurrence-context" ## Response 415 fields (application/json): - `detail` (array) - `detail.loc` (array, required) - `detail.msg` (string, required) - `detail.type` (string, required) ## Response 429 fields