Adding a simple product

What Are API Products?

An API Product is a regular WooCommerce product — either Simple or Variable — with Probo fulfillment data attached. You link the product to a Probo API product code, provide the artwork (a PDF, JPG, or PNG file), and set your own price.

When a customer purchases the product, the order is sent to Probo along with your artwork file and product specifications. Probo handles printing and shipping.

Your customers see a standard WooCommerce product page and add items to their cart just like any other product. They do not interact with the Probo configurator or upload their own files.

When to Use API Products

API Products are ideal when:

• You sell pre-designed products where the artwork is the same for every order (e.g., branded business cards, pre-made flyers, promotional materials).
• You want to control the price directly through WooCommerce's Regular/Sale price fields.
• You want to use WooCommerce variations for options like size or material.
• Your customers do not need to upload artwork or configure product options themselves.

If your customers need to choose their own options and upload artwork, see Configurable Products instead.

Creating a Simple API Product

Follow these steps to create a simple product that fulfills through Probo:

Step 1: Create the product

1. In your WordPress dashboard, go to Products → Add New.
2. Enter a product name and description as you normally would.
3. Make sure the product type is set to Simple product in the Product Data dropdown.

Step 2: Set your price

1. In the General tab of the Product Data panel, enter your Regular price (and optionally a Sale price).
2. This is the price your customers will see and pay. You control it completely.

Step 3: Configure the Probo Connect tab

1. Click the Probo Connect tab in the Product Data panel.
2. In the Probo API Product Code dropdown, start typing to search for your product. The dropdown searches your Probo API product catalog and shows results as code (title). Select the correct product.

Step 4: Choose the uploader type

In the Select File Uploader type dropdown, choose how the print file is supplied:

• Artwork via URL — You provide a direct link to the print file. This is the most common option.
• No file — No artwork is sent with the order. Use this when artwork is handled separately.

Step 5: Set up the print file (for "Artwork via URL")

If you selected "Artwork via URL":

1. In the Print File URL field, enter a direct URL to your print file (PDF, JPG, or PNG). You can also click Select from Media to pick a file from your WordPress Media Library.
2. A preview of the file appears below the URL field.
3. In the Print File Formatting dropdown, choose how the file should be formatted:
   • Fill Even — Scales the artwork to fill the product evenly.
   • Fill — Scales the artwork to fill the product area.
   • Nothing — Sends the file as-is without formatting.

Step 6: Configure advanced options (optional)

Check Advanced options to reveal dimension override fields:

• Height and Width — Override the default height and width from the Probo API product. Leave empty to use the API product's standard dimensions.

This is useful when you need a custom size that differs from the standard product dimensions.

Step 7: Enable Probo Shipping (optional)

If you have the Probo Shipping method enabled in WooCommerce, you'll see a Probo Shipping Configuration section at the bottom of the tab:

• Check Use in Probo shipping calculation to include this product in Probo's shipping cost calculation at checkout.
• For Simple products, this is unchecked by default.

Step 8: Publish

Click Publish (or Update if editing). Your API product is now live and will fulfill through Probo when ordered.

Creating a Variable API Product

Variable products let you offer different options (like size or material) as WooCommerce variations, each potentially linked to a different Probo product code.

Step 1: Create the variable product

1. Go to Products → Add New.
2. Set the product type to Variable product.
3. In the Attributes tab, add your attributes (e.g., "Size" with values "A4" and "A3").
4. Check Used for variations for each attribute.
5. In the Variations tab, generate your variations.
6. Set the price for each variation in the variation settings.

Step 2: Configure the parent product

1. Go to the Probo Connect tab.
2. Select the Probo API Product Code — this is the default code used for all variations unless overridden.
3. Configure the uploader type and print file settings as described above.

Step 3: Override per variation (optional)

Each variation has a Probo Variant options section where you can optionally override:

• Probo API Product Code — Use a different Probo product for this variation.
• Height and Width — Override dimensions for this specific variation.

If you leave these fields empty, the variation uses the values from the parent product.

This is useful when, for example, your "A4" variation uses one Probo product code and your "A3" variation uses another.

Step 4: Publish

Click Publish. Each variation will use its own Probo product code and dimensions (if set), or fall back to the parent product settings.

Uploader Types Explained

The uploader type determines how the print file is supplied to Probo when the order is placed.

Artwork via URL

You provide a direct link to the artwork file (PDF, JPG, or PNG). This is the most common option for API Products.

• Enter a URL in the Print File URL field, or pick a file from the WordPress Media Library.
• Choose a formatting option (Fill Even, Fill, or Nothing) to control how the artwork is fitted to the product.
• The file URL and formatting are sent to Probo when the order is synced.

No file

No artwork file is sent with the order. Use this when:

• Artwork is handled through a separate process outside the plugin.
• The product does not require artwork (e.g., blank products).

Custom uploader types

Developers can register additional uploader types, this is explained in a different page

How Pricing Works

For API Products, you are in full control of the price:

• Set your price using WooCommerce's Regular price and Sale price fields in the General tab.
• The Default Margin multiplier from Probo Settings does not automatically apply to API Products. That setting is for Configurable Products only.
• Your cost from Probo (the production and shipping cost) is separate from the price you charge customers. You manage your own margins.