VibeFox Coordinadora for WooCommerce — Help
Requirements
WordPress: 5.8 or later.
WooCommerce: 5.0 or later, installed and active. The plugin refuses to activate without it.
PHP: 8.0 or later.
Coordinadora API key (for live quotes only): live quotes come from the Coordinadora Cotizador through the Coordinadora WooCommerce service, the same service the official Coordinadora plugin uses. Coordinadora issues the API key to customers with an active commercial agreement. Ask your Coordinadora account manager or see wc.coordinadora.com. You also need the 8-digit DANE code of the city you ship from. Without a key the method works with fixed prices only.
Products: for a live quote every product in the cart needs a weight and dimensions (length, width, height).
VibeFox license key: bought on vibefox.net. One key works on one domain.
Installation
1. In WordPress go to Plugins > Add New > Upload Plugin, choose the plugin ZIP file and click Install Now. You can also upload the vfd_coordinadora folder to /wp-content/plugins/ by FTP.
2. Click Activate.
3. Open the settings: WooCommerce > Settings > Shipping > VibeFox Coordinadora, or click Settings under the plugin name on the Plugins page.
4. Enter your VibeFox license key in the license block at the top of the page and click Activate.
5. Enter the API key, the origin city DANE code and, if your store currency is not COP, the COP exchange rate. Add at least a fixed price for Colombia as a fallback (see Configuration).
6. Add VibeFox Coordinadora to a shipping zone that covers Colombia in WooCommerce > Settings > Shipping > Shipping zones, or turn on Ignore shipping zones and choose countries.
7. Make sure your products have weight and dimensions.
Configuration
All settings are on one page: WooCommerce > Settings > Shipping > VibeFox Coordinadora. They apply to every shipping zone. When you add the method to a zone, the zone window has only one field:
Title (zone): the shipping method name shown to the customer for this zone. Leave it empty to use the global Name.
The settings page shows warnings at the top when live quotes cannot work or the method would be hidden: the origin DANE code is missing or invalid, the COP exchange rate is missing, or there is no fixed price for Colombia. Every time you save the settings, the cached quotes are cleared. Numbers can be typed with a point or a comma (9,99 = 9.99).
General
Enable/Disable: turns Coordinadora on or off in all zones at once.
Name: the shipping method name shown to the customer at checkout. Default: Coordinadora. A zone Title overrides it.
Tax status: Taxable adds WooCommerce shipping tax on top of the rate, None does not. Choose None if your prices or the Coordinadora quote already include tax.
Live Coordinadora rates
Live quotes are requested for destinations in Colombia. Leave the key empty to use fixed prices only.
API key: your Coordinadora WooCommerce API key from Coordinadora. It is never written to the log.
Origin city (DANE code): the 8-digit DANE code of the city you ship from, for example 11001000 Bogotá, 05001000 Medellín, 76001000 Cali or 08001000 Barranquilla. A 5-digit municipality code is also accepted and completed to 8 digits.
COP per 1 unit of store currency: Coordinadora quotes in Colombian pesos. If your store currency is not COP, enter how many COP make 1 unit of your currency, for example 4300. The rate is also used to send the declared value in COP. Leave it empty and live rates are not used. If your store currency is COP, leave it empty.
Fixed prices (used when there is no API key, for destinations outside Colombia, and as a fallback when a live quote is unavailable)
Prices by country: a table of countries with a Price column and optional prices by package size in your store currency. The size comes from the cart weight: XS up to 1 kg, S 1–2 kg, M 2–3 kg, L 3–5 kg, XL over 5 kg. Price is used when the size column is 0 or empty. Click + Add country to add a row and the cross to remove one. The country * All other countries applies to countries without their own row. A country without a row (and without *) gets no fixed price. A row with Price 0 and no size price gives free shipping.
Fixed price per: Order charges the price once. Item (price × quantity) multiplies it by the number of items in the cart. This applies to fixed prices only; a live Coordinadora quote always covers the whole order.
Conditions
Min weight (kg): hide the method below this cart weight. 0 means no limit.
Max weight (kg): hide the method above this cart weight. Default: 25. 0 means no limit.
Minimum order subtotal: show the method only if the cart subtotal is at least this amount. Leave empty to always show it.
Excluded shipping classes: hide the method if a cart item belongs to one of these WooCommerce shipping classes.
Free shipping: turn on free delivery from the subtotal below.
Free shipping from: the cart subtotal from which shipping is free. Used only when Free shipping is on. No API request is made in that case.
Availability without shipping zones
Ignore shipping zones: offer the method for the countries below even if it is not added to a shipping zone.
Countries: the destination countries for that mode. Leave empty to use all countries the store ships to. This field is used only when Ignore shipping zones is on.
Advanced
Debug log: logs rate calculations in WooCommerce > Status > Logs, source vfd-coordinadora. API errors are always logged, even when this option is off. The API key and customer addresses are never logged.
Remove data on uninstall: when on, deleting the plugin removes its settings, zone methods and cached rates. Deactivation never deletes data.
How it works at checkout
When the customer enters a delivery address, WooCommerce asks the plugin for a rate. The plugin first checks the conditions: cart weight, minimum order subtotal and excluded shipping classes. If free shipping applies, the customer gets a free rate and no request goes to Coordinadora.
For an address in Colombia with an API key, the plugin finds the DANE code of the destination city in this order: a DANE code in the city field (Colombian departments and cities checkout plugins write it, for example MEDELLIN (ANT) (05001000)), an 8-digit postcode, or the built-in list of department capitals and about 40 largest cities. A city from the list is checked against the selected department. Accents and case are ignored.
Then the plugin sends Coordinadora the destination DANE code and each product with the origin city, its weight (kg), dimensions (cm), quantity and declared value (COP). Store units are converted automatically. Coordinadora returns the price in COP, and the plugin converts it to your store currency. Each quote is cached for 1 hour. A failed request is remembered for 10 minutes, so a Coordinadora outage never slows every checkout refresh. The API timeout is 10 seconds.
When a live quote is unavailable (API error, unknown city, a product without weight or dimensions, missing settings), the fixed price is used. If there is none, the method is hidden. Error details go to the WooCommerce log, never to the customer.
The method works on the classic checkout and on the Cart and Checkout blocks. It is compatible with WooCommerce High-Performance Order Storage (HPOS).
The plugin calculates rates only. It does not create shipments or guides (guías), print labels, book pickups (recogidas), track parcels, collect cash on delivery (recaudo) or offer Droop pickup points; use the Coordinadora portal for these. It does not quote same-day delivery, and international destinations use the fixed prices.
License key
The plugin works with a VibeFox license key from vibefox.net. The license block is at the top of WooCommerce > Settings > Shipping > VibeFox Coordinadora. Paste the key into License key and click Activate. The block shows the status, for example the date the license is active until and your domain. Use Check now to check the status again, Change key to enter another key and Remove key to remove it from this site. The link Manage licenses and domains in your account opens your vibefox.net account.
One key works on one domain. Removing the key from a site does not free its domain slot. Free the slot in your vibefox.net account.
Without an active key, Coordinadora is not shown to customers at checkout. Logged-in store managers still see it, marked (unlicensed — visible to admins only), so you can set up and test the plugin before you buy a key. A reminder appears on the Plugins page and on WooCommerce pages. Existing orders are not affected.
When a license expires, the plugin keeps working, but updates and support need a renewal. The status is checked again automatically in the background.
Troubleshooting
Coordinadora does not appear at checkout: check that the license is active, Enable/Disable is on, and the method is added to the zone of the customer's country (or Ignore shipping zones is on and the country is allowed). Check the weight limits, Minimum order subtotal and Excluded shipping classes. Without a live quote, a fixed price for the country or * must exist.
The live rate is not shown, only the fixed price: turn on Debug log, reload the checkout and open WooCommerce > Status > Logs, source vfd-coordinadora. Typical reasons: the destination city is not recognised, a product has no weight or dimensions, the origin DANE code or the COP exchange rate is missing, or Coordinadora returned an error.
The destination city is not recognised: install a Colombian departments and cities checkout plugin that writes the DANE code into the city field. Developers can map more cities with the vfd_crd_dane_cities and vfd_crd_destination_dane filters.
Does the rate include tax? The rate is what Coordinadora quotes. With Tax status set to Taxable WooCommerce adds shipping tax on top; choose None if the quote already includes it for you.
Rates look outdated after a change: save the settings page. This clears the cached quotes.
The license block shows an error: follow the message in the block. For example, if the key is already used on another domain, free a slot in your vibefox.net account and click Check now. If the site address changed, click Check now to activate the key for the new domain. If the license server cannot be reached, the plugin keeps working on the last known status.
Uninstall
Deactivating the plugin keeps all settings; it only clears the cached quotes. To remove it, deactivate and delete it on the Plugins page. The license key and license status of this plugin and the cached quotes are always removed. Settings and zone methods are removed only if Remove data on uninstall was on. Otherwise they stay for a later re-install. Existing orders keep their shipping lines.
Coordinadora is a trademark of its respective owner. This plugin is not affiliated with or endorsed by Coordinadora.