OCA para WooCommerce

Descripción

Integra el servicio de envíos OCA en tu tienda WooCommerce con cálculo automático de tarifas, generación de guías y rastreo de paquetes. Este plugin te permite ofrecer a tus clientes una opción de envío confiable y rastreable a través de OCA en Argentina.

Índice

• OCA para WooCommerce
  • Descripción
  • Índice
  • Cómo Instalar
  • Cómo Configurar
    • Configuración del Manager
      • Configuración General del Manager
      • Credenciales de Transportistas
      • Configuración de Moneda
      • Campos Personalizados
    • Configuración del Transportista OCA
      • Información del Remitente OCA
      • Configuración de Productos OCA
      • Configuración de Envío OCA
      • Configuración de Costos OCA
      • Configuración de Descuentos OCA
      • Envío Gratuito OCA
      • Restricciones OCA
      • Otros Ajustes OCA
  • Cómo Utilizar
    • Generación de Guías de Envío
    • Rastreo de Paquetes
    • Configuración de Productos
    • Consideraciones Importantes

Cómo Instalar

Para instalar este plugin, sigue las instrucciones generales de instalación de plugins de WooCommerce que puedes encontrar en nuestra guía de instalación de WooCommerce.

Cómo Configurar

Configuración del Manager

El Manager es el componente central que controla la configuración general para todos los transportistas. Para configurarlo:

1. Ve a WooCommerce > Ajustes > Integración > "Envíos para Argentina"
2. Configura los siguientes campos:

Configuración General del Manager

• Habilitar/Deshabilitar: Activa o desactiva el módulo de envíos
• API Host: Servidor de la API (por defecto: shipping.yipi.app)
• API Key: Tu clave de licencia de Cujiware. Para obtener tu licencia, consulta nuestra guía de licencias

Credenciales de Transportistas

• Usuario de OCA: Credenciales de OCA e-Pak para generar etiquetas (opcional)
• Contraseña de OCA: Credenciales de OCA e-Pak para generar etiquetas (opcional)

Configuración de Moneda

• Conversión de Moneda: Opciones para manejar diferentes monedas
  • Desactivar módulo
  • Usar tasa de conversión oficial
  • Usar tasa de conversión manual
• Tasa de Conversión Manual: Valor personalizado para la conversión

Campos Personalizados

Si ya tienes instalado otro plugin que agrega campos personalizados al checkout (como "Checkout Field Editor", "WooCommerce Checkout Manager" o "Checkout Fields Manager"), estos campos podrían duplicarse con los que necesita OCA. Para evitar la duplicación, puedes configurar el meta-key que usa tu plugin para guardar estos datos en la orden de WooCommerce. Por ejemplo, si tu plugin guarda el DNI como "_billing_dni", debes configurar ese valor en el campo "Meta-key para DNI". De esta manera, OCA obtendrá los datos directamente de los campos existentes en lugar de crear nuevos campos en el checkout. Si no configuras estos meta-keys, el sistema agregará automáticamente los campos necesarios al checkout.

Los campos son:

• Meta-key para DNI: Campo personalizado para el DNI
• Meta-key para Teléfono: Campo personalizado para el teléfono
• Meta-key para Altura (Facturación): Campo personalizado para la altura
• Meta-key para Altura (Envío): Campo personalizado para la altura
• Meta-key para Departamento (Facturación): Campo personalizado para el departamento
• Meta-key para Departamento (Envío): Campo personalizado para el departamento
• Meta-key para Piso (Facturación): Campo personalizado para el piso
• Meta-key para Piso (Envío): Campo personalizado para el piso

Configuración del Transportista OCA

1. Ve a WooCommerce > Ajustes > Envío > OCA
2. Habilita el método de envío
3. Configura los siguientes campos:

Información del Remitente OCA

• Código Postal: Ingresa el código postal de origen
• Provincia: Selecciona la provincia de origen
• Ciudad: Ingresa la ciudad de origen
• Calle: Ingresa la calle de origen
• Número: Ingresa el número de la dirección
• Piso: Ingresa el piso (opcional)
• Departamento: Ingresa el departamento (opcional)
• Detalle: Información adicional de la dirección
• Nombre Completo: Nombre del remitente o razón social
• Teléfono: Número de contacto
• Email: Correo electrónico de contacto

Configuración de Productos OCA

• Peso por defecto: Peso predeterminado para productos sin peso especificado
• Ancho por defecto: Ancho predeterminado para productos sin dimensiones
• Alto por defecto: Alto predeterminado para productos sin dimensiones
• Profundidad por defecto: Profundidad predeterminada para productos sin dimensiones

Configuración de Envío OCA

• Tipo de Envío: Selecciona entre entrega a domicilio o en sucursal
• Sucursal de Origen: Selecciona la sucursal de OCA más cercana
• CUIT: Número de CUIT para OCA e-Pak
• Recolección en Tienda: Activa si OCA recoge los paquetes en tu tienda
• Horario de Recolección: Selecciona el horario de recolección
  • 8:00 - 17:00
  • 8:00 - 12:00
  • 14:00 - 17:00
• Tiempo de Entrega: Tiempo estimado de entrega si el servicio no lo proporciona
• Cálculo de Cajas: Algoritmo para calcular las cajas necesarias
  • Smart: Selecciona las mejores cajas para todo el pedido
  • Forzar una caja: Intenta que todo quepa en una caja
  • Una caja por producto: Separa cada producto en su propia caja

Configuración de Costos OCA

• Cargo Fijo: Monto fijo a agregar al costo de envío
• Porcentaje de Cargo: Porcentaje a agregar al costo de envío
• Monto Mínimo: Valor mínimo del costo de envío
• Monto Máximo: Valor máximo del costo de envío

Configuración de Descuentos OCA

• Monto Mínimo para Descuento: Monto mínimo del carrito para aplicar descuento
• Peso Mínimo para Descuento: Peso mínimo del pedido para aplicar descuento
• Porcentaje de Descuento: Porcentaje a descontar del costo de envío
• Monto de Descuento: Monto fijo a descontar del costo de envío

Envío Gratuito OCA

• Activar Envío Gratuito: Habilita la opción de envío gratuito
• Modo de Envío Gratuito: Selecciona cómo se aplicará el envío gratuito
  • Usar "Envío Gratuito" si se aplica un cupón de envío gratuito
  • Usar "Envío Gratuito" si hay un cupón aplicado y se cumplen los criterios
  • Usar "Envío Gratuito" si hay un cupón aplicado o se cumplen los criterios
  • Usar "Envío Gratuito" automáticamente solo si se cumplen los criterios
• Monto Mínimo: Monto mínimo del carrito para envío gratuito
• Peso Mínimo: Peso mínimo del pedido para envío gratuito
• Provincias: Selecciona las provincias con envío gratuito

Restricciones OCA

• Categorías Excluidas: Productos de estas categorías no podrán usar este método
• Provincias Excluidas: Este método no estará disponible en estas provincias
• Monto Mínimo de Activación: Monto mínimo del carrito para activar el método
• Monto Máximo de Activación: Monto máximo del carrito para activar el método
• Peso Mínimo de Activación: Peso mínimo del pedido para activar el método
• Peso Máximo de Activación: Peso máximo del pedido para activar el método

Otros Ajustes OCA

• Ocultar Tiempo de Entrega: Oculta la etiqueta de tiempo estimado de entrega
• Debug: Activa el registro de eventos para depuración

Cómo Utilizar

Generación de Guías de Envío

1. Cuando un pedido es procesado, el sistema calculará automáticamente el costo de envío basado en:

   • Peso y dimensiones de los productos
   • Dirección de entrega
   • Tipo de envío seleccionado
   • Configuración de costos y descuentos
   • CUIT configurado

2. Para generar una guía de envío:

   • Ve a WooCommerce > Pedidos
   • Selecciona el pedido
   • En la sección de envío, haz clic en "Generar Guía de Envío"
   • El sistema generará la guía usando las credenciales de OCA e-Pak configuradas

Rastreo de Paquetes

1. El sistema permite rastrear los paquetes de dos formas:

   • Automáticamente: Los estados se actualizan según la información de OCA
   • Manualmente: Puedes verificar el estado en cualquier momento

2. Para rastrear un paquete:

   • Ve a WooCommerce > Pedidos
   • Selecciona el pedido
   • En la sección de envío, verás el estado actual y el número de seguimiento
   • Haz clic en "Actualizar Estado" para obtener la información más reciente

Configuración de Productos

1. Para productos con dimensiones específicas:

   • Edita el producto en WooCommerce
   • En la pestaña "Datos del producto", configura:
     • Peso
     • Dimensiones (largo, ancho, alto)
   • Guarda los cambios

2. Para productos sin dimensiones:

   • El sistema usará los valores predeterminados configurados
   • Puedes modificar estos valores en la configuración del transportista

Consideraciones Importantes

1. Moneda:

   • El sistema soporta ARS y USD
   • Puedes configurar la conversión automática o manual
   • Las tasas de conversión se actualizan diariamente

2. Debug:

   • Activa el modo debug para registrar eventos
   • Los logs se guardan en WooCommerce > Estado > Registros
   • Para más información sobre cómo activar y ver los logs, consulta nuestra guía de logs

3. Restricciones:

   • Configura cuidadosamente las restricciones por categoría y provincia
   • Considera los límites de peso y monto para cada transportista
   • Ajusta los tiempos de entrega

4. Características Específicas de OCA:

   • CUIT:
     • Es obligatorio para usar OCA e-Pak
     • Debe ser un CUIT válido
   • Recolección en Tienda:
     • Configura el horario de recolección según tus necesidades
     • Asegúrate de que el horario sea compatible con tu operación