Target Plus
Test Target Plus Connection
Checks a Seller ID and API token against Target Plus without storing anything. Always answers 200; `data.ok` is the result.
Get Target Plus Setup Hints
Facts to show before connecting a seller. `has_sps_target_trading_partner` is true when an SPS Commerce connection already trades with Target (its name or a trading-partner ID contains 'target'): Target first-party orders (Target as the buyer) keep arriving over SPS Commerce, and a Target Plus connection carries only marketplace orders.
List Target Plus Integrations
Lists every Target Plus seller account connected to this account. The seller API token is never returned (`has_api_token` says whether one is stored).
Create Target Plus Integration
Connects a Target Plus seller. The credentials are checked against Target first; then the integration is created and a background setup job syncs the seller's distribution centers and shipping methods. `tracked_job_log_id` identifies that job.
Get Target Plus Integration
Returns one Target Plus integration. The seller API token is never returned.
Update Target Plus Integration
Partially updates an integration — only the fields sent change. Sending `api_token` rotates the token: the new token is checked against Target before it replaces the stored one (422 if Target rejects it). `seller_id` and `environment` cannot change.
Delete Target Plus Integration
Disconnects a Target Plus seller: the stored token, distribution centers and shipping methods are deleted. SKU.io sales orders already created are kept as manual orders.
Get Target Plus Dashboard
Connection state, reference-data counts, order counts, tracking-push counts and the account-health estimate for one integration. `unmapped_distribution_centers` counts distribution centers not yet mapped to a warehouse; `new_distribution_centers` lists the unmapped ones Target added after setup. `fulfillments` counts shipped fulfillments by tracking-push state (`failed` and `blocked` need attention).
List Target Plus Activity
The integration's activity log, newest first. Each entry names its subject (`subject_type`, `subject_id`, `subject_label`) and the `batch_uuid` of the change it belongs to, when there is one. Paginated (default 10 per page, max 100).
List Target Plus Orders
Lists the integration's Target Plus orders, newest order date first. Each row carries the order's Target status and its status bucket (`creatable`, `shipped`, `cancelled`, `auto_cancelled`, `unknown`), the distribution center and the warehouse it maps to, the reasons the order is held back from becoming a SKU.io sales order (`hold_reasons`), ship-by risk, and the linked SKU.io sales order once one exists (`sku_sales_order_updated_at` is when it was last updated from the Target order).
Get Target Plus Order Filter Options
Returns the values the order filters accept for this integration, plus header counts.
Get Target Plus Order Sync Info
Summarizes what has been imported: the most recently updated order (`latestIdentifier` is its Target order number, `latestDate` when Target last changed it), how many orders are stored, how many have every line matched to a SKU.io product (`mappedCount`) and how many have at least one unmatched line (`unmappedCount`). `start_date` is the integration's order import start date (Y-m-d) or null.
Refresh Target Plus Orders
Queues a background pull of orders from Target Plus and returns the tracked job's ID right away; poll the tracked job for progress and the result.
Get Target Plus Order
Returns one order with everything on the list row plus the normalized shipping `address`, `line_items` (each line's TCIN, seller SKU, quantities, price and discounts, its distribution center and mapped warehouse, and the SKU.io product it matched — `mapped_by` is `listing` or `sku`), recorded `shipments`, a `financial` summary (merchandise, discounts, Target-funded discounts, total), `needs_action_codes` and the full list of `hold_reason_codes`.
Get Target Plus Order Raw Data
Fetches the order from Target Plus now and returns it as Target sends it (`order`), together with the stored shipping address and the stored fulfillment records. Use it to compare what Target holds with what SKU.io imported.
List Target Plus Order Activity
The order's own activity log, newest first: imports, status changes, holds, SKU.io sales order creation, acknowledgements and errors. Each entry includes the user or process that caused it (`causer`) when there is one. Paginated (default 10 per page, max 100).
Create SKU Order from Target Plus Order
Creates the SKU.io sales order for one Target Plus order now, instead of waiting for the automatic run. Returns the new `sales_order_id` and the refreshed order.
Delete SKU Order for Target Plus Order
Deletes the SKU.io sales order linked to this Target Plus order and keeps the Target Plus order, now unlinked. Nothing changes on Target.
Acknowledge Target Plus Order
Acknowledges the order on Target Plus. Only lines matched to a SKU.io product are acknowledged; unmatched lines stay held until they are mapped. Send `lines` to acknowledge specific lines only.
Cancel Target Plus Order Lines
Seller-cancel units on a Target Plus order. Line-level and irreversible, and Target counts seller cancellations against the Order Defect Rate. Only lines with nothing shipped can be cancelled, and only their open units; for shipped items contact Target support. The cancellation runs as a tracked job; afterwards the order is re-read and the SKU.io order lines are cancelled and their open fulfillment reset.
Bulk Create SKU Orders from Target Plus Orders
Queues a background job that creates SKU.io sales orders for the chosen Target Plus orders and returns its tracked job ID and the number of orders it will process. Orders that are held, already linked or cancelled are skipped and reported in the job result.
Bulk Update SKU Orders from Target Plus Orders
Re-reads the chosen orders from Target Plus right away and reconciles their SKU.io sales orders: status changes are stored and orders Target cancelled are cancelled in SKU.io. Returns how many orders were refreshed and how many SKU.io sales orders were cancelled. Returns 502 when Target rejects the request or cannot be reached.
Bulk Archive Target Plus Orders
Archives the chosen orders. Archived orders are hidden from List Target Plus Orders unless an `archived` filter is sent; nothing changes on Target or on linked SKU.io sales orders.
Bulk Unarchive Target Plus Orders
Restores archived orders to the active list.
Bulk Delete Target Plus Orders
Deletes the chosen Target Plus order records from SKU.io together with their linked SKU.io sales orders. Nothing changes on Target, and a later pull that covers these orders imports them again. An order whose SKU.io sales order may not be deleted (for example it has received returns, PayPal payments or credits) is kept whole and reported, and the rest are still deleted. To delete only the SKU.io sales orders and keep the Target Plus orders, use Bulk Delete SKU Orders for Target Plus Orders.
Bulk Delete SKU Orders for Target Plus Orders
Deletes the SKU.io sales orders linked to the chosen Target Plus orders and keeps the Target Plus orders, now unlinked. Orders without a linked sales order are ignored, and nothing changes on Target. A sales order that may not be deleted (for example it has received returns, PayPal payments or credits) is skipped and reported; the rest are still deleted.
List Target Plus Distribution Centers
Lists the seller's Target Plus distribution centers (DCs) with the SKU.io warehouse each one ships from. Orders from a DC that is not mapped to a warehouse are held until it is. Each DC includes its address, timezone, cut-off time, working hours and ship nodes as Target reports them, how many orders it received in the last 30 days, and `shares_warehouse_with` — the other DC IDs fed by the same warehouse. DCs Target no longer reports are kept with `is_removed: true`.
Update Target Plus Distribution Center
Maps a distribution center to the SKU.io warehouse that fulfills its orders, or clears the mapping with `warehouse_id: null`. Held orders from that DC become eligible for SKU.io sales order creation once it is mapped.
Refresh Target Plus Distribution Centers
Queues a background re-sync of the seller's distribution centers from Target Plus and returns the tracked job ID right away. New DCs are added unmapped; DCs Target no longer reports are marked removed. No body.
List Target Plus Returns
Paginated returns for this Target Plus integration with their RMA and credit.
Get Target Plus Return Filter Options
Values seen on this integration's returns for the filter pickers, plus counts for the summary.
Get Target Plus Return Sync Info
The newest return read from Target and when returns last synced.
Refresh Target Plus Returns
Queue a returns refresh and return the tracked job id to poll. Without a mode it reads everything changed since the last sync; `since` / `from_start_date` / `date_range` re-read from a date without moving the sync position; `return_order_numbers` refreshes just those returns. A refresh while return import is turned off completes with a 'Skipped' message.
Get Target Plus Return
One return with its lines, tracking, RMA, sales credit and order links.
Get Target Plus Return Raw Data
The return exactly as Target sent it.
Retry Target Plus Return
Book the return's RMA and credit again after fixing what stopped it (for example a product mapping). 422 with the reason when it still can't be booked.
Bulk Archive Target Plus Returns
Archive returns. `mode: selected` archives `ids`; `mode: all` archives everything matching `filters`.
Bulk Unarchive Target Plus Returns
Unarchive returns. Same targeting as Bulk Archive Target Plus Returns.
List Target Plus Fulfillments
Paginated list of shipped SKU.io fulfillments on this integration's Target Plus orders, with each one's tracking-push state.
Get Target Plus Fulfillment Stats
Counts of active (non-archived) shipped fulfillments on this integration's Target Plus orders by tracking-push state. `not_submitted` includes `blocked`. `pending_sync` is how many Target does not have yet, whatever their state, and `target_shipments` is how many shipments Target has on this integration's orders, sent from SKU.io or reported by Target (see List Target Plus Shipments).
List Target Plus Shipments
Lists every shipment Target Plus has on this integration's orders, one row per order line and tracking number, newest ship date first. `source` is `sku` for a shipment SKU.io sent with a fulfillment's tracking, and `target` for one Target reported that was shipped outside SKU.io (then `sales_order_fulfillment` is null). `status` is Target's shipment status; `error` holds Target's message when it refused the shipment.
Submit Target Plus Fulfillments
Queues a tracking push to Target Plus now for each chosen SKU.io fulfillment Target does not have yet, and returns how many were queued. Fulfillments Target already has, and archived ones, are skipped. Each push runs the same checks as the automatic push but does not wait for its retry delay; a push that is blocked or refused shows up in List Target Plus Fulfillments with its reason. Target emails the guest once it accepts a shipment.
Submit All Pending Target Plus Fulfillments
Queues a tracking push to Target Plus now for every shipped SKU.io fulfillment on this integration's orders that Target does not have yet (up to 5000), and returns how many were queued. Fulfillments Target already has, and archived ones, are skipped. Each push runs the same checks as the automatic push but does not wait for its retry delay; a push that is blocked or refused shows up in List Target Plus Fulfillments with its reason. Target emails the guest once it accepts a shipment.
Resubmit Target Plus Fulfillment
Run the tracking push for one SKU.io fulfillment now (the same checks as the automatic push). Tracking numbers Target already has are never sent twice. Target emails the guest once it accepts a shipment.
List Target Plus Shipping Methods
Target's shipping-method list (`data`), every SKU.io shipping method with its mapping (`mappings`), and the carriers Target accepts. A row with no saved mapping carries `suggested_target_shipping_method`, matched by carrier SCAC and service words; a suggestion is not used until it is saved. `carrier_on_allowlist: false` means Target does not accept that carrier at all.
Update Target Plus Shipping Method Mappings
Save the given rows; rows not sent keep their mapping. `target_shipping_method: null` removes a mapping. The method must be on this seller's Target list. Returns the same payload as List Target Plus Shipping Methods.
List Target Plus Listings
Lists the integration's Target Plus catalog items (listings), newest first. Each row carries Target's identifiers (seller SKU, TCIN, UPC), the listing status (`status.key`: pending, approved, approved_update_pending, rejected, suspended, unlisted, other) with a plain-language explanation, any errors Target reported, offer / list / MAP prices, quantity per distribution center, the linked SKU.io product once mapped, and a price-parity note when the Target price is above the product's Shopify price.
Get Target Plus Listing Filter Options
Returns the listing statuses with a count for each, overall counts (total, mapped, unmapped, with errors, and SKU.io products not yet listed on this Target Plus account), and whether new listings automatically create or link SKU.io products. Counts exclude archived listings.
Get Target Plus Listing Sync Info
Returns the most recently synced listing (its seller SKU and sync time) and the total, mapped and unmapped listing counts. Use it to show how fresh the catalog is before starting a refresh.
Refresh Target Plus Listings
Queues a background re-read of the seller's catalog from Target Plus and returns the tracked job ID right away. New items are added, changed items are updated, and new listings are linked to (or create) SKU.io products according to the integration's settings.
Export Target Plus Listings
Downloads the listings as a CSV (default) or XLSX file. Accepts the same `filter[...]` and `sort` parameters as List Target Plus Listings, so the file holds exactly the listings that list returns (all pages). Datetimes are written in the account's timezone.
Download Target Plus Listing Mappings
Downloads a CSV mapping sheet: one row per listing with the SKU.io product it is mapped to (`map_to_sku` and `sku_product_name` are blank when unmapped). Variation parents are left out. Edit `map_to_sku` and send the file to Upload Target Plus Listing Mappings to change mappings in bulk.
Upload Target Plus Listing Mappings
Uploads a mapping sheet (the Download Target Plus Listing Mappings CSV) and maps each listing to the SKU.io product it names. Each row names a listing by `seller_sku` and the product by `map_to_sku`; a blank `map_to_sku` unmaps the listing. Other columns are ignored.
Get Target Plus Listing Field Mappings
Returns which Target Plus listing field fills which SKU.io product field when a SKU.io product is created from a listing. `default_mappings` are the built-in rules, `custom_mappings` are the ones saved for this integration, and `effective_mappings` (also returned as `mappings`) is the result: a custom mapping replaces the default for the same SKU.io field. `available_listing_fields` and `available_sku_fields` list every field that can be used, including pricing tiers (`price.<tier>.value`) and product attributes (`attributes.<name>`).
Update Target Plus Listing Field Mappings
Replaces the integration's custom field mappings and returns the full mapping set (same shape as Get Target Plus Listing Field Mappings). Send an empty array to go back to the defaults. Applies to SKU.io products created from listings from now on; existing products are not changed.
Update Target Plus Auto-Create Products Setting
Turns automatic SKU.io product creation on or off for this integration. When on, each new listing that does not match an existing SKU.io product by SKU gets a new SKU.io product (filled using the field mappings) and is mapped to it.
Get Target Plus Listing
Returns one listing with everything in the list row plus: Target's catalog `fields` (name/value pairs), `inventory` (one row per distribution center, as in List Target Plus Inventory), `pricing` (Target's offer, list and MAP prices, the SKU.io price, the last price pushed, and a MAP warning when the SKU.io price is below MAP), `orders_count`, and for variations the `parent` or the `variation_children`.
Get Target Plus Listing Raw Data
Returns the catalog item exactly as Target Plus last sent it (stored at the last sync; no call is made to Target). Field names and structure are Target's.
List Target Plus Listing Orders
Lists the Target Plus order lines that sold this listing, newest first, with the order's number, date and Target status and the linked SKU.io sales order once one exists. Paginated (default 10 per page, max 100).
Refresh Target Plus Listing
Re-reads this one item from Target Plus now (not queued) and returns the updated listing in the same shape as Get Target Plus Listing. No body.
Get Target Plus Listing Product Matches
Suggests SKU.io products to map this listing to: an `exact_match` on SKU (the seller SKU), a `barcode_match` on the UPC, and up to 5 `similar_matches` by title words. Each suggestion is `null` (or the list empty) when nothing matches. Changes nothing; map the chosen product with Map Target Plus Listing. No body.
Map Target Plus Listing
Links this listing to a SKU.io product, replacing any existing link, and returns the updated listing row. Past Target Plus order lines that were waiting on this listing are linked too, and inventory and price for the listing are recalculated from the product. Variation parents cannot be mapped; map their variations.
Unmap Target Plus Listing
Removes the link between this listing and its SKU.io product and returns the updated listing row. The listing stays on Target; SKU.io stops pushing inventory and price for it until it is mapped again. No body.
Create SKU Product from Target Plus Listing
Creates a SKU.io product from this listing (filled using the field mappings) and maps the listing to it. If a SKU.io product with the same SKU already exists, the listing is linked to that product instead and `linked_existing` is `true`. Returns the updated listing row. Variation parents cannot be created; create their variations. No body.
Bulk Create SKU Products from Target Plus Listings
Creates SKU.io products for the chosen listings (filled using the field mappings) and maps each listing to its product; a listing whose SKU matches an existing SKU.io product is linked to it instead. Already-mapped listings and variation parents are skipped. Returns how many listings became mapped.
Bulk Archive Target Plus Listings
Archives the chosen listings. Archived listings are hidden from List Target Plus Listings and List Target Plus Inventory unless an `archived` filter is sent; nothing changes on Target or on mapped SKU.io products. Returns how many listings were archived.
Bulk Unarchive Target Plus Listings
Restores archived listings so they show in List Target Plus Listings again. Returns how many listings were unarchived.
Bulk Delete Target Plus Listings
Deletes the chosen listings from SKU.io, together with their product mappings. Nothing changes on Target or on SKU.io products: an item still on the seller's Target catalog is imported again by the next catalog read. Returns how many listings were deleted.
Bulk Map Target Plus Listings
Maps, re-maps or unmaps the chosen listings in one call.
List Target Plus Item Types
Lists every Target Plus item type cached for this connection, approved types first. `approved: false` types carry `unavailable_reason` ('Not approved for your account') and cannot be published to. `last_synced_at` is when the list was last read from Target (null after the cache expires). `sales_channel_id` is the sales channel to use with the listing drafts API.
Refresh Target Plus Item Types
Reads the item types, this seller's approvals and the merch type attributes (the fields each approved type asks for) from Target now. Throttled: inside the throttle window (60 minutes by default) the saved list is returned with `refreshed: false` and nothing is sent to Target. Returns 422 with Target's message when Target refuses the read (for example a revoked seller token). Requires the integrations.sync permission.
List Target Plus Inventory
Lists one row per listing and distribution center: the quantity SKU.io will send (the mapped warehouse's available stock less safety stock), the quantity Target currently shows, the last quantity pushed and when, and a sync `status`: `synced` (in sync), `variance` (waiting to push), `needs_recalc` (recalculating), or a reason the row is not pushed: `not_mapped` (listing not mapped to a SKU.io product), `unmapped_dc` (distribution center not mapped to a warehouse), `excluded_warehouse` (a marketplace-fulfilled warehouse, never sent), `suspended` (suspended by Target). Variation parents are left out.
Get Target Plus Inventory Summary
Returns inventory row counts by status (`by_status`), with `synced`, `variance`, `needs_recalc` and `skipped` (not mapped, distribution center not mapped, excluded warehouse or suspended) totals, when the last inventory push ran and how many rows it sent, the current safety stock, and the active distribution centers. Counts exclude archived listings.
Sync Target Plus Inventory
Queues a background push of inventory to Target Plus now and returns the tracked job ID right away. Rows whose quantity differs from what Target shows are sent, per distribution center; rows with a skip status are not. No body.
Get Target Plus Inventory Settings
Returns the safety stock (units held back from every distribution center's quantity), each active distribution center with the warehouse it draws stock from and why it is excluded, if it is, and the warehouse types whose stock is never sent to Target (marketplace fulfillment services).
Update Target Plus Inventory Settings
Sets the safety stock and returns the inventory settings (same shape as Get Target Plus Inventory Settings). Every mapped listing's quantities are recalculated, and changed quantities go out with the next inventory push.
Get Target Plus Pricing Settings
Returns the SKU.io pricing tier used for Target's list (reference, strike-through) price, or `null` when no list price is sent, and the pricing tiers to choose from.
Update Target Plus Pricing Settings
Sets which SKU.io pricing tier fills Target's list price and returns the pricing settings. Send `null` to stop sending a list price.
List Target Plus Payouts
Weekly (Tuesday) Target Plus payouts of one integration, newest first, each with its summary split, accounting readiness and bank deposit status. Payouts come from the imported Financial Reconciliation Report, or from the settlement API when it is enabled. Requires the accounting:read scope.
Get Target Plus Payout
One payout with its lines, the orders they pay (linked to the Target Plus order and the SKU.io sales order), detailed accounting readiness checks, posted ledger entries and deposit status. 404 when the payout belongs to another integration.
Import Financial Reconciliation Report
Upload a Financial Reconciliation Report CSV downloaded from the Target Plus Partner Portal (Reports). Rows are stored as payout lines and rolled up into weekly payouts. Idempotent: rows are keyed by Target's line ID (or a hash of the row when the report has none), so importing the same file twice adds nothing ('0 new, N already imported'). A row whose figures changed is restated; a payout that already posted is then re-posted. Requires the accounting:write scope and permission to sync integrations.
List Target Plus Report Imports
Every Financial Reconciliation Report uploaded for the integration, newest first, with what each import did. Sorts: id, created_at (default -id). Pagination: page, per_page (default 10).
Sync Target Plus Payouts
Queue a read of payouts from the Target Plus settlement API: since the last sync (less an overlap), or from `since`. Only available while the settlement API is enabled for this environment; otherwise answers 422 — import the Financial Reconciliation Report instead. Returns the tracked job ID.
List Target Plus Payout Lines
Payout lines across every payout of the integration (sales, refunds, referral and Circle Card fees, return charge-backs, adjustments and each payout's transfer row), each linked to its payout, Target Plus order and SKU.io sales order.
List Target Plus Payout Mapping Groups
Mapping groups for this integration plus the global groups. Each group posts as one document (an invoice or a bill) per payout. The default groups (Target Plus Sales, Target Plus Fees) are created on first read.
Create Target Plus Payout Mapping Group
Create a mapping group scoped to this integration.
Update Target Plus Payout Mapping Group
Rename a group or change its document type. Payouts that resolve mappings into the group re-post.
Delete Target Plus Payout Mapping Group
Delete a group. Its mappings become unassigned and fall to the fallback accounts.
Reorder Target Plus Payout Mapping Groups
Set the display order of the groups.
List Global Target Plus Payout Mapping Groups
Global mapping groups shared by every Target Plus integration.
Create Global Target Plus Payout Mapping Group
Create a global mapping group.
Update Global Target Plus Payout Mapping Group
Update a global mapping group; every Target Plus integration's payouts re-post.
Delete Global Target Plus Payout Mapping Group
Delete a global mapping group.
Reorder Global Target Plus Payout Mapping Groups
Set the display order of the global groups.
List Target Plus Payout Type Mappings
Every payout line type (financial code) with the account and mapping group it posts to for this integration: its own override, else the global mapping. Known Target line types (item sale, refund, referral fee, Circle Card fee, return charge-back, shipping, tax, adjustments) are pre-seeded; new types appear when a report first carries them.
Update Target Plus Payout Type Mappings
Set the account and/or group of several line types for this integration.
Export Target Plus Payout Type Mappings
Download the effective type mappings as a spreadsheet (one row per line type with its account and group), for editing and re-import. Response: an .xlsx file download.
Import Target Plus Payout Type Mappings
Apply an edited mappings spreadsheet previously uploaded to the file store.
Bulk Assign Target Plus Payout Type Mappings
Assign one account and/or group to many line types at once.
Get Target Plus Payout Finance Settings
Fallback accounts for unmapped lines, the clearing account for orders already invoiced per order, the accounting mode (per_order or per_payout), the payout accounting start date, and where payouts come from (api_enabled, last import / sync).
Update Target Plus Payout Finance Settings
Update any of: fallback_revenue_nominal_code_id, fallback_expense_nominal_code_id, invoiced_order_clearing_nominal_code_id (nullable account IDs), accounting_sync_mode (per_order or per_payout), payout_accounting_start_date (nullable date), effective_from (optional Y-m-d for account changes). Switching to per_payout moves the channel's revenue cut-over so revenue is counted once; payouts and per-order documents re-post.
Get Target Plus Accounting Settings
The referral fee % Target charges per item type (rates are contract-specific) and the default %. Used to estimate the referral fee on each order until a payout settles the real fee. Also lists the catalog's item types.
Update Target Plus Accounting Settings
Set the referral fee estimate rates.