Control por Sucursal

Para separar los documento emitidos por sucursal, se deben usar cuentas de usuario distintas en cada sucursal.

La cuenta de usuario con la que se registró el contribuyente en SuperFactura, será la cuenta del “usuario administrador”, quien tendrá acceso para ver todos los documentos emitidos por el contribuyente (en cualquiera de sus sucursales).

Luego, para cada sucursal, se deberá crear un “usuario sucursal”, el cual solo podrá visualizar los documentos emitidos por su sucursal.

Las cuentas de “usuario sucursal” se deben crear aquí y luego informar a soporte@superfactura.cl indicando el E-mail de la cuenta y su código de sucursal (según figura registrado en el SII).

En cada sucursal de deberá instalar el servidor local e iniciar sesión con la cuenta de “usuario sucursal” correspondiente.

Referencias

Los DTE pueden incluir referencias a otros documentos usando el tag “Referencia”. Ejemplo:

{
	"Encabezado" : {
		"IdDoc" : {
			"TipoDTE" : "33"
		},
		"Emisor" : {
			"RUTEmisor" : "99581150-2"
		},
		"Receptor" : {
			"RUTRecep" : "1-9",
			"RznSocRecep" : "Test",
			"GiroRecep" : "Giro",
			"DirRecep" : "Dirección",
			"CmnaRecep" : "Comuna",
			"CiudadRecep" : "Ciudad"
		}
	},
	"Detalle" : [
		{
			"NmbItem" : "Item 1",
			"DscItem" : "Descripción del item 1",
			"QtyItem" : "3",
			"UnmdItem" : "KG",
			"PrcItem" : "100"
		},
		{
			"NmbItem" : "Item 2",
			"DscItem" : "Descripción del item 2",
			"QtyItem" : "5",
			"UnmdItem" : "KG",
			"PrcItem" : "65"
		}
	],
	"Referencia" : [
		{
			"TpoDocRef" : "801",
			"FolioRef" : 123,
			"FchRef" : "2016-05-19"
		},
		{
			"TpoDocRef" : "HES",
			"FolioRef" : 234,
			"FchRef" : "2017-06-20"
		}
	]
}

El SII reconoce los siguientes tipos de documentos (TpoDocRef):

30 : Factura (Papel)
32 : Factura Exenta (Papel)
33 : Factura Electrónica
34 : Factura Exenta Electrónica
35 : Boleta Afecta (Papel)
38 : Boleta Exenta (Papel)
39 : Boleta Electrónica
41 : Boleta Exenta Electrónica
43 : Liquidación Factura de Electrónica
45 : Factura de Compra
46 : Factura de Compra Electrónica
50 : Guía de Despacho (Papel)
52 : Guía de Despacho Electrónica
55 : Nota de Débito (Papel)
56 : Nota de Débito Electrónica
60 : Nota de Crédito (Papel)
61 : Nota de Crédito Electrónica
101 : Factura de Exportación (papel)
104 : Nota de Débito de Exportación (papel)
106 : Nota de Crédito de Exportación (papel)
110 : Factura de Exportación Electrónica
111 : Nota de Débito de Exportación Electrónica
112 : Nota de Crédito de Exportación Electrónica
801 : Orden de Compra
802 : Nota de Pedido
803 : Contrato
804 : Resolución
805 : Proceso ChileCompra
806 : Ficha ChileCompra
807 : DUS
808 : B/L (Conocimiento de Embarque)
809 : AWB (Air Will Bill)
810 : MIC/DTA
811 : Carta de Porte
812 : Resolución del SNA donde califica Servicios de Exportación
813 : Pasaporte
814 : Certificado de Depósito Bolsa Prod. Chile.
815 : Vale de Prenda Bolsa Prod. Chile
914 : Declaración de Ingreso (DIN)
HES : Hoja Entrada Servicio

Observaciones

  • Las referencias en boletas electrónicas tienen un formato distinto.
  • Un DTE soporta hasta máximo 40 referencias (limitación del SII).

SuperFactura y Portal MIPYME

Actualmente es posible optar entre:

  1. Emitir boletas y facturas con SuperFactura.
  2. Emitir boletas con SuperFactura y emtir facturas y otros documentos (NC, ND, GD, etc) con el portal MIPYME.

Notas de Crédito

Para poder emitir notas de crédito, la normativa establece que el contribuyente debe ser “facturador electrónico”, aún cuando no emita facturas.

Si se opta por emitir boletas con SuperFactura y facturas con MIPYME, entonces, para anular una boleta, deberá generar manualmente la NC en el portal MIPYME.

Así mismo, para poder emitir una NC con Software de Mercado, será necesario primero ser certificado y habilitado como “Facturador Electrónico con Software de Mercado”.

Facturador Electrónico con Software de Mercado

Si el contribuyente habilita en la ficha del contribuyente algún documento aparte de las boletas afectas y exentas, se entenderá que optó por ser facturador electrónico con Software de Mercado.

En este casto, ya no se podrá seguir utilizando el portal MIPYME una vez que el contribuyente haya sido habilitado en producción en SuperFactura.

Mientras el contribuyente no sea habilitado en producción, es decir, mientras realiza pruebas en el ambiente de certificación, puede seguir usando el portal MIPYME normalmente.

La principal ventaja de emitir las boletas, facturas y/o NC directamente desde el Software de Mercado en vez del portal MIPYME, es que se evita tener que ingresar el documento en dos sistemas distintos. Por ejemplo, para anular un documento, simplemente se presiona el botón “Anular” en el Software de Mercado, en vez de tener que generar la NC manualmente en el portal MIPYME (haciendo referencia a la boleta anulada) y además tener que registrar la anulación en el Software de Mercado para que rebaje la deuda del cliente.

Información para Contadores

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.

Solucionar Problema de Desconexiones

En caso de que su impresora térmica se desconecte automáticamente, puede ser útil eliminar y volver a agregar la impresora virtual LPT1.

Ejemplo:

NET USE LPT1 /DELETE
NET USE LPT1 \\localhost\pos

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í.