Manual Webservice CL

MANUAL DE INTEGRACIÓN
M E DIA N TE W EB S E RV IC E
Versión 2.2.1
Facturación.cl
Gran Avenida José Miguel Carrera #5018
Santiago – Chile
Fono (56-2) 947 28 00
Manual de Integración mediante Servicio Web
Índice
Introducció n...................................................................................... 3
Clientes SOAP... ................................................................................ 4
URL del Servicio Web .......................................................................... 5
Modelo de Operació n ......................................................................... 5
Codificaci ón ..................................................................................... 6
Autenticación .................................................................................... 6
Métodos del Servicio Web .................................................................... 7
Ejemplos......................................................................................... 10
Respuesta Métodos Consumidos ............................................................. 12
Impresión Térmica ............................................................................. 17
Componentes de Impresión .................................................................. 19
Facturación.cl
Santiago – Chile
Fono (56-2) 947 28 00
I n t r o d u c c i ón
El presente manual tiene como objetivo dar a conocer el medio de integración
desde una aplicación que soporte conexión mediante Servicio Web, con el sistema
de Facturación.cl que ofrece la emisión y resguardo de sus Documentos
Tributarios Electrónicos.
Para realizar la integración entre aplicaciones, utilizaremos la tecnología

conocida como Servicio Web SOAP a fin de acceder a las funcionalidades ofrecidas
por nuestra plataforma.
Un servicio Web es un conjunto de protocolos o estándares que permiten

intercambiar los datos entre aplicaciones de software, permitiendo que distintos
programas, hechos en diferentes lenguajes de programación y ejecutándose en
diversas plataformas, puedan interactuar entre sí.
Para la comunicación de datos mediante Servicios Web, éstos utilizan estándares y

protocolos globales. Siendo muchos de estos libres, incrementando así la
popularidad de SOAP.
El protocolo SOAP permite la comunicación de dos objetos mediante el

intercambio de archivos XML.
Facturación.cl 3
Santiago – Chile
Fono (56-2) 947 28 00
C l i e n tes S O AP
Gracias a que la tecnología de Servicio Web SOAP está basada en estándares

abiertos y regidos por la W3C. Existen diversos clientes disponibles para la
mayoría de las plataformas y lenguajes de programación mediante API's que
permiten hacer uso de servicios web, dejando a disposición del programador
múltiples librerías que permiten el acceso a nuestros servicios.
A continuación, se presenta un listado de solamente algunos de los clientes y

librerías existentes que permiten realizan la comunicación con nuestro
WebServices
Plataforma Lenguaje Nombre URL

Multiplataforma PHP NuSOAP http://nusoap.sourceforge.net/
Multiplataforma PHP 5 SOAP API http://cl.php.net/soap
Multiplataforma Java WS ToolKit http://java.net/projects/metro
Multiplataforma Perl SOAP Lite http://www.soaplite.com
Microsoft Windows C#, J#, VB.Net System.Net http://msdn.microsoft.com/en-
us/library/ms997641.aspx
Microsoft Windows C++ SOAP ToolKit http://msdn.microsoft.com/en-
us/library/aa286526.aspx
Microsoft Microsoft Office Office Web http://www.microsoft.com/es-
Windoews Services ToolKit es/download/details.aspx?id=2224
Facturación.cl 4
Santiago – Chile
Fono (56-2) 947 28 00
URL del Servicio Web
Para acceder al WebService tanto en ambiente de pruebas como producción debe

utilizar la siguiente URL: http://ws.facturacion.cl/WSDS/wsplano.asmx?wsdl
M o d e l o d e O p e r a c i ón
- El primer paso consiste en construir el archivo de Integración, el cual será

necesario para la emisión y generación de los Documentos Tributarios
Electrónicos.
Actualmente disponemos de dos formatos, para los cuales existe su

documentación respectiva a fin de crearlos basados en ciertas estructuras de
información, los formatos son:
 Archivos de Texto Plano (TXT)

 Archivos en estándar XML
Éstos archivos deberán contener la información del documento a generar (Factura

Electrónica, Guía de Despacho Electrónica, Nota de Crédito Electrónica, Nota de
Débito Electrónica, etc.).
Para más información respecto de los formatos de dichos archivos, se pueden

consultar los manuales correspondientes, los cuales contienen la información de
cómo construir dichos archivos.
- El segundo paso consiste en enviar dicho archivo a nuestro Servicio Web,

valiéndose de un cliente SOAP permitido por su aplicación.
- El tercer paso y final consiste en obtener la representación impresa del

documento tributario ya generado, ésta representación es creada en formato
PDF, el cual retorna si así se configura.
Facturación.cl 5
Santiago – Chile
Fono (56-2) 947 28 00
C o d i f i c a c ió n
La información debe ser enviada de manera codificada utilizando el formato de

codificación Base64, el cual es un estándar disponible en múltiples lenguajes de
programación.
En los casos en que se indique Codificado, tanto en los datos enviados, como
recibidos se debe utilizar dicho algoritmo.
Autenticación
Para hacer uso del servicio, es necesario invocar o consumir los métodos,
indicando las credenciales de autenticación que son entregadas al inicio del
proceso de integración, las que variaran dependiendo si esta en ambiente de
pruebas o producción. Estas son diferentes a las utilizadas para acceder a la
plataforma de facturación.cl.
Para verificar las credenciales debe ingresar en la plataforma web en
Administrador/Integración/DTEPlano/Credenciales.
Ya terminadas las pruebas se proporcionan las que se deben utilizar para el
entorno productivo.
La información de autenticación es transmitida en una variable de tipo objeto,

que contiene la siguiente estructura con los datos de autenticación:
Clase: logininfo
Campo Descripción Codificado Obligatorio
Usuario Corresponde al nombre del usuario. SI SI
Rut Corresponde al RUT de su empresa. SI SI
Clave Clave asignada a su empresa. SI SI
Puerto Se debe asignar por defecto 0 (cero), SI SI
a menos que se requiera utilizar
impresión automática.
IncluyeLink En caso que se requiera obtener los NO NO
Link de los documentos impresos en
la emisión o procesamiento, se debe
agregar este campo indicando como
valor “1”.
Si el documento posee copia
Cedible, además se incluirá el Link de
su representación.
Facturación.cl 6
Santiago – Chile
Fono (56-2) 947 28 00
M é t o do s d e l S e r v i ci o W eb
El Servicio Web posee varios métodos los cuales es posible consumir mediante
cualquier cliente SOAP, por lo que se entrega una breve descripción de los que
utilizarán en la integración.
Método: Procesar
Descripción:
Permite procesar el archivo de Integración y generar el DTE (Documento
Tributario Electrónico).
Parámetro Descripción Codificado

login Estructura con datos de autenticación del cliente. -
file Archivo a procesar SI
formato Corresponde al tipo de archivo enviado: -
1 = Archivo de texto / 2 = Archivo XML
Respuesta:
Retorna un archivo en formato XML con la información de resultado del
archivo procesado.
Método: ObtenerLink
Descripción:
Obtiene el Link de descarga del Documento Tributario una vez que este ha
sido generado y enviado al SII.
Se puede utilizar directamente el indicador “IncluyeLink” al procesar, en caso
que se desee obtener los link de Impresión al emitir.

tpomov Corresponde al tipo de movimiento asociado al SI
documento enviado:
C = Compra / V = Venta / B = Boleta
folio Corresponde al número de Folio del Documento. SI
tipo Corresponde al Tipo de Documento (Tipo DTE) SI
cedible Indica si se obtendrá la copia cedible del PDF. SI
True = Se obtiene copia Cedible.
False = Se obtiene la copia Original.
Respuesta: SI
Retorna un XML que contiene el LINK de descarga del documento
en formato PDF.
Facturación.cl 7
Santiago – Chile
Fono (56-2) 947 28 00
Método: Online
Descripción:
Se utiliza para verificar que el Servicio Web se encuentra disponible.
Parámetros No posee parámetros

Respuesta:
Retorna una cadena con el texto “Online=1”.
Método: getBoletaTicket
Descripción:
Obtiene los datos necesarios para poder generar la salida de impresión de una
Boleta Electrónica emitida en formato Ticket Térmico.

ticket Corresponde al comando de solicitud con la SI
siguiente nomenclatura:
ticket@tipodte@folio
Respuesta: SI
Retorna un XML que contiene la información necesaria para ser
enviada a la salida de impresión térmica.
Método: getXMLDte (Costo Adicional)

Descripción:
Este es un método adicional que permite obtener al archivo XML del
documento generado previo envío al Servicio de Impuestos Internos SII.

documento enviado:
C = Compra / V = Venta / B = Boleta
Respuesta: SI
Como respuesta retorna el archivo XML del documento solicitado
en formato base64Binary.
Facturación.cl 8
Santiago – Chile
Fono (56-2) 947 28 00
Método: EliminarDoc
Descripción:
Permite eliminar un Documento no Electrónico en el sistema.

documento enviado:
C = Compra / V = Venta
Respuesta:
Retorna el resultado de la eliminación del documento indicado.
Método: AnularGuia
Descripción:
Permite anular una Guía de Despacho en el sistema (puede ser Electrónica o
no Electrónica).

documento enviado:
V = Venta
tipo Corresponde al Tipo de Documento (Tipo DTE), el SI
cual puede ser: 50 ó 52.
Respuesta:
Retorna el resultado de la anulación del documento indicado.
Facturación.cl 9
Santiago – Chile
Fono (56-2) 947 28 00
Ejemplos
En el siguiente ejemplo, veremos la manera de procesar el archivo de

integración, utilizando PHP4 y valiéndonos de la librería NuSoap.
<?php
require_once('lib/nusoap.php');
/* Ruta de acceso al servicio web */

$wsdl = 'http://192.168.1.1:8088/wsplano.asmx?wsdl';
/* Creamos una instancia del cliente SOAP */

$client = new soapclient($wsdl,true);
$client->setUseCurl(0);
$err = $client->getError();
if ($err) {
echo '<h2>Error en el constructor</h2><pre>' . $err .
'</pre>'; exit();
}
/* Definimos los parametros a pasar al servicio */

$params = array(
'login' => array(
'Usuario' => base64_encode("Usuario")
,'Rut' => base64_encode("1-9")
,'Clave' => base64_encode("123456")
,'Puerto' => base64_encode("0")
,'IncluyeLink' => "1"),
'file' =>
base64_encode($contenido_archivo),
'formato' => "1");
/* Invocamos el Web Service, Metodo: Procesar */

$result = $client->call('Procesar',$params);
/* Verificamos la respuesta, retornada por el servicio

*/ if ($client->fault) {
echo '<h2>Fault (Error - La solicitud SOAP es
erronea)</h2><pre>'; print_r($result); echo '</pre>';
} else {
$err = $client-
>getError(); if ($err) {
echo '<h2>Error</h2><pre>' . $err . '</pre>';
} else {
/* Resultado exitoso */
echo $result['ProcesarResult'];
}
}
?>
Facturación.cl 10
Santiago – Chile
Fono (56-2) 947 28 00
En el ejemplo siguiente, veremos la misma funcionalidad del código anterior

utilizando PHP5 y su API SOAP integrada.
<?php
/* Ruta de acceso al servicio web */

$wsdl = 'http://192.168.1.1:8088/wsplano.asmx?wsdl';
try {
/* Creamos una instancia del cliente SOAP */
$client = new soapclient($wsdl);
/* Definimos los parametros a pasar al servicio */

$params = array(
'login' => array(
'Usuario' => base64_encode("Usuario")
,'Rut' => base64_encode("1-9")
,'Clave' => base64_encode("123456")
,'Puerto' => base64_encode("0")), 'file' =>
base64_encode($contenido_archivo), 'formato' => "1");
/* Invocamos el Web Service, Metodo: Procesar */

$response = $client->Procesar($params);
/* Respuesta entregada por el servicio web */ print_r($response);

} catch(SoapFault $e){ echo 'Hubo un error';
}
?>
Facturación.cl 11
Santiago – Chile
Fono (56-2) 947 28 00
Respuesta Métodos Consumidos
El método Procesar retorna como respuesta un archivo XML con la información

del resultado de el o los documentos procesados.
Ejemplo de proceso exitoso:
<WSPLANO>
<Resultado>True</Resultado>
<Mensaje>Proceso existoso.</Mensaje>
<Detalle>
<Documento>
<Folio>126</Folio>
<TipoDte>33</TipoDte>
<Operacion>VENTA</Operacion>
<Fecha>2008-09-12T15:55:09</Fecha>
<Resultado>True</Resultado>
<urlOriginal>aHR0cDovL3...I9PWZhbHNl</urlOriginal>
<urlCedible>aHR0cDovL3...M1ZjYmcPXRydWU=</urlCedible>
</Documento>
</Detalle>
</WSPLANO>
Ejemplo de proceso con errores:
<WSPLANO>
<Resultado>False</Resultado>
<Mensaje>Posee documentos con error.</Mensaje>
<Detalle>
<Documento>
<Folio>126</Folio>
<TipoDte>33</TipoDte>
<Operacion>VENTA</Operacion>
<Fecha>2008-09-12T15:55:09</Fecha>
<Resultado>False</Resultado>
<Error>ERROR: P0001: Ya existe el Documento
del TipoDTE = 33 con Folio = 126</Error>
</Documento>
</Detalle>
</WSPLANO>
Facturación.cl 12
Santiago – Chile
Fono (56-2) 947 28 00
Al consumir el método ObtenerLink, retornará como respuesta un archivo XML

que contendrá el Link de descarga del documento electrónico, generado en
formato PDF, este Link vendrá codificado en Base64, por lo cual deberá ser
decodificado.
Ejemplo de resultado ObtenerLink:
<WSPLANO>
<Mensaje>
aHR0cDovL3d3dy5kb21pbmlvLmNvbS9zaXN0ZW1hL2Rlc2Nhcmdhci5waHA/cDE9
YzI1YzBmYzllYiZwMj1HREkmbT1WJmk9JmM9ZmFsc2U=
</Mensaje>
</WSPLANO>
El nodo WSPLANO/Mensaje contendrá el Link codificado. una vez decodificado,

se obtendrá un Link similar al que se muestra a continuación:
http://www.dominio.com/sistema/descargar.php?p1=c25c0fc9eb&p2=GDI&m=V&i=
&c=false
Desde dicho Link, el cliente podrá descargar el archivo PDF del documento
electrónico.
Al consumir el método Online, puede verificar que el Servicio Web se encuentra

disponible.
Ejemplo de resultado Online:
<WSPLANO>
<Mensaje>
Online=1
</Mensaje>
</WSPLANO>
Facturación.cl 13
Santiago – Chile
Fono (56-2) 947 28 00
Al consumir el método getXMLDte, retornará como respuesta un archivo XML del

documento solicitado, el cual vendrá codificado en Base64, por lo cual deberá ser
decodificado.
Ejemplo de resultado getXMLDte:
<WSPLANO>
<Mensaje>
PERURSB2ZXJzaW9uPSIxLjAiPg0KCTxEb2N1bWVudG8gSUQ9IkYxVDM0Ij4NCgkJPEVuY2FiZX
phZG8+DQoJCQk8SWREb2M+DQoJCQkJPFRpcG9EVEU+MTwvVGlwb0RURT4NCgkJCQk8Rm9saW8+
MTwvRm9saW8+DQoJCQkJPEZjaEVtaXM+MjAwNi0wNC0xMTwvRmNoRW1pcz4NCgkJCTwvSWREb2
M+DQoJCQk8RW1pc29yPg0KCQkJCTxSVVRFbWlzb3I+REVNTzwvUlVURW1pc29yPg0KCQkJCTxS
em5Tb2M+REVNTzwvUnpuU29jPg0KCQkJCTxHaXJvRW1pcz5ERU1PPC9HaXJvRW1pcz4NCgkJCQ
k8QWN0ZWNvPkRFTU88L0FjdGVjbz4NCgkJCQk8RGlyT3JpZ2VuPkRFTU88L0Rpck9yaWdlbj4N
CgkJCQk8Q21uYU9yaWdlbj5ERU1PPC9DbW5hT3JpZ2VuPg0KCQkJCTxDaXVkYWRPcmlnZW4+RE
VNTzwvQ2l1ZGFkT3JpZ2VuPg0KCQkJPC9FbWlzb3I+DQoJCQk8UmVjZXB0b3I+DQoJCQkJPFJV
VFJlY2VwPkRFTU88L1JVVFJlY2VwPg0KCQkJCTxSem5Tb2NSZWNlcD5ERU1PPC9Sem5Tb2NSZW
NlcD4NCgkJCQk8R2lyb1JlY2VwPkRFTU88L0dpcm9SZWNlcD4NCgkJCQk8RGlyUmVjZXA+REVN
TzwvRGlyUmVjZXA+DQoJCQkJPENtbmFSZWNlcD5ERU1PPC9DbW5hUmVjZXA+DQoJCQkJPENpdW
RhZFJlY2VwPkRFTU88L0NpdWRhZFJlY2VwPg0KCQkJPC9SZWNlcHRvcj4NCgkJCTxUb3RhbGVz
Pg0KCQkJCTxNbnRFeGU+REVNTzwvTW50RXhlPg0KCQkJCTxNbnRUb3RhbD5ERU1PPC9NbnRUb3
RhbD4NCgkJCTwvVG90YWxlcz4NCgkJPC9FbmNhYmV6YWRvPg0KCQk8RGV0YWxsZT4NCgkJCTxO
cm9MaW5EZXQ+REVNTzwvTnJvTGluRGV0Pg0KCQkJPENkZ0l0ZW0+DQoJCQkJPFRwb0NvZGlnbz
5ERU1PPC9UcG9Db2RpZ28+DQoJCQkJPFZsckNvZGlnbz5ERU1PPC9WbHJDb2RpZ28+DQoJCQk8
L0NkZ0l0ZW0+DQoJCQk8SW5kRXhlPkRFTU88L0luZEV4ZT4NCgkJCTxObWJJdGVtPkRFTU88L0
5tYkl0ZW0+DQoJCQk8UXR5SXRlbT5ERU1PPC9RdHlJdGVtPg0KCQkJPFVubWRJdGVtPkRFTU88
L1VubWRJdGVtPg0KCQkJPFByY0l0ZW0+REVNTzwvUHJjSXRlbT4NCgkJCTxNb250b0l0ZW0+RE
VNTzwvTW9udG9JdGVtPg0KCQk8L0RldGFsbGU+
</Mensaje>
</WSPLANO>
* NOTA: Este método tiene un costo asociado por lo que debe solicitar
una cotización a la mesa de ayuda de facturación.cl.
Facturación.cl 14
Santiago – Chile
Fono (56-2) 947 28 00
Ya decodificado toma la siguiente forma:
<DTE version="1.0">
<Documento ID="F1T34">
<Encabezado>
<IdDoc>
<TipoDTE>1</TipoDTE>
<Folio>1</Folio>
<FchEmis>2006-04-11</FchEmis>
</IdDoc>
<Emisor>
<RUTEmisor>DEMO</RUTEmisor>
<RznSoc>DEMO</RznSoc>
<GiroEmis>DEMO</GiroEmis>
<Acteco>DEMO</Acteco>
<DirOrigen>DEMO</DirOrigen>
<CmnaOrigen>DEMO</CmnaOrigen>
<CiudadOrigen>DEMO</CiudadOrigen>
</Emisor>
<Receptor>
<RUTRecep>DEMO</RUTRecep>
<RznSocRecep>DEMO</RznSocRecep>
<GiroRecep>DEMO</GiroRecep>
<DirRecep>DEMO</DirRecep>
<CmnaRecep>DEMO</CmnaRecep>
<CiudadRecep>DEMO</CiudadRecep>
</Receptor>
<Totales>
<MntExe>DEMO</MntExe>
<MntTotal>DEMO</MntTotal>
</Totales>
</Encabezado>
<Detalle>
<NroLinDet>DEMO</NroLinDet>
<CdgItem>
<TpoCodigo>DEMO</TpoCodigo>
<VlrCodigo>DEMO</VlrCodigo>
</CdgItem>
<IndExe>DEMO</IndExe>
<NmbItem>DEMO</NmbItem>
<QtyItem>DEMO</QtyItem>
<UnmdItem>DEMO</UnmdItem>
<PrcItem>DEMO</PrcItem>
<MontoItem>DEMO</MontoItem>
</Detalle>
Facturación.cl 15
Santiago – Chile
Fono (56-2) 947 28 00
Al consumir el método EliminarDoc, Retorna el resultado de la eliminación del

documento no electrónico indicado.
Ejemplo de resultado EliminarDoc:
<WSPLANO>
<Mensaje>
Resultado>OK</Resultado
</Mensaje>
</WSPLANO>
Al consumir el método AnularGuia, Retorna el resultado de la anulación del

documento indicado. En este caso la guía de despacho seleccionada.
Ejemplo de resultado AnularGuia:
<WSPLANO>
<Mensaje>
Resultado>OK</Resultado
</Mensaje>
</WSPLANO>
Facturación.cl 16
Santiago – Chile
Fono (56-2) 947 28 00
Impresión Térmica
Consiste en un formato ticket de documento electrónico, desarrollado sin incluir

logotipo, siendo la mejor alternativa en velocidad y bajo consumo de insumos de
impresión, el cual requiere de una impresora térmica con capacidades gráficas con
cabezal de entre 3 y 4 pulgadas.
Para acceder a este formato debe obtener los módulos de FETICKET y BETICKET
correspondiente a factura y boleta térmica en la plataforma de facturacion.cl en
Widget de Compra de Productos Adicionales/Contrate Aquí/Otros Servicios.
Con la impresión térmica puede integrar y controlar el proceso de impresión
enviando los datos directamente a una impresora compatible con el lenguaje de
impresión POS/ESC. Consumiendo el método getBoletaTicket, indicando los datos
de la boleta que desea imprimir siendo la estructura (ticket@tipodte@folio).
Ej: Boleta Electrónica Afecta, Folio 100
Comando: ticket@39@100
Al ejecutar la llamada al servicio web, retornara un archivo XML con los datos
del ticket a imprimir en un archivo XML de la siguiente forma:
<WSPLANO>
<Mensaje>
<Head>GyEBHSEBUkFaT04gU09DSUFMIFB08gUy....</Head>
<Foot>DQpUSU1CUkUgRUxFQ1RST05JQ08gUy5J...</Foot>
<TED>PFRFRCB2ZXJzaW9uPSIxLjAiPjxERD48U...</TED>
</Mensaje>
</WSPLANO>
* NOTA: Este método solo puede ser consumido si cuento con formato
ticket térmico de Boletas o Facturas Electrónicas.
Facturación.cl 17
Santiago – Chile
Fono (56-2) 947 28 00
Las tres variables retornadas: Head, Foot y TED contienen su data codificada en
Base64, tras ser decodificadas, cada una de ellas contendrá la siguiente
información:
Head:
Cabecera de la Boleta
(Formato: POS/ESC)
TED:
Timbre Fiscal
(Formato: RAW) Debe ser impresa como un

código Bidimensional PDF417, para lo cual
debe consultar el manual del desarrollador
de su impresora.
Foot:
Pie de Pagina
(POS/ESC)
Facturación.cl 18
Santiago – Chile
Fono (56-2) 947 28 00
Componentes de Impresión
Las siguientes modalidades de impresión permiten la incorporación de la

impresión ticket, utilizando un componente preconstruido, minimizando el
desarrollo a realizar
1) Aplicación de Escritorio
i. Debe ejecutar la función: getBoletaTicket y obtener los datos de la boleta.

Descargue la librería de impresión:
https://www.facturacion.com/soporte/ImprimirTicket.jar
ii. Desde su aplicación realice una llamada por línea de comando a la Librería:
ImprimirTicket.jar, pasando como parámetros:
Nombre de la impresora: Debe ser una impresora instalada en el equipo local.

Y las Variables:
Head, Ted y Foot, Tal como retorna el XML del servicio Web sin decodificar.
Ejemplo en Lenguaje: VB.NET

Dim sImpresora As String = """" & g_sImpresora & """"
Dim sHead As String = """" &
oXMLRes.SelectSingleNode("/WSPLANO/Mensaje/Head").InnerText & """" Dim
sFoot As String = """" &
oXMLRes.SelectSingleNode("/WSPLANO/Mensaje/Foot").InnerText & """" Dim
sTed As String = """" &
oXMLRes.SelectSingleNode("/WSPLANO/Mensaje/TED").InnerText & """"
Dim Process As New Process()

Process.StartInfo = New ProcessStartInfo("""C:\Archivos de programa
files\Java\jre6\bin\java.exe""", " -jar ImprimirTicket.jar " &
sImpresora & " " & sHead & " " & sFoot & " " & sTed)
Process.StartInfo.CreateNoWindow =
True
Process.StartInfo.UseShellExecute
= False
Process.StartInfo.RedirectStandard
Output = True Process.Start()
Dim sRetorno As String = Process.StandardOutput.ReadLine()
Realizada la llamada, el ticket saldrá impreso por la impresora indicada.
Facturación.cl 19
Santiago – Chile
Fono (56-2) 947 28 00
2) Aplicación Web
Si su aplicación es una página web y desea incorporar la impresión térmica

en ella, debe realizarlo mediante la llamada a una página web que
incrustara en su página el componente de impresión. Al realizar la llamada
de la página, debe indicar los siguientes parámetros:
Campo Descripción
chk Corresponde a un identificador de validación proporcionado por
Facturacion.cl, este valor es único y será fijo.
i Nombre de la impresora, codificado en Base64
t Tipo de documento (39: Boleta Electrónica – 41: Boleta No
Afecta o Exenta Electrónica.
F Folio de la Boleta a imprimir.
Para realizar la llamada al componente de impresión, debe ejecutar la

siguiente URL con los parámetros previamente indicados:
Ejemplo:
https://www.facturacion.com/nombresistema
/form/boletaticket/externo.php?chk=f3342derf&i=U3RhciBCU0
MxMA==&t=39&f=52145
Donde la impresora es: Start BSC10 / TipoDTE: 39 /Folio: 52145
Una vez construida la URL puede incluirla fácilmente en su sistema web, la

opción más recomendable es mediante un iframe que mediante una llamada
Javascript asocie la URL al src del iframe.
Facturación.cl 20
Santiago – Chile
Fono (56-2) 947 28 00
Ejemplo:
<input type="button" onclick="termico()" value="imprimir">
<iframe id="impresion"
style="width:1px;height:1px;border:0px"></if
rame>
<script type="text/javascript">
function termico() {
var iframe = document.getElementById
("impresion"); iframe.src =
"https://www.facturacion.com/aliascliente/form/boletaticket/ex
terno.p hp?chk=f3342derf&i=U3RhciBCU0MxMA==&t=39&f=52145
";
}
</script>
* NOTA: La opción de impresión utilizando el componente

proporcionado por Facturación.cl requiere de tener instalado en el
equipo La máquina virtual Java la cual se puede descargar de forma
gratuita desde: https://www.java.com/es/download/.
* NOTA: El componente de impresión, funciona solo con un número
limitado de impresoras, si desea saber si su impresora es
compatible, puede hacerlo utilizando la herramienta:
http://www.facturacion.cl/verificaimpresora
Facturación.cl 21
Santiago – Chile
Fono (56-2) 947 28 00

Manual Webservice CL

Cargado por

Copyright:

Formatos disponibles

Manual Webservice CL

Cargado por

Información del documento

Descripción original:

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Manual Webservice CL

Cargado por

Copyright:

Formatos disponibles

MANUAL DE INTEGRACIÓN

Para realizar la integración entre aplicaciones, utilizaremos la tecnología

Un servicio Web es un conjunto de protocolos o estándares que permiten

Para la comunicación de datos mediante Servicios Web, éstos utilizan estándares y

El protocolo SOAP permite la comunicación de dos objetos mediante el

Gracias a que la tecnología de Servicio Web SOAP está basada en estándares

A continuación, se presenta un listado de solamente algunos de los clientes y

Plataforma Lenguaje Nombre URL

URL del Servicio Web

Para acceder al WebService tanto en ambiente de pruebas como producción debe

- El primer paso consiste en construir el archivo de Integración, el cual será

Actualmente disponemos de dos formatos, para los cuales existe su

 Archivos de Texto Plano (TXT)

Éstos archivos deberán contener la información del documento a generar (Factura

Para más información respecto de los formatos de dichos archivos, se pueden

- El segundo paso consiste en enviar dicho archivo a nuestro Servicio Web,

- El tercer paso y final consiste en obtener la representación impresa del

La información debe ser enviada de manera codificada utilizando el formato de

La información de autenticación es transmitida en una variable de tipo objeto,

Parámetro Descripción Codificado

Parámetro Descripción Codificado

Parámetros No posee parámetros

Parámetro Descripción Codificado

Método: getXMLDte (Costo Adicional)

Parámetro Descripción Codificado

Parámetro Descripción Codificado

Parámetro Descripción Codificado

En el siguiente ejemplo, veremos la manera de procesar el archivo de

/* Ruta de acceso al servicio web */

/* Creamos una instancia del cliente SOAP */

/* Definimos los parametros a pasar al servicio */

/* Invocamos el Web Service, Metodo: Procesar */

/* Verificamos la respuesta, retornada por el servicio

En el ejemplo siguiente, veremos la misma funcionalidad del código anterior

/* Ruta de acceso al servicio web */

/* Definimos los parametros a pasar al servicio */

/* Invocamos el Web Service, Metodo: Procesar */

/* Respuesta entregada por el servicio web */ print_r($response);

Respuesta Métodos Consumidos

El método Procesar retorna como respuesta un archivo XML con la información

Ejemplo de proceso exitoso:

Ejemplo de proceso con errores:

Al consumir el método ObtenerLink, retornará como respuesta un archivo XML

Ejemplo de resultado ObtenerLink:

El nodo WSPLANO/Mensaje contendrá el Link codificado. una vez decodificado,

Al consumir el método Online, puede verificar que el Servicio Web se encuentra

Ejemplo de resultado Online:

Al consumir el método getXMLDte, retornará como respuesta un archivo XML del

Ya decodificado toma la siguiente forma:

Al consumir el método EliminarDoc, Retorna el resultado de la eliminación del

Ejemplo de resultado EliminarDoc:

Al consumir el método AnularGuia, Retorna el resultado de la anulación del

Ejemplo de resultado AnularGuia:

Consiste en un formato ticket de documento electrónico, desarrollado sin incluir

Ej: Boleta Electrónica Afecta, Folio 100

(Formato: RAW) Debe ser impresa como un

Las siguientes modalidades de impresión permiten la incorporación de la

i. Debe ejecutar la función: getBoletaTicket y obtener los datos de la boleta.

Nombre de la impresora: Debe ser una impresora instalada en el equipo local.