La API SuperFactura es un componente de Software que permite emitir documentos tributarios electrónicos y boletas electrónicas de venta directamente desde su Software Propio.
SuperFactura
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 debe informar a soporte@superfactura.cl:
- El E-mail de la cuenta creada
- El código de sucursal (según figura registrado en el SII)
- La dirección de la sucursal
Las cuentas de “usuario sucursal” no deben contener nombres de personas, sino nombres para identificar la sucursal (ej: sucursal.valparaiso@empresa.cl). SuperFactura actualmente no envía información a estos correos.
En caso de usar el servicio offline para puntos de venta, se debe instalar en cada sucursal 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:
- Emitir boletas y facturas con SuperFactura.
- 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
- En el menú Libros > Compra y Venta se visualiza toda la información de Compra y Venta registrada en SuperFactura. Ver más información aquí.
- En el menú Libros > Ventas Diarias se visualiza el Resumen de Ventas Diarias con información exclusivamente relacionada con boletas electrónicas. Por ejemplo, se muestran boletas y NC que anulan boletas, pero no las NC que anulan facturas. Este registro anteriormente se llamaba Reporte de Consumo de Folios (RCOF). Ver más información aquí.
- En el menú Documentos > Emitidos se pueden consultar los documentos emitidos (ventas) con SuperFactura. La información oficial de los documentos emitidos (ventas) es la que maneja SuperFactura.
- En el menú Documentos > Recibidos se pueden visualizar los documentos recibidos (compras) en SuperFactura. La información oficial de los documentos recibidos es el Registro de Compras y Ventas del SII y es ahí donde se deben hacer los acuses de recibo.
- El timbraje de folios y la anulación de folios vencidos se realiza en forma 100% automática en SuperFactura. Cuando los folios se vencen, es normal que se produzcan saltos de folios.
- SuperFactura ofrece generar documentos mediante:
- Facturador Web (para documentos no soportados por el Software Propio)
- La aplicación SuperBoleta para puntos de venta
- Integración con Softwara Propio
- Integraciones con sitios E-Commerce
- Con SuperContador es posible generar automáticamente balances tributarios, hacer conciliación bancaria y cobranza. SuperContador es un servicio adicional que conversa con SuperFactura.
Integración de JumpSeller.cl con Boleta Electrónica
SuperFactura ofrece gratis la integración de su sitio JumpSeller.cl con Boleta Electrónica.
Para más información, por favor, contactar a contacto@superfactura.cl.
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
- Ingrese al panel de administración de WooCommerce
- Ingrese al menú WooCommerce > Ajustes > Avanzado > WebHooks
- 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
Para imprimir con impresoras térmicas, se debe utilizar siempre el formato EscPos, el cual ofrece una calidad y velocidad de impresión muy superior al formato PDF y además permite controlar que los tamaños y márgenes de impresión sean los correctos según cada modelo de impresora.
Para impresión con impresoras de inyección de tinta, ver aquí.
Configuración
Ver instrucciones aquí.
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 (navegador web), se recomienda hacer lo siguiente:
- En la aplicación web, debe colocar un botón “Print” que permitirá descargar un archivo en formato ESC/POS con la extensión especial “.pos” (ej: “doc.pos”). El contenido de este archivo se puede generar en el servidor usando la API de SuperFactura con la opción “getEscPos”. Este archivo se puede también descargar directamente desde el menú “Documentos Emitidos” de SuperFactura usando el botón “POS” que se encuentra al lado derecho del listado.
- Para que estos archivos se impriman automáticamente al ser abiertos desde el browser, seguir estas instrucciones.
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:
- Ingresar a: https://superfactura.cl/content/mis-contribuyentes
- 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.
- 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
- Descargar e instalar VC_redist.x86.exe
- Descargar e instalar Servidor Local SuperFactura
- 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í.