mutation CreateConnector($request: CreateConnectorCommandRequestInput!) {
CreateConnector(request: $request) {
salesChannelId
name
url
isActive
isLocked
companyId
}
}{
"request": {
"url": "string",
"apiToken": "string",
"name": "string",
"companyId": "id"
}
}{
"data": {
"CreateConnector": {
"salesChannelId": "string",
"name": "string",
"url": "string",
"isActive": true,
"isLocked": true,
"companyId": "id"
}
}
}CreateConnector
Creates a new JTL-Connector account. The salesChannelId is derived server-side from the persisted tShop row (--, ADR-69) and cannot be supplied by the client - hence POST with no id in the route. The route matches the sibling collection GET sales-channels/connector/accounts (QueryConnectorAccounts) one-to-one - same collection, POST creates what GET lists. ResyncConnector/DeleteConnectorLink are not a precedent for this route shape: both act on an already-existing connector and therefore correctly carry instead. Performs a live handshake against the endpoint (init + features + global-data pull) using the ShopKey-less clients from WAWI-91760, then validates every taxrate the connector reports against the chosen company’s tSteuersatz (400 if any is unmapped). If the live call or taxrate validation fails, nothing is persisted. Otherwise tShop + tShopKonfiguration are inserted in one transaction, followed by a separate transaction for the full metadata mirror; if that second step fails, the handler compensates by deleting the shop row pair rather than leaving an orphaned, metadata-less account - not a single atomic transaction end-to-end. Connector-driven sections of the response (Languages, Currencies, Features, TaxRates, ServerInfo) are always sourced live from the handshake and are never accepted as request input - persisting client-supplied connector metadata would re-introduce the user-write semantics rejected in WAWI-90486/WAWI-90484, and would persist potentially stale data.
If a request with this mutation’s Idempotency-Key was already completed, the response’s extensions contains an idempotency.{responseName} entry with wasReplayed: true.
CreateConnector(request: CreateConnectorCommandRequestInput!): 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 CreateConnector($request: CreateConnectorCommandRequestInput!) {
CreateConnector(request: $request) {
salesChannelId
name
url
isActive
isLocked
companyId
}
}{
"request": {
"url": "string",
"apiToken": "string",
"name": "string",
"companyId": "id"
}
}{
"data": {
"CreateConnector": {
"salesChannelId": "string",
"name": "string",
"url": "string",
"isActive": true,
"isLocked": true,
"companyId": "id"
}
}
}Was this page helpful?