# Partially update supplier

Endpoint: PATCH /enrichment/suppliers/{externalId}
Version: 2.51.0
Security: OAuth2

## Path parameters:

  - `externalId` (string, required)
    Previously sent externalId

## Request fields (application/merge-patch+json):

  - `defaultAccountAssignment` (object)

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

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

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

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

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

  - `externalId` (string, required)
    External id of the supplier that is globally unique across the provided supplier 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 supplier in the source system (not unique across clients)
    Example: "CODE1"

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

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

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

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

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

  - `alternativePayee` (string)
    externalId of the supplier which is the alternative payee for this supplier

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

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

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

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

  - `state` (string)
    State where the company 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 supplier
    Example: [{"id":"DE123456789","countryCode":"DE"}]

  - `vatIds.id` (string)

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

  - `taxIds.type` (string)

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

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

  - `supplierSubsidiaries` (array)

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

  - `supplierSubsidiaries.paymentTerms` (object)

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

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

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

  - `supplierSubsidiaries.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

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

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

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

  - `supplierSubsidiaries.withholdingTaxInfo` (array)

  - `supplierSubsidiaries.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"

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

  - `supplierBankAccounts` (array)

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

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

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

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

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

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

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

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

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

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

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

  - `supplierBankAccounts.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"]}

## Response 200 fields (application/json):

  - `defaultAccountAssignment` (object)

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

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

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

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

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

  - `externalId` (string, required)
    External id of the supplier that is globally unique across the provided supplier 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 supplier in the source system (not unique across clients)
    Example: "CODE1"

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

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

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

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

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

  - `alternativePayee` (string)
    externalId of the supplier which is the alternative payee for this supplier

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

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

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

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

  - `state` (string)
    State where the company 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 supplier
    Example: [{"id":"DE123456789","countryCode":"DE"}]

  - `vatIds.id` (string)

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

  - `taxIds.type` (string)

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

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

  - `supplierSubsidiaries` (array)

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

  - `supplierSubsidiaries.paymentTerms` (object)

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

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

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

  - `supplierSubsidiaries.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

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

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

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

  - `supplierSubsidiaries.withholdingTaxInfo` (array)

  - `supplierSubsidiaries.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"

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

  - `supplierBankAccounts` (array)

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

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

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

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

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

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

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

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

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

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

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

  - `supplierBankAccounts.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"]}

## 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