Importación de Documentos con API SuperFactura

Para importar documentos mediante la API SuperFactura, el proceso es muy similar a la emisión de documentos mediante archivos JSON o XML.

La única diferencia es que se debe agregar la opción adicional “Import” para indicar si estamos importando un documento “recibido” (compras) o “emitido” (ventas).

Ejemplos PHP

Importar un documento recibido

/**
 * Este ejemplo muestra como importar un documento recibido a SuperFactura.
 */

require_once('SuperFacturaAPI/api.php');

// 1) Generar arreglo con datos del DTE recibido

$datos = array(
	'Encabezado' => array(
		'IdDoc' => array(
			'Folio' => 123,
			'TipoDTE' => 33,
			'FchEmis' => '2015-01-01',
		),
		'Emisor' => array(
			'RUTEmisor' => '1-9',
			'RznSoc' => 'Test',
			'GiroEmis' => 'Giro',
			'DirOrigen' => 'Dirección',
			'CmnaOrigen' => 'Comuna',
			'CiudadOrigen' => 'Ciudad',
		),
		'Receptor' => array(
			// Acá basta con proporcionar el RUT de nuestro contribuyente
			'RUTRecep' => '99581150-2',
		),
		// 'Totales' será agregado por SuperFactura
	),
	'Detalles' => array(
		array(
			// 'NroLinDet' será agregado por SuperFactura
			'NmbItem' => 'Item 1',
			'DscItem' => 'Descripción del item 1',
			'QtyItem' => 3,
			'UnmdItem' => 'KG',
			'PrcItem' => 100,
		),
		array(
			'NmbItem' => 'Item 2',
			'DscItem' => 'Descripción del item 2',
			'QtyItem' => 5,
			'UnmdItem' => 'KG',
			'PrcItem' => 65,
		)
	),
);

// 2) Usar API para importra el DTE a SuperFactura

$api = new SuperFacturaAPI('usuario@cliente.cl', 'mypassword');
$resultado = $api->SendDTE($datos, 'cer', array( // 'pro' = ambiente producción y 'cer' = ambiente certificación
	'import' => 'recibido', // Indica que no queremos generar un DTE, sino importarlo como un documento recibido.
));

// 3) Procesar salida de la API

if($resultado['ok']) {
	die("Ok");

} else {
	die('Error');
}

Importar un documento emitido

/**
 * Este ejemplo muestra como importar un documento emitido a SuperFactura.
 */

require_once('SuperFacturaAPI/api.php');

// 1) Generar arreglo con datos del documento emitido

$datos = array(
	'Encabezado' => array(
		'IdDoc' => array(
			'Folio' => 1,
			'TipoDTE' => 30,
			'FchEmis' => '2015-01-01',
		),
		'Emisor' => array(
			// Acá basta con proporcionar el RUT de nuestro contribuyente
			'RUTEmisor' => '99581150-2',
		),
		'Receptor' => array(
			'RUTRecep' => '1-9',
			'RznSocRecep' => 'Test',
			'GiroRecep' => 'Giro',
			'DirRecep' => 'Dirección',
			'CmnaRecep' => 'Comuna',
			'CiudadRecep' => 'Ciudad',
		),
		// 'Totales' será agregado por SuperFactura
	),
	'Detalles' => array(
		array(
			// 'NroLinDet' será agregado por SuperFactura
			'NmbItem' => 'Item 1',
			'DscItem' => 'Descripción del item 1',
			'QtyItem' => 3,
			'UnmdItem' => 'KG',
			'PrcItem' => 100,
		),
		array(
			'NmbItem' => 'Item 2',
			'DscItem' => 'Descripción del item 2',
			'QtyItem' => 5,
			'UnmdItem' => 'KG',
			'PrcItem' => 65,
		)
	),
);

// 2) Usar API para importra el DTE a SuperFactura

$api = new SuperFacturaAPI('usuario@cliente.cl', 'mypassword');
$resultado = $api->SendDTE($datos, 'cer', array( // 'pro' = ambiente producción y 'cer' = ambiente certificación
	'import' => 'emitido', // Indica que no queremos generar un DTE, sino importarlo como un documento emitido.
));

// 3) Procesar salida de la API

if($resultado['ok']) {
	die("Ok");

} else {
	die('Error');
}

Programa de Resellers

El Programa de Resellers consiste en una alianza para entregar a nuestros partners proveedores de Software un servicio de facturación electrónica de excelencia y con soporte personalizado. Además, incluye pago de comisiones de venta (de por vida) o planes y precios especiales para sus clientes.

Pago de Comisiones

  • El programa comprende el pago de comisiones a Resellers, de acuerdo a la cantidad de contribuyentes (clientes finales) que pagan por el servicio de SuperFactura mensualmente y la tabla de comisiones publicada aquí.
  • Las comisiones se pagan mensualmente mediante envío de una liquidación mensual y transferencia bancaria a la cuenta bancaria del Reseller.
  • A su vez, el Reseller documenta los ingresos percibidos mediante una boleta de honorarios o una factura afecta emitida a SuperFactura SpA.
  • El pago de los impuestos correspondientes a los ingresos percibidos por el Reseller (retenciones en el caso de boletas de honorarios o el IVA en el caso de facturas afectas) serán de responsabilidad del Reseller.

Modalidades de Facturación de SuperFactura

Existen tres modalidades de facturación del servicio de SuperFactura:

  1. Facturación del servicio de SuperFactura al cliente final
  2. Facturación del servicio de SuperFactura y servicios del Reseller al cliente final
  3. Facturación del servicio de SuperFactura al Reseller

A continuación, describiremos cada de las modalidades en detalle.

Facturación del Servicio de SuperFactura al Cliente Final

  • SuperFactura emite facturas por el servicio de facturación electrónica y el Reseller emite facturas por sus propios servicios (por ejemplo, mantención y soporte del Software del Reseller).
  • Las gestiones de cobranza del servicio de SuperFactura son realizadas directamente por SuperFactura (en forma automatizada) y en caso de morosidad, SuperFactura puede suspender el servicio de facturación electrónica del cliente moroso.
  • La facturación de los servicios de SuperFactura es por mes adelantado y las facturas tienen vencimiento de 30 días.
  • Esta es la modalidad más común y preferida, ya que separa completamente la facturación del servicio ofrecido por SuperFactura de la facturación de los servicios que ofrece el Reseller, evitando las desventajas que presentan las demás modalidades.

Facturación del Servicio de SuperFactura y Servicios del Reseller al Cliente Final

  • Bajo esta modalidad, SuperFactura emite facturas por el servicio de facturación electrónica y además por los servicios que ofrece el Reseller a los clientes finales.
  • Esto tiene la ventaja de que SuperFactura realizará la facturación y las gestiones de cobranza, incluso por los servicios que presta el Reseller.
  • Los servicios del Reseller se liquidan y cancelan mensualmente de la misma forma que las comisiones.
  • Una vez registrado el contribuyente en la plataforma, se deberá informar a SuperFactura el valor mensual de los servicios del Reseller (expresados en unidades de fomento) y la glosa de los servicios del Reseller, para que estos sean incluídos en la factura mensual emitida por SuperFactura.

Facturación del Servicio de SuperFactura al Reseller

  • Bajo esta modalidad, SuperFactura emitirá mensualmente las facturas al Reseller, quien asumirá la completa responsabilidad de 1) realizar la cobranza a sus clientes, 2) realizar el pago oportuno de las facturas mensuales emitidas por SuperFactura (por mes adelantado) y 3) asumir y responder por las deudas originadas por sus clientes finales.
  • Una desventaja crítica de este modelo es que SuperFactura no conocerá ni hará distinción del estado de pago de las facturas emitidas por el Reseller a sus clietnes finales. Por lo tanto, en caso de que el Reseller mantenga deuda con SuperFactura, se suspenderán todos los servicios contratados por el Reseller afectando a todos sus clientes finales.
  • El Reseller será responsable del pago oportuno a SuperFactura (por mes adelantado) de los servicios entregados a sus clientes finales.
  • Es importante mencionar que las gestiones de cobranza de servicios mensuales suele ser compleja y degastante, por lo cual, el 99% de los Resellers terminan solicitando que la facturación y gestión de cobranza sea realizada directamente por SuperFactura, ya que de esta manera el Reseller se ahorra trabajo administrativo, gestiones de cobranza y la responsabilidad de responder por las dedudas originadas por sus clientes finales morosos para evitar la suspensión de los servicios.

Precios Especiales

Muchas veces el interés del Reseller es ofrecer a sus clientes la integración de facturacón electrónica a un precio final más competitivo.

En estos casos, el Reseller no busca percibir comisiones de SuperFactura, sino obtener para sus clientes un descuento especial de los servicios de SuperFactura para que el precio mensual total del Software Propio y del servicio de SuperFactura sea atractivo para los clientes.

Dependiendo del número de clientes que se migrarán en el corto plazo y su volumen de facturacion mensual, es posible acordar planes y precios especiales exclusivos para los clientes del Reseller.

En estos casos, las distintas modalidades de facturación son las mismas que las indicadas en el punto anterior.

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

Contribuyente no puede pasar a Producción

En algunos casos, el contribuyente no puede declarar el “cumplimiento de requisitos” para comenzar a facturar en el ambiente de producción.

Esto generalmente ocurre cuando el contribuyente requiere una verificación de actividad por parte del SII, lo cual se puede realizar acá.

Comprobación del Problema

Es importante aclarar que con frecuencia los funcionarios del SII orientan en forma negligente al contribuyente, por lo cual, recomendamos seguir estos pasos para ver el mensaje de error que presenta el SII:

  1. Ingresar a la página del SII con el certificado digital del representante legal a la opción:
    https://maullin.sii.cl/cvc_cgi/dte/pe_avance7 y presionar el botón para declarar cumplimiento.
  2. Mostrar el mensaje de error al funcionario del SII y solicitarle una solución.
  3. Volver a probar el paso 1 hasta que el problema haya sido resuelto.

Por favor, tener en cuenta que el equipo de soporte de SuperFactura no puede resolver estos problemas.

Documentos con Montos Brutos

Al emitir facturas, por defecto se asume que los montos indicados en los detalles no incluyen IVA, salvo que se indique el tag <MntBruto> (ver especificación oficial del SII).

Sin embargo, en el caso de la emisión de boletas de ventas afectas, los montos siempre se expresan con IVA, es decir, siempre se deben indicar montos brutos.

Es importante advertir que cuando se anula una Boleta de Venta Afecta (con montos brutos), se debe indicar explícitamente en la Nota de Crédito que los montos son brutos, agregando el tag <MntBruto>.

Manejo de Sucursales

Casa Matriz

En el encabezado de una muestra impresa se debe indicar siempre la dirección de la casa matriz, la cual se configura en la ficha del contribuyente de Superfactura.

Sucursal

Adicionalmente, es posible indicar la sucursal desde la cual se emite el documento o desde la cual se despachan los productos.

Para esto, se puede enviar desde el Software Propio el nombre de la sucursal (un alfanumérico de hasta máximo 20 caracteres) en el tag Encabezado > Emisor > Sucursal. En caso de no proporcionar este tag, se utilizará por defecto el campo “Sucursal” defindo en la ficha del contribuyente.

En forma similar, también es posible enviar el código de sucursal asignado por el SII (código númerico) dentro del tag Encabezado > Emisor > CdgSIISucur. En caso de no proporcionar este dato, se utilizará por defecto el campo “Código SII Sucursal” configurado en la ficha del contribuyente.

Este tag solo es válido para facturas y similares, no para boletas.

Sucursal en Boletas

El formato para boletas permite proporcionar el tag “CdgSIISucur”, pero no el tag “Sucursal”. Como alternativa, SuperFactura permite especificar el tag SuperFactura > Sucursal para incluir el nombre de la sucursal en la muestra impresa, sin embargo, es importante advertir que este tag no es enviado al SII.

Control por Sucursales

Generalmente los contribuyentes que operan en varias sucursales necesitan separar sus ventas y mantener control por sucursal.

Impresión del Membrete

SuperFactura permite corregir la presentación estética del membrete del documento.

En la ficha del contribuyente, en el campo “Membrete, se puede personalizar el membrete usando formato HTML.

También existe el campo “Membrete en Impresora Térmica” que permite personalizar el membrete para impresión con impresora térmica en formato texto plano.

Esta información se imprimirá en el formato PDF de las facturas, pero no se incluirá dentro del XML que se envía al SII.

ADVERTENCIA: En caso de modificar el membrete, es importante que valide con su contador que el membrete cumpla con las normativas del SII.

Formato Oficial del SII

Los DTE que se envían con SuperFactura deben respetar el formato oficial del SII:

La estructura de los tags aplica por igual para el formato XML y JSON.

En el caso del formato XML, es muy importante respetar el orden de los tags definido por el SII.

En el caso del formato JSON, el orden no importa y además es posible omitir varios tags, así que este formato es mucho más sencillo y se recomienda siempre trabajar con formato JSON en vez de XML. Ver ejemplos JSON.

Es muy importante que los integradores de facturación electrónica entiendan y se familiaricen con los formatos indicados más arriba. Acá daremos algunas sugerencias para facilitar su lectura:

  • A partir de la página 11 se presenta la documentación de todos los tags soportados por el SII y de su estructura (orden).
  • En la documentación se especifican “areas” que se abren y cierran. Por ejemplo, en página 11, antes de la linea 2, se abre el tag <IdDoc> que se cierra en página 15, después de la linea 30. Por lo tanto, todos los tags entre las lineas 2 y 30 deberán ir encerrados dentro del tag “<IdDoc>…</IdDoc>”.
  • Al trabajar con el formato XML,se debe respetar el orden de los tags. Por lo tanto, el tag <TipoDTE> especificado en linea 2, siempre debe venir antes que el tag <Folio> especificado en linea 3.

Ingreso Manual de Documentos Recibidos

ACTUALIZACIÓN: Desde agosto de 2017 ya no es necesario enviar los Libros de Compras y Ventas al SII. Por esta razón, tampoco es necesario preocuparse de ingresar a SuperFactura los Documentos Recibidos que eventualmente pudieran faltar. La información oficial de los Documentos Recibidos ahora se centraliza en el Registro de Compras y Ventas del SII.

Generalmente los documentos recibidos (emitidos por otros proveedores) son cargados automáticamente en SuperFactura, salvo que se trate de documentos en papel o por otros motivos.

Para ingresar un documento manualmente, acceda al menú Documentos > Recibidos y haga click en el botón Ingresar Documento Recibido.

En el caso de documentos con impuestos adicionales (ej: ILA), éstos se deben registrar al final del formulario, haciendo click en el botón Agregar Impuesto Adicional.

Registro de Compras y Ventas del SII

A partir de agosto 2017, los Libros de Compra y Venta fueron reemplazados por el Registro de Compras y Ventas del SII.

El Registro de Compras y Ventas se encuentra disponible acá y es la única opción válida para enviar los acuses de recibo, que permiten hacer uso del crédito fiscal de las facturas de compra.

El menú “Compras y Ventas” seguirá disponible en SuperFactura, pero sólo para consultar los documentos emitidos.

Más Información

Cálculo del IVA

Conforme al Art. 21°, de la Ley N° 18.267:

a contar del 1° de enero de 1984, las personas naturales, instituciones bancarias, de previsión social y en general todo otro servicio, institución o empresa, pública o privada, eliminarán de su contabilidad las fracciones de la unidad monetaria. Con tal objeto, se despreciarán las fracciones inferiores a cincuenta centavos de peso y se elevarán al entero superior las de cincuenta centavos o más.

Por lo tanto, la forma correcta de calcular el IVA a partir del monto neto, es redondear el valor del IVA.

Por ejemplo, el IVA del monto neto $33.655 es $6.394 (no $6.395).

En caso de no aplicar correctamente este criterio, los documentos y libros serán aceptados por el SII, pero generarán un reparo leve que será informado al contribuyente con la observación “LBR – 2 – Reparo en Calculo de – [MntIVA] distinto a [MntNeto]*[TasaImp]“.

Calcular el Monto Neto a partir del Monto Total puede parecer algo muy sencillo, sin embargo, no lo es. De hecho, para algunos montos totales como $103, $110, $116, etc. no existe un monto neto al que se le pueda sumar el IVA calculado por medio del Art. 21° de la Ley.

Cuando se emite un documento con SuperFactura, es posible simplemente omitir el tag MntNeto para que SuperFactura realice el cálculo automáticamente. De todas maneras, acá presentamos pseudo-código para explicar como se puede realizar este cálculo:

/**
 * Obtiene neto del total, procurando que neto + iva (redondeado) = total
 * OBS: Hay valores para $total para los cuales no existirá un neto tal que:
 * neto + iva = total, donde iva = round(neto) * 0.19
 * Por ejemplo: total = 103, 110, 116, 122, 128, 135, 141, 147, 153, 160, 166,172, 178, 185, 191, 197, 204, 210,...
 */
function GetNetoFromTotal($total, $allowFloat = false) {
	if($allowFloat) {
		$neto = $total / 1.19;
	} else {
		$neto = floor($total / 1.19); // Intentaremos tanteando con el neto menor (floor($x) < round($x))
		$ivaDelNeto = round($neto * 0.19); // IVA calculado correctamente (con round)
		if($neto + $ivaDelNeto > $total) {
			// No cuadra => arreglar neto para cuadrar
			$neto--;
		}
	}
	return $neto;
}

Autorizar un Usuario en el SII

Para autorizar un usuario a realizar trámites de facturación electrónica en el SII:

  1. Ingresar a https://maullin.sii.cl/cvc_cgi/dte/eu_enrola_usuarios (ambiente de certificación)
  2. Ingresar el RUT del contribuyente
  3. Presionar el botón Ingresar Nuevo Usuario si el usuario no existía, o el botón Sel… si el usuario ya existía.
  4. Marcar todas las opciones y presionar el botón Grabar Cambios.
  5. Ingresar a https://palena.sii.cl/cvc_cgi/dte/eu_enrola_usuarios (ambiente de producción)
  6. Ingresar el RUT del contribuyente
  7. Presionar el botón Ingresar Nuevo Usuario si el usuario no existía, o el botón Sel… si el usuario ya existía.
  8. Marcar todas las opciones y presionar el botón Grabar Cambios.
  9. Notificar a soporte@superfactura.cl que se han otorgado los permisos en el SII.