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.

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 el documento debe ser impreso en una impresora térmica conectada a en un puerto específico. Ejemplo: LPT1:
  • '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: '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 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

  1. Descargar e instalar .NET Core Runtime 3.1.x
  2. Descargar e instalar el archivo que corresponda según su plataforma:
  3. Descargar e instalar Servidor Local SuperFactura.
  4. Ingresar con su cuenta y contraseña de SuperFactura.

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 la cantidad y montos totales de boletas electrónicas (resumen de operaciones con boletas) es inconsistente con la información que maneja el mismo SII, y que puede ser revisada en la opción de Consulta Reporte Consumo de Folios en la página del SII.

Se les recomienda que, al momento de declarar el F29,  revisen que la información propuesta sea consistente con la información entregada por SuperFactura acá:
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 deberá corregirlas manualmente, es decir, ingresando los valores correctos en el “Resumen Registro de Ventas” del Registro de Compras y Ventas del SII.

Se les recuerda que, en general, el SII no se hace responsable por estos errores y que el contribuyente siempre debe revisar la información que declara.

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.