Store imports API

Base URL: https://app.skuflow.ai/api. Every call needs Authorization: Bearer skf_… (Authentication); {organizationId} ($ORGANIZATION_ID in the examples) is your business's id.

The DecoNetwork connectionCopy Anchor Link

Whether a DecoNetwork login is saved (the site's address and the server's mode; the username and password are never answered). Read-only; call before listing DecoNetwork stores.

ExampleCopy Anchor Link

curl "https://app.skuflow.ai/api/organizations/$ORGANIZATION_ID/store-imports/deconetwork/connection" \
  -H "Authorization: Bearer $SKUFLOW_API_KEY"

ResponseCopy Anchor Link

Connect DecoNetworkCopy Anchor Link

Saves the DecoNetwork site's address and a staff login (use a dedicated staff account; the site needs DecoNetwork's API apps, an Enterprise feature) after DecoNetwork accepted it with one order search. The password is stored encrypted and never answered or logged. 400 when DecoNetwork refuses the login or can't be reached. The login reads orders (the site's stores, production files, coupons) and blank costs; it changes nothing in DecoNetwork.

Request bodyCopy Anchor Link

ExampleCopy Anchor Link

curl -X PUT "https://app.skuflow.ai/api/organizations/$ORGANIZATION_ID/store-imports/deconetwork/connection" \
  -H "Authorization: Bearer $SKUFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"siteUrl":"https://example.com","username":"string","password":"string"}'

ResponseCopy Anchor Link

Disconnect DecoNetworkCopy Anchor Link

Destructive: forgets the saved DecoNetwork login. Stores and products already imported stay; storefronts can still be previewed (without production files or blank costs).

ExampleCopy Anchor Link

curl -X DELETE "https://app.skuflow.ai/api/organizations/$ORGANIZATION_ID/store-imports/deconetwork/connection" \
  -H "Authorization: Bearer $SKUFLOW_API_KEY"

ResponseCopy Anchor Link

List the DecoNetwork site's storesCopy Anchor Link

The stores of the connected DecoNetwork site with their addresses, as its orders of the last year name them (DecoNetwork has no API that lists stores; a store with no orders isn't listed: preview it by its address). Reads DecoNetwork; changes nothing. 409 without a connection (PUT /store-imports/deconetwork/connection).

ExampleCopy Anchor Link

curl "https://app.skuflow.ai/api/organizations/$ORGANIZATION_ID/store-imports/deconetwork/stores" \
  -H "Authorization: Bearer $SKUFLOW_API_KEY"

ResponseCopy Anchor Link

List store importsCopy Anchor Link

The business's store imports, newest first, with their status, summary, the store made and the result. Read-only.

ParametersCopy Anchor Link

ExampleCopy Anchor Link

curl "https://app.skuflow.ai/api/organizations/$ORGANIZATION_ID/store-imports" \
  -H "Authorization: Bearer $SKUFLOW_API_KEY"

ResponseCopy Anchor Link

Preview a DecoNetwork storeCopy Anchor Link

Reads a DecoNetwork storefront (its public pages; with a saved login also blank costs, production files and coupons from DecoNetwork's API) and matches it, writing nothing but this import record: every product with its blank's match (EXISTING catalog product, SUPPLIER style to import, or CREATE), its decorations, where its artwork comes from (PRODUCTION_FILE or PLACEHOLDER), DecoNetwork's price per size and problems. Give the customer the store is for (customerId, GET /customers) or leave it out to make one named newCustomerName (default the store's name) when applying. Then POST /store-imports/{storeImportId}/apply.

Request bodyCopy Anchor Link

ExampleCopy Anchor Link

curl -X POST "https://app.skuflow.ai/api/organizations/$ORGANIZATION_ID/store-imports" \
  -H "Authorization: Bearer $SKUFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"storeUrl":"https://example.com"}'

ResponseCopy Anchor Link

A store importCopy Anchor Link

One store import: the preview (every product with its match, decorations, artwork source, prices per size and problems), progress while applying, and the result (what was made, warnings, what the owner still has to do). Poll it after POST …/apply. Read-only.

ParametersCopy Anchor Link

ExampleCopy Anchor Link

curl "https://app.skuflow.ai/api/organizations/$ORGANIZATION_ID/store-imports/{storeImportId}" \
  -H "Authorization: Bearer $SKUFLOW_API_KEY"

ResponseCopy Anchor Link

Delete a store import recordCopy Anchor Link

Destructive: deletes the import's record (its preview and result). What it made stays: undo first to remove that. 409 while it runs.

ParametersCopy Anchor Link

ExampleCopy Anchor Link

curl -X DELETE "https://app.skuflow.ai/api/organizations/$ORGANIZATION_ID/store-imports/{storeImportId}" \
  -H "Authorization: Bearer $SKUFLOW_API_KEY"

ResponseCopy Anchor Link

Apply a store importCopy Anchor Link

Customer-visible prices: starts making what the preview showed, in the background (poll GET /store-imports/{storeImportId}): the customer (when new), a DRAFT store (never opened: the owner opens it) with DecoNetwork's categories and logo, each product's catalog product (matched, imported from the supplier, or made), the customer's artwork (production files downloaded, else the store picture as a placeholder), a design per product, the customer's products with DecoNetwork's price as their FIXED store price (size upcharges where sizes cost more) and the store items following them. Applying again updates in place and sets those customer products' store prices to DecoNetwork's again, which moves every store following them. 409 while another import runs or after undo.

ParametersCopy Anchor Link

ExampleCopy Anchor Link

curl -X POST "https://app.skuflow.ai/api/organizations/$ORGANIZATION_ID/store-imports/{storeImportId}/apply" \
  -H "Authorization: Bearer $SKUFLOW_API_KEY"

ResponseCopy Anchor Link

Undo a store importCopy Anchor Link

Destructive: deletes the store it made (409 once that store took orders: close it instead) and what imports of that DecoNetwork store made for this customer that nothing else uses (customer products, designs, artwork, catalog products); what is used elsewhere is kept and listed in result.undo. Matched catalog products and the customer stay.

ParametersCopy Anchor Link

ExampleCopy Anchor Link

curl -X POST "https://app.skuflow.ai/api/organizations/$ORGANIZATION_ID/store-imports/{storeImportId}/undo" \
  -H "Authorization: Bearer $SKUFLOW_API_KEY"

ResponseCopy Anchor Link