Professional Documents
Culture Documents
Interfaces de Facturación
On Line/Masivo
Versión 5.3
Fecha 11/08/2016
1. BITÁCORA DE CAMBIOS
Fecha de Cambio Versión Autor Detalle cambios
05/07/2010 4.2 Fernando Se modifica método
Parcerisas OnlineRecoveryRecList,
respecto de la lista de datos
que retorna.
06/07/2010 4.3 Fernando Se modifica método
Parcerisas OnlineRecoveryRecList,
respecto de la lista de datos
que retorna. Se agrega dato
Fecha de Recepción DTE en
plataforma de PPL.
06/09/2011 4.4 Eduard Carriel Se agrega información sobre
consulta PDF
Se agrega descripción de
interfaces de procesos
Masivos
15/11/2011 4.5 Maximiliano De agrega información para
Casanova sobre los métodos nuevos
GestionRec y OnlineRecoveryFolio
27/05/2013 4.6 Felipe Carvajal Se agregan ejemplos de
respuesta para cada opción de
retorno de los WS.
24/01/2014 4.7 Felipe Carvajal Se corrige ejemplo pare el
método
OnlineRecoveryRecList
20/10/2014 4.8 Alfonso Henriquez Se agrega documentación
de WS de aceptación y
rechazo comercial y de Ley
19983 de forma masiva.
16/06/2015 4.9 Eduard Carriel Agrega método de
anulación de Boletas
22/09/2015 5.0 Eduard Carriel Agrega métodos existentes
no inlcuidos anteriormente
11/08/2016 5.3 Eduard Carriel Corrige parámero extra en
OnlineGeneration
2. INTRODUCCIÓN.
Para todos los métodos se retorna un String en formato XML, con la información del
proceso.
3. GENERACIÓN (INYECCIÓN) DE DOCUMENTOS EN LA PLATAFORMA
Importante:
param1:(string) Login del usuario. Puede venir vacío si se utiliza hash MD5 para la validación
Tipos de Datos:
Codigo: int
Mensaje: String
Ejemplo invocación:
Request
Response
0 = ID asignado
5 = Estado en SII
6 = Folio Asignado
MÉTODO: OnlineGenerationRaw
Tiene la misma función que los métodos OnlineGenerationDte y OnlineGenerationBol,
con la diferencia que no está enfocado a un tipo de documento en particular, por lo
que se agrega un nuevo parámetro (param4), en donde se le indica dicho tipo (la
invocación es similar a la de los métodos anteriores (mas el parámetro extra)), y la
respuesta es exactamente la misma.
param1:(string) Login del usuario. Puede venir vacío si se utiliza hash MD5 para la validación
Tipos de Datos:
Codigo: int
Mensaje: String
MÉTODO: OnlineGeneration
Tiene la misma función que los métodos OnlineGenerationDte y OnlineGenerationBol,
la diferencia es sólo en parámetro que indica el documento a generar (param3), que
corresponde al XML previamente generado, el que será foliado (si corresponde),
timbrado y firmado. La respuesta es exactamente la misma a la de los métodos
anteriores
param1:(string) Login del usuario. Puede venir vacío si se utiliza hash MD5 para la validación
Tipos de Datos:
Codigo: int
Mensaje: String
4. RECUPERACIÓN DE INFORMACIÓN DE DOCUMENTOS DE LA
PLATAFORMA
MÉTODO: OnlineRecovery
Permite recuperar información del documento, los parámetros son:
param1:(string) Login del usuario. Puede venir vacío si se utiliza hash MD5 para la validación
Tipos de Datos:
Codigo: int
Mensaje: String
Request
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-
ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<SOAP-ENV:Body>
<m:OnlineRecovery xmlns:m="http://webservices.online.webapp.paperless.cl">
<m:param0>96915310</m:param0>
<m:param1>adm_ppl</m:param1>
<m:param2>abc123</m:param2>
<m:param3>61</m:param3>
<m:param4>1025</m:param4>
<m:param5>0</m:param5>
</m:OnlineRecovery>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Response
0 = ID asignado
5 = Estado en SII
6 = Folio Asignado
param1:(string) Login del usuario. Puede venir vacío si se utiliza hash MD5 para la validación
Tipos de Datos:
Codigo: int
Mensaje: String
Request
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-
ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<SOAP-ENV:Body>
<m:OnlineRecovery2 xmlns:m="http://webservices.online.webapp.paperless.cl">
<m:param0>96915310</m:param0>
<m:param1>adm_ppl</m:param1>
<m:param2>abc123</m:param2>
<m:param3>61</m:param3>
<m:param4>1025</m:param4>
<m:param5>1000</m:param5>
<m:param6>0</m:param5>
</m:OnlineRecovery2>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
param1:(string) Login del usuario. Puede venir vacío si se utiliza hash MD5 para la validación
Tipos de Datos:
Codigo: int
Mensaje: String
Ejemplo invocación
Request
Response
0 = ID asignado
5 = Estado en SII
6 = Folio Asignado
MÉTODO: OnlineRecoveryRecList
Retorna información de los datos principales de los documentos recibidos en 1 día
determinado.
Los parámetros son:
Ejemplo invocación:
Request
Response
Siendo:
Código: el código de retorno de la consulta. Ver detalle en Tabla de Códigos
Mensaje: La lista de documentos recibidos (separados por pipe) en el formato:
99999999-9;99;9999;AAAA-MM-DD|99999999-9;99;9999;AAAA-MM-DD;9999999
99999999-9: Rut emisor del documento con digito verificador separado por guión (-)
99: Tipo de documento según SII
9999: Folio del documento
AAAA-MM-DD: Fecha de Emisión del documento
9999999: Monto Bruto (Monto total Documento)
Importante: Si alguno de los datos indicados no viene en el archivo XML del documento se enviará el dato
vacío en la estructura, conservando los separadores. Ejemplo: ;;
Para efectos de detallar los datos que son opcionales en el XML se debe revisar el documento de
especificación del SII, respecto de la normativa de cada uno de los campos indicados.
MÉTODO: listaDocRec
Retorna información de los datos principales de los documentos recibidos en un rago
de días determinado.
Los parámetros son:
Ejemplo invocación:
Request
Response
Cantidad de Documentos
Rut Receptor (sin dv)|Rut Emisor (sin dv)| Tipo de Documento|Folio del Documento
6. CONSULTA DE INFORMACIÓN
MÉTODO: Consult
Permite recuperar información particular de un Cliente. Este servicio requiere que para
cada Cliente exista la implementación correspondiente de acuerdo a sus necesidades
particulares
param1:(string) Login del usuario. Puede venir vacío si se utiliza hash MD5 para la validación
param3:( int) Parámetros de consulta (tipo, valores y formato, dependen de cada cliente)
Ejemplo invocación
Request
<?xml version="1.0" encoding="UTF-8" ?>
<ns1:Consult xmlns:ns1="http://webservices.online.webapp.paperless.cl">
<ns1:param0>83382700</ns1:param0>
<ns1:param1>gen_paperless</ns1:param1>
<ns1:param2>abc123</ns1:param2>
<ns1:param3>'parametros'</ns1:param3>
</ns1: Consult >
Ejemplo invocación:
Request
Response
Los parámetros son similares para todos los servicios, aunque aquellos terminados en
“Desc”, incluyen un parámetro extra con la descripción de la OT:
Ejemplo invocación:
Request
Nota: SERVICIOGENERACION corresponde al servicio invocado, y el parámetro 4, sólo debe ir en los servicios terminados en
“Desc”
Response
param3:(string) Ruta local al Servidor, del archivo con los datos del Libro
Ejemplo invocación:
Request
Response
<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<ns: GeneracionLibroResponse xmlns:ns="http://webservices.online.webapp.paperless.cl">
<ns:return>
<?xml version="1.0" encoding="ISO-8859-1"?>
<Respuesta>
<Codigo>0</Codigo>
<Mensaje>100</Mensaje>
</Respuesta>
</ns:return>
</ns: GeneracionLibroResponse>
</soapenv:Body>
</soapenv:Envelope>
Nota: La respuesta es un XML en formato String (no un ComplexType). Los caracteres
< corresponden a la codificación del caracter “<”.
El valor del tag “Mensaje” corresponde al Id asignado por la Plataforma Paperless
METODO : OnlineRecoveryFolio
Permite pedir un rango de folios para la compañía para un tipo de documento. Retornando como respuesta un xml con
la información de menor folio como inicio hasta el mayor folio.
Ejemplo:
Request
Response
Explicación de la respuesta
El Cliente pide una cantidad de folios en total 30, Como respuesta se puede dar de la
siguiente forma [1,30] o [1,10][51,69][71]
porque [1,10][51,69][71] hasta completar los 30, se puede dar el caso, que los folios del
11 al 50 estén utilizados y por eso es el motivo de que se salta tal cantidad de folios.
10. GESTIÓN DE DOCUMENTOS RECIBIDOS
METODO: GestionRec
Este método gestiona los documentos recibidos para la aprobación o rechazo comercial
para los documentos aprobados por el SII.
Ejemplo:
Request
Response
Ejemplo:
Request
Response
Ejemplo:
Request
Response
Ejemplo:
Request
Response
Códigos:
Ejemplo:
Request
Response
MÉTODO: AnulaGuia
Permite anular folios de Guías de Despacho, los parámetros son:
param1:(string) Login del usuario. Puede venir vacío si se utiliza hash MD5 para la validación
Request
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-
ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<SOAP-ENV:Body>
<m:AnulaGuia xmlns:m="http://webservices.online.webapp.paperless.cl">
<m:param0>96915310</m:param0>
<m:param1>adm_ppl</m:param1>
<m:param2>abc123</m:param2>
<m:param3>52</m:param3>
<m:param4>1025</m:param4>
</m:AnulaGuia>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Response
Error, archivo Xml inválido. No se puede recuperar información desde el archivo enviado, dado
-1
que está mal formado.
-3 Error, falta información del emisor Falta registrar algunos datos del Emisor o No Existe.
Error, no hay CAF para el No hay CAF registrado para el Folio y Tipo de documento enviado.
-7
documento
-10 Error al enviar documento. No se pudo ingresar el documento a la aplicación para ser enviado
al SII. Esto se debe principalmente a errores de schema del archivo
ingresado.
-12 Error, documento no encontrado. Se trata de consultar un documento que no existe (al consultar el
XML, el PDF, el Estado ante el SII, el Timbre, etc.).
-13 Error al generar imagen del Se da generalmente por que no se puede encontrar las librerías
timbre. gráficas del sistema.
-19 Error de Schema. Este error indica que el documento XML generado por la plataforma
de PPL no cumple con el Schema del SII. Algunas causas pueden
ser: Certificado inválido, error en el formateo de un dato como por
ejemplo fechas, etc.
8 Documento Aceptado por el SII El documento fue enviado al SII y se recibió respuesta de
Aceptación por mail.
6 Documento Aceptado con El documento fue enviado al SII y se recibió respuesta de Reparo
Reparos por el SII por mail. (En el Xml de Respuesta generado por la aplicación, se
agrega el motivo del reparo).
7 Documento Aceptado con El documento fue enviado al SII y se recibió respuesta de Reparo
Reparos Leves por el SII Leve por mail. (En el Xml de Respuesta generado por la aplicación,
se agrega el motivo del reparo).
l :(string) Login del usuario. Puede venir vacío si se utiliza hash MD5 para la validación
l :(string) Login del usuario. Puede venir vacío si se utiliza hash MD5 para la validación
Siendo:
Código: el código de retorno de la consulta. Ver detalle en Tabla de Códigos
Mensaje: Respuesta solicitada según el tipo de devolución definido
14. RECUPERACIÓN DE INFORMACIÓN DE DOCUMENTOS DE LA
PLATAFORMA VIA HTTP
l :(string) Login del usuario. Puede venir vacío si se utiliza hash MD5 para la validación
Siendo:
Código: el código de retorno de la consulta. Ver detalle en Tabla de Códigos
Mensaje: El mensaje estará conformado de 2 ó más tags, los que se describen a
continuación:
Estado: Descripción del estado general de la respuesta
Detalle (1 a n): Pueden ser varios elementos de este tag, e indican información
adicional del documento
Ejemplo para un documento aprobado:
l :(string) Login del usuario. Puede venir vacío si se utiliza hash MD5 para la validación
ConsHash-RutEmisor-Folio-2-ConsHash
Siendo:
ConsHash: La constante Hash asignada al Cliente y registrada en la Base de
Datos Paperless (si no tiene valor asignado se conserva el guión inicial y
final, quedando "-RutEmisor-Folio-2-")
RutEmisor: Rut de la empresa sin el dígito verificador
Folio: Folio del documento consultado
NOTA: La constante "2" corresponde al tipo de respuesta solicitada, que en
este caso es PDF
Siendo:
Código: el código de retorno de la consulta. Ver detalle en Tabla de Códigos de
Retorno.
Mensaje: El link del PDF del documento
16. GENERACIÓN DE DOCUMENTOS EN FORMA MASIVA VÍA HTTP
t: (int) Tipo de Documentos del archivo (1 -> DTE, 2 -> Boleta, 3 -> Mixto)
l :(string) Login del usuario. Puede venir vacío si se utiliza hash MD5 para la validación
Siendo:
Código: el código de retorno de la consulta. Ver detalle en Tabla de Códigos de
Retorno.
Mensaje: El Id asignado a la OT
17. APROBACIÓN Y RECHAZO DE LEY MASIVO
METODO: AprobRechLeyMasivo
Este método procesa documentos y acepta o rechaza la ley de forma masiva para
finalmente entregar un resumen de los registros procesados, dando un detalle por
documento (separado por salto de línea).
param3:(int) Entrada (pueden venir varias líneas separadas por un salto de línea):
RUTRECEPTOR|RUTEMISOR|TIPODTE|FOLIO|RESPUESTA*|MOTIVO
* Respuestas 1, 2 o 3, que significan APROBAR, RECHAZAR o ENVÍO DE LEY
respectivamente.
* En caso de enviar 2 se debe adjuntar el motivo obligatorio.
* En caso de enviar 3 se puede adjuntar el recinto en el campo MOTIVO
opcionalmente.
Ejemplo:
Request
l :(string) Login del usuario. Puede venir vacío si se utiliza hash MD5 para la validación
Siendo:
Código: el código de retorno de la consulta. Ver detalle en Tabla de Códigos de
Retorno.
Mensaje: Informe de la anulación correcta, o el motivo de la no anulación
19. GESTIÓN DE DOCUMENTOS EMITIDOS
METODO: GestionEmitido
Este método gestiona los documentos emitidos para la aprobación o rechazo comercial.
Ejemplo:
Request
Response
ejemplos :
2|Documento Rechazado Comercialmente|rechazado por monto total|2015-09-02|2015-
09-01
3|Aprobado Envio Ley 19.983|Comprobante Mercaderia/Servicio recibido en: Central de
Recepcion|2012-03-02|2012-03-02
4|Acuse de recibo recibido|ok|2012-03-02|2012-03-02
Códigos: