Skip to content

WooCommerce Variable Products on Torob – Setup Guide

How to Display WooCommerce Product Variations Separately on Torob

WooCommerce stores often use variable products to manage different colors, sizes, weights, and product options.

However, when integrating with Torob, some stores encounter a problem: only the parent product appears, while individual variations are not listed separately.

In this tutorial, we will use Notran Torob Connect, a free and open-source WordPress plugin, to address this limitation.

Why Is This a Problem?

Consider a product called “Women’s Linen Shirt” available in different colors and sizes.

In WooCommerce, these variations belong to a single variable product. However, a basic integration may provide only the parent product to Torob.

Creating separate WooCommerce products for every variation can lead to unnecessary duplication, increased inventory-management complexity, and potential SEO issues.

A better approach is to preserve WooCommerce’s variable-product structure while exposing individual variations through Torob’s API.

Introducing Notran Torob Connect

Notran Torob Connect is a WooCommerce integration plugin designed to work with Torob Product API v3.

Its main purpose is to provide individual variation data with customizable titles, without requiring duplicate products.

Key Features

  • Support for simple and variable WooCommerce products
  • Independent product variation entries
  • Custom titles for product variations
  • Configurable variation attribute naming
  • Product and variation exclusion options
  • Product API v3 compatibility
  • Product data preview
  • Optional webhook-based update notifications
  • Synchronization and authentication logs

Requirements

Before installation, make sure you have:

  1. An active WordPress website with WooCommerce installed
  2. Properly configured variable products
  3. Administrator access to the store
  4. A registered Torob merchant account
  5. A server with accurately synchronized system time

Step 1: Install the Plugin

Download the latest plugin ZIP from the GitHub repository.

In your WordPress dashboard:

  1. Navigate to Plugins → Add New Plugin.
  2. Select Upload Plugin.
  3. Upload the ZIP file.
  4. Install and activate the plugin.

A Torob integration section will become available under WooCommerce.

Step 2: Configure the Integration

Navigate to:

WooCommerce → اتصال به ترب → اتصال و تنظیمات

Review the product feed settings and variation title options.

Depending on your requirements, you can configure how attributes appear in product titles and exclude specific products or variations from the feed.

Step 3: Customize Variation Titles

Suppose a WooCommerce product has the following variations:

WooCommerce variationTorob title
Linen Shirt – Black – MWomen’s Linen Shirt Black Size M
Linen Shirt – White – LWomen’s Linen Shirt White Size L
Linen Shirt – Beige – XLWomen’s Linen Shirt Beige Size XL

The plugin allows variation titles to be configured so that each variation can be exposed as an individual item in the API response.

This improves the structure and clarity of product data submitted to Torob.

Final publication of each item is subject to Torob’s own processing and approval.

Step 4: Preview Product Data

Navigate to:

WooCommerce → اتصال به ترب → پیش‌نمایش محصول

Inspect a selection of simple and variable products.

Verify the following information:

  • Product and variation titles
  • Unique variation identifiers
  • Pricing and stock status
  • Product URLs
  • Variation attributes

Correct any inaccurate information before connecting the feed.

Step 5: Register the Product API Endpoint

The plugin provides the following Product API v3 endpoint:

https://YOUR-DOMAIN.com/wp-json/notran-torob/v3/products

Replace YOUR-DOMAIN.com with your actual store domain.

Submit this endpoint to Torob support for connection and validation.

The endpoint expects authenticated POST requests from Torob. Opening it directly in a browser does not constitute a valid API test.

Authentication

Torob sends a signed JWT in the X-Torob-Token request header.

You do not need to manually append that token to the feed URL.

Ask Torob support to perform an authenticated test request and verify the response.

Step 6: Configure the Optional Webhook

The plugin also supports webhook-based product update notifications.

This feature can be used to notify Torob of relevant product changes, including price and inventory updates.

Important: The webhook authentication token is separate from the JWT used to authenticate incoming Product API v3 requests.

If you enable webhook notifications, obtain the appropriate token through Torob’s supported process and configure it in the plugin settings.

Step 7: Verify Synchronization

Once the endpoint is registered:

  1. Request a connection test from Torob support.
  2. Open the plugin’s synchronization status screen.
  3. Review the authentication and request logs.
  4. Confirm that variations are returned as separate items.
  5. Check their processed listing status on Torob.

A successful API response does not guarantee immediate publication in Torob’s search results.

Troubleshooting

JWT Expiration Errors

An incorrectly synchronized server clock can cause JWT authentication failures.

Verify the server’s system clock and NTP synchronization. After correcting the time, request a fresh authenticated test from Torob.

Changing the WordPress timezone setting alone does not fix an inaccurate server clock.

Only Parent Products Appear

Check the product preview to confirm that individual variations exist in the API output.

If they do, ask Torob support to verify whether those entries have been successfully processed.

Price or Stock Updates Are Delayed

Review the webhook configuration, authentication token, synchronization logs, and Torob’s update processing status.

API Authentication Fails

Inspect the authentication log and verify that the JWT header reaches WordPress, the token is valid, and the server clock is correctly synchronized.

Conclusion

Notran Torob Connect provides a structured way to expose WooCommerce product variations to Torob while retaining the original variable-product structure.

The plugin is released as free, open-source software, and its source code is available on GitHub.

Download: https://github.com/shahroodi/notran-torob-sync

Project Overview: https://shahroodi.com/project/notran-torob-woocommerce/

Developed by: Ali Shahroodi
Website: shahroodi.com

Leave a Comment

Your email address will not be published.