Инструкции по работе с платформой Hotlist.biz

ORDER DETAILS
  $url = "https://yourdomain.com/api/commerce/orders/ORDERID"; // Set the endpoint URL (replace with your actual API endpoint)
  $authKey = "your_authorization_token_here"; // Authorization token (use your real key)
  $ch = curl_init($url); // Initialize cURL session
  // Set cURL options
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // Return response as string
  curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "Authorization: Bearer " . $authKey, // Set Authorization header
  "Content-Type: application/json" // Optional: declare expected response type
  ]);
  // Execute request
  $response = curl_exec($ch);
  // Check for cURL error
  if (curl_errno($ch)) {
  echo "Request error: " . curl_error($ch);
  } else {
  // Parse and print the JSON response
  $data = json_decode($response, true);
  print_r($data); // Output server response
  }
  // Close cURL session
  curl_close($ch);
  

UPDATE ORDER
  $url = "https://yourdomain.com/api/commerce/orders/ORDERID"; // Order API endpoint
  $authKey = "your_authorization_token_here"; // Authorization token
  // Data to update (use API keys, not raw DB field names)
  $updateData = [
  "first_name"  => "Alex",
  "last_name"   => "Las",
  "email"       => "alex@example.com",
  "phone"       => "+380671112233",
  // Full address in plain text (if needed)
  "address"   => "Full address not tied to structured eform fields",
  // Structured address fields (eform system)
  "buyer_address_eform1" => "Region / State",         
  "buyer_address_eform2" => "City",                   
  "buyer_address_eform3" => "Street",                 
  "buyer_address_eform4" => "House number",           
  "buyer_address_eform5" => "Apartment",              
  "buyer_address_eform6"             => "01001",       // Zip/Postal code/Department
  // Order details
  "total" => "999",                        // Total price
  "status" => "processing",                // Internal status or number
  "status_for_customer" => "completed",    // Customer-facing status or number
  ];
  $ch = curl_init($url); 
  // cURL options
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "PATCH");
  curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($updateData, JSON_UNESCAPED_UNICODE));
  curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "Authorization: Bearer " . $authKey,
  "Content-Type: application/json"
  ]);
  $response = curl_exec($ch);
  if (curl_errno($ch)) {
  echo "Request error: " . curl_error($ch);
  } else {
  $data = json_decode($response, true);
  print_r($data); 
  }
  curl_close($ch);

CREATE ORDER
  $url = "https://yourdomain.com/api/commerce/orders"; // Order API endpoint
  $authKey = "your_authorization_token_here"; // Authorization token (use your real key)
  // Order data + products
  $orderData = [
  // Buyer info
  "first_name"  => "Name",                // Buyer's first name
  "last_name"   => "Soname",              // Buyer's last name
  "email"       => "alex@example.com",    // Buyer's email (required)
  "phone"       => "+380671112233",       // Buyer's phone number
  "address"     => "Full address of not used address eform", // General address
  "buyer_address_eform1" => "State",      // State / Region
  "buyer_address_eform2" => "City",       // City
  "buyer_address_eform3" => "Street",     // Street
  "buyer_address_eform4" => "house number", // House number
  "buyer_address_eform5" => "flat",       // Apartment / Flat
  "postcode"    => "01001",               // Postcode / ZIP
  // Total order amount (optional)
  // If you set "total", it will be used as the final order total.
  // If you skip "total", the system will calculate the total automatically
  // based on the products in "line_items".
  //"total"       => "999",
  "status"      => "processing",          // Internal status
  "status_for_customer" => "processing",  // Status shown to the customer
  "currency"   => "USD",                  // Order currency
  // Products in the order
  "line_items" => [
    [
     "product_id" => 478734,         // Product ID (required)
     "quantity"   => 0,               // Quantity (required) / default - 1
     "price"      => 100,            // Custom price (optional, overrides site price)
    ],
    [
     "product_id" => 478268,
     "quantity"   => 10,
     "variation" => "51"             // Variation name or code
    ],
    [
     "product_id" => 478266,
     "quantity"   => 1,
     "variation_id" => 735302        // Variation ID (priority over "variation")
    ]
   ]
  ];
  
  $ch = curl_init($url);
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
  curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($orderData, JSON_UNESCAPED_UNICODE));
  curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "Authorization: Bearer " . $authKey,
  "Content-Type: application/json"
  ]);

  $response = curl_exec($ch);
  if (curl_errno($ch)) {
  echo "Request error: " . curl_error($ch);
  } else {
  $data = json_decode($response, true);
  print_r($data);
  }
  curl_close($ch);
  

UPDATE PRODUCT
 $url = "https://yourdomain.com/api/commerce/products/PRODUCT_ID"; // Product API update endpoint
  $authKey = "your_authorization_token_here"; // Authorization token (use your real key)
// Product data
$productData = [
  "id" => 479077, // Product ID is ignored here because it's specified in the URL
  "name" => "Basketballshoesconverseallstarbbprototypecx", // Internal name for database  (does not affect front-end display)
  "title" => "Basketball shoes Converse All Star BB Prototype CX", // Product title (required for new)
  "type" => 1298, // Product type for filtering and attributes
  "access" => true, // Product availability (true = active)
  "description" => "<p>Sneakers Converse All Star BB Prototype CX — Basketball shoes...</p>", // Full product description (HTML allowed)
  "short_description" => "", // Short description of product 
  "sku" => "AO2515C", // Product SKU code
  "sku_show" => 0, // Whether to show SKU publicly (0 = no)
  "price" => "3000", // Current price
  "currency" => "UAH", // Currency code
  "regular_price" => "5760", // Old (regular) price 
  "price_for" => "0", // Unit for pricing (see documentation for accepted values  https://hotlist.biz/en/user_guide.html#autohrefinside13_7)
  "stock_quantity" => 0, // Quantity in stock (0 - unlimited)
  "stock_status" => 0, // Stock status (0 = in stock, 1 = out of stock, others see docs)
  "weight" => 0, // Weight value
  "weight_units" => 0, // Weight units: 0 = grams, 1 = kilograms
  "dimensions" => [
    "length" => 0, // Length
    "width"  => 0, // Width
    "height" => 0, // Height
    "units"  => "0", // Dimension units: 0 = centimeters, 1 = meters
 ],
 "categories" => [
    ["id" => 30519, "name" => null], // Product category (by ID, name, or both)
  ],
  "tags" => "tag1, tag2", // Tags, comma separated, max 8 tags
 "images" => [
    "0" => "-uploadshopcat-s16572/479077/479077_1.webp", // Local image path (won`t be uploaded)
    "1" => "https://hotlist.biz/upload/shop_catalog/s16572/479077/479077_2.webp", // Remote image URL (will be downloaded and attached)
  ],
 "images_replace" => false, // By default: do NOT replace images with the same index. If true, replace existing images by index.
 "images_skip_index" => false, // If true, find next free index if the given index is occupied and save image there.
 "images_replace_new_index" => false, // If true, even if replace and skip are false, save under new free index if original index is occupied.
 "variations_only_update" => false, // If true, new variations will be added without deleting old ones; otherwise all old variations are removed before adding new
 "variations" => [
  [
    "priority" => 0, // Display priority of the variation
    "id" => 736413, // Variation ID for updating existing variation; if not provided, search by SKU or title
    "sku" => "SKU1234", // Variation SKU (recommended)
    "title" => "42", // Variation name (required)
    "status" => "true", // access ( true / false / forbidden)
    "description" => "",
    "stock_status" => 0, // Stock status, same logic as main product
    "show_stock" => 0, // Whether to show stock count
    "instock" => 10, // Quantity in stock for this variation
    "image_num" => 0, // Image index linked to this variation
    "price" => "+100", // Price adjustment: absolute, or relative (+/-)
    "price_old" => "120", // Old price
    "price_cost" => "80", // Cost price
    "bulk_prices" => [ // Bulk pricing rules
      [
      "moq" => 10, 
       "price" => 5000
      ], // Price if order >= 10 units
      [
      "moq" => 15, 
      "price" => 4500
      ], // Price if order >= 15 units
  ],
  "dimensions" => [ // Variation dimensions, same units as product
    "length" => 0, // Length
    "width" => 0,  // Width
    "height" => 0, // Height
    "units" => 0,  // Dimension units: 0 = centimeters, 1 = meters
  ],
  ],
  [
    "priority" => 0,
    "title" => "43",
    "description" => "",
    "stock_status" => 0,
    "show_stock" => 1,
    "instock" => 1,
    "image_num" => 2,
    "price" => "+100",
    "price_old" => "120",
    "price_cost" => "80",
    "bulk_prices" => [
  ["moq" => 10, "price" => 5000],
  ["moq" => 15, "price" => 4500],
  ],
  "dimensions" => [
    "length" => 0,
    "width" => 0,
    "height" => 0,
    "units" => 0,
  ],

  ],
  ],
 "products_synonyms" => "", // Comma-separated list of grouped or similar product IDs or SKUs
 "priority" => 12, // Sorting priority (higher number = higher position, max 99)
 "producer" => ["id" => 4713, "name" => null], // Producer category by ID and/or name
 "producer_show" => 0, // Show producer on product page
 "producer_country" => "", // Producer country (text)
 "collection" => ["id" => null, "name" => null], // Collection category (ID and/or name)
 "collection_show" => 0, // Show collection flag
 "supplier" => ["id" => null, "name" => null], // Supplier info
 "bulk_prices" => [ // Bulk prices for main product
    ["moq" => 10, "price" => 5000],
    ["moq" => 15, "price" => 4500],
  ],
 "price_cost" => "", // Cost price for the main product
 "settings_comments" => "e_shop_page_hoteng_com|e_shop_page_hoteng_rating_com|e_shop_page_hoteng_show_rating_com|e_shop_page_hoteng_com_captcha|e_shop_page_hoteng_vis_com|e_shop_page_hoteng_num30",
 "password" => "", // Password protection (if any)
 "show_tree" => 0, // Category tree display setting
 "show_stock" => 0, // Show stock on product page
 "moq" => 0, // Minimum order quantity
 "shipping" => 0, // Shipping enabled flag
 "shipping_settings" => 0, // Shipping configuration
 "shipping_price" => 0, // Shipping cost
 "shipping_note" => "", // Notes about shipping
 "shipping_days" => 0, // Delivery time in days
 "shipping_sum" => 0, // Combine shipping for same products flag
 "show_period" => 0, // Product display period
 "bought_with" => "", // Comma-separated list of products often bought together
 "bought_with_email" => "", // Email to send bought-together product lists
 "new" => 1, // Is product new (1 = yes, 0 = no)
 "reduced_price" => 0, // Price reduced flag
 "discount" => "-20%", // Discount text (informational)
 "featured" => 1, // Featured product flag
 "promotion" => 1, // Has promotion flag
 "promotion_text" => "", // Promotion text
 "promotion_expires" => 1751113909, // Promotion end timestamp
 "promotion_expires_job" => 0, // Job to execute after promotion ends
 "variations_title" => "", // Title above variation selectors
 "variations_type" => 0, // Variation type (Google Merchant Size Type): 0=default from category settings, 1=color, 2=pattern, 3=material, 4=age_group, 5=gender, 6=size
 "variations_require" => 0, // Require variation selection before purchase
 "variations_cartexplode" => 0, // Variation display method settings
 "yml" => 0, // Export to YML/XML flag
 "noimport" => "0", // Disable import via admin panel flag
 "custom_label_4" => "", // Custom label for Google Merchant
 "description_tab_1" => "", // Description tab 1 content
 "description_tab_2" => "", // Description tab 2 content
 "description_tab_3" => "", // Description tab 3 content
 "description_tab_4" => "", // Description tab 4 content
 "description_tab_5" => "", // Description tab 5 content
 "video" => "", // Video URL
 "video_duration" => "", // Video duration in HH:MM:SS format
 "delete" => "delete", // delete product ( true or delete )
 // Product attributes for filtering and characteristics
 "attributes" => [
   [
  // "id"      => 1298,  // Attribute name You can use or NAME or ID
    "name" => "Product type", // Attribute name
    "options" => ["Sneakers"] // Attribute values (multiple allowed)
   ],
   [
    "name" => "Producer", //  Attribute name
    "options" => ["Converse"] //Attribute values (multiple allowed)
   ],
   [
    "name" => "Size", //Attribute name
    "options" => ["37,5", "40"] //Attribute values (multiple allowed)
     // "value_ints"      => [10096, 10101], //You can use or NAME or ID
     // "value_parent_id" => 1763 You can use or NAME or ID
   ],
  ]
 ];

  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "UPDATE"); // Use UPDATE method for update operation (UPDATE / PUT / PATCH)
  curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($productData, JSON_UNESCAPED_UNICODE));
  curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "Authorization: Bearer " . $authKey,
  "Content-Type: application/json"
  ]);

  $response = curl_exec($ch);
  if (curl_errno($ch)) {
  echo "Request error: " . curl_error($ch);
  } else {
  $data = json_decode($response, true);
  print_r($data);
  }
curl_close($ch);

UPDATE MULTIPLE PRODUCT (up to 5000 same time)
$url = "https://yourdomain.com/api/commerce/products"; // Product API update endpoint
$authKey = "your_authorization_token_here"; // Authorization token (use your real key)
// Product data
  $productsData = [
  "products" => [
   [
    "id" => 479077,
    "title" => "New Product Title 1"
    ...
   ],
   [
    "sku" => "SKU123456",
    "title" => "New Product Title 2"
    ...
   ],
   [
    "id" => 479078,
    "title" => "New Product Title 3"
    ...
   ]
  ]
 ];
 
$ch = curl_init($url); 
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "UPDATE"); // UPDATE / PUT / PATCH
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($productsData, JSON_UNESCAPED_UNICODE));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer " . $authKey,
"Content-Type: application/json"
]);
$response = curl_exec($ch);
if (curl_errno($ch)) {
  echo "Request error: " . curl_error($ch);
} else {
  $data = json_decode($response, true);
  print_r($data);
}
curl_close($ch);

UPDATE MULTIPLE CATEGORIES (up to 3000 same time)
$url = "https://yourdomain.com/api/commerce/products/categories"; // Categories API update endpoint
$authKey = "your_authorization_token_here"; // Authorization token (use your real key)
// Categories data
 $categoriesData = [
  "categories" => [
    [
      "category_id" => 30518, // Category ID
      "category_name" => "sneakers", // System category name (slug) REQUIRED
      "category_title" => "Sneakers", // Category title
      "category_parent_id" => 1, // Parent category ID
      "category_parent_name" => "ParentCategory", // Parent category Name
      "category_position" => 0, // Position in the list
      
      "category_visible" => 0, // Visibility (0 = hidden, 1 = visible)
      "category_lang" => "ru", // Category language
      
      "category_show_tree" => 0, // Show tree (0/1)
      "category_multilangid" => 0, // Multilanguage binding ID

      "category_image" => [
        "0" => "https://hotlist.biz/upload/catalog/16572/files/style/categories/30518.webp", // Image URL
      ],
      "images_replace" => 1, // Image replace if exists
      "category_image_settings" => 7, // Image display settings
      "category_button" => "", // Custom button (without href)
      "category_access" => 0, // Access level
      "category_title_seo_append" => "", // SEO: title suffix
      "category_description_seo_append" => "", // SEO: description suffix
      "category_meta_d" => "", // Meta description
      "category_meta_k" => "", // Meta keywords
      "category_title_inpage" => "Sneakers", // Title shown inside the category page
      "category_text" => "", // Category description text
      "category_text_position" => 0, // Description position
      "category_settings_comments" => "", // Comment settings
      
      "category_settings_rating" => 0, // Enable rating (0/1)
      "category_datestamp" => "2025-09-16T12:41:07+00:00", // Datetime of creation/update
     
      "category_googlegoods_catid" => 0, // Google Goods category ID
      "category_promua_catid" => 0, // Prom.ua category ID
      "category_rozetkaua_title" => "", // Rozetka.ua category title
      "category_merchant_product_category" => "", // Merchant product category
      "category_gm_product_type" => 0, // Google Merchant product type
      "category_gm_sizetype" => 0, // Google Merchant size type
      
      "category_priceappend_rozetka" => "", // Extra price settings for Rozetka
      "category_priceappend_promua" => "", // Extra price settings for Prom.ua
      "category_settings_childproductshow" => 0, // Show products from subcategories (0/1)
      "category_settings_style" => 0, // Style settings
      "category_settings_sibling" => 0, // Show sibling categories (0/1)
      "update_exists" => 1, // Update exists category (0/1)
      "delete" => 0, // For delete category (0/1)
    ]
  ]
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "UPDATE"); // UPDATE / PUT / PATCH
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($categoriesData, JSON_UNESCAPED_UNICODE));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer " . $authKey,
"Content-Type: application/json"
]);

$response = curl_exec($ch);
if (curl_errno($ch)) {
  echo "Request error: " . curl_error($ch);
} else {
  $data = json_decode($response, true);
  print_r($data);
}
curl_close($ch);

UPDATE MULTIPLE PRODUCERS (up to 3000 same time)
$url = "https://yourdomain.com/api/commerce/products/producers"; // Producers API update endpoint
$authKey = "your_authorization_token_here"; // Authorization token (use your real key)
// Producers data
 $producersData = [
  "producers" => [
    [
      "producer_id" => 30518, // Producer ID
      "producer_name" => "sneakers", // System producer name (slug) REQUIRED
      "producer_title" => "Sneakers", // Producer title
      "producer_parent_id" => 1, // Parent producer ID
      "producer_parent_name" => "ParentCategory", // Parent producer Name
      "producer_position" => 0, // Position in the list
      
      "producer_visible" => 0, // Visibility (0 = hidden, 1 = visible)
      "producer_lang" => "ru", // Producer language
      
      "producer_show_tree" => 0, // Show tree (0/1)
      "producer_multilangid" => 0, // Multilanguage binding ID

      "producer_image" => [
        "0" => "https://hotlist.biz/upload/catalog/16572/files/style/categories/30518.webp", // Image URL
      ],
      "images_replace" => 1, // Image replace if exists
      "producer_image_settings" => 7, // Image display settings
      "producer_button" => "", // Custom button (without href)
      "producer_access" => 0, // Access level

      "producer_meta_d" => "", // Meta description
      "producer_meta_k" => "", // Meta keywords
      "producer_title_inpage" => "Sneakers", // Title shown inside the producer page
      "producer_text" => "", // Producer description text
      "producer_text_position" => 0, // Description position
      "producer_settings_comments" => "", // Comment settings
      
      "producer_settings_rating" => 0, // Enable rating (0/1)
      "producer_datestamp" => "2025-09-16T12:41:07+00:00", // Datetime of creation/update
     
      "update_exists" => 1, // Update exists producer (0/1)
      "delete" => 0, // For delete producer (0/1)
    ]
  ]
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "UPDATE"); // UPDATE / PUT / PATCH
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($producersData, JSON_UNESCAPED_UNICODE));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer " . $authKey,
"Content-Type: application/json"
]);

$response = curl_exec($ch);
if (curl_errno($ch)) {
  echo "Request error: " . curl_error($ch);
} else {
  $data = json_decode($response, true);
  print_r($data);
}
curl_close($ch);

UPDATE MULTIPLE COLLECTIONS (up to 3000 same time)
$url = "https://yourdomain.com/api/commerce/products/collections"; // Collections API update endpoint
$authKey = "your_authorization_token_here"; // Authorization token (use your real key)
// Collections data
 $collectionsData = [
  "collections" => [
    [
      "collection_id" => 30518, // Collection ID
      "collection_name" => "sneakers", // System collection name (slug) REQUIRED
      "collection_title" => "Sneakers", // Collection title
      "collection_parent_id" => 1, // Parent collection ID
      "collection_parent_name" => "ParentCategory", // Parent collection Name
      "collection_position" => 0, // Position in the list
      
      "collection_visible" => 0, // Visibility (0 = hidden, 1 = visible)
      "collection_lang" => "ru", // Collection language
      
      "collection_show_tree" => 0, // Show tree (0/1)
      "collection_multilangid" => 0, // Multilanguage binding ID

      "collection_image" => [
        "0" => "https://hotlist.biz/upload/catalog/16572/files/style/categories/30518.webp", // Image URL
      ],
      "images_replace" => 1, // Image replace if exists
      "collection_image_settings" => 7, // Image display settings
      "collection_button" => "", // Custom button (without href)
      "collection_access" => 0, // Access level

      "collection_meta_d" => "", // Meta description
      "collection_meta_k" => "", // Meta keywords
      "collection_title_inpage" => "Sneakers", // Title shown inside the collection page
      "collection_text" => "", // Collection description text
      "collection_text_position" => 0, // Description position
      "collection_settings_comments" => "", // Comment settings
      
      "collection_settings_rating" => 0, // Enable rating (0/1)
      "collection_datestamp" => "2025-09-16T12:41:07+00:00", // Datetime of creation/update
     
      "update_exists" => 1, // Update exists collection (0/1)
      "delete" => 0, // For delete collection (0/1)
    ]
  ]
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "UPDATE"); // UPDATE / PUT / PATCH
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($collectionsData, JSON_UNESCAPED_UNICODE));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer " . $authKey,
"Content-Type: application/json"
]);

$response = curl_exec($ch);
if (curl_errno($ch)) {
  echo "Request error: " . curl_error($ch);
} else {
  $data = json_decode($response, true);
  print_r($data);
}
curl_close($ch);