WooCommerce
WooCommerce connects your flow to your WooCommerce store. With a single component you can look up, create, change and delete products, customers and orders, and get the list of the store’s tags and categories.
You choose what to do with two fields: Operation (the action) and Entity (what it acts on). The component only shows the fields that combination needs.
When to use it
- Review new orders every day and notify the warehouse.
- Update product prices or stock from a supplier’s price list.
- Add to the store the customers coming from another tool.
- Create product pages with the description an agent writes.
- Let a customer service agent check the status of an order.
Configuration
The component needs a WooCommerce API credential with your store’s address, the consumer key and the consumer secret. See Credentials.
| Field | What it does |
|---|---|
| Credential (required) | Your WooCommerce store’s credential. |
| Operation | The action: Get, Create, Update, Delete, Get Tags (list product tags) or Get Categories (list product categories). Default: Get. |
| Entity | What it acts on: Product, Customer or Order. Default: Product. It doesn’t appear with Get Tags or Get Categories. |
| Entity ID | The item’s identifier in WooCommerce. It doesn’t appear when creating. Required to update and delete. |
Looking up (Get, Get Tags and Get Categories)
| Field | What it does |
|---|---|
| Entity ID | With Get, when filled in only that item is returned; when empty, a list is returned. |
| Search | Optional, with Get. A text to filter the list: only items containing it are shown. |
| Limit | Advanced option. The maximum number of items in the list. Default: 10. |
| Order By | Advanced option, with Get. The field the list is sorted by. Put a hyphen in front for reverse order, for example -date. Default: date. |
Creating or updating a product
| Field | What it does |
|---|---|
| Product Name | The product name. Required when creating and updating. |
| Add Others Caracteristics | Advanced option. Turn it on to fill in more product details. |
| Other Caracteristics | Which extra details you want to fill in. Each one shows its own field. They include the price (Regular Price), the code (SKU), the descriptions (Description, Short Description), the category (Category), the tags (Product Tags), inventory (Manage Stock, Stock Quantity, Stock Status, Backorders), visibility (Status, Catalog Visibility, Featured), taxes (Tax Status, Tax Class), shipping (Weight, Dimensions, Shipping Class), the image (Image), the product type (Type, Virtual, Downloadable, External URL), sale dates (Date on Sale From, Date on Sale To) and your store’s own data (Metadata). |
Creating or updating a customer
| Field | What it does |
|---|---|
| Customer Email | The customer’s email. Required when creating. |
| Additional Info | Turn it on to fill in more customer details. |
| Additional Info Fields | Which extra details you want to fill in: Username, First Name, Last Name, Password, Billing Address, Shipping Address and Metadata. |
Creating or updating an order
| Field | What it does |
|---|---|
| Customer ID | The order’s customer. |
| Include Complementary Info | Turn it on to fill in more order details. |
| Complementary Info | Which extra details you want to fill in: the status (Status, with values such as pending, processing or completed), the currency (Currency), whether it is paid (Set Paid), the customer note (Customer Note), the billing and shipping addresses, the payment method, and the product, shipping, fee and coupon lines. For lines, you set how many there are and a group of fields appears for each one. |
Output
The Result output returns what WooCommerce sends back: the items looked up, the tags or categories, or the item created, updated or deleted with its details. If the requested item doesn’t exist, it returns nothing.
Connect it to an agent, to Parse Data or to a spreadsheet. The component can also be used as a tool by an agent, which decides what to look up or change based on the conversation.
Example
A shop updates its prices every week from its supplier’s price list:
- Read the price list from a spreadsheet, with each product’s identifier, name and new price.
- Add WooCommerce and choose Update in Operation and Product in Entity.
- Connect the identifier to Entity ID and the name to Product Name, turn on Add Others Caracteristics, choose Regular Price and connect the new price to that field.
- Run the flow: each product gets its updated price.
Good practices
- Before creating a product with a category or tags, use Get Categories and Get Tags to see which ones already exist in the store.
- Try the operations that create, change or delete with test items before using them with real data.