UpdateConnectorCommandRequestInput
Partially updates an existing JTL-Connector account. Only fields included in the request are changed; omitted fields keep their current value; “isActive” is ignored. Languages, currencies, features, tax rates and server information are read-only and cannot be changed here. If “Url” or “ApiToken” changes, JTL-Wawi first performs a live handshake with the new connection data; if the handshake fails, nothing is saved. Requests that do not change “Url” or “ApiToken” are saved without contacting the endpoint. The endpoint metadata is not refreshed by this call; use “POST /v2/sales-channels//connector/refresh” or “RefreshConnector” for that. - Request
UpdateConnectorCommandRequestInputFields
Sales channel id of the connector account to update. Opaque, tenant-local composite identifier (not a UUID); use the value returned by a sales channel listing.
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. A changed URL must not point to the same host and path as another active JTL-Connector account; deleted (inactive) accounts are ignored, and a deleted account itself is not checked.
API token used to authenticate against the connector endpoint. Omit to leave unchanged. Write-only; never returned. A new token is verified with a live handshake before it is saved.
Name of the connector account. Omit to leave unchanged.
ID of the company the connector account belongs to. Omit to leave unchanged. Cannot be null. The tax rates reported by the endpoint are validated against this company's tax rates.
DEPRECATED: do not use. This property is ignored and will be removed in a future API version.
Connector account is locked. Omit to leave unchanged.
Root category for imported items. Omit to leave unchanged; send null to clear it.
Use the shop-assigned order number instead of the JTL-Wawi-generated one. Omit to leave unchanged.
The connector account is allowed to import data from the endpoint. Omit to leave unchanged.
Items and categories are imported. Omit to leave unchanged.
Orders and customers are imported. Omit to leave unchanged.
Item images are imported. Omit to leave unchanged.
The connector account is allowed to upload data to the endpoint. Omit to leave unchanged.
Items are uploaded completely, rather than price/stock-restricted. Omit to leave unchanged.
Item uploads are restricted to prices only. Omit to leave unchanged.
Item uploads are restricted to stock only. Omit to leave unchanged.
Customer data is uploaded. Omit to leave unchanged.
Images are uploaded. Omit to leave unchanged.
Existing items are merged/refreshed rather than only added. Omit to leave unchanged.
Existing customer data is refreshed. Omit to leave unchanged.
Images are deleted on import. Omit to leave unchanged.
JTL-Wawi calculates the tax rate for items, rather than taking the endpoint-reported one. Omit to leave unchanged.
JTL-Wawi calculates the tax rate for shipping, rather than taking the endpoint-reported one. Omit to leave unchanged.
The shipping (departure) country as an ISO 3166-1 alpha-2 code, e.g. DE. Omit to leave unchanged; send null to clear it. Case-insensitive; returned in uppercase.
Maximum number of entities transferred per run. Omit to leave unchanged; send null for unrestricted.
Maximum number of entities pulled per synchronization run. Omit to leave unchanged. Cannot be null.
Maximum number of images transferred per run. Omit to leave unchanged; send null for unrestricted.
Maximum transfer rate for uploads, in megabytes. Omit to leave unchanged; send null for unrestricted.
Maximum number of entities per quick-sync run. Omit to leave unchanged. Cannot be null.
Manufacturer data sent to the endpoint is filtered to only assigned manufacturers. Omit to leave unchanged.
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.
Was this page helpful?