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.

Problemas con AntiVirus y API para DOS

Recientemente algunos usuarios que operan con Software integrado con la API SuperFactura para DOS, han reportado problemas ocasionados por su AntiVirus, tras lo cual el comando superfactura.exe entrega el siguiente mensaje de error:

cannot represent a stream of type RES as a STDIO FILE*

Este problema en algunos casos persiste incluso tras desactivar el AntiVirus y volver a copiar los archivos originales, siendo necesario renombrar el archivo superfactura.exe por otro nombre o ejecutarlo desde otra carpeta.

Para solucionar en forma definitiva, recomendamos a los usuarios reemplazar el comando superfactura.exe por una nueva versión:

Obtención del Certificado Digital

Para una atención más expedita, puede comprar el certificado digital directamente a través de SuperFactura.

Valor del Certificado

  • Vigencia de 1 año: $11.900 + IVA = $14.161
  • Vigencia de 2 años: $15.800 + IVA = $18.802
  • Vigencia de 3 años: $18.300 + IVA = $21.777

Instrucciones para Solicitar el Certificado

Para poder obtener su certificado digital, debe compeltar estos 4 pasos:

1) Depositar el valor total en la cuenta corriente:

Banco :Banco Estado
Nombre Titular :SuperFactura SpA
RUT :76.711.612-8
Cuenta :22870072060
Tipo de Cuenta :Chequera Electrónica
E-Mail :pagos@superfactura.cl

2) Enviar el comprobante de transferencia a pagos@superfactura.cl.

3) Completar el formulario con los antecedentes del representante legal.

  • Ingrese aquí.
  • Procure ingresar todos los datos tal cual como aparecen en la cédula de identidad.
  • Debe adjuntar una foto de la cédula de identidad (vigente) por ambos lados.

4) Si aún no ha registrado el contribuyente en SuperFactura, por favor, hágalo siguiendo estas instrucciones. Puede dejar en blanco el campo “Certificado Digital” ya que este será subido por SuperFactura.

Dentro de un plazo de aprox. 1 día, le haremos llegar el certificado digital al correo indicado en el formulario del paso 3.

Corregir el XML de un Documento

Para corregir el código XML de documento tributario:

  • Ingrese al menú Documentos Emitidos y abra el documento con el botón con ícono de lápiz que está a la derecha de la página.
  • Modifique el campo “XML” y presione el botón “Aceptar”.
  • Si ya se había entregado el PDF al cliente, deberá hacerle llegar el nuevo PDF, ya que el primero no tendrá ninguna validez.
  • Se recomienda que la corrección del XML la haga el programador del Software Propio y que además se corriga el error en el Software Propio, o en los procesos , idealmente incorporando validaciones previas a la generación del DTE.

Certificado Digital de Emergencia

Para emitir facturas, timbrar folios y realizar todas las operaciones requeridas por un facturador electrónico, es necesario contar con un certificado digital.

Dado que los certificados digitales se vencen, para reducir el riesgo de que un contribuyente quede sin la posibilidad de facturar, SuperFactura registra en el SII un certificado digital de emergencia, el cual permite timbrar folios y facturas.

Es importante advertir que el certificado de emergencia no permitirá realizar todas las operaciones que permite el certificado digital del representante legal, tales como anular folios, rectificar RCOFs y envíos de libros, enviar RCOF para certificación y emisión de boletas, realizar traspaso a producción, etc).

Por lo tanto, si bien la emisión de facturas y boletas puede seguir operando con el certificado de emergencia, se recomienda siempre mantener cargado un certificado vigente.

Tenga presente que SuperFactura le notificará por E-mail cuando un certificado digital ha expirado.

Certificado Digital del Representante Legal

Para que un contribuyente pueda operar como facturador electrónico, se require el certificado digital del representante legal de la empresa.

En la práctica, este certificado consiste en un archivo con extensión .PFX que se carga en el portal MIPYME del SII para poder emitir facturas, así que probablemente su empresa ya cuenta con uno actualmente. Le sugerimos consultar al contador o al representante legal de su empresa.

Si por alguna razón no le es posible obtener el certificado digital, puede solicitar uno nuevo aquí.

Si compró el certificado a otro proveedor, una vez obtenido el certificado, debe subirlo en la ficha del contribuyente en SuperFactura:

  1. Ingrese al menú Mis Contribuyentes
  2. Al lado derecho de la página, ingrese al botón para “Ver o Modificar”.
  3. Suba el certificado digital (archivo .PFX) en el campo “Certificado Digital” e ingrese la contraseña en el campo “Contraseña del Certificado”.
  4. Presione el botón Aceptar abajo al final de la página.