SuperFactura soporta integración con cualquier lenguaje de programación mediante el comando superfactura.exe que permite emitir documentos tributarios electrónicos a partir de un archivo generado por su Software.
El comando recibe los siguientes argumentos:
superfactura.exe [usuario] [contraseña] [ambiente] [archivo] [opciones]
El archivo puede tener formato XML o JSON (más flexible y sencillo) y debe tener una estructura similar a la especificación oficial del SII para Documentos Tributarios Electrónicos o Boletas Electrónicas de Venta:
{
"Encabezado" : {
"IdDoc" : {
"TipoDTE" : "33"
// 'FchEmis' => '2015-01-01' // Opcional
},
"Emisor" : {
"RUTEmisor" : "99581150-2"
// Los demás datos serán agregados por SuperFactura
},
"Receptor" : {
"RUTRecep" : "1-9",
"RznSocRecep" : "Test",
"GiroRecep" : "Giro",
"DirRecep" : "Dirección",
"CmnaRecep" : "Comuna",
"CiudadRecep" : "Ciudad"
}
},
"Detalles" : [
{
"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"
}
]
}
Ver más ejemplos aquí.
<?xml version="1.0" encoding="ISO-8859-1"?>
<DTE version="1.0">
<Documento ID="ID-INTERNO">
<Encabezado>
<IdDoc>
<TipoDTE>33</TipoDTE>
<Folio>123</Folio>
<FchEmis>2015-04-09</FchEmis>
</IdDoc>
<Emisor>
<RUTEmisor>99581150-2</RUTEmisor>
<RznSoc>IMATRONIX S A</RznSoc>
<GiroEmis>SISTEMAS DE INFORMACIÓN EMPRESARIALES</GiroEmis>
<Acteco>726000</Acteco>
<CdgSIISucur>065955163</CdgSIISucur>
<DirOrigen>AVDA LIMONARES 455, Nº 29, VIÑA DEL MAR</DirOrigen>
<CmnaOrigen>VINA DEL MAR</CmnaOrigen>
<CiudadOrigen>VINA DEL MAR</CiudadOrigen>
<CdgVendedor>XXX</CdgVendedor>
</Emisor>
<Receptor>
<RUTRecep>1-9</RUTRecep>
<RznSocRecep>Test</RznSocRecep>
<GiroRecep>Giro</GiroRecep>
<CorreoRecep>dte@cliente.cl</CorreoRecep>
<DirRecep>Dirección</DirRecep>
<CmnaRecep>Comuna</CmnaRecep>
<CiudadRecep>Ciudad</CiudadRecep>
</Receptor>
<Totales>
<MntNeto>64475</MntNeto>
<MntExe>0</MntExe>
<TasaIVA>19</TasaIVA>
<IVA>12250</IVA>
<ImptoReten>
<TipoImp>26</TipoImp>
<TasaImp>20.5</TasaImp>
<MontoImp>649440</MontoImp>
</ImptoReten>
<ImptoReten>
<TipoImp>271</TipoImp>
<TasaImp>18</TasaImp>
<MontoImp>590328</MontoImp>
</ImptoReten>
<MntTotal>1316493</MntTotal>
</Totales>
</Encabezado>
<Detalle>
<NroLinDet>1</NroLinDet>
<CdgItem>
<TpoCodigo>INT</TpoCodigo>
<VlrCodigo>75032715</VlrCodigo>
</CdgItem>
<NmbItem>CORONA EXTRA 355 CC 4.6</NmbItem>
<DscItem>CORONA EXTRA 355 CC 4.6</DscItem>
<UnmdRef>UNI</UnmdRef>
<QtyItem>72</QtyItem>
<UnmdItem>UNI</UnmdItem>
<PrcItem>440</PrcItem>
<CodImpAdic>26</CodImpAdic>
<MontoItem>31680</MontoItem>
</Detalle>
<Detalle>
<NroLinDet>2</NroLinDet>
<NmbItem>Coca-Cola</NmbItem>
<DscItem>Coca-Cola</DscItem>
<UnmdRef>UNI</UnmdRef>
<QtyItem>36</QtyItem>
<UnmdItem>UNI</UnmdItem>
<PrcItem>911</PrcItem>
<CodImpAdic>271</CodImpAdic>
<MontoItem>32796</MontoItem>
</Detalle>
<DscRcgGlobal>
<NroLinDR>1</NroLinDR>
<TpoMov>D</TpoMov>
<GlosaDR>Descuento de 1 peso</GlosaDR>
<TpoValor>$</TpoValor>
<ValorDR>1</ValorDR>
</DscRcgGlobal>
</Documento>
</DTE>
El comando generará como salida un string JSON que incluirá el número de folio asignado al documento:
{"ok":true,"folio":"125"}
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 el panel de administración 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. Este servicio es gratuito y no expira.
En caso de tener alguna consulta, por favor, escríbanos a soporte@superfactura.cl.