mutation RefreshConnector($request: RefreshConnectorCommandRequestInput!) {
RefreshConnector(request: $request) {
salesChannelId
name
url
isActive
isLocked
companyId
}
}{
"request": {
"salesChannelId": "string"
}
}{
"data": {
"RefreshConnector": {
"salesChannelId": "string",
"name": "string",
"url": "string",
"isActive": true,
"isLocked": true,
"companyId": "id"
}
}
}RefreshConnector
Re-mirrors all connector-driven metadata of an existing JTL-Connector account on demand: performs a live handshake against the endpoint (core.connector.init, connector.identify, core.connector.features, global_data.pull), maps the reported metadata onto Wawi data, persists the connector’s mirror tables in one transaction, runs the four global-data sync services (shipping methods, cross-selling groups, units, measurement units) and finally pushes the acknowledgements. The modern equivalent of the legacy global-data import performed today by both the Abgleich and the WPF editor save; without that persisted mirror the Abgleich lacks data (tShopSprache, tShopWaehrung) and fails. Returns the same full object as CreateConnector. Two things are deliberately NOT modified: the customer-group assignment - which Wawi customer group an endpoint-side group maps to - which stays the separate user decision owned by PUT sales-channels//connector/customer-groups, and the locally editable configuration (tShop/tShopKonfiguration). The endpoint side of those mappings IS refreshed: the endpoint-reported name of an existing mapping is updated, a mapping whose endpoint group the endpoint no longer reports is removed, and a live group with no existing mapping is never auto-assigned - choosing its Wawi counterpart stays the user decision owned by the customer-groups endpoint, which lists it as an unassigned candidate. Distinct from ResyncConnector, which clears the Wawi-to-Connector shop mappings so the next sync re-imports everything - this command imports nothing item-level and only refreshes the metadata mirror. Concurrency with a running Abgleich is uncritical: both paths upsert the same semantics from the same live source, so the outcome is last-writer-wins. Caveat inherited from the live pull: each global-data collection is fetched with the connector protocol’s default page limit of 50 items, and the mirror write is a full-state replacement, so a connector reporting more than 50 entries in a collection has the excess assignments removed.
If a request with this mutation’s Idempotency-Key was already completed, the response’s extensions contains an idempotency.{responseName} entry with wasReplayed: true.
RefreshConnector(request: RefreshConnectorCommandRequestInput!): Connector!Arguments
Returns
Sales channel id of this connector account. Null when the request used ?simulate=true - no account was persisted, so no id could be 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.
The Wawi calculates the tax rate for items, rather than taking the endpoint-reported one.
The 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 country code, or null if not set. Canonical form is UPPERCASE (ADR-85); matching is case-insensitive.
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 Wawi-generated one.
Languages available in the Wawi, annotated with the assignment/default state reported by the connector endpoint's live handshake.
ISO 4217 currencies known to the 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.
Taxrates reported by the connector endpoint's live handshake, each merged with the internal Wawi taxrate it was validated against.
Live-only metadata about the connected endpoint's platform and protocol version, as reported by its handshake.
mutation RefreshConnector($request: RefreshConnectorCommandRequestInput!) {
RefreshConnector(request: $request) {
salesChannelId
name
url
isActive
isLocked
companyId
}
}{
"request": {
"salesChannelId": "string"
}
}{
"data": {
"RefreshConnector": {
"salesChannelId": "string",
"name": "string",
"url": "string",
"isActive": true,
"isLocked": true,
"companyId": "id"
}
}
}Was this page helpful?