Documentación

1. Requisitos Previos

1.1 Correos de Costa Rica

Si usted desea utilizar Mojito Shipping para realizar envíos por medio de Correos de Costa Rica primero debe estar registrado en Pymexpress.

Puede llamar al teléfono de Correos de Costa Rica +506 2202-2992, extensión 4335.

También existe un formulario web de registro en dirección: https://comercioelectronico.correos.go.cr/vende-por-internet/

Una vez que lo hayan registrado como cliente en Pymexpress, debe solicitar el acceso al Web Service, para esto debe pedir los datos de integración.

Correos de Costa Rica le enviará un PDF con detalles técnicos. Lo necesario para configurar Mojito Shipping lo podrá encontrar en la página 4, estos datos son:

  • URL de consulta
  • User
  • Pass
  • Usuario id
  • Tipo de cliente
  • Servicio id
  • Código de cliente

1.2 Prepare su Tienda

Su tienda WordPress debe tener instalado y configurado el plugin WooCommerce, además debe tener instalado el plugin WC Provincia Canton Distrito

2. Instalación

Instale Mojito Shipping desde el escritorio de su WordPress en la opción Plugins > Añadir nuevo.

Si lo desea, también puede descargar el archivo zip desde el repositorio de WordPress: https://downloads.wordpress.org/plugin/mojito-shipping.zip

3. Configuración

3.1 Active el método (portador) de Correos de Costa Rica

Desde el Escritorio de su WordPress, acceda a la opción Ajustes > Mojito Shipping, seleccione la opción “Correos de Costa Rica” en las pestaña “General”.

Seguido haga clic en el botón “Guardar”.

Ahora podrá ver un tab en la parte superior con el título “Correos de Costa Rica”

3.2 Configuración de su negocio

En ésta sección debe indicar:

  • Ubicación de su negocio
  • Servicio de envío dentro de Costa Rica
  • Servicio de envío fuera de Costa Rica (PRO)
  • Excepción de IVA (PRO)

3.3 Configuraciones del Web Service

Llene la sección “Configuraciones del Web Service” con los siguientes datos:

  • URL de consulta
  • User
  • Pass
  • Usuario id
  • Tipo de cliente
  • Servicio id
  • Código de cliente

Estos datos están en el archivo PDF que Correos de Costa Rica debió enviarle.

3.4 Configuraciones del remitente

Llene los datos de remitente de su negocio:

  • Nombre
  • Dirección
  • Código postal
  • Teléfono

Si no conoce su código postal puede usar el servicio de Correos de Costa Rica: https://correos.go.cr/codigo-postal/

3.5 Mensaje en correo de pedidos

Configure tanto la etiqueta como el mensaje:

3.6 Montos mínimos y redondeo

En ésta sección podrá configurar Mojito Shipping para que cobre un monto mínimo y redondee el costo final del envío.

Las opciones que puede configurar son:

  • Redondear el monto final (PRO)
  • Habilitar montos mínimos
  • Monto mínimo general
  • Monto mínimo para envío dentro del GAM (PRO)
  • Monto mínimo para envío fuera del GAM (PRO)
  • Monto mínimo para envío internacional (PRO)

3.7 Tarifas fijas

Usted podrá establecer un costo fijo para los envíos dentro o fuera del GAM. Importante: Esto sobrescribiría cualquier otro cálculo de tarifa de envío.

3.8 Tipo de Cambio

Si su tienda vende en dólares podrá activar la conversión automática de tipo de cambio

3.9 Ajustes de peso máximo

Esta opción le permitirá inhabilitar el método de envío de Correos de Costa Rica si el peso máximo del pedido supera los 30kg (máximo permitido por Correos de Costa Rica por paquete)

3.10 Ajustes de Conexión Proxy

Correos de Costa Rica usa los puertos 82 (pruebas) y 88 (producción), si su proveedor de hospedaje no puede abrir estos puertos entonces deberá usar una Conexión Proxy.

3.11 Conexión Proxy de Mojito (PRO)

Esta opción le permite resolver la conexión con Correos de Costa Rica en los siguientes casos:

  • Si su proveedor de hosting no puede abrir los puertos 82 y 88.
  • Si usted necesita un Proxy pero no cuenta con uno.
  • Si la conexión con Correos de Costa Rica le retorna errores como:
    • Something happened: SOAP-ERROR: Parsing WSDL: Couldn’t load from …
    • Error in service query: SOAP-ERROR: Parsing WSDL: Couldn’t load from …

Para utilizar el Proxy provisto por Mojito escríbanos a support@mojitowp.com con la dirección IP de su sitio web y le habilitaremos el acceso.

3.12 Mostrar Logo de Correos de Costa Rica (PRO)

Esta opción permite que se muestre el logo de Correos de Costa Rica en el carrito y página de pago.

3.13 Mostrar Detalles de Seguimiento (PRO)

Esta opción permite al usuario (comprador) y/o al administrador ver el seguimiento del paquete reportado por Correos de Costa Rica.

3.14 Exportar PDF (PRO)

Configuración para exportar datos de pedidos y número de guía en PDF

3.15 Configuración de etiqueta

Esta opción le permite establecer una etiqueta personalizada para el Carrito y la Página de pago.

3.16 Filtros disponibles

‘mojito_shipping_checkout_custom_rate’

Permite modificar la etiqueta y el costo final de envío.

Parámetros: array $rate, array $filter_params

add_filter('mojito_shipping_checkout_custom_rate', function( $rate, $filter_params ) {
          
	// Cambiar texto
	$label = 'Correos de Costa Rica: ' . $filter_params['carrier_name'] . ': ';
	$label .= 'Tiempo estimado de envío 2 a 4 días hábiles, ';
	$label .= 'peso total: ' . $filter_params['shipping_weight'] . ' gramos';

	// Cambiar costo de envío
	$new_shipping_cost = $rate['cost'] + 1500; // Costo de envio + 1500 colones

	$rate['label'] = $label;
	$rate['cost']  = $new_shipping_cost;

	return $rate;

}, 10, 2);

‘mojito_shipping_ccr_strict_shipping_weight’

Dado que Correos de Costa Rica cobra cada 1000 gramos (cada kilo) entonces desde la versión 1.1.19 se hace redondeo cada 1000 gramos.

ejemplo: 1350 gramos pasa a ser 2000 gramos.

Este filtro permite inhabilitar esta característica:

// Con este filtro 1350 gramos se calcularán como 1350 gramos y no como 2000 gramos.
add_filter( 'mojito_shipping_ccr_strict_shipping_weight', function() {
	return false;
});

‘mojito_shipping_custom_iva’ (PRO)

Permite modificar el porcentaje de IVA que se aplica a la tarifa de envío. El porcentaje predeterminado es 13%

Parámetro: int $iva_perc

// Establecer 4% de IVA
add_filter('mojito_shipping_custom_iva', function( $iva_perc ) {
	return 4;
}, 10, 1);

‘mojito_shipping_ccr_logo_src’ (PRO)

Permite establecer un logo personalizado para Correos de Costa Rica.

Parámetro: string $logo_src

add_filter('mojito_shipping_ccr_logo_src', function( $logo_src ){
	return 'https://my.custom.domain/new-logo.png';
});

‘mojito_shipping_ccr_pdf_custom_header’ (PRO)

Permite agregar información al encabezado del archivo PDF exportado. Admite HTML.

Parámetro: array $data

$data[‘content’] Contenido personalizado

$data[‘position’] Ubicación horizontal, permite L (left), C (center), R (right)

add_filter('mojito_shipping_ccr_pdf_custom_header', function( $data ){
	$data['content'] = '<h1>Custom Header</h1>';
	$data['position'] = 'R';
	return $data;
});

‘mojito_shipping_ccr_pdf_after_barcode’ (PRO)

Permite agregar información justo después del código de barras en el archivo PDF exportado. Admite HTML.

Parámetro: array $data

$data[‘content’] Contenido personalizado

$data[‘position’] Ubicación horizontal, permite L (left), C (center), R (right)

add_filter('mojito_shipping_ccr_pdf_after_barcode', function( $data ){
	$data['content'] = '<h1>After Barcode</h1>';
	$data['position'] = 'C';
	return $data;
});

‘mojito_shipping_ccr_pdf_after_sender_data’ (PRO)

Permite agregar información justo después de la información del remitente en el archivo PDF exportado. Admite HTML.

Parámetro: array $data

$data[‘content’] Contenido personalizado

$data[‘position’] Ubicación horizontal, permite L (left), C (center), R (right)

add_filter('mojito_shipping_ccr_pdf_after_sender_data', function( $data ){
	$data['content'] = '<h1>After Sender Data</h1>';
	$data['position'] = 'C';
	return $data;
});

‘mojito_shipping_ccr_pdf_after_recipient_data’ (PRO)

Permite agregar información justo después del la información del destinatario en el archivo PDF exportado. Admite HTML.

Parámetro: array $data

$data[‘content’] Contenido personalizado

$data[‘position’] Ubicación horizontal, permite L (left), C (center), R (right)

add_filter('mojito_shipping_ccr_pdf_after_recipient_data', function( $data ){
	$data['content'] = '<h1>After Recipient Data</h1>';
	$data['position'] = 'C';
	return $data;
});

‘mojito_shipping_ccr_pdf_after_package_data’ (Obsoleto)

Use ‘mojito_shipping_ccr_pdf_after_client_notes’ en su lugar.

‘mojito_shipping_ccr_pdf_after_client_notes’ (PRO)

Permite agregar información justo después de la información del pedido en el archivo PDF exportado. Admite HTML.

Parámetro: array $data

$data[‘content’] Contenido personalizado

$data[‘position’] Ubicación horizontal, permite L (left), C (center), R (right)

add_filter('mojito_shipping_ccr_pdf_after_package_data', function( $data ){
	$data['content'] = '<h1>After Package Data</h1>';
	$data['position'] = 'C';
	return $data;
});

‘mojito_shipping_ccr_pdf_after_package_content’ (PRO)

Permite agregar información justo después de la información del contenido del paquete en el archivo PDF exportado. Admite HTML.

add_filter('mojito_shipping_ccr_pdf_after_package_content', function( $data ){
	$data['content'] = '<h1>After Package Content</h1>';
	$data['position'] = 'C';
	return $data;
});

‘mojito_shipping_ccr_pdf_ccr_logo_src’ (PRO)

Permite establecer el logo personalizado de Correos de Costa Rica mediante una URL en el archivo PDF exportado.

Parámetro: string $url

add_filter('mojito_shipping_ccr_pdf_ccr_logo_src', function( $url ){	
	return 'https://my.custom.domain/new-logo.png';
});

‘mojito_shipping_ccr_pdf_site_logo_src’ (PRO)

Permite establecer el logo personalizado de la tienda mediante una URL en el archivo PDF exportado.

Parámetro: string $url

add_filter('mojito_shipping_ccr_pdf_site_logo_src', function( $url ){	
	return 'https://my.custom.domain/new-logo.png';
});

4. Zonas de envío

Una vez lista la configuración de Mojito Shipping con Correos de Costa Rica, debe ir a WooCommerce > Ajustes > Envios > Zonas de envío

Aquí debe seleccionar las zonas de envío en las que desea vender.

Agrega las que desee y a cada una debe colocarle un “método de envío”, aquí debe seleccionar “Mojito Shipping: Correos de Costa Rica”

5. Problemas conocidos

5.1 Error de conexión con Correos de Costa Rica

Síntomas: Si la conexión con Costa Rica le retorna errores como:

  • Something happened: SOAP-ERROR: Parsing WSDL: Couldn’t load from …
  • Error in service query: SOAP-ERROR: Parsing WSDL: Couldn’t load from …

Soluciones:

  1. Solicitar a Correos de Costa Rica que agregue la dirección IP de su página a la “Lista Blanca”
  2. Solicitar a su proveedor de hospedaje que abra los puertos 82 y 88 hacía las direcciones IP de Correos de Costa Rica
  3. Habilite la configuración Proxy dentro de las opciones de Mojito, ésta opción requiere que usted cuente con un servidor Proxy.
  4. Habilite la opción “Mojito Proxy” (PRO)

5.2 Problemas con el plugin WC Provincia Cantón Distrito

Síntomas: A la hora de selecionar la provincia, cantón y distrito los campos del formulario no se actualizan.

Soluciones: Puede probar agregando uno de los siguientes códigos a su Child Theme:


add_action( 'wp_enqueue_scripts', function(){

	$WCPCD_DIR = plugin_dir_url( 'wc-provincia-canton-distrito/wc-prov-cant-dist.php' );
        $WCPCD_JSON = $WCPCD_DIR . 'assets/js/prov-cant-dist.json';
	
	$json = json_decode( wp_remote_fopen( $WCPCD_JSON , true) );
	
	wp_enqueue_script( 'custom-wcpcd-script', $WCPCD_DIR . 'assets/js/prov-cant-dist.min.js', array('jquery'), '1.1', true);

	wp_localize_script(
		'custom-wcpcd-script',
		'wcpcd_ajax',
		array(
			'ajax_url' => admin_url('admin-ajax.php'),
			'city_first_option' => apply_filters( 'wcpcd_city_field_placeholder', __('Choose a city', 'wc-prov-cant-dist')),
			'json' => $json
		)
	);
});

add_filter( 'wcpcd_get_provincia_canton_distrito', function() {

	$WCPCD_DIR  = ABSPATH . 'wp-content/plugins/wc-provincia-canton-distrito/';
	$WCPCD_JSON = $WCPCD_DIR . 'assets/js/prov-cant-dist.json';

	$json = json_decode( file_get_contents ( $WCPCD_JSON ), true );

	return $json;

}, 10, 1 );