> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omnicommerce.sg/llms.txt
> Use this file to discover all available pages before exploring further.

# Import Selected Zalora Products

> Requires catalog:write. Queue an exact import of 1–25 Zalora productSetIds from a connected store. Omit storeId only when one store or one default store is unambiguous.

Returns 202 with links.job for optional status checks and retrieval of Omni product IDs. Only one import may run per store at a time. This endpoint does not invoke an AOP, enrich products, or publish listings.



## OpenAPI

````yaml /openapi.json post /api/v1/zalora/import
openapi: 3.1.0
info:
  title: OmniCommerce API
  version: 1.0.0
  license:
    name: Proprietary
    url: https://omnicommerce.sg/terms
  description: >-
    OmniCommerce API surface for agents and developer integrations. Includes
    public endpoints (merchant discovery, product search, compare, catalog, ACO
    retrieval) and authenticated endpoints (product management via API key
    Bearer tokens).
servers:
  - url: https://omnicommerce.sg
    description: Production
  - url: http://localhost:3000
    description: Local development
security: []
tags:
  - name: agentic-checkout
    description: Merchant-fulfilled agentic checkout
    x-group: Agentic Checkout
  - name: aops
    description: Agent operating procedures
    x-group: AOPs
  - name: commerce
    description: Root commerce discovery
    x-group: Commerce
  - name: developer-platform
    description: Authenticated developer platform APIs
    x-group: Developer Platform
  - name: looks
    description: AI-styled product looks
    x-group: Looks
  - name: oauth
    description: OAuth token endpoints
    x-group: OAuth
  - name: orders
    description: Workspace and agentic orders
    x-group: Orders
  - name: organizations
    description: Organization management
    x-group: Organizations
  - name: price-books
    description: Marketplace list-price markup rules
    x-group: Price Books
  - name: products
    description: Product CRUD, bulk import, and publish
    x-group: Products
  - name: promotions
    description: Central promotions and marketplace sync
    x-group: Promotions
  - name: public-agent
    description: Public agent discovery and catalog APIs
    x-group: Public Agent
  - name: returns
    description: returns
    x-group: Returns
  - name: settlements
    description: settlements
    x-group: Settlements
  - name: ucp
    description: Universal Commerce Protocol
    x-group: UCP
paths:
  /api/v1/zalora/import:
    post:
      tags:
        - developer-platform
      summary: Import Selected Zalora Products
      description: >-
        Requires catalog:write. Queue an exact import of 1–25 Zalora
        productSetIds from a connected store. Omit storeId only when one store
        or one default store is unambiguous.


        Returns 202 with links.job for optional status checks and retrieval of
        Omni product IDs. Only one import may run per store at a time. This
        endpoint does not invoke an AOP, enrich products, or publish listings.
      operationId: post_v1_zalora_import
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: https://json-schema.org/draft/2020-12/schema
              type: object
              properties:
                productSetIds:
                  minItems: 1
                  maxItems: 25
                  type: array
                  items:
                    type: string
                    minLength: 1
                    maxLength: 255
                  description: >-
                    Zalora productSetIds to import. Values are trimmed and
                    de-duplicated while preserving order.
                storeId:
                  description: >-
                    Connected Zalora store/account ID. Omit when the
                    organization has exactly one Zalora store or one default
                    Zalora store.
                  type: string
                  minLength: 1
                  maxLength: 255
                organizationId:
                  description: >-
                    Required for session auth; derived from the credential for
                    bearer auth.
                  type: string
                  minLength: 1
                  maxLength: 255
              required:
                - productSetIds
              additionalProperties: false
            example:
              productSetIds:
                - '1001'
                - '1002'
              storeId: zalora-store-id
      responses:
        '202':
          description: Jobs accepted for background processing.
          content:
            application/json:
              schema:
                type: object
                required:
                  - ok
                  - status
                  - jobId
                  - data
                  - links
                properties:
                  ok:
                    type: boolean
                  apiVersion:
                    type: string
                  operationId:
                    type: string
                  status:
                    type: string
                    enum:
                      - accepted
                  jobId:
                    type: string
                  links:
                    type: object
                    additionalProperties:
                      type: string
                  warnings:
                    type: array
                    items:
                      type: string
                  recommendations:
                    type: array
                    items:
                      type: string
                  data:
                    type: object
                    required:
                      - success
                      - queued
                      - productSetIds
                      - jobIds
                      - succeededCount
                      - failedCount
                      - results
                    properties:
                      success:
                        type: boolean
                        description: >-
                          True when all requested targets were accepted for
                          processing. Does not mean processing completed.
                      queued:
                        type: boolean
                      productSetIds:
                        type: array
                        items:
                          type: string
                      jobIds:
                        type: array
                        items:
                          type: string
                      succeededCount:
                        type: integer
                        minimum: 0
                      failedCount:
                        type: integer
                        minimum: 0
                      storeId:
                        type: string
                      correlations:
                        type: array
                        items:
                          type: object
                          additionalProperties: true
                      results:
                        type: array
                        items:
                          type: object
                          required:
                            - productSetId
                            - success
                            - jobId
                          properties:
                            productSetId:
                              type: string
                            success:
                              type: boolean
                            jobId:
                              type: string
        '400':
          description: >-
            Invalid request or queue preparation failed. Inspect the error
            before resubmitting.
        '401':
          description: Missing or invalid credentials.
        '403':
          description: >-
            Missing scope, insufficient permission, organization mismatch, or
            inactive organization.
        '404':
          description: Target not found in the authenticated organization.
        '409':
          description: An import or enrichment job is already active for the target.
        '429':
          description: Rate limit exceeded.
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        Bearer API key for server-to-server access. Session auth is also
        supported in first-party UI flows.

````