Input objects

UpdateConnectorCommandRequestInput

Partially updates an existing JTL-Connector account. Every field is optional: a field present in the request body is changed, a field left out keeps its persisted value (May<T> PATCH semantics). The writable field set is the writable half of CreateConnector, property for property, and the response is the same full Connector object - create an account, then patch any subset of the same fields. Only locally editable data is writable here: tShop base data, the connection credentials and tShopKonfiguration. The connector-driven sections (Languages, Currencies, Features, TaxRates, ServerInfo) are response-only and are never accepted as request input, for the same reason as in CreateConnector. Changing Url or ApiToken is not a local write: the persisted metadata mirror describes one specific endpoint, so a connection change is verified against the connection the account would end up with, before anything is written, and the request fails without persisting when that handshake does not succeed. The mirror itself is not refreshed here - the shared refresh service is WAWI-91762 and has no code yet, so until it lands the mirror is brought up to date by RefreshConnector or the next Abgleich. A request that changes neither - or submits the values the account already has - performs a purely local persist with no live call. There is deliberately no ?simulate switch: testing a connection before an account exists is CreateConnector's ?simulate=true, and testing an existing account's credentials is AuthenticateConnector (WAWI-90496). This monolithic PATCH deliberately overlaps the section-based save family (WAWI-90485 configuration, WAWI-90494 credentials); the team decided on 2026-08-26 to build both and remove one later. - Request

inputUpdateConnectorCommandRequestInput

Fields

salesChannelId

String!

required

Sales channel id of the connector account to update.

url

String

URL of the connector endpoint. Omit to leave unchanged. Connection data - submitting a different value triggers the live handshake, which must succeed before anything is written.

apiToken

String

API token used to authenticate against the connector endpoint. Omit to leave unchanged. Write-only - never echoed back, and no response model of this API exposes it. Connection data - a new token triggers the live handshake, which must succeed before anything is written, and discards any Connector session cached for this account so the next call authenticates with the new token.

name

String

Name of the connector account. Omit to leave unchanged.

companyId

ID of the company the connector account belongs to. Omit to leave unchanged. Cannot be cleared - the company is mandatory at creation and is the company whose tSteuersatz the endpoint-reported taxrates are validated against.

isActive

Boolean

Connector account is active. Omit to leave unchanged.

isLocked

Boolean

Connector account is locked. Omit to leave unchanged.

rootCategoryId

Root category for imported items. Omit to leave unchanged; send null to clear it.

useShopOrderNumber

Boolean

Use the shop-assigned order number instead of the Wawi-generated one. Omit to leave unchanged.

canImport

Boolean

The connector account is allowed to import data from the endpoint. Omit to leave unchanged.

shouldImportItemsAndCategories

Boolean

Items and categories are imported. Omit to leave unchanged.

shouldImportOrdersAndCustomers

Boolean

Orders and customers are imported. Omit to leave unchanged.

shouldImportImages

Boolean

Item images are imported. Omit to leave unchanged.

canUpload

Boolean

The connector account is allowed to upload data to the endpoint. Omit to leave unchanged.

shouldUploadItemComplete

Boolean

Items are uploaded completely, rather than price/stock-restricted. Omit to leave unchanged.

shouldUploadItemPriceRestricted

Boolean

Item uploads are restricted to prices only. Omit to leave unchanged.

shouldUploadItemStockRestricted

Boolean

Item uploads are restricted to stock only. Omit to leave unchanged.

shouldUploadCustomers

Boolean

Customer data is uploaded. Omit to leave unchanged.

shouldUploadImages

Boolean

Images are uploaded. Omit to leave unchanged.

shouldRefreshExistingItems

Boolean

Existing items are merged/refreshed rather than only added. Omit to leave unchanged.

shouldRefreshCustomers

Boolean

Existing customer data is refreshed. Omit to leave unchanged.

shouldDeleteImagesOnImport

Boolean

Images are deleted on import. Omit to leave unchanged.

shouldWawiCalculateTaxRate

Boolean

The Wawi calculates the tax rate for items, rather than taking the endpoint-reported one. Omit to leave unchanged.

shouldWawiCalculateTaxRateForShipping

Boolean

The Wawi calculates the tax rate for shipping, rather than taking the endpoint-reported one. Omit to leave unchanged.

shippingCountryIso

String

The shipping/departure country as an ISO 3166-1 alpha-2 country code. Omit to leave unchanged; send null to clear it. Canonical form is UPPERCASE (ADR-85); matching is case-insensitive.

entityCount

Int

Maximum number of entities transferred per run. Omit to leave unchanged; send null for unrestricted.

pullCount

Int

Maximum pull count per sync run. Omit to leave unchanged. Not nullable - the column carries a definite value, so there is no unrestricted state to express.

imagesCount

Int

Maximum number of images transferred per run. Omit to leave unchanged; send null for unrestricted.

maximumTransferRate

Decimal

Maximum transfer rate for uploads, in megabytes. Omit to leave unchanged; send null for unrestricted.

quickSyncCount

Int

Maximum quick-sync count per sync run. Omit to leave unchanged. Not nullable, for the same reason as PullCount.

sendOnlyAssignedManufacturers

Boolean

Manufacturer data sent to the endpoint is filtered to only assigned manufacturers. Omit to leave unchanged.

idempotencyKey

String

Client-supplied idempotency key. When provided, a repeated request with the same key and payload replays the original result instead of re-executing the mutation.

Overview

GraphQL

REST API

UpdateConnectorCommandRequestInput

Fields