{"id":403312,"date":"2026-11-19T04:14:52","date_gmt":"2026-11-19T04:14:52","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/vilahub-marketplaces-for-woocommerce\/"},"modified":"2026-11-19T04:14:39","modified_gmt":"2026-11-19T04:14:39","slug":"vilahub-for-woocommerce","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/vilahub-for-woocommerce\/","author":23601631,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.1","stable_tag":"1.0.1","tested":"7.1.5","requires":"6.5","requires_php":"8.1","requires_plugins":null,"header_name":"VilaHub \u2013 Marketplaces for WooCommerce","header_author":"VilaHub","header_description":"Integra\u00e7\u00e3o do WooCommerce com Mercado Livre, Shopee, Magalu, Amazon, SHEIN e outros marketplaces. Gerencie produtos, pedidos, estoque e NF-e.","last_updated":"2026-11-19 04:14:39","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/vilahub.com.br\/desenvolvedores","header_author_uri":"https:\/\/vilahub.com.br","rating":0,"author_block_rating":0,"active_installs":0,"downloads":27,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","changelog"],"tags":{"1.0.1":{"tag":"1.0.1","author":"vilahub","date":"2026-11-19 04:14:39","revision":3810617}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3810632,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3810632,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.1"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[209,172479,232707,31799,250630],"plugin_category":[45],"plugin_contributors":[293801],"plugin_business_model":[],"class_list":["post-403312","plugin","type-plugin","status-publish","hentry","plugin_tags-amazon","plugin_tags-integracao","plugin_tags-magalu","plugin_tags-mercado-livre","plugin_tags-shopee","plugin_category-ecommerce","plugin_contributors-vilahub","plugin_committers-vilahub"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/vilahub-for-woocommerce\/assets\/icon-128x128.png?rev=3810632","icon_2x":"https:\/\/ps.w.org\/vilahub-for-woocommerce\/assets\/icon-256x256.png?rev=3810632","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>VilaHub connects WooCommerce to its external integration service. From WordPress you can authorize accounts, configure prices, send products, review publications and manage supported marketplace orders.<\/p>\n\n<ul>\n<li>Explicit OAuth authorization with PKCE; no WordPress password sharing.<\/li>\n<li>Product selection, destination account, price review and explicit publication confirmation.<\/li>\n<li>Background transmission of products, variations, prices, stock, images and attributes.<\/li>\n<li>Publication status, channel validation and supported category\/attribute corrections.<\/li>\n<li>Separate marketplace order screen; imported sales are not native WooCommerce orders.<\/li>\n<li>WooCommerce or external ERP inventory authority, with idempotent local deductions.<\/li>\n<li>Supported invoices and shipping documents, always behind a separate user action.<\/li>\n<li>Fiscal, financial and plugin-support screens connected to the authorized VilaHub company.<\/li>\n<\/ul>\n\n<p>Requires WooCommerce 9.0+, WordPress 6.5+, PHP 8.1+, OpenSSL, HTTPS and a VilaHub account. The interface is in Brazilian Portuguese. HPOS and legacy storage are supported.<\/p>\n\n<h4>External service and data transmission<\/h4>\n\n<p>The plugin depends on VilaHub for the catalog, marketplace connections, publication queue, marketplace orders and supported fiscal\/shipping services. It cannot perform those operations offline.<\/p>\n\n<p>Service endpoints: https:\/\/vilahub.com.br\/api\/v1 and https:\/\/vilahub.com.br\/api\/oauth. Authorization is hosted at https:\/\/vilahub.com.br\/conectar\/woocommerce. API calls use HTTPS; official marketplace authorization pages open only when the seller chooses to connect an account.<\/p>\n\n<p>Information is exchanged as follows:<\/p>\n\n<ul>\n<li>Connection sends the callback URL, installation\/client identifiers and OAuth PKCE\/state parameters. Tokens are encrypted locally with keys derived from WordPress security salts. Authorization can be revoked, and old grants do not silently gain scopes.<\/li>\n<li>Product restriction preview sends product IDs, titles, descriptions and brands in bounded batches. It does not publish products.<\/li>\n<li>An explicit send or enabled synchronization can transmit SKU, title, plain-text description, brand, GTIN, price, stock, dimensions, weight, tags, public image URLs, variations, attributes, NCM\/unit when configured, and local installation\/operation identifiers.<\/li>\n<li>Channel connection sends seller\/store identifiers, company document when supplied and credentials entered for key-based providers. OAuth providers use their official flow. The plugin does not download executable code from VilaHub.<\/li>\n<li>After order permission and account activation, periodic requests can receive buyer\/contact\/address data, items, totals, payment\/fulfillment\/tracking status, fiscal status and document references. Fields depend on the marketplace and are kept in private local plugin tables.<\/li>\n<li>Order activation, inventory authority, acknowledgements, product links and explicit order\/fiscal\/shipping actions are sent to VilaHub. Native store orders are not uploaded by this feature.<\/li>\n<li>Fiscal configuration sends issuer, address, contact, accountant and tax data. An administrator can upload an A1 PFX\/P12 certificate and password or an authorized invoice XML. Invoice issuance, consultation, marketplace submission and label requests use VilaHub and the authorized providers. No invoice is issued merely by opening or importing an order.<\/li>\n<li>Finance requests subscription, usage, invoices, credits and dropshipping commission summaries. Payments continue on the authenticated VilaHub page; the plugin does not collect card or bank credentials.<\/li>\n<li>Support chat sends the question, plugin page\/version and store URL. Human transfer sends the transcript and account identity. Never send passwords, tokens, certificates or banking credentials in chat.<\/li>\n<\/ul>\n\n<p>The plugin does not send WordPress passwords, card\/bank credentials or native store order lists. It processes buyer and fiscal data as described; account for this in store privacy practices. Public product images can be fetched from supplied URLs (up to ten HTTPS URLs and ten MB per image).<\/p>\n\n<p>Optional WhatsApp support opens only when clicked and receives no buyer\/order data automatically.<\/p>\n\n<ul>\n<li>Service: https:\/\/vilahub.com.br<\/li>\n<li>Terms: https:\/\/vilahub.com.br\/termos<\/li>\n<li>Privacy: https:\/\/vilahub.com.br\/privacidade<\/li>\n<li>Pricing: https:\/\/vilahub.com.br\/planos<\/li>\n<li>API documentation: https:\/\/vilahub.com.br\/api\/v1\/docs<\/li>\n<\/ul>\n\n<h4>Source code, assets and build<\/h4>\n\n<p>The complete human-readable source code is included in this plugin package. PHP, JavaScript, CSS and vector assets are distributed as source files; no compiled, generated, obfuscated or minified code is required at runtime. The package has no dependency installation or build step: the files in this directory are the files that are shipped and maintained.<\/p>\n\n<h4>Plans and integrations<\/h4>\n\n<p>The external service has a permanent Free plan (up to ten products and one active integration per company), an eligible thirty-day Full trial and paid usage under current terms. Quotas apply to the company, not just this store.<\/p>\n\n<p>VilaHub's wider ecosystem includes Mercado Livre, Magalu, Shopee, VilaBrasil\/Medusa, Amazon, TikTok Shop, MadeiraMadeira, Leroy Merlin, Netshoes\/Zattini, Americanas\/B2W, SHEIN, Carrefour, AliExpress, Dafiti, Bling, ERP TINY\/Olist, Omie, WooCommerce, Loja Integrada, Nuvemshop, Shopify and Tray. Capabilities, approval and availability differ by provider and account; this list does not promise identical operations or a direct connector in this plugin for every service.<\/p>\n\n<h4>Supported operations<\/h4>\n\n<p>Connection screens exist for Mercado Livre, Shopee, Magalu, Amazon, TikTok Shop, VilaBrasil, SHEIN, Netshoes, MadeiraMadeira, Americanas\/SkyHub and Leroy Merlin. Marketplace order reception is currently offered for Mercado Livre, Magalu, Shopee, TikTok Shop, VilaBrasil and MadeiraMadeira after per-account activation.<\/p>\n\n<ul>\n<li>Magalu: supported fiscal profile\/A1 setup, preview, direct issuance for CRT 1, consultation, authorized external XML, submission, XML\/DANFE and available labels. Other regimes use authorized external XML where supported.<\/li>\n<li>Mercado Livre: official label PDF subject to shipment\/printable-status checks. Invoice submission is not part of this workflow.<\/li>\n<li>TikTok Shop: package consultation, validated authorized XML and shipping documents when released by the channel. Unsupported grouping\/dispatch stays in Seller Center.<\/li>\n<li>Shopee, VilaBrasil and MadeiraMadeira: order information and documents supplied by the service; no new generic fiscal\/label action is added by this release.<\/li>\n<\/ul>\n\n<p>Mercado Livre and Shopee expose supported category\/attribute preparation. Connecting Amazon, SHEIN or Leroy Merlin does not create a generic batch publisher. Provider credentials, account approval and channel rules always apply.<\/p>\n\n<h3>Important behavior<\/h3>\n\n<p>Prices use BRL and inventory uses whole quantities. No currency conversion, invented tax data or fractional allocation is performed. Products\/variations need distinct SKUs and their own stock; negative quantity is sent as zero. The API accepts up to 100 variations, two attributes per variation and replaces the variation list as a whole. Existing SKU links require explicit approval before their first transmitted update. Successful catalog synchronization does not mean a marketplace listing is published.<\/p>\n\n<p>Queues use bounded batches, persistent operation identifiers and retries. WordPress cron and WooCommerce Action Scheduler must run; low-traffic stores may need a server scheduler.<\/p>\n\n<p>Marketplace orders remain separate from native WooCommerce orders. With WooCommerce as inventory authority, linked stock is changed through its product API; observers can see the change. With ERP authority, the plugin makes no local deduction. Paid-order deductions and pre-dispatch cancellations are idempotent. Old or undated sales require explicit confirmation. Refunds or dispatched goods never return stock automatically; confirm only physically received quantities. The plugin does not issue marketplace financial refunds.<\/p>\n\n<p>Fiscal actions require supported channel capability, configuration and user review. An uncertain result is consulted instead of retransmitted automatically. Real provider\/SEFAZ homologation is separate from synthetic tests.<\/p>\n\n<p>Each installation is bound to the authorized company, credentials and store URL. A cloned origin blocks synchronization until reviewed. Multisite network activation is unsupported; activate per store. Changing WordPress security salts requires reconnection.<\/p>\n\n<h3>Removal<\/h3>\n\n<p>Deactivation stops scheduled tasks and preserves data. Disconnect first to revoke remote authorization; uninstall does not make a remote deletion request. By default uninstall retains mappings, private marketplace orders, inventory ledgers and migration backups for recovery, while removing local secrets and pausing synchronization. Products and normal native orders are not deleted.<\/p>\n\n<p>Defining <code>VILAHUB_DELETE_DATA_ON_UNINSTALL<\/code> as <code>true<\/code> in <code>wp-config.php<\/code> permanently deletes local plugin tables\/options during uninstall, including private orders and migration backups. Do not use it while operations are unresolved.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install WooCommerce and activate VilaHub.<\/li>\n<li>Open VilaHub &gt; In\u00edcio, choose Come\u00e7ar, sign in or create the service account, confirm the company and authorize the store.<\/li>\n<li>Use VilaHub &gt; Conectar Canal de Venda to authorize an account; manage it in Minhas Integra\u00e7\u00f5es.<\/li>\n<li>In Products &gt; All products, select products, choose Enviar para marketplace, choose the destination, apply, review prices and confirm.<\/li>\n<li>Review results in VilaHub &gt; Produtos publicados.<\/li>\n<li>In VilaHub &gt; Pedidos, configure order reception, activate the account and choose WooCommerce or ERP inventory authority. Reauthorize if the old grant lacks the necessary scopes.<\/li>\n<li>Manage marketplace orders, item links, inventory pending items and available documents in the separate order screen.<\/li>\n<\/ol>\n\n<p>No WooCommerce REST key or WordPress password is required. Legacy manual VilaHub keys remain supported. Never activate a second copy under a different plugin folder on the same store.<\/p>\n\n<!--section=changelog-->\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Validate and sanitize administrative fiscal fields, item links, return quantities, identifiers and certificate input.<\/li>\n<li>Limit the activation notice to the Plugins and VilaHub administration screens.<\/li>\n<li>Ship the support interface as readable source and document that the plugin has no build or minification step.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<p>Initial public release.<\/p>","raw_excerpt":"Connect WooCommerce to Mercado Livre, Shopee, Magalu, Amazon, SHEIN and other marketplaces. Manage products, orders, inventory and invoices.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/403312","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=403312"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/vilahub"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=403312"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=403312"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=403312"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=403312"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=403312"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=403312"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}