mutation UpdateConnector($request: UpdateConnectorCommandRequestInput!) {
UpdateConnector(request: $request) {
salesChannelId
name
url
isActive
isLocked
companyId
}
}{
"request": {
"salesChannelId": "string"
}
}{
"data": {
"UpdateConnector": {
"salesChannelId": "string",
"name": "string",
"url": "string",
"isActive": true,
"isLocked": true,
"companyId": "id"
}
}
}UpdateConnector
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.
If a request with this mutation’s Idempotency-Key was already completed, the response’s extensions contains an idempotency.{responseName} entry with wasReplayed: true.
UpdateConnector(request: UpdateConnectorCommandRequestInput!): Connector!Arguments
Returns
Sales channel id of this connector account. Opaque, tenant-local composite identifier (not a UUID). Null when "Simulate" is true (omitted in REST, null in GraphQL); no account was saved, so no id is assigned.
Name of the connector account.
URL of the connector endpoint.
Connector account is active.
Connector account is locked.
ID of the company the connector account belongs to.
The connector account is allowed to import data from the endpoint.
Items and categories are imported.
Orders and customers are imported.
Item images are imported.
The connector account is allowed to upload data to the endpoint.
Items are uploaded completely, rather than price/stock-restricted.
Item uploads are restricted to prices only.
Item uploads are restricted to stock only.
Customer data is uploaded.
Images are uploaded.
Existing items are merged/refreshed rather than only added.
Existing customer data is refreshed.
Images are deleted on import.
JTL-Wawi calculates the tax rate for items, rather than taking the endpoint-reported one.
JTL-Wawi calculates the tax rate for shipping, rather than taking the endpoint-reported one.
Maximum transfer rate for uploads, in megabytes, or null if unrestricted.
Maximum number of images transferred per run, or null if unrestricted.
Maximum number of entities transferred per run, or null if unrestricted.
Maximum pull count per sync run.
Maximum quick-sync count per sync run.
Manufacturer data sent to the endpoint is filtered to only assigned manufacturers.
The shipping (departure) country as an ISO 3166-1 alpha-2 code, e.g. DE, or null if not set. Case-insensitive; returned in uppercase.
Fallback category for uncategorized imported items, or null if not set.
Root category for imported items, or null if not set.
The shop-assigned order number is used instead of the JTL-Wawi-generated one.
Languages available in JTL-Wawi, annotated with the assignment/default state reported by the connector endpoint's live handshake.
ISO 4217 currencies known to JTL-Wawi, annotated with the assignment/default state reported by the connector endpoint's live handshake.
Every known connector feature, each marked whether the connector endpoint reported it as enabled.
Tax rates reported by the endpoint during the live handshake, each with the JTL-Wawi tax rate it was matched to. Returned when a connector account is created ("POST /v2/sales-channels/connector/accounts" or "CreateConnector") or refreshed ("POST /v2/sales-channels/{salesChannelId}/connector/refresh" or "RefreshConnector"); always empty in the update response ("PATCH /v2/sales-channels/{salesChannelId}/connector" or "UpdateConnector").
Live-only metadata about the connected endpoint's platform and protocol version, as reported by its handshake.
mutation UpdateConnector($request: UpdateConnectorCommandRequestInput!) {
UpdateConnector(request: $request) {
salesChannelId
name
url
isActive
isLocked
companyId
}
}{
"request": {
"salesChannelId": "string"
}
}{
"data": {
"UpdateConnector": {
"salesChannelId": "string",
"name": "string",
"url": "string",
"isActive": true,
"isLocked": true,
"companyId": "id"
}
}
}Was this page helpful?