Comenzar una conversación

Instalación de plugin de factura.com para Magento

Magento es una solución de comercio electrónico de código abierto, que ofrece a todos los comerciantes y dueños de negocios online, un sistema de carrito de compras flexible, además de un control total sobre cada aspecto, contenido y  funcionalidad de la tienda en línea.

Magento ofrece un catálogo bastante extenso de herramientas para la administración, el marketing y la optimización de motores de búsqueda, por lo tanto se le considera como una de las mejores plataformas Ecommerce disponibles actualmente.

Además, la capacidad de Magento permite escalar tiendas a partir de solo unos pocos productos y necesidades simples hasta expandir fácilmente a decenas de miles de productos sin tener qué cambiar de plataforma y ofrece una variedad importante de temas y plugins que permiten mejorar significativamente la experiencia del cliente.


ACERCA DEL MÓDULO DE FACTURACIÓN DE FACTURA.COM

La extensión de Factura.com proporciona integración con la plataforma de Factura.com incluyendo las siguientes funciones:

  • Reporte de facturas creadas en el panel de administración.
  • Descargar PDF de facturas para consulta desde el panel de administración.
  • Funcionalidad para que los clientes creen facturas directamente desde el área de clientes.

Este módulo es compatible con Magento CE desde la versión 1.7.0 hasta la versión 1.9.3, aún no es compatible con la versión 2 de Magento CE ni otras versiones de Magneto.

LINK PARA DESCARGA


INSTALACIÓN DEL MÓDULO

Para instalar el Módulo, es necesario descargar el código del repositorio en Github de
Factura.com como archivo .zip.


             

Descomprimir archivo .zip y cargar las carpetas app y skin en la carpeta raíz de la instalación de Magento.


Posteriormente borrar la caché de Magento en el menú Sistema > Gestión de Caché en el administrador de Magento para borrar la caché del sistema y actualizar el registro de extensiones instaladas.


En este menú hacer clic en el botón Flush Magento Cache.


Así se actualizará automáticamente el Módulo. En algunos casos hará falta cerrar sesión y volver a entrar al administrador.


ÁREA DE ADMINISTRACIÓN

En el menú desplegable Ventas estará el menú Facturación que es el acceso al administrador del Módulo de factura.com, hacer clic en esta opción para acceder.

A continuación se muestra el listado de las facturas generadas por los clientes
mediante el módulo. Esta lista muestra solamente los datos ID, Order No, Invoice No
y Estatus.


En la parte superior derecha se encuentra el botón Configuración que es el acceso a
la configuración del módulo. Hacer clic en este botón para configurar el módulo.

Dentro de esta configuración se encuentra un formulario con los campos necesarios
para el funcionamiento del módulo. Los campos son los siguientes:

Sandbox mode:

Marcar esta opción para activar el ambiente de desarrollo del módulo. Las facturas que se creen con esta opción activada no serán válidas.

Api Key

Este dato se obtiene en el administrador de Factura.com y sirve para conectarse con la API de Factura.com.

Secret Key

Este dato también se obtiene de Factura.com y sirve para conectarse con la API. Junto con la Api Key forma de la acreditación de tu cuenta.

Serie
Es la serie con la que se crearán las facturas. Esta serie se crea en Factura.com previamente, por lo que antes de seleccionarla deberás guardar los demás datos (API KEY y SECRET KEY).
Moneda
La moneda con la que se crearán las facturas. Esta es la moneda en la que vende tu tienda en línea.
Uso de CFDI
Este dato se refiere al uso de comprobantes fiscales, viene del catálogo del SAT. Selecciona el que se adecúe a tu negocio.
Días de tolerancia
Por defecto, el sistema no permite facturar pedidos de meses anteriores al actual, sin
embargo, se puede configurar el número de días de tolerancia después de mes de compra para la facturación.
Fecha de activación
Este dato se especifica para establecer una fecha a partir de la cual se tiene permitido facturar y así prevenir la facturación de pedidos previos a la instalación del módulo.
Título del widget
Este campo se refiere al título o leyenda en la pantalla que verá el cliente.
Descripción del widget
Aquí se puede agregar una descripción para la sección.
Color de fondo del header del widget
Este es el color de fondo del encabezado del widget o formulario de facturación. Se
puede configurar con los colores acorde al diseño de su página web.
 1forge Api Key
Si en su configuración selecciona una moneda diferente a Peso Mexicano (MXN), el
módulo hará una consulta al servicio de 1forge para obtener el tipo de cambio actual y
enviarlo al crear la factura, por lo tanto deberás registrarte en su sitio y obtener esta
API KEY (ver sección Obtener API KEY de 1forge).
Nota: si en la configuración seleccionas Peso Mexicano no tendrás qué guardar este
dato, ni registrarte en 1forge.
Configuración de impuestos - Activar IEPS
Marca esta opción para activar el cálculo de IEPS de tus ventas, esta configuración es
requerida si tus productos llevan este impuesto.
Configuración de impuestos - Porcentaje de IEPS
Aquí se especifica el porcentaje de impuesto IEPS que llevan tus productos. Ingresa un
número entero, por ejemplo 3 para aplicar el 3% de IEPS sobre el costo de tu
producto.
Después de terminar de configurar el módulo, hacer clic en el botón Guardar
configuración en la pate superior derecha para guardar los cambios realizados. Los
campos obligatorios están marcados con un asterisco (*) en color rojo.


Adicionalmente a esta configuración, el módulo requiere algunas configuraciones extra
en tu sistema, éstas son la configuración de Impuestos y la configuración de los
nuevos Atributos de producto que son necesarios para el funcionamiento del módulo.


CONFIGURACIÓN DE IMPUESTOS
Lo primero que se tiene qué hacer es crear la Clase de Impuesto para los productos, Tasa de Impuesto y la Regla.

Para esto vamos al menú Sales > Tax > Product Tax Classes para crear la clase.

La Clase de Impuesto es sólo un identificador para aplicarlo a los productos, es
simplemente para conocer qué impuestos aplicamos a los productos. Si lo deseas
puedes usar la clase que ya viene predeterminada en Magento Taxable Goods o
puedes crear una nueva.



Sólo tendrás que hacer clic en el botón Add New y agregar el nombre de la clase y
hacer clic en el botón Save Class para guardar la configuración.

Posteriormente ir al menú Sales > Tax > Manage Tax Zones & Rates para agregar la
Tasas e Impuestos.

En esta sección haz clic en el botón Add New para agregar una nueva Tasa; esto te llevará a un formulario donde podrás crear la nueva Tasa de Impuesto.

En este formulario verás los campos:

Tax Identifier: Identificador que le darás a esta Tasa de Impuesto. (Puedes llamarlo MX).
Country: País de compra en el que aplicará este impuesto (Selecciona México).
State: Estado en el que se aplicará (puedes seleccionar * para que aplique a todos.

• Zip/Post is Range: Si el Impuesto aplica para un rango de códigos postales,
selecciona que YES, por el contrario selecciona NO.
• Zip/Post Code: Código postal al que aplicará este Impuesto (escríbe * para que
aplique a todos los códigos postals).
• Rate Percent: Porcentaje de Impuesto que se aplicará (escribe 16 para aplicar el
16% de IVA).

Después de ingresar la información haz clic en el botón Save Rate para guardar la
configuración.

Después de tener la Clase y la Tasa, vamos a crear la Regla para el nuevo Impuesto.
Para esto vamos al menú Sales > Tax > Manage Tax Rules y hacer clic en el botón Add New Tax Rule para crear una nueva Regla.

Aquí veremos un formulario con las siguientes opciones para configurar la Regla.

Name: es el nombre de la regla (puedes ponerle IVA).

 Customer Tax Class: Es la clase para los clientes, aquí puedes seleccionar Retail Customer para aplicar el Impuesto a todos los clientes.

• Product Tax Class: Esta es la clase que tendrán los productos para aplicarles el
Impuesto. (Puedes seleccionar la clase que creaste previamente, o seleccionar la predeterminada Taxable Goods).

Tax Rate: La Tasa de Impuesto que se aplicará a esta Regla (selecciona la que creaste previamente para el IVA).

Priority: Si hay más de una Regla en el sistema, esta opción permite darle prioridad (selecciona 0 para que esta Regla tenga la mayor prioridad).

Calculate off subtotal only: Esta opción es para para calcular los impuestos en el subtotal solamente (no marques esta opción para que cada producto tenga un calculo por separado).

 Sort Order: Al igual que la prioridad, las Reglas se ordena en base a este parámetro, selecciona 1 para que sea la primer Regla.

Al terminar haz clic en el botón Save Rule para guardar la configuración.


Con esto ya tenemos creado el Impuesto para los productos, ahora vamos a configurar cómo Magento muestra estos impuestos al cliente. Para esto vamos al menú System > Configuration y posteriormente en la barra lateral de la izquierda buscamos la opción Sales > Tax para acceder a la configuración de los Impuestos.


En esta sección configuramos cómo se muestran los Impuestos en la tienda en línea. Esta parte es importante tanto para el cliente como para el módulo de facturación, se recomienda configurar como se indica a continuación.

En el primer bloque vemos la opción Tax Class for Shipping, esta opción se refiere a la Clase de Impuesto que se le aplicará al envío. Los envíos en la factura se manejan como un producto o concepto más, por lo que es necesario calcular el IVA de estos. Selecciona Taxable Goods (o la clase que hayas aplicado a los productos).


En el segundo bloque tenemos los cálculos de los Impuestos, como primera opción vemos Tax Calculation Method Based On, esto se refiere al método para calcular los Impuestos, seleccionamos Unit Price para que se aplique al precio base del producto.

La opción Tax Calculation Based On es la forma en que se aplica la Regla, seleccionamos Shipping Address para que aplique los impuestos en base al país (México) en el que se hizo la compra.

Catalog Prices se refiere a cómo el administrador estableció los precios de los productos. Selecciona Including Tax si tus productos ya tienen el IVA incluido, de lo contrario selecciona Excluding Tax para que no tengas qué actualizar los precios de los productos. (Se recomienda Including Tax para que sea más fácil para ti manejar tus productos).

En Shipping Prices selecciona Including Tax si el precio de envío ya incluye el IVA. De lo contrario selecciona Excluding Tax.

En Apply Customer Tax selecciona After Discount para aplicar el IVA después de los descuentos, ya que así es como se manejan los descuentos en la facturación.

En la opción Apply Discount On Prices selecciona Excluding Tax para que al descuento no se le aplique IVA.

En algunas ocasiones puedes modificar los precios para algún cliente en especial, si es así, en la opción Apply Tax On selecciona Custom price if available.

La última opción de este bloque es Enable Cross Border Trade, se refiere a aplicar
impuestos para clientes de otros países. Selecciona Yes si así lo crees conveniente.

En el bloque Default Tax Destination Calculation se configura el país para el que se
aplicarán los impuestos. Selecciona México, Todos los estados (*) y Todos los
códigos postales (*).


El bloque Price Display Settings es para mostrar los impuestos en el catálogo.

Aquí selecciona Including Tax para ambas opciones: Display Product Prices In Catalog y Display Shipping Prices. Esto para no confundir a tus clientes. Si lo deseas puedes mostrarlos Excluding Tax, esto es sólo una recomendación.


El siguiente bloque es Shopping Cart Display Settings, aquí se configura cómo se muestran los precios en el carrito de compras.

Puedes seleccionar Including Tax o Excluding Tax, acorde a cómo quieras mostrar los impuestos en el carrito.

Pasa lo mismo con el bloque Orders, Invoices, Credit Memos Display Settings, selecciona la opción que prefieras. Se recomienda seleccionar Including Tax para mejor claridad al cliente.


El último bloque es Fixed Product Taxes y se refiere a impuestos fijos. Esta configuración no es recomendable, ya que en México no se utilizan. Configura como se muestra en la imagen.


CONFIGURACIÓN DE PRODUCTO
Para que el módulo trabaje acorde a la facturación CFDI 3.3 se han creado algunos atributos nuevos en los productos, además de aplicar los impuestos a los productos.

Para esto vamos al menú Catalog > Manage Products para configurar estas opciones.



Primero configuramos los impuestos y precios del producto. En el menú Prices de la barra lateral izquierda seleccionamos Taxable Goods (o la Clase que diste de alta
previamente) en la opción Tax Class.

Esto hará que el precio cambie, porque separa el Impuesto del precio que has dado de
alta. Es un comportamiento normal. Ajusta el precio si lo crees necesario.


Ahora volvemos a la pestaña General de la barra lateral izquierda para configurar los atributos nuevos, necesarios para crear las facturas.

Al final de las opciones verás 4 atributos nuevos, estos son:

• Clave Producto/Servicio (SAT)
Se refiere a la clave del producto que viene del catálogo del SAT. Este dato lo puedes obtener buscando en el panel de factura.com donde das de alta los productos o directamente en el catálogo del SAT.

• Aplicar IEPS a este producto

En ocasiones puede que a algunos productos no tengan IEPS, mientras que otros sí. Para esto selecciona Yes/No acorde al escenario que consideres.

Es importante que marques la opción de IEPS de la Configuración general para que
esta configuración sea efectiva.

• Clave Unidad (SAT)
Esta es la Clave de Unidad del catalogo del SAT.Este dato también lo puedes obtener en el panel de factura.com o directamente del catálogo el SAT.

• Unidad de Servicio (SAT)
Este es el texto del catálogo del SAT que se refiere a la Unidad de Servicio de tu producto (por ejemplo Pieza).

Después de configurar estos datos, haz clic en el botón Save para guardar la configuración.



ÁREA DE FRONT END - CLIENTES

Este módulo tiene la capacidad de facturar los pedidos realizados desde el área de clientes, es decir, sus clientes podrán crear las facturas de los pedidos automáticamente.

Para esto se deberá configurar una opción en el menú o en cualquier otra sección del sitio con la dirección dominio.com/facturacion, esta opción actualmente no es configurable.

En esta sección aparecerá el mensaje y el titulo de la sección que se configuró previamente en la sección de configuración del módulo.

El cliente deberá ingresar los datos referentes a su pedido en la tienda en línea y su RFC. El número de pedido y el correo electrónico son obligatorios para verificar la existencia del pedido en la tienda en línea. Si el correo electrónico no coincide con el pedido, mostrará un mensaje indicando el error.


Si el pedido ya se encuentra facturado, mostrará el mensaje correspondiente y botones de descarga de la factura, uno para formato PDF y otro para XML.

El RFC será buscado en la plataforma de Factura.com y si este se encuentra registrado autocompletará el formulario del segundo paso en el flujo de facturación, es decir, completará la información de contacto e información fiscal, permitiendo que el usuario pueda editar la información.

De lo contrario, el usuario tendrá qué completar el formulario con su información.

En esta actualización se agrega el campo Número de Registro de Identificación Fiscal que es obligatorio si el cliente a facturar es del extranjero. Este campo se mostrará al final del resto de la información sólo si el País seleccionado es diferente a México.

En el tercer paso, el cliente visualizará el contenido de la factura, es decir, los datos del
Emisor, datos del Receptor, Conceptos y Totales. Esto es sólo un preview de la factura.

El cliente deberá seleccionar el método y la forma de pago, los cuales son datos obligatorios por el SAT para generar la factura.

Después de seleccionado el método y la forma de pago, deberá hacer clic en el botón
Generar Factura, el cual enviará la información a la plataforma de Factura.com para la
creación del CFDI.


Después de haber enviado la información, Factura.com creará la factura, enviándola por correo electrónico al cliente (correo especificado en el segundo paso) y mostrando un par de botones para descargar la factura en formatos PDF y XML.

ANEXO: CONFIGURACIÓN 1FORGE

Para la creación de la cuenta en 1Forge (API para Tipo de Cambio) es necesario seguir los siguientes pasos:

1.- Ir a la página https://1forge.com/forex-data-api   y hacer clic en el botón Client Area:


2.- Hacer clic en el enlace Create an account para crear una nueva cuenta:

3.- Completar el formulario con la información correspondiente. Aceptar los términos y
condiciones y hacer clic en el botón Register:


4.- A tu correo electrónico deberá llegar un correo de bienvenida, dentro de ese correo
viene el API KEY que necesitamos para la configuración:


5.- Copia ese API KEY e ingrésalo en la configuración del módulo de Factura.com en el
campo 1forge Api Key para que el módulo sea capaz de obtener el tipo de cambio
actual.


Ahora se encuentra completa la instalación
del plugin para tu tienda



Para cualquier duda en los pasos antes vistos comunicarse vía:

www.factura.com


Factura.com ® - Todos los derechos reservados
FACTURA PUNTO COM SAPI DE CV

Elegir archivos o arrastra y suelta los archivos
¿Te resulta útil?
No
  1. Francisco González N.

  2. Publicado

Comentarios

  1. Rodrigo Gonzalez

    Buen día, ya instalado y configurado el módulo en magento, en el paso 2/4 no permite seleccionar el país por lo cual no te permite continuar con los demás pasos