Vasy for WooCommerce

Description

Vasy for WooCommerce links your WooCommerce store with your Vasy account. Enter your Vasy Account URL and Company ID, and the plugin sets everything up for you:

  • A guided 6-step setup: Introduction, Integration Features, Prerequisites & Connect, Synchronization, Integration Settings and Logs & Troubleshooting.
  • Connect: sets the permalink structure to Post name, creates a Read/Write REST API key owned by an administrator and creates the Order Created, Order Updated and Customer Created webhooks (no duplicates).
  • Pause / Resume: temporarily stop the integration without deleting anything. Webhooks become inactive and the plugin’s REST API key is blocked until you resume.
  • Test Connection: checks REST API reachability, key validity, Read/Write permission and owner, webhook status and delivery errors.
  • Update & Reconnect: validates the existing key and re-creates the webhooks without generating new keys.
  • Regenerate REST API Keys & Webhooks: creates a new key and webhooks and downloads the new credentials as an Excel file.
  • Disconnect: removes the key and webhooks and resets the saved settings.
  • Confirmation pop-ups for every action, clear status (Connected, Paused, Disconnected, Connection Failed) and activity logs with filters.
  • Includes a Delete existing catalog tool to permanently remove existing products, categories and attributes before the product master is synced from Vasy.

Before you connect

  1. Hosting must have at least 2 Core CPU and 8 GB RAM.
  2. The website base URL must be a main domain or a subdomain only, for example demowebsite.com or woocommerce.demowebsite.com.
  3. A proxy configuration is required. Contact the Vasy support team (Support@vasy.ai) to get it set up.
  4. If any security plugin or functionality is active, whitelist the Vasy IP 20.244.143.30.

How the integration works

  1. Remove existing Products, Categories and Attributes from the WooCommerce website (you can use the built-in delete tool).
  2. Enter your Vasy Account URL and Company ID and click Connect.
  3. In Vasy, go to Apps & Integrations > eCommerce & Marketplaces > WooCommerce and sync the product master data.
  4. Only products that have an image in Vasy are synced to WooCommerce.
  5. Inventory and orders are managed on Vasy HO only. Product modification is not allowed from WooCommerce.
  6. Currently only 3 webhooks are supported: Order Created, Order Updated and Customer Created.

Requirements

  • WooCommerce must be installed and active.
  • A Vasy account.

External services

This plugin connects your store to the Vasy service (https://vasy.ai/), operated by Vasy.

Vasy webhooks (croods.vasyerp.com)

When you click Connect, the plugin creates three standard WooCommerce webhooks that send data to https://croods.vasyerp.com/woocommerce/... including your Vasy Company ID in the URL:

  • Order created: sent each time a new order is created.
  • Order updated: sent each time an order is updated.
  • Customer created: sent each time a new customer account is created.

The data sent is the standard WooCommerce webhook payload for these events, which includes order details (items, totals, status) and customer details such as name, email, phone and billing/shipping address. Each request is signed with a secret generated by WooCommerce. No data is sent until you connect the plugin, and the webhooks are removed when you click Disconnect.

Service provider: Vasy. Website: https://vasy.ai/
Terms of service: https://vasy.ai/
Privacy policy: https://vasy.ai/

Health check connection test

When you click Run health check, the plugin makes one HTTPS request (HEAD) to https://croods.vasyerp.com/ to test whether your server can reach Vasy. No store, order or customer data is sent. WordPress adds its standard User-Agent header, which includes your site address.

Links to vasy.ai

The “Vasy Official Website” link opens https://vasy.ai/ in a new tab with UTM tags (utm_source=wordpress_plugin) only when you click it. Nothing is sent otherwise.

REST API key

The plugin creates a WooCommerce REST API key on your own site and shows the Consumer Key and Secret once on screen so that you can enter them in Vasy. The plugin itself does not send these keys anywhere.

Installation

  1. Make sure WooCommerce is installed and active.
  2. Upload the plugin folder to the /wp-content/plugins/ directory, or install it through the Plugins screen in WordPress.
  3. Activate the plugin. You are taken to the Vasy settings page.
  4. Enter your Vasy Account URL (for example business.vasyerp.com), your Company ID, and choose the administrator who will own the API key.
  5. Click Connect and copy the Consumer Key and Consumer Secret shown on screen. They are displayed only once.

FAQ

What does Pause do?

Pause keeps your REST API key and webhooks but makes the webhooks inactive and blocks REST API requests made with this plugin’s key. Nothing is deleted. Click Resume to continue. Pause is not Disconnect.

What does Regenerate do?

It removes the old key, creates a new Read/Write key, re-creates the webhooks and downloads the new credentials as an Excel file. You must update the new credentials in Vasy, otherwise the integration stops working. The file is generated on request, is never stored in a public folder and is available for 10 minutes only.

Where can I see what the plugin is doing?

Open Vasy > Integration Settings for the status and Test Connection, and Vasy > Logs & Troubleshooting for the activity log and health checks. Webhook deliveries to Vasy are logged with the HTTP result.

Does “Connected” mean Vasy accepted my Company ID?

Not yet. The status is based on this site: the REST API key, active webhooks and recent delivery results. A later version will verify the Account URL and Company ID with Vasy.

Why does the health check say a webhook is disabled?

WooCommerce disables a webhook after repeated failed deliveries. Fix the cause (see Logs), then use Reactivate webhooks.

Where do I find the REST API keys?

Right after you click Connect, they are shown at the top of the page and can be downloaded as an Excel file. Copy them immediately, the secret is shown only once. If you lose them, click Regenerate REST API Keys & Webhooks to create a new pair.

Can I recover products after using the delete tool?

No. The delete tool removes products (with variations), categories and attributes permanently. They do not go to Trash and cannot be restored. Always take a full backup first.

Does this plugin delete my orders?

No. Orders are not deleted, but their line items will no longer link to products that were deleted.

Why are some Vasy products missing in WooCommerce?

Only products that have an image in Vasy are synced to WooCommerce.

Can I edit products in WooCommerce?

No. Products, categories, attributes and stock are managed in Vasy. Inventory and orders are managed on Vasy HO only.

Why can’t I edit or delete the plugin’s REST API key and webhooks in WooCommerce?

The key and the 3 webhooks created by this plugin are view-only so the connection cannot be broken by accident. Use Vasy > Integration Settings (Update & Reconnect, Regenerate or Disconnect) to change them. You can still add your own keys and webhooks. Any change made to them outside the plugin is written to the Activity log and a health check runs automatically. Developers can switch the lock off with the vasyerp_lock_managed_items filter.

What happens if I deactivate or delete the plugin?

Deactivating blocks the integration without deleting anything: the REST API key stops working and the webhooks are paused. When you activate the plugin again, the key and the webhooks that were active are restored automatically (a pause you set yourself before deactivating stays in place until you click Resume). Deleting the plugin removes the REST API key and the Vasy webhooks it created, together with its settings and logs. Products, orders and customers are never deleted. After deleting, the old key stops working, so update Vasy if you reinstall.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Vasy for WooCommerce” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Vasy for WooCommerce” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.3.6

  • Security and directory review: code checked against the WordPress coding and security standards, docblocks and escaping tidied, request-level tests for nonces, permissions and input handling.

1.3.5

  • Webhooks created by the plugin are now named “Vasy – …”. Delivery URLs are unchanged.

1.3.4

  • Rebranded: VasyERP is now Vasy in all plugin text. Web addresses, webhooks and settings are unchanged.

1.3.3

  • The REST API key and webhooks created by the plugin are now view-only in WooCommerce (edit, revoke and delete are refused, including through the REST API).
  • Any change to the key or webhooks is written to the Activity log, and a health check now runs automatically afterwards.
  • Connection status now reports a REST API key that is not Read/Write.

1.3.2

  • Introduction page: new About Vasy text and an About the Vasy–WooCommerce integration section.

1.3.1

  • Introduction page: “New to Vasy?” now offers Sign up and Book a Free Demo (both open in a new tab; nothing is sent until the user clicks).

1.3.0

  • New design across every page: brand header with a step bar, consistent cards, buttons, forms, status badges and tables, numbered instructions, colour-coded action cards and a segmented Logs & Troubleshooting menu.
  • Works on phones and tablets; respects reduced-motion settings.
  • Small wording fixes (1 problem / 2 problems) and a cleaner Connect page once the store is connected.

1.2.14

  • Performance: the admin stylesheet and script now load on Vasy pages only; catalog counts are queried once per page; fewer database writes per webhook delivery; no background checks until the store is connected.

1.2.13

  • Introduction page: “New to Vasy?” sign-up link (opens in a new tab; nothing is sent until the user clicks).

1.2.12

  • Merged Important Points and Connect Your Store into one page: Prerequisites & Connect (now a 6-step flow).

1.2.11

  • Moved the A/B field tables (Vasy WooCommerce, WooCommerce Vasy) from Important Points to Integration Features.
  • Redesigned the “How data flows” diagram.

1.2.10

  • While the integration is Connected the prerequisite checklist and the delete-catalog tool are locked; Pause or Disconnect unlocks them.

1.2.9

  • Important points: merged Category & Subcategory, MRP & Selling Price, Brand & Department rows.
  • Website base URL is now enforced (main domain or subdomain only): Connect is blocked otherwise. Removed it from the prerequisite checklist.

1.2.8

  • Vasy ID shown read-only on each variation of a variable product.
  • Redesigned support section placed inside the page so it no longer overlaps content.

1.2.7

  • Synchronization page counts only products with a _vasy_product_id and categories with a _vasy_category_id.

1.2.6

  • Vasy Product ID and Category ID are shown read-only on the Edit Product and Edit Category screens.

1.2.5

  • Products without a _vasy_product_id and categories without a _vasy_category_id are highlighted in red in the WooCommerce admin lists.

1.2.4

  • Added “Need any support?” section (helpline, email, dedicated account manager) on every plugin page.
  • Notice on the WooCommerce Products, Categories and Attributes screens: Vasy does not allow catalogue changes from WooCommerce.
  • Removed Product Master Synchronization from Connect Your Store (it lives on the Synchronization tab).

1.2.3

  • First-time connect verifies in the backend that the store has 0 products, 0 categories and 0 attributes and asks the user to confirm the inventory was removed.
  • If existing data is found, the user can still connect by ticking “I agree to continue the integration without clearing the existing data”. A reminder that the integration will not work properly then stays visible on every plugin page.
  • Inventory change log: product, category and attribute add / edit / delete done from the WooCommerce admin panel are recorded (changes through the REST API are expected and not flagged).
  • The label is now “WooCommerce Base URL” everywhere.

1.2.2

  • Disabled webhooks: WooCommerce can switch a webhook to Disabled after repeated failed deliveries. The plugin now detects this, writes a detailed entry to the activity log (which webhook, failure count, last failed delivery, likely cause and what to do) and shows an alert with a Reactivate webhooks button on every plugin page. Test Connection opens the alert as a popup when a webhook is disabled.
  • Fixed stray code text shown above “Connect Your Store”.
  • Important Points: the Vasy to WooCommerce and WooCommerce to Vasy tables now sit side by side (50% / 50%).

1.2.1

  • Important Points: the prerequisites are now a checklist with Done / Pending status and a progress bar.
  • Health check redesigned: summary, “Needs attention” first and passed checks in a compact grid; Health check, Activity logs and Common issues are now tabs so there is less scrolling.
  • Activity logs: filter by date range (with Today / 7 / 30 days shortcuts), type (including “Important only”), area and search text.
  • Support contact (Support@vasy.ai) added; links to vasy.ai carry UTM tags.

1.2.0

  • New 7-page guided onboarding wizard.
  • New Pause, Resume, Test Connection, Update & Reconnect, Regenerate (with Excel credentials download) and Disconnect actions with confirmation pop-ups.
  • Duplicate webhooks are prevented and cleaned up.
  • Fixed attribute deletion errors not being detected by the delete tool.
  • Deactivating the plugin now blocks the REST API key and pauses the webhooks; activating restores them.
  • Deleting the plugin now also removes the REST API key and webhooks it created.

1.1.1

  • Fixed the “REST API key last used” time on the Overview page showing a wrong time (hours off) for sites not on UTC.

1.1.0

  • New Overview page with connection status, delivery statistics, webhooks and recent activity.
  • New Health Check page with fix instructions for each problem and a Reactivate webhooks button.
  • New Logs page recording setup actions, catalog deletions, health checks and webhook deliveries.
  • Plugin data for logs and health results is removed on uninstall.

1.0.0

  • Initial release.