# Update external service settings Updates the external service settings. Endpoint: PUT /external-services-settings Version: latest Security: SecretApiKey, JWT ## Request fields (application/json): - `quickBooksOnline` (object) QuickBooks Online settings. - `quickBooksOnline.customer` (object) Customer settings. - `quickBooksOnline.customer.sync` (string) Specifies how to synchronize customers between your Rebilly and QuickBooks Online account. Enum: "manually", "when-used", "always" - `quickBooksOnline.customer.displayName` (string) Enum: "id", "full-name", "organization-name" - `quickBooksOnline.invoice` (object) Invoice settings. - `quickBooksOnline.invoice.sync` (string) Specifies how to synchronize invoices between your Rebilly and QuickBooks Online account. Enum: "manually", "when-issued", "always" - `quickBooksOnline.invoice.syncZeroInvoices` (boolean) Specifies whether to synchronize zero amount invoices. - `quickBooksOnline.invoice.unearnedRevenueAccountId` (string,null) ID of the journal account where all products are created. Example: "jrn_acc_01H32J1C97KWGRCKF1E1JY0QG8" - `quickBooksOnline.invoice.taxesAccountId` (string,null) ID of the journal account where all taxes are created. Example: "jrn_acc_01H32J1KGXSRDH0K8Q7YYA552T" - `quickBooksOnline.invoice.discountsAccountId` (string,null) ID of the journal account where all discounts are created. Example: "jrn_acc_01H32J1KGXSRDH0K8Q7YYA552T" - `quickBooksOnline.invoice.department` (string,null) ID of the QuickBooks Online department that invoices are related to. Example: "jrn_acc_01H32J1KGXSRDH0K8Q7YYA552T" - `quickBooksOnline.invoice.itemName` (string) Name of the invoice item. - `quickBooksOnline.invoice.itemDescription` (string) Description of the invoice item. - `quickBooksOnline.invoice.itemSku` (string) Stock Keeping Unit (SKU) of the invoice item. - `quickBooksOnline.invoice.itemLineDescription` (string) Description of the invoice line item. - `quickBooksOnline.invoice.taxName` (string) Name of the tax that is applied to the invoice. - `quickBooksOnline.invoice.taxDescription` (string) Description of the tax that is applied to the invoice. - `quickBooksOnline.invoice.taxSku` (string) Stock Keeping Unit (SKU) of the tax that is applied to the invoice. - `quickBooksOnline.invoice.taxLineDescription` (string) Description of the tax line. - `quickBooksOnline.transaction` (object) Transaction settings. - `quickBooksOnline.transaction.syncPayments` (string) Specifies how to synchronize transactions between your Rebilly and QuickBooks Online account. Enum: "manually", "always" - `quickBooksOnline.transaction.syncRefundReceipts` (string) Specifies how to synchronize invoices between your Rebilly and QuickBooks Online account. Enum: "manually", "always" - `quickBooksOnline.transaction.depositAccountId` (string,null) ID of the journal account where all payments and refund receipts are deposited. Example: "jrn_acc_01H32J1C97KWGRCKF1E1JY0QG8" - `quickBooksOnline.transaction.department` (string,null) ID of the QuickBooks Online department that payments and refund receipts are related to. Example: "jrn_acc_01H32J1KGXSRDH0K8Q7YYA552T" - `quickBooksOnline.journalEntry` (object) Journal entry settings. - `quickBooksOnline.journalEntry.sync` (string) Specifies how to synchronize journal entries between your Rebilly and QuickBooks Online account. Enum: "manually", "always" ## Response 200 fields (application/json): - `quickBooksOnline` (object) QuickBooks Online settings. - `quickBooksOnline.customer` (object) Customer settings. - `quickBooksOnline.customer.sync` (string) Specifies how to synchronize customers between your Rebilly and QuickBooks Online account. Enum: "manually", "when-used", "always" - `quickBooksOnline.customer.displayName` (string) Enum: "id", "full-name", "organization-name" - `quickBooksOnline.invoice` (object) Invoice settings. - `quickBooksOnline.invoice.sync` (string) Specifies how to synchronize invoices between your Rebilly and QuickBooks Online account. Enum: "manually", "when-issued", "always" - `quickBooksOnline.invoice.syncZeroInvoices` (boolean) Specifies whether to synchronize zero amount invoices. - `quickBooksOnline.invoice.unearnedRevenueAccountId` (string,null) ID of the journal account where all products are created. Example: "jrn_acc_01H32J1C97KWGRCKF1E1JY0QG8" - `quickBooksOnline.invoice.taxesAccountId` (string,null) ID of the journal account where all taxes are created. Example: "jrn_acc_01H32J1KGXSRDH0K8Q7YYA552T" - `quickBooksOnline.invoice.discountsAccountId` (string,null) ID of the journal account where all discounts are created. Example: "jrn_acc_01H32J1KGXSRDH0K8Q7YYA552T" - `quickBooksOnline.invoice.department` (string,null) ID of the QuickBooks Online department that invoices are related to. Example: "jrn_acc_01H32J1KGXSRDH0K8Q7YYA552T" - `quickBooksOnline.invoice.itemName` (string) Name of the invoice item. - `quickBooksOnline.invoice.itemDescription` (string) Description of the invoice item. - `quickBooksOnline.invoice.itemSku` (string) Stock Keeping Unit (SKU) of the invoice item. - `quickBooksOnline.invoice.itemLineDescription` (string) Description of the invoice line item. - `quickBooksOnline.invoice.taxName` (string) Name of the tax that is applied to the invoice. - `quickBooksOnline.invoice.taxDescription` (string) Description of the tax that is applied to the invoice. - `quickBooksOnline.invoice.taxSku` (string) Stock Keeping Unit (SKU) of the tax that is applied to the invoice. - `quickBooksOnline.invoice.taxLineDescription` (string) Description of the tax line. - `quickBooksOnline.transaction` (object) Transaction settings. - `quickBooksOnline.transaction.syncPayments` (string) Specifies how to synchronize transactions between your Rebilly and QuickBooks Online account. Enum: "manually", "always" - `quickBooksOnline.transaction.syncRefundReceipts` (string) Specifies how to synchronize invoices between your Rebilly and QuickBooks Online account. Enum: "manually", "always" - `quickBooksOnline.transaction.depositAccountId` (string,null) ID of the journal account where all payments and refund receipts are deposited. Example: "jrn_acc_01H32J1C97KWGRCKF1E1JY0QG8" - `quickBooksOnline.transaction.department` (string,null) ID of the QuickBooks Online department that payments and refund receipts are related to. Example: "jrn_acc_01H32J1KGXSRDH0K8Q7YYA552T" - `quickBooksOnline.journalEntry` (object) Journal entry settings. - `quickBooksOnline.journalEntry.sync` (string) Specifies how to synchronize journal entries between your Rebilly and QuickBooks Online account. Enum: "manually", "always" ## Response 401 fields (application/json): - `status` (integer) HTTP status code. - `type` (string) Problem type in the form of a [URI](https://tools.ietf.org/html/rfc3986) reference. It should provide human-readable documentation for the problem type. When this member is not present, its value is assumed to be "about:blank". - `title` (string) Short, human-readable summary of the problem type. Other than for the purposes of localization, this should not change from occurrence to occurrence of the problem. - `detail` (string) Human-readable explanation that is specific to this occurrence of the problem. - `instance` (string) URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. ## Response 403 fields (application/json): - `status` (integer) HTTP status code. - `type` (string) Problem type in the form of a [URI](https://tools.ietf.org/html/rfc3986) reference. It should provide human-readable documentation for the problem type. When this member is not present, its value is assumed to be "about:blank". - `title` (string) Short, human-readable summary of the problem type. Other than for the purposes of localization, this should not change from occurrence to occurrence of the problem. - `detail` (string) Human-readable explanation that is specific to this occurrence of the problem. - `instance` (string) URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. ## Response 422 fields (application/json): - `status` (integer) HTTP status code. - `type` (string) Problem type in the form of a [URI](https://tools.ietf.org/html/rfc3986) reference. It should provide human-readable documentation for the problem type. When this member is not present, its value is assumed to be "about:blank". - `title` (string) Short, human-readable summary of the problem type. Other than for the purposes of localization, this should not change from occurrence to occurrence of the problem. - `detail` (string) Human-readable explanation that is specific to this occurrence of the problem. - `instance` (string) URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. - `invalidFields` (array) Invalid field details. Example: [{"field":"field1","message":"field1 is invalid"},{"field":"subObject.field2","message":"field2 is invalid"},{"field":"subObject.field2","message":"another error in the field2"}] - `invalidFields.field` (string) Name of the field. Dot notation is used for nested object field names. - `invalidFields.message` (string) Message field. ## Response 429 fields (application/json): - `type` (string) Problem type in the form of a [URI](https://tools.ietf.org/html/rfc3986) reference. It should provide human-readable documentation for the problem type. When this member is not present, its value is assumed to be "about:blank". Example: "about:blank" - `title` (string) Short, human-readable summary of the problem type. Other than for the purposes of localization, this should not change from occurrence to occurrence of the problem. Example: "Rate Limit Exceeded" - `status` (integer) HTTP status code. - `detail` (string) Human-readable explanation that is specific to this occurrence of the problem. Example: "A request cannot be executed because the user has sent too many requests within a certain period of time" - `instance` (string) URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.