Krama Sync for MercadoLibre

Description

This plugin connects your WooCommerce store to your MercadoLibre Chile seller account so you
do not have to keep both catalogs up to date by hand.

What it does

  • Pushes WooCommerce stock changes to your MercadoLibre listings.
  • Pushes WooCommerce price changes (regular and sale price), with optional per-product rules.
  • Imports MercadoLibre orders into WooCommerce, consolidating multi-item carts into a single order.
  • Publishes WooCommerce products to MercadoLibre, with category and attribute assistance.
  • Imports existing MercadoLibre listings and matches them to WooCommerce products by SKU.
  • Shows an error monitor so failed synchronisations are visible instead of silent.

Account required

This plugin is the WordPress client for the Krama Sync service operated by Krama Tech. Using it
requires a Krama Sync account. A free plan and a 14-day trial of the paid plan are
available. The plugin is useless without an account — it is a client, not a standalone tool.

Trademark disclaimer

Krama Sync is an independent product built and operated by Krama Tech (krama.tech). It is not
affiliated with, endorsed by, or sponsored by MercadoLibre. MercadoLibre is a trademark of
MercadoLibre, S.R.L., used here only to describe compatibility with its marketplace.

External services

This plugin relies on three external services. Installing and connecting it means store data
leaves your server. Please read this section before installing.

1. Krama Sync API (Krama Tech)

The plugin sends data to the Krama Sync API in order to perform the synchronisation. This is
the core function of the plugin and cannot be disabled while the plugin is connected.

Endpoint: https://woo.melisync.krama.tech

Data transmitted, and when:

  • When a product’s stock changes in WooCommerce: product ID, SKU, stock quantity, regular price.
  • When a product or variation is saved: product ID, variation ID, SKU, regular price, sale price.
  • When you create or sign in to your Krama Sync account from the onboarding wizard: the
    name, email address and password you submit, and the time you accepted the Terms of
    Service and Privacy Policy. Name and email are pre-filled from your WordPress user, and
    nothing is sent until you press the button. Creating an account sends a verification
    email to that address; the plugin stays on the wizard until the link in it is opened.
  • When you connect your store from the wizard or from Settings: your store URL and the
    WooCommerce REST API key and secret you enter, so the service can read and update your
    catalogue and create orders on your behalf.
  • When you publish or import: product titles, descriptions, images, categories, attributes
    and prices for the products you select.
  • When orders are imported: MercadoLibre order and buyer data needed to create the
    WooCommerce order.

Terms of Service: https://krama.tech/terminos
Privacy Policy: https://krama.tech/privacidad

2. MercadoLibre API (MercadoLibre S.R.L.)

The Krama Sync service communicates with MercadoLibre on your behalf, using the credentials you
authorise via MercadoLibre’s own OAuth screen. The plugin itself does not contact MercadoLibre
directly; your MercadoLibre password is never seen by this plugin or by Krama Tech.

MercadoLibre Terms of Service: https://www.mercadolibre.cl/ayuda/terminos-y-condiciones_991
MercadoLibre Privacy Policy: https://www.mercadolibre.cl/ayuda/politica-privacidad_994

3. Mercado Pago (Mercado Pago S.A.)

Paid Krama Sync plans are billed through Mercado Pago subscriptions. When you choose to
upgrade from the plugin’s Settings screen, the Krama Sync API creates a subscription checkout
and the plugin opens Mercado Pago’s own checkout page in a new browser tab. Payment details
are entered on Mercado Pago’s site; the plugin never sees or stores them. Only the account
email you registered with Krama Sync is shared with Mercado Pago to attach the subscription
to your account. Nothing is sent to Mercado Pago unless you start an upgrade.

Mercado Pago Terms of Service: https://www.mercadopago.cl/ayuda/terminos-y-condiciones_299
Mercado Pago Privacy Policy: https://www.mercadopago.cl/privacidad

Updates

The copy of this plugin distributed through the WordPress.org directory receives updates
only from WordPress.org. It does not contact the Krama Sync API to look for new versions.

Source code

The admin interface in build/index.js is compiled with @wordpress/scripts (webpack). The
complete, human-readable sources are shipped inside this plugin, so no external download is
needed to review or rebuild them:

  • src/ — the TypeScript/React source files.
  • webpack.config.js — the build configuration.
  • package.json — the dependencies and build script.

To rebuild: run npm install && npm run build in the plugin directory. This regenerates
build/index.js and build/index.asset.php.

Installation

  1. Install and activate WooCommerce if you have not already. This plugin will not activate
    without it.
  2. Install the plugin from the WordPress plugin directory, or upload it through
    Plugins > Add New > Upload Plugin.
  3. Activate the plugin.
  4. Go to Krama Sync in the admin menu and follow the onboarding wizard: create or connect
    your Krama Sync account, then authorise your MercadoLibre account.
  5. Choose which products to synchronise.

FAQ

Do I need a paid account?

You need a Krama Sync account. There is a free plan, and the paid plan includes a 14-day trial.

Does this work with MercadoLibre outside Chile?

Currently the service targets MercadoLibre Chile only.

Does it change my MercadoLibre prices automatically?

Only if you enable price synchronisation. Stock and price sync are configured separately, and
price sync is off until you turn it on.

What happens to my listings if I deactivate the plugin?

Nothing is deleted. Synchronisation stops; your WooCommerce products and MercadoLibre listings
stay as they are.

What data is removed when I uninstall?

Deleting the plugin removes its WordPress options, including the stored account token. Data
held by the Krama Sync service is deleted from your account settings on the service itself.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Krama Sync for MercadoLibre” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.2.7

  • The readme is now written entirely in English, so the listing reads in one language. The Spanish version is provided as a translation on translate.wordpress.org: a store set to Spanish sees the whole page in Spanish, and one set to English sees it all in English.

1.2.6

  • The Pro button no longer offers 14 free days to a merchant who has already used them. In that case it says the charge starts today, before sending you to Mercado Pago.
  • Errors opening Mercado Pago are shown on the page itself, instead of a browser dialog that blocked the WordPress admin screen.

1.2.5

  • Added a disclaimer of non-affiliation with MercadoLibre to the readme description and the plugin header, as requested by the WordPress.org pre-review.

1.2.4

  • Creating an account now requires accepting the Terms of Service and the Privacy Policy, and confirming your email through the link that is sent. The setup wizard waits until you confirm.
  • New “Resend email” button in the setup wizard.

1.2.3

  • The Plugin URI header points to the product page (krama.tech/kramasync); WordPress.org requires it to differ from Author URI.

1.2.2

  • The plugin is renamed “Krama Sync for MercadoLibre”: WordPress.org does not allow “WooCommerce” in the name of third-party plugins.

1.2.1

  • Prepared for the WordPress.org directory: no self-updater, text domain matching the slug, and uninstall without direct database queries.
  • Removed the “API URL” setting from the settings screen. The plugin always uses https://woo.melisync.krama.tech; a developer can override it with define(‘MLWC_API_URL’, …) in wp-config.php.
  • The readme declares every piece of data sent to the service, including the WooCommerce REST API credentials.

1.2.0

  • The product is renamed Krama Sync.

1.1.0

  • The plugin updates itself from Plugins Updates.
  • The session renews automatically; it no longer returns to the setup wizard every 7 days.
  • A clear notice with a link to the settings screen when the plan’s product limit is reached.

1.0.0

  • Initial release.