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 de la forma más sencilla posible.
La API soporta todos los atributos especificados por el SII y está disponible para PHP, C#, .Net, Visual Basic 6, NodeJS, Python, Ruby, Clipper y otros lenguajes.
1) Incluya la API en su software.
require_once('SuperFacturaAPI/api.php');
2) Defina el arreglo con los datos de la factura.
El formato del arreglo es similar al formato oficial del SII, pero una de las ventajas de la API de SuperFactura es que permite omitir varios datos que no son necesarios ya que pueden ser calculados por la API o administrados via Web.
$datos = array(
'Encabezado' => array(
'IdDoc' => array(
'TipoDTE' => 33,
// 'FchEmis' => '2015-01-01', // Opcional
),
'Emisor' => array(
'RUTEmisor' => '99581150-2',
// Los demás datos serán agregados por SuperFactura
),
'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,
)
),
);
3) Emisión del DTE.
SuperFactura se encargará de firmar, enviar al SII y generar muestras impresas en formato PDF con sólo dos líneas de código:
$api = new SuperFacturaAPI('usuario@cliente.cl', 'contraseña');
$resultado = $api->SendDTE($datos, 'cer');
Observación:
Reemplace usuario@cliente.cl y contraseña por los datos de su cuenta de SuperFactura. La cuenta se puede crear aquí.
Utilice el parámetro cer para generar facturas de prueba en el ambiente de certificación del SII y pro operar en el ambiente de producción.
Adicionalmente, se recomienda siempre enviar la opción adicional documentID.
4) Obtención del folio. Con el siguiente código podemos validar que el DTE se generó exitosamente y obtener el folio definitivo, el cual debiera ser registrado en su Software.
if($resultado['ok']) {
die("Ok. Folio: {$resultado['folio']}");
} else {
die('Error');
}
El código fuente completo de estos ejemplos está incluído en la descarga de la API SuperFactura.
En caso de generarse algún error, su Software debiera ofrecer al usuario la opción de reintentar o cancelar la emisión del documento sin redigitar sus datos.
El logo y diseño de las muestras impresas PDF y el certificado digital para firmar los DTE se configuran en la Ficha del Contribuyente de SuperFactura.
Para obtener más información sobre el servicio SuperFactura, ver cotización aquí.
Para realizar pruebas de integración y emitir documentos en el ambiente de certificación del SII, ver pasos para comenzar. El servicio para realizar pruebas es completamente gratis.
En caso de tener alguna consulta, puede escribirnos a contacto@superfactura.cl.