Tasa BCV en WooCommerce
Muestra precios en bolívares dinámicos junto al precio en dólares. Ejemplo de referencia visual para productos simples con moneda base USD.
Obtener tu API key
Entra a app.cotizave.com, crea una cuenta gratuita y copia tu API key desde el dashboard.
Definir la constante en wp-config.php
Abre wp-config.php y añade esta línea antes de /* That's all, stop editing! */:
define( 'COTIZAVE_API_KEY', 'tu-api-key-aqui' );
Pegar el snippet en functions.php del tema hijo
Agrega el siguiente código al final del archivo functions.php de tu tema hijo (nunca del tema padre para no perder cambios en actualizaciones):
/**
* Obtiene la tasa BCV desde Cotizave con caché de 30 minutos.
*
* @return float Tasa válida o 0 como señal interna de no disponibilidad.
*/
function cotizave_get_bcv_rate() {
if (!defined('COTIZAVE_API_KEY') || trim(COTIZAVE_API_KEY) === '') return 0.0;
$cached = get_transient( 'cotizave_bcv' );
if ( is_numeric($cached) && is_finite((float) $cached) && $cached > 0 ) {
return (float) $cached;
}
$response = wp_remote_get(
'https://api.cotizave.com/v2/fx/VE/rates/ve-bcv',
[
'headers' => [
'X-API-Key' => trim(COTIZAVE_API_KEY),
],
'timeout' => 5,
'redirection' => 0,
]
);
if ( is_wp_error( $response ) || wp_remote_retrieve_response_code($response) !== 200 ) {
return 0.0;
}
$body = json_decode( wp_remote_retrieve_body( $response ), true );
$rate = $body['mid'] ?? null;
if ((!is_int($rate) && !is_float($rate)) || !is_finite((float) $rate) || $rate <= 0
|| ($body['stale'] ?? false) === true) return 0.0;
if ( $rate > 0 ) {
set_transient( 'cotizave_bcv', $rate, 30 * MINUTE_IN_SECONDS );
}
return $rate;
}
/**
* Muestra el equivalente en bolívares junto al precio del producto.
* Solo modifica el HTML visible; no afecta totales ni el checkout.
*/
add_filter( 'woocommerce_get_price_html', function ( $price, $product ) {
if (get_woocommerce_currency() !== 'USD' || !$product->is_type('simple')) return $price;
if (is_cart() || is_checkout()) return $price;
$usd = (float) wc_get_price_to_display($product);
if ( $usd <= 0 ) {
return $price;
}
$bcv = cotizave_get_bcv_rate();
if ( $bcv > 0 ) {
$ves = number_format( $usd * $bcv, 2, ',', '.' );
$price .= '<br><small style="color:#666;font-size:0.85em;">≈ Bs. ' . esc_html( $ves ) . ' (referencia BCV)</small>';
}
return $price;
}, 10, 2 );El transient guarda una tasa validada durante 30 minutos. Ese intervalo es una decisión de este ejemplo, no la frecuencia de publicación del BCV. Una consulta cada 30 minutos durante 30 días puede consumir 1.440 solicitudes: supera las 800 de Free. Si la API no responde, la función devuelve 0 como señal interna de error. El filtro conserva el precio original en USD y omite la referencia en VES; nunca muestra una tasa cero.
Antes de usarlo en una tienda
Comprueba productos simples, ofertas, impuestos incluidos y excluidos, fallos HTTP y vencimiento del cache. Alinea el TTL del cache de página/CDN con el de la tasa: un HTML cacheado puede mostrar una referencia anterior aunque el transient ya se haya renovado.
El redondeo a dos decimales es solo de presentación. Para cobrar en VES necesitas una implementación específica que fije la tasa del pedido, trate variaciones, carrito y checkout, use precisión decimal y evite conversiones repetidas. Este ejemplo no implementa ese flujo ni ha sido validado en todas las combinaciones de plugins.
Casos de uso frecuentes
Tiendas B2C en Venezuela
Operan con precios en USD pero muestran el equivalente en bolívares como referencia informativa, no como importe final del pedido.
Dropshipping
Productos con precio en dólares del proveedor. Los clientes venezolanos ven automáticamente el valor en bolívares sin trabajo manual.
E-commerce con clientes mixtos
Sirves a compradores locales e internacionales. El ejemplo muestra la misma referencia en VES a todos los visitantes; no realiza segmentación geográfica.
Preguntas frecuentes
¿El snippet puede romper el checkout o el cálculo de totales?
El ejemplo no modifica el precio interno. Debes probarlo con tu tema, plugins y configuración fiscal antes de publicarlo. El filtro woocommerce_get_price_html solo modifica el HTML que se muestra al comprador, no el precio interno que WooCommerce usa para calcular totales, impuestos ni procesar el pago. Los montos en el carrito y en el pedido siguen siendo los precios base que definiste.
¿Puedo mostrar el paralelo en lugar del BCV?
Sí. Cambia el endpoint en la función cotizave_get_bcv_rate() de /v2/fx/VE/rates/ve-bcv a /v2/fx/VE/rates/ve-paralelo y actualiza el nombre del transient para evitar conflictos. Puedes tener ambas funciones activas al mismo tiempo para mostrar BCV y paralelo en paralelo.
¿Hay un plugin oficial de Cotizave para WooCommerce?
Todavía no. Estamos evaluando publicar uno en el directorio de WordPress. Por ahora, este ejemplo solo añade una referencia visual para productos simples en USD.