Get store info (yekar.woocommerce.get-store-info) | Read | Confirm the connection works and report the store's currency. Every price and total in this integration is a decimal string in this currency - there are no currency codes on product prices, only on orders. Run this first when a store's connection is in doubt. |
List products (yekar.woocommerce.list-products) | Read | A page of products with prices, stock and categories, filtered by search text, SKU, status, category, stock status or sale flag. total is the store's own count of everything matching, not the page size. Note a stockQuantity of null means the product does not manage stock - use stockStatus to answer 'can it be bought'. For a variable product the price fields summarize a range; the real prices live on its variations. |
Get product (yekar.woocommerce.get-product) | Read | One product by id, with its full description (HTML stripped to text), prices, stock and categories. stockQuantity null means stock is not managed for this product, which is different from zero. |
List orders (yekar.woocommerce.list-orders) | Read | A page of orders with status, totals, payment method and customer. total on the response is the store's own count of matching orders. On each order, total is the amount AS PLACED - WooCommerce records refunds separately, so a refunded order still shows its original total with refundedTotal beside it. looksPaid reads the status (processing/completed); datePaid is the actual fact. |
Get order (yekar.woocommerce.get-order) | Read | One order with its line items (up to 25; lineItemsOmitted counts the rest), billing and shipping locations, payment method and totals. A line's subtotal is before discounts and total after - they differ on any discounted line. |
List customers (yekar.woocommerce.list-customers) | Read | A page of customer ACCOUNTS with contact details and whether they have ever paid. Two things to know: WooCommerce returns only accounts with the customer role unless you pass role: all, and GUEST checkouts create no account at all - so this list is not the same as everyone who has ordered. Count buyers from orders, not from here. |
Get customer (yekar.woocommerce.get-customer) | Read | One customer account by id: name, email, billing contact details and whether they have ever paid. To find someone by email instead, use List customers with the email filter. |
List order notes (yekar.woocommerce.list-order-notes) | Read | An order's note history - status changes WooCommerce logs itself, staff notes, and notes that were emailed to the customer. customerNote: true means the buyer received it; false means staff-only. |
List coupons (yekar.woocommerce.list-coupons) | Read | A page of discount coupons with their type, amount, expiry and usage. discountType decides what amount means - percent is a percentage, fixed_cart is an amount off the whole order, fixed_product an amount off each qualifying item - so neither field means anything alone. A coupon with no dateExpires never expires. |
List product categories (yekar.woocommerce.list-product-categories) | Read | The store's product categories with their ids, parents and product counts. The ids are what List products' category filter takes. productCount is WooCommerce's own per-category count. |
Get sales report (yekar.woocommerce.get-sales-report) | Read | WooCommerce's own sales totals for a period - gross sales, NET sales (excluding tax, shipping and refunds), order count, item count, refunds and discounts. Use this instead of adding up a page of orders: it is computed store-side across the whole period, excludes refunds properly, and separates revenue from tax and shipping. Dates are in the STORE's timezone. |
Create product (yekar.woocommerce.create-product) | Write | Create a simple product. It is created as a DRAFT unless you pass status publish. Prices are decimal strings in the store's currency. Running this twice creates TWO products unless you set a SKU - WooCommerce enforces SKU uniqueness, so the second attempt then fails instead of duplicating. |
Update product (yekar.woocommerce.update-product) | Write | Update a product's name, prices, SKU, descriptions, status or categories. Only the fields you pass change. Pass salePrice "" to end a sale. CAREFUL with categoryIds: the list REPLACES the product's categories rather than adding to them. To change stock use Update product stock instead. |
Update product stock (yekar.woocommerce.update-product-stock) | Write | Set a product's stock to an ABSOLUTE quantity (not a delta), or turn stock management on/off, or set purchasability directly. WooCommerce offers no compare-and-set here: a sale that happens between reading the count and writing it will be overwritten, so re-read immediately before writing and prefer quiet periods for bulk corrections. |
Update order status (yekar.woocommerce.update-order-status) | Write | Set an order's status. This is not just a label - the store's own automations run: completed normally emails the customer and releases downloads, cancelled restores stock. Setting refunded records the status but moves NO money; the actual refund has to be issued in the payment gateway (Stripe, PayPal, Square) or the WooCommerce admin. |
Add order note (yekar.woocommerce.create-order-note) | Write | Add a note to an order. By default it is a STAFF-ONLY note. Setting customerNote true makes WooCommerce EMAIL the note to the customer - that message cannot be recalled, so only do it when the intent is to contact the buyer. Every call adds another note; there is no deduplication. |
Create customer (yekar.woocommerce.create-customer) | Write | Create a customer account. This creates a real WordPress user on the store: the email must be unique (a duplicate is refused, not merged) and, depending on the store's settings, WooCommerce may send the person a new-account email. Guest buyers do not need an account - only create one when the customer should be able to log in. |