CreateConnectorCommandRequestInput
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. - Request
CreateConnectorCommandRequestInputFields
When true, runs the identical live handshake and taxrate validation but writes nothing to the database - a connection test before the real create. Defaults to false when omitted. Note: the response shape differs when true - nothing is persisted and SalesChannelId is null - see the response description for the transport-specific details of this deviation.
URL of the connector endpoint. Mandatory.
API token used to authenticate against the connector endpoint. Mandatory. Write-only - never echoed back in the response.
Name of the connector account. Mandatory.
ID of the company the connector account belongs to. Mandatory - also the company whose tSteuersatz the connector-reported taxrates are validated against.
Connector account is active. Optional - defaults to the WPF editor default when omitted.
Connector account is locked. Optional - defaults to the WPF editor default when omitted.
Root category for imported items. Optional - defaults to the WPF editor default when omitted.
Use the shop-assigned order number instead of the Wawi-generated one. Optional - defaults to the WPF editor default when omitted.
The connector account is allowed to import data from the endpoint. Optional - defaults to the WPF editor default when omitted.
Items and categories are imported. Optional - defaults to the WPF editor default when omitted.
Orders and customers are imported. Optional - defaults to the WPF editor default when omitted.
Item images are imported. Optional - defaults to the WPF editor default when omitted.
The connector account is allowed to upload data to the endpoint. Optional - defaults to the WPF editor default when omitted.
Items are uploaded completely, rather than price/stock-restricted. Optional - defaults to the WPF editor default when omitted.
Item uploads are restricted to prices only. Optional - defaults to the WPF editor default when omitted.
Item uploads are restricted to stock only. Optional - defaults to the WPF editor default when omitted.
Customer data is uploaded. Optional - defaults to the WPF editor default when omitted.
Images are uploaded. Optional - defaults to the WPF editor default when omitted.
Existing items are merged/refreshed rather than only added. Optional - defaults to the WPF editor default when omitted.
Existing customer data is refreshed. Optional - defaults to the WPF editor default when omitted.
Images are deleted on import. Optional - defaults to the WPF editor default when omitted.
The Wawi calculates the tax rate for items, rather than taking the endpoint-reported one. Optional - defaults to the WPF editor default when omitted.
The Wawi calculates the tax rate for shipping, rather than taking the endpoint-reported one. Optional - defaults to the WPF editor default when omitted.
The shipping/departure country as an ISO 3166-1 alpha-2 country code. Optional - defaults to the WPF editor default when omitted. Canonical form is UPPERCASE (ADR-85); matching is case-insensitive.
Maximum number of entities transferred per run, or null for unrestricted. Optional - defaults to the WPF editor default when omitted.
Maximum pull count per sync run. Optional - defaults to the WPF editor default when omitted.
Maximum number of images transferred per run, or null for unrestricted. Optional - defaults to the WPF editor default when omitted.
Maximum transfer rate for uploads, in megabytes, or null for unrestricted. Optional - defaults to the WPF editor default when omitted.
Maximum quick-sync count per sync run. Optional - defaults to the WPF editor default when omitted.
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?