Integración de WooCommerce con Boleta Electrónica

SuperFactura ofrece gratis la integración de su sitio WooCommerce con Boleta Electrónica.

Para más información, por favor, contactar a contacto@superfactura.cl.

Configuración via WebHook

  1. Ingrese al panel de administración de WooCommerce
  2. Ingrese al menú WooCommerce > Ajustes > Avanzado > WebHooks
  3. Cree un WebHook con los siguientes datos:
    • Nombre: SuperFactura
    • Tema: Pedido actualizado (u “orden actualizada” según versión).
    • Versión API: WP REST API v3
    • Webhook: <url entregada por SuperFactura>
    • Secret: <token entregado por SuperFactura>

Impresión con Impresoras Térmicas

Generalmente las impresoras térmicas se pueden compartir en red y asociar a un puerto virtual LPT1:  para así facilitar la impresión mediante codigos Esc/Pos, lo cual ofrece una calidad y velocidad de impresión muy superior a la impresión en modo gráfico de las muestras impresas en formato PDF.

Para impresión con impresoras de inyección de tinta, ver aquí.

Configuración

  1. Instale la impresora con los drivers del proveedor y realice una prueba de impresión genérica para asegurar que la impresora opera correctamente.
  2. Comparta la impresora en red: En [Printer Properties > Sharing] marque la casilla “Share this printer” y asigne un nombre de red a la impresora.
  3. Abra una interfaz de comandos  (ejecute “cmd.exe”) en el computador desde el cual se ejecuta la API de SuperFactura.
  4. Ingrese el siguiente comando con el nombre de red de la impresora.
    NET USE LPT1 \\computador\impresora /PERSISTENT:YES
  5. Realice una prueba ejecutando el comando:
    echo "Test" > LPT1:

Impresión via API

La API de SuperFactura permite imprimir los documentos directamente a la impresora térmica y ofrece además soporte para todas las impresoras térmicas del mercado compatibles con EscPos.

Opciones de Impresión

La API de SuperFactura ofrece las siguientes opciones adicionales para imprimir directamente los documentos a una impresora térmica:

  • 'printer' : Indica que se debe imprimir a una impresora térmica conectada en un puerto específico. Siempre se debe indicar el puerto virtual “LPT1:” y no el puerto USB de la impresora.
  • 'model' : Indica el modelo de la impresora térmica permitiendo generar códigos y formatos Esc/Pos específicos según cada modelo de impresora. Ejemplos: 'default', 'rpt-005', 'xp-n160ii', ‘zj-5809k‘, etc. SuperFactura soportará, dentro de lo posible, todos los modelos de impresoras compatibles con Esc/Pos.
  • 'copias' : Indica el número de copias originales que deben ser impresas. Por defecto, se asume 1.
  • 'cedible' : Indica el número de copias cedibles que deben ser impresas. Por defecto, se incluirá una copia cedible para los documentos que corresponda.

Ejemplos de Uso

Acá encontrará ejemplos de uso para 1) imprimir los documentos con impresoras térmicas y 2) operar con el servicio offline (se pasa la opción "url" con la dirección y puerto del servidor local, que generalmente será “http://127.0.0.1:9080“).

Impresión via Web

Si se requiere imprimir desde una aplicación web a una impresora térmica instalada en el PC del usuario, se recomienda hacer lo siguiente:

  1. Ejecutar la API en el servidor con la opción “getEscPos” para obtener el archivo de impresión en formato ESC/POS.
  2. En su aplicación web, colocar un botón “Print” que permita descargar ese archivo con una extensión especial (por ejemplo, “doc.prn”).
  3. Asociar los archivos “.prn” para que se impriman al ser abiertos:
    • En el PC del usuario, descargar y descomprimir el archivo print.bat y dejarlo en alguna carpeta que no sea eliminada accidentalmente por los usuarios.
    • En el explorador de Windows, abrir el archivo “doc.prn” con el menú derecho y la opción “Open With”
    • Seleccionar la opción “More Apps”
    • Seleccionar la opción “Look for another app on this PC”
    • Seleccionar el archivo “print.bat”
  4. Así, la próxima vez que el navegador descargue un archivo .prn desde la web, este se abrirá con el comando print.bat que se encargará de enviarlo a la impresora en LPT1.

Ficha del Contribuyente

La ficha del contribuyente es el formulario en el cual se administran todos los datos del contribuyente en SuperFactura.

Para acceder a la ficha del contribuyente, debe:

  1. Ingresar a: https://superfactura.cl/content/mis-contribuyentes
  2. Presionar el botón  que se encuentra al lado derecho del listado. Si no se ve en pantalla, debe mover la barra de desplazamiento que se encuentra en la parte inferior del listado.
  3. Tras modificar la ficha del contribuyente, debe presionar el botón “Aceptar” que se encuentra al final del formulario.

Servicio Offline para Puntos de Venta

En el caso de puntos de venta que realizan ventas en forma presencial con impresoras térmicas, se recomienda el uso del “Servicio Offline” de SuperFactura.

El “Servicio Offline” consiste en un Software “Servidor Local” que se instala en el mismo computador del punto de venta y que permite seguir emitiendo documentos incluso cuando no hay conexión a Internet.

Además, este Software incluye soporte para casi todos los modelos de impresoras térmicas, a través de impresión directa mediante códigos Esc/Pos, lo cual ofrece una velocidad y calidad de impresión muy superior a la impresión en forma gráfica de documentos PDF.

Si bien el servicio opera en forma offline, será necesario que el software tenga acceso a Internet para enviar los documentos al SII idealmente una hora después de emitir un documento, o como mínimo, antes de las 12:00 PM del día siguiente para efectos de poder enviar el RCOF al SII, y además para descargar nuevos timbrajes del SII.

Para la integración con el “Servicio Offline”, se utiliza la misma API de SuperFactura utilizada también para la operación online.

Para más información de esta solución ver el brochure aquí.

Instalación del Servidor Local

  1. Descargar e instalar .NET Core Runtime 3.1.x
  2. Descargar e instalar VC Runtime
  3. Descargar e instalar Servidor Local SuperFactura
  4. Ingresar con su cuenta y contraseña de SuperFactura

Uso de la API

Para generar documentos usando el servidor local, debe agregar a su Software la siguiente linea:

api.url = "http://localhost:9080"

Ver ejemplos de uso aquí.

Error en Propuesta F29 del SII

Se ha detectado que el SII está entregando valores propuestos incorrectos para las operaciones con boletas electrónicas en la declaración F29 desde el periodo de julio 2020.

La información de las boletas electrónicas (“resumen de operaciones con boletas”) es inconsistente con la información que maneja el mismo SII en la Consulta Reporte Consumo de Folios en la página del SII y que supuestamente es utilizada por el SII para elaborar la propuesta del F29.

Los Reportes de Consumo de Folios son informados al SII por SuperFactura. Para revisar los Reportes de Consumo de Folios enviados al SII y comparar esta información con la almacenada en SuperFactura, puede utilizar el reporte Resumen de Ventas Diarias.

Se les recomienda que, al momento de declarar el F29,  revisen que la información propuesta de las ventas sea consistente con el libro de ventas generado por SuperFactura en https://superfactura.cl/content/enviar-libros.

Al final de esta misma página encontrará un botón “Enviar Libro” que permite solucionar el problema sobrescribiendo los valores propuestos por el SII.

Si esto no soluciona el problema, entonces puede corregir la información manualmente, ingresando los valores correctos en el “Resumen Registro de Ventas” del Registro de Compras y Ventas del SII.

Finalmente, aprovechamos de recordar que, para documentos emitidos, la información oficial es la que maneja SuperFactura. En cambio, para documentos recibidos, la información oficial es la que maneja el SII en el Registro de Compras y Ventas, ya que los proveedores no siempre envían los DTE a la casilla de intercambio.

En caso de consultas sobre este artículo, sugerimos enviarlas a soporte@superfactura.cl con copia al 1) administrador de la empresa y 2) contador de la empresa.