Plugin para WooCommerce

El plugin Fulfy Plus Venezuela Shipping for WooCommerce muestra en el checkout de tu tienda los precios de envío de los transportistas de Fulfy y crea la guía cuando el pedido se paga. El comprador elige su ciudad, marca en un mapa el punto exacto de entrega y, si envías a oficina, la oficina donde retira. El precio sale de tu plan de Fulfy, y encima puedes sumar tu propio fee, porcentaje, mínimo y máximo, descuentos o envío gratis.

Antes de empezar

• Una cuenta de Fulfy con correo y teléfono verificados, y Saldo USD o un plan que cubra los transportistas que vas a ofrecer.
• Una dirección de origen en Fulfy (Mis direcciones): es desde donde salen tus paquetes. Ver cómo crear una dirección.
• Una API key creada en API Keys del panel de Fulfy. Ver cómo crear una API key.
• WordPress 6.1 y WooCommerce 6.0 o más recientes, con PHP 7.4 o superior.
• La moneda de la tienda en dólares, euros o bolívares.

Descargar el plugin

Descargar Fulfy Plus Venezuela Shipping para WooCommerce (.zip)

El plugin está en revisión para el directorio de WordPress.org; mientras tanto se instala subiendo este archivo. No lo descomprimas.

Instalar y conectar

1. En WordPress, ve a Plugins → Añadir nuevo → Subir plugin, elige el archivo fulfy-plus-venezuela-shipping.zip que descargaste, pulsa Instalar ahora y luego Activar.
2. Ve a WooCommerce → Ajustes → Envío → Fulfy.
3. Pega tu API key en API key de Fulfy y guarda. El campo queda vacío por seguridad y solo muestra los últimos cuatro caracteres.
4. Pulsa Probar conexión: debe decir cuántas direcciones de origen tiene tu cuenta.
5. Elige la Dirección de origen y guarda.

Agregar los transportistas

1. En WooCommerce → Ajustes → Envío, abre (o crea) una zona de envío para Venezuela.
2. Pulsa Añadir método de envío y elige Fulfy.
3. Edita el método: en Transportista elige uno (Zoom, Tealca…). Repite los pasos 2 y 3 por cada transportista que quieras ofrecer.

Solo aparecen en el checkout las opciones que tu plan de Fulfy permite cotizar con precio. Un transportista sin cobertura en tu plan, o en modo de referencia, no se muestra.

Ajustes de cada transportista

Grupo	Qué controla
Título	«Transportista - Modalidad» (por ejemplo «Zoom - Retiro en oficina») o tu propio texto. Con varias modalidades, se agrega la modalidad al final.
Modalidades permitidas	Retiro en oficina, entrega a domicilio, delivery y cobro en destino. El cobro en destino viene apagado: actívalo aquí si lo quieres ofrecer. El comprador le paga al transportista al recibir, así que no suma al carrito y la opción muestra un monto aproximado.
Fee extra fijo y Porcentaje extra	Se suman al precio del transportista: primero el porcentaje y luego el fee, en USD. 0 no suma nada.
Precio mínimo y Precio máximo del envío	Límites de lo que paga el comprador por este transportista. 0 = sin límite.
Enviar sin seguro	No declara el valor del pedido: el transportista aplica su seguro mínimo y el precio baja, pero si el paquete se pierde solo cubre ese mínimo.
Mostrar solo desde / hasta un monto o un peso	Fuera de ese rango, el transportista no se ofrece. 0 = sin límite.
Ocultar	Si el carrito tiene productos de ciertas categorías, o si el punto de entrega está en ciertos estados. Para un producto puntual, marca No enviar con… en la pestaña Envío del producto.
Descuento en el envío	En porcentaje o monto fijo, desde un monto o peso mínimo.
Envío gratis	Con cupón, con cupón y criterios, con cupón o criterios, o automático por criterios (monto, peso, estados, códigos postales o «todos los productos son de estas categorías»).

El precio final se calcula en este orden: precio de Fulfy, más el % extra y el fee, menos el descuento, y luego los límites del transportista y los generales. El envío gratis lo deja en 0, y al final se convierte a la moneda de la tienda.

Ajustes generales

• Precio mínimo y máximo del envío y Peso mínimo y máximo del pedido: valen para todos los transportistas.
• Tasa para convertir a bolívares: la tasa BCV del día que publica Fulfy, o una tasa manual.
• Emitir guías con Fulfy: apágalo para mostrar solo los precios públicos de los transportistas. No se emite ninguna guía y coordinas cada envío con el transportista.
• Mostrar cobro en destino que Fulfy no puede emitir: ofrece esa modalidad con su precio público estimado aunque tu plan no pueda emitir la guía. En esos pedidos coordinas el envío con el transportista.
• Emitir la guía al pasar a «Procesando» y al pasar a «Completado»: sin ninguna de las dos, la guía se emite a mano desde el pedido.
• Si el precio subió al emitir: emitir igual (deja una nota con la diferencia) o dejar el pedido en espera para que emitas a mano.
• Paquetes: el algoritmo de cajas, y cómo se arma el bulto cuando no configuraste cajas. Las cajas se cargan en WooCommerce → Cajas Fulfy. Un producto puede tener sus propios bultos en la pestaña Envío del producto, en el campo Bultos Fulfy.
• Estado del pedido en tránsito y entregado: el estado de WooCommerce al que pasa el pedido cuando el transportista informa ese avance.

Qué ve el comprador

En el checkout, cuando el país es Venezuela:

1. Tipo de Identificación, Número de Identificación, Prefijo Celular y Número Celular. Son los mismos campos que usan los plugins de Zoom y MRW: si ya los tienes, no se duplican.
2. Ciudad: una lista con las ciudades del estado elegido, sin valor por defecto.
3. Un mapa para marcar el punto exacto de entrega. Los precios de Fulfy aparecen después de marcarlo.
4. Si elige Retiro en oficina, la lista de oficinas cercanas con su distancia. Si la más cercana está a más de 8 km, ve un aviso.

La guía

Cuando el pedido pasa al estado configurado, el plugin crea la guía en segundo plano. En el pedido, el recuadro Fulfy muestra el estado, el número de guía, la etiqueta (PDF, o EPL para impresora térmica si lo elegiste y el transportista lo ofrece) y el enlace de seguimiento. Desde ahí puedes Emitir guía, Sincronizar estado o Anular guía. En el listado de pedidos, la acción en lote Emitir guías Fulfy emite varias a la vez.

El comprador recibe un correo con el número de guía y el enlace de seguimiento, y también lo ve en Mi cuenta → Pedidos.

Sin guías duplicadas

Si el pedido cambia de estado varias veces a la vez (pasarela de pago, administrador, webhook), el plugin crea una sola guía. Si una respuesta de Fulfy se pierde, el reintento recupera la misma orden en vez de crear otra.

Pedido en espera

Si elegiste «dejar en espera» y el precio subió desde el checkout, o la opción ya no existe, el pedido queda En espera: emitir a mano y te llega un correo. La guía solo se crea cuando pulsas Emitir guía.

Preguntas frecuentes

No veo los precios de Fulfy en el checkout. El país debe ser Venezuela, el comprador debe marcar el punto en el mapa y la moneda de la tienda debe ser dólares, euros o bolívares. Activa Modo debug para ver el motivo, como administrador, en el checkout y en WooCommerce → Estado → Registros (fuente «fulfy»).

¿Puedo usar mi contrato con el transportista? El contrato se configura en Fulfy, en la dirección de origen. El plugin usa el precio que Fulfy calcule para esa dirección.

¿Qué pasa si anulo la guía? Se anula con el transportista mientras no haya recibido el paquete, y Fulfy devuelve el cobro. Después puedes volver a emitir desde el pedido.

---

Relacionado: API Keys · Mis direcciones · Modalidades de entrega