MAGENTO
Versiones de Magento soportadas: Magento 2.4 Open Source y Commerce Edition.
GUÍA DE INSTALACIÓN
- Ir al root de Magento y copiar el código en app/code/.
- Se debe ver [magento_root]/app/code/Oca/TrackEPak
- Correr los siguientes comandos en Magento:
- $ bin/magento setup:upgrade
- $ bin/magento setup:di:compile
- $ bin/magento setup:static-content:deploy
- Activar el Modulo en el admin
- Ingresar al Admin de la tienda.
- Ingresar a Store -> Settings
- Ingresar a Sales -> Shipping Methods
- Seleccionar el Módulo de OCA y activarlo.
- Descripción de opciones
- Title: Título que se verá en el checkout
- Method Name: Nombre del método que se verá en el checkout
- Shipping Cost: En el caso de usar un costo fijo para todas las ubicaciones (seleccionar esta opción hará que no se calculen los costos desde OCA)
- Type: Calcular costo en base a item, a orden complete o ninguno (en el caso de usar un costo fijo)
- Use Flat Rate instead of Calculate from API: Seleccionar TRUE para que calcule los precios desde la API de OCA
- Ship to Aplicable Countries: No cambiar
- Ship to Specific Countries: No cambiar
- Tracking URL: URL de OCA para seguir el tracking de los envíos, no cambiar.
- SOAP Epak Tracking URL: API de OCA. No cambiar.
- SOAP Oep Tracking URL: API de OCA. No cambiar.
- OCA Cuit: Cuit de la tienda.
- OCA Username: Nombre de la cuenta para autenticar con OCA
- OCA Password: Password para autenticar con OCA
- Account Number: Número de cuenta OCA
- Operatory: Número de Operatoria registrada con OCA.
- Todos los productos deben tener Ancho, alto y largo. En el caso de que no los tengan, hay que configurar una opción por default: Ir a Store -> Settings -> Configuration -> OCA -> Dimension y setear las tres a una opción por defecto, en metros. Mínimo 0.01
GUÍA DE CONFIGURACIÓN
Instalación y Configuración del Módulo
Una vez instalado el módulo de OCA en Magento, es necesario configurarlo para comenzar a usarlo.
- Acceder a la Configuración del Módulo:
- Dirígete a
Stores -> Configuration -> Sales -> Delivery Methods
. - Baja hasta la sección
Módulo de Envíos OCA
. - Habilitar el Módulo:
- Selecciona
Habilitado
enYes
.
Opciones de Configuración
A continuación se describen las opciones disponibles en la configuración del módulo:
- Habilitado:
- Yes: El módulo calculará el costo basado en las dimensiones de tus productos (alto, ancho, largo y peso). Si dicha información no está cargada, se usarán valores por defecto.
- Título:
- Shipping by OCA track EPak
- Título en la Tienda:
- Oca Shipping
- Costo de Envío:
- 10
- Tipo:
- None
- Calculate Handling Fee:
- Fixed
- Use flat rate instead of calculate from API:
- No
- Ship to Applicable Countries:
- All Allowed Countries
- URL Api de Seguimiento:
-
TEST:
http://webservice.oca.com.ar/oep_tracking_test/Oep_Track.asm x?wsdl
-
PRODUCCIÓN:
https://webservice.oca.com.ar/epak_tracking/Oep_Trackepak.as mx?wsdl
- URL Api de e-Pak:
-
TEST:
http://webservice.oca.com.ar/epak_tracking_test/Oep_TrackEPa k.asmx?wsdl
-
PRODUCCIÓN:
https://webservice.oca.com.ar/epak_tracking/Oep_Trackepak.as mx?wsdl
- URL Api de Etiquetas:
-
TEST:
http://www5.oca.com.ar/ocaepakNet/Views/ConsultaTracking/Tra ckingConsult.aspx?numberTracking=
-
PRODUCCIÓN:
https://webservice.oca.com.ar/epak_tracking/Oep_Trackepak.as mx?wsdl
- CUIT:
- 30-53625919-4
- Usuario e-Pak:
- test@oca.com.ar
- Contraseña e-Pak: ••••••
- Nro. de Cuenta Corriente:
- 111757/001
- Operativa:
- 64665
- Retiros:
- Calle y Número: Bacacay 2001
- Ciudad: Caba
- Provincia: Buenos Aires
- Código Postal: 1406
- Franja horaria de retiro: De 08:00 a 17:00 hs
- Sort Order: Use system value
Carga de Operativas
Después de configurar el módulo, ve a Menu -> Oca TRACKEPAK -> Operativas
y carga todas las operativas provistas por OCA. Estas operativas se utilizarán para crear las guías y calcular los precios de envío en el checkout.
Configuración de Productos
Para calcular los precios de envío correctamente, asegúrate de que todos los productos de la tienda tengan las dimensiones cargadas. OCA utiliza los campos personalizados: Oca Alto, Oca Ancho, Oca Largo
y el peso (campo por defecto en Magento).
Gestión de Envíos
- Impactar una Guía:
- Si un cliente selecciona un servicio de OCA en el checkout, las compras
aparecerán en
Menu -> Oca TRACKEPAK -> Envios
. - Desde aquí, podrás impactarlas en lote, imprimir etiquetas, solicitar cancelaciones, ver seguimientos y especificar los bultos reales que contiene el envío.
- Historial de Peticiones:
- En Menu -> Oca TRACKEPAK -> Historial de Peticiones encontrarás toda la comunicación con OCA y tu tienda de Magento, incluyendo consultas de precios, impacto de guías y creación de etiquetas.
Errores Frecuentes
- No Aparece OCA en el Checkout:
- Verifica que el módulo esté habilitado.
- Asegúrate de tener operativas cargadas.
- Los productos deben tener sus dimensiones cargadas.
- La dirección de envío debe estar completa, especialmente el Código Postal.
- No Puedo Impactar una Guía:
- Verifica que haya stock válido para los productos en la orden.
- Asegúrate de tener un centro de imposición válido para la operativa seleccionada.