WebServices

Interfaces de Facturación
On Line
Versión 1.4

Fecha 28/04/2015
1. BITÁCORA DE CAMBIOS
Fecha de Cambio Versión Autor Detalle cambios
05/04/2011 1.0 Fernando Creación del documento.
Parcerisas
18/05/2011 1.1 Fernando Se agrega método
Parcerisas OnlineRecoveryRecList.
17/06/2014 1.1 Fernando Se modifica la tabla de
Parcerisas Códigos de Estado. Se
actualizan los valores de
los Estados retornados
por la SUNAT. Punto 6 del
documento.
17/06/2014 1.1 Fernando Se corrige el salto de
Parcerisas línea declarado
originalmente como
@#Lindet#@ por
@#Linea#@
27/06/2014 1.2 Fernando 1. Se agrega el método
Parcerisas OnlineConsultaEstado
2. Se agrega a Método
OnlineGeneration el
retorno del HASH y
PDF417
24/07/2014 1.3 Michele Di Carlo Se actualizan los códigos
de tipo de retorno por los
WS de OnlineGeneration y
OnlineRecovery
29/04/2015 1.4 Miguel Rojas Se agrega consideración
sobre la utilización del
encoding UTF-8

2. INTRODUCCIÓN.

El presente documento tiene por finalidad entregar la información para la

implementación Online desde los sistemas actuales y el ambiente de
facturación, a través de tecnologías WebServices.

Para todos los métodos se retorna un String en formato XML, con la

información del proceso.
3. CONSIDERACIÓN GENERAL
Para el correcto reconocimiento de caracteres especiales en las tramas que se
envían a la plataforma de Paperless, se debe de incluir en las llamadas de los
web services la referencia al UTF-8 de la siguiente manera:

4. GENERACIÓN (INYECCIÓN) DE DOCUMENTOS EN LA PLATAFORMA

Importante:

Los archivos WSDL serán publicados en una url por confirmar.

MÉTODO: OnlineGeneration (colocar ejemplos e incorporarlos)

Permite la generación de documentos en forma OnLine (1 por vez), y los
parámetros son:

param0:(string) RUC de la empresa emisora

param1:(string) Login del usuario.

param2:(string) Password del usuario

param3:(string) Documento a generar.

param4:(int) Tipo de generación de folios (automática -> 1, manual -> 2)

param5:(int) Tipo de devolución de respuesta, el que pueden ser:

0 = ID asignado
1 = URL del XML
2 = URL del PDF
3 = Estado en la SUNAT
4 = Folio Asignado (Serie-Correlativo)
5 = Bytes del PDF en Base64
6 = PDF417 (Cadena de texto a imprimir en el PDF 417)
7 = HASH (Cadena de texto)

Ejemplo invocación:
Request
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:ws="http://ws.online.asp.core.paperless.cl">

<soap:Header/>

<soap:Body>

<ws:OnlineGeneration>

<ws:ruc>20109072177</ws:ruc>

<ws:login>gen_paperless</ws:login>

<ws:clave>abc123</ws:clave>

<ws:docTxt>

EN|01|F500-00000011||||2014-05-04|USD|20109072177|6|Tecnologica de Alimentos|Tecnologica de
Alimentos|150131|CALETA NRO. SN CAS. VEGUETA (CALETA DE
VEGUETA)|LIMA|HUAURA|HUACHO|20531010389|6|INVERSIONES ZERO SOCIEDAD ANONIMA CERRAD|CAL. LA
MANCHURRIA NRO. 375 , HUAURA - HUACHO , LIMA,LIMA|8.44|1.52|||9.96|||20531010389|6

DOC|1001| 8.44

DN|1|1000|NUEVE Y 96 / 100 Dolares Americanos

DE|1|5.43|C62|1.000|5.43|000000000000267818|01|4.60|4.60

DEDI|000000000000267818@@RODAMIENTO 6205-2RSH

DEIM|0.83|4.60|0.83|18||10||1000|IGV|VAT

DE|2|4.53|C62|1.000|4.53|000000000000267834|01|3.84|3.84

DEDI|000000000000267834@@RODAMIENTO 6204-2RSH

DEIM|0.69|3.84|0.69|18||10||1000|IGV|VAT

DI|1.52|1.52|1000|IGV|VAT

PES|GlosaDetalle

PESD|1|EP. ANA TOMASA

PESD|2|MATRICULA : CO-15807-CM

PESD|3|VALE REQUISION ALMACEN FLOTA N°00225

PESD|4|ATENDIDO POR ALMACEN FS14 VEGUETA

PE|CantArticulos|2

PE|GlosaMonto|NUEVE Y 96 / 100 Dolares Americanos

PE|Pedido|0000176324

PE|NumIntSap|0090219387

</ws:docTxt>

<ws:tipoFoliacion>1</ws:tipoFoliacion>

<ws:tipoRetorno>1</ws:tipoRetorno>

</ws:OnlineGeneration>

</soap:Body>

</soap:Envelope>

Response
<soapenv:Envelope xmlns:soapenv="http://www.w3.org/2003/05/soap-envelope">

<soapenv:Body>

<ns:OnlineGenerationResponse xmlns:ns="http://ws.online.asp.core.paperless.cl">

<ns:return><![CDATA[<?xml version="1.0" encoding="UTF-8" ?>

<Respuesta>

<Codigo>0</Codigo>

<Mensaje>http://localhost:8085/Facturacion/XMLServlet?id=UfnXLlqR/gQ(IgU)&o=E</Mensaje>

</Respuesta>]]></ns:return>

</ns:OnlineGenerationResponse>

</soapenv:Body>

</soapenv:Envelope>

NOTA: La respuesta es un XML en formato String, no una estructura compleja.

Cambiar el estado SUNAT
Es solo para consulta
Solo se invoca una vez para el mismo documento

5. RECUPERACIÓN DE INFORMACIÓN DE DOCUMENTOS DE LA

PLATAFORMA

MÉTODO: OnlineRecovery
Permite recuperar información del documento, los parámetros son:

param0:(string) RUC de la empresa

param1:(string) Login del usuario

param2:(string) Password del usuario

param3:(string) Tipo de documento Electrónicos según la SUNAT

01 = Factura
03 = Boleta
07 = Nota de Crédito
08 = Nota de Débito
param4:(string) Folio del documento consultado (Serie-Correlativo). Por ejemplo:
F00001-1

param5:(int) Tipo de devolución de respuesta, el que pueden ser:

0 = ID asignado
1 = URL del XML
2 = URL del PDF
3 = Estado en la SUNAT
 4 = Folio Asignado (Serie-Correlativo)
5 = Bytes del PDF en Base64
6 = PDF417 (Cadena de texto a imprimir en el PDF 417)
7 = HASH (Cadena de texto)

Ejemplo invocación
Request

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:ws="http://ws.online.asp.core.paperless.cl">

<soap:Header/>

<soap:Body>

<ws:OnlineRecovery>

<ws:ruc>20100070970</ws:ruc>

<ws:login>gen_paperlesss</ws:login>

<ws:clave>abc123</ws:clave>

<ws:tipoDoc>1</ws:tipoDoc>

<ws:folio>F001-1</ws:folio>

<ws:tipoRetorno>2</ws:tipoRetorno>

</ws:OnlineRecovery>

</soap:Body>

</soap:Envelope>

Response

<soapenv:Envelope xmlns:soapenv="http://www.w3.org/2003/05/soap-envelope">

<soapenv:Body>

<ns:OnlineRecoveryResponse xmlns:ns="http://ws.online.asp.core.paperless.cl">

<ns:return><![CDATA[<?xml version="1.0" encoding="UTF-8" ?>

<Respuesta>

<Codigo>0</Codigo>

<Mensaje>http://localhost:8085/Facturacion/PDFServlet?id=LE7l6wk7Yvc(IgU)&o=E</Mensaje>

</Respuesta>]]></ns:return>

</ns:OnlineRecoveryResponse>

</soapenv:Body>

</soapenv:Envelope>

NOTA: La respuesta es un XML en formato String, no una estructura compleja.

6. INFORMACIÓN DE DOCUMENTOS RECIBIDOS WS
MÉTODO: OnlineRecoveryRec
Permite recuperar información de los documentos Recibidos, los parámetros
son

param0:(string) RUC de la empresa

param1:(string) Login del usuario

param2:(string) Password del usuario

param3(string) RUC del Emisor del Documento

param4:( int) Tipo de documento Electrónicos según la SUNAT

01 = Factura
03 = Boleta
07 = Nota de Crédito
08 = Nota de Débito
param5:(string) Folio del documento consultado (Serie-Correlativo). Por ejemplo:
F001-1
Param6:(int) Tipo de devolución de respuesta, el que pueden ser:
0 = ID asignado
1 = URL del XML
2 = URL del PDF
3 = Estado en SUNAT

Ejemplo invocación
Request

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:ws="http://ws.online.asp.core.paperless.cl">

<soap:Header/>

<soap:Body>

<ws:OnlineRecoveryRec>

<ws:ruc>20100070970</ws:ruc>

<ws:login>admin</ws:login>

<ws:clave>abc123</ws:clave>

<ws:rucEmisor>24905499934</ws:rucEmisor>

<ws:tipoDoc>1</ws:tipoDoc>

<ws:folio>F001-234</ws:folio>

<ws:tipoRetorno>3</ws:tipoRetorno>

</ws:OnlineRecoveryRec>

</soap:Body>

</soap:Envelope>
Response

<soapenv:Envelope xmlns:soapenv="http://www.w3.org/2003/05/soap-envelope">

<soapenv:Body>

<ns:OnlineRecoveryRecResponse xmlns:ns="http://ws.online.asp.core.paperless.cl">

<ns:return><![CDATA[<?xml version="1.0" encoding="UTF-8" ?>

<Respuesta>

<Codigo>-8</Codigo>

<Mensaje>DOCUMENTO ACEPTADO POR LA SUNAT</Mensaje>

</Respuesta>]]></ns:return>

</ns:OnlineRecoveryRecResponse>

</soapenv:Body>

</soapenv:Envelope>

Nota: La respuesta es un XML en formato String (no un ComplexType). Los

caracteres &lt; corresponden a la codificación del caracter “<”.

MÉTODO: OnlineRecoveryRecList
Retorna información de los datos principales de los documentos recibidos en
1 día determinado.
Los parámetros son:

param0:(string) RUC de la empresa

param1:(string) Login del usuario

param2:(string) Password del usuario

param3:(string) Fecha de recepción

Ejemplo invocació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:OnlineRecoveryReclist xmlns:m="http://webservices.online.webapp.paperless.cl">
<m:param0>20100070970</m:param0>
<m:param1>gen_paperless</m:param1>
<m:param2>abc123</m:param2>
<m:param3>2010-03-03</m:param3>
</m:OnlineRecoveryReclist>
 </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Response

<?xml version="1.0" encoding="UTF-8"?>

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<ns: OnlineRecoveryReclist xmlns:ns="http://webservices.online.webapp.paperless.cl">
<ns:return>
&lt;?xml version="1.0" encoding="ISO-8859-1"?>
&lt;Respuesta>
&lt;Codigo>0&lt;/Codigo>
&lt;Mensaje>99999999-9;99;9999;AAAA-MM
DD;9999999;9999999;9999999;9999999;XXXXXXX;AAAA-MM-DD|99999999-9;99;9999;AAAA-MM-DD;9999999;9999999; 9999999;
9999999; XXXXXXX;AAAA-MM-DD &lt;/Mensaje>
&lt;/Respuesta>
</ns:return>
</ns:OnlineRecoveryReclist>
</soapenv:Body>
</soapenv:Envelope>

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;9999999;9999999;9999999;9999999;XXXXXXX;AAAA-MM-
DD|99999999-9;99;9999;AAAA-MM-DD;9999999;9999999; 9999999; 9999999; XXXXXXX; AAAA-MM-
DD
999999999: RUC Emisor
99: Tipo de documento según SUNAT
9999: Serie - Correlativo
AAAA-MM-DD: Fecha de Emisión del documento
9999999: Monto Bruto (Monto total Documento)
9999999: IGV
9999999: Monto Neto
9999999: Orden de Compra
XXXXXXX: Moneda
AAAA-MM-DD: Fecha de Recepción del documento en la plataforma de PPL.

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. El detalle de la
especificación de los datos está en el documento de integración de SPSA.

En caso de no encontrar documentos en el día consultado, el mensaje retornado es:

“Error, documento no encontrado.: No hay documentos recibidos para la fecha consultada”

7. INFORMACIÓN DE DOCUMENTOS EMITIDOS (POR RANGO DE

FECHAS)

MÉTODO: OnlineConsultaEstado
Retorna información de los datos principales de los documentos para un
estado determinado para un RUC receptor particular para un rango de fecha.
Los parámetros son:

param0:(string) RUC de la empresa Emisora

param1:(string) Login del usuario

param2:(string) Password del usuario

param3:(string) Ruc de la empresa Receptora

param4:(string) Fecha Emisión desde (DD/MM/YYYY)

param5:(string) Fecha Emisión hasta (DD/MM/YYYY)

param6:(int) Estado:
1: Generación PPL
2: Aprobado SUNAT
3: Rechazado SUNAT
4: Reparado SUNAT
5: No enviado SUNAT

Los datos son obligatorios y la diferencia entre las fechas no puede ser mas de 1 mes.

Ejemplo invocació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:OnlineRecoveryRec xmlns:m="http://webservices.online.webapp.paperless.cl">
<m:param0>20100070970</m:param0>
<m:param1>gen_paperless</m:param1>
<m:param2>abc123</m:param2>
<m:param3>24905499934</m:param3>
<m:param4>01/01/2014</m:param4>
<m:param5>30/01/2014</m:param5>
<m:param6>3</m:param6>
</m:OnlineRecoveryRec>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Response

<?xml version="1.0" encoding="UTF-8"?>

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<ns:OnlineRecoveryRecResponse xmlns:ns="http://webservices.online.webapp.paperless.cl">
<ns:return>
200101039|01/01/2014|F001-002|PEN|123.23
200101039|02/01/2014|F001-004|PEN|13.23
200101039|02/01/2014|F001-006|PEN|12.56
200101039|02/01/2014|F001-008|PEN|54.3
200101039|03/01/2014|F001-009|PEN|1233.4
</ns:return>
</ns:OnlineRecoveryRecResponse>
</soapenv:Body>
</soapenv:Envelope>

8. LOS CÓDIGOS DE RETORNO SON

Código Descripción Causa

0 Respuesta solicitada En este caso el proceso finaliza correctamente.

Error, archivo Xml inválido. No se puede recuperar información desde el archivo

-1
enviado, dado que está mal formado.

Error, el archivo debe El archivo contiene más de 1 documento.

-2
contener solo 1 documento

Error, falta información del Falta registrar algunos datos del Emisor o No Existe.
-3
emisor

-4 Error, Emisor no registrado El Emisor no existe.

Error al recuperar el No se encuentra el certificado de la empresa en el servidor

-5
Certificado de la Empresa de aplicaciones.

-6 Error al Foliar el documento. No se pudo asignar un correlativo al documento.

-8 Error al firmar el documento. Falla al firmar el Documento.

-9 Error al firmar el envío. Falla al firmar el Envío.

-10 Error al enviar documento. No se pudo ingresar el documento a la aplicación para ser
enviado a la SUNAT. Esto se debe principalmente a errores
de schema del archivo ingresado.

-11 Error de conexión DB. Se debe a un problema con la Base de Datos.

-12 Error, documento no Se trata de consultar un documento que no existe (al

encontrado. consultar el XML, el PDF, el Estado ante la SUNAT, etc.).

-14 Error al validar usuario. El usuario no existe, el password no corresponde u otro.

 Código Descripción Causa

-19 Error de Schema. Este error indica que el documento XML generado por la
plataforma de PPL no cumple con el Schema UBL de la
SUNAT. Algunas causas pueden ser: error en el formateo
de un dato como por ejemplo fechas, etc.

-98 Mensaje de Error Errores inesperados, ej: Falla la comunicación webservices.

-99 Error, opción de retorno La opción de retorno selecciona no es válida.

inválida.

1 Aceptado Documento con Estado Aceptado por la SUNAT

2 Aceptado con Documento con Estado Aceptado con observaciones

observaciones por la SUNAT

3 Rechazado Documento con Estado Rechazado por la SUNAT

9. GENERACIÓN (INYECCIÓN) DE DOCUMENTOS EN LA PLATAFORMA

VIA HTTP

PÁGINA: Online.jsp (http:/ip:puerto/Facturacion/webservices/Online.jsp)

Permite la generación de documentos en forma OnLine (1 por vez) a partir
de información del archivo enviado vía POST.

Requiere los siguientes parámetros:

e :(string) RUC de la empresa

t :(int) Código de Tipo de documento según la SUNAT

tr:(int) Tipo de devolución de respuesta, el que pueden ser:

0 = ID asignado
1 = URL del XML
2 = URL del PDF
3 = Estado en SUNAT
4 = Folio Asignado (Serie y Correlativo)
a :(string) Documento en formato archivo Plano (método POST)

l :(string) Login del usuario

pw :(string) Password del usuario

La respuesta retornada tiene el siguiente formato:

<?xml version="1.0" encoding="UTF-8" ?>

<Respuesta>
<Codigo>0</CODIGO>
<Mensaje>42</Mensaje>
</Respuesta>

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
10. RECUPERACIÓN DE INFORMACIÓN DE DOCUMENTOS DE LA
PLATAFORMA VIA HTTP

PÁGINA: ConsultaEstadoSUNAT.jsp
(http:/ip/Facturacion/webservices/ConsultaEstadoSUNAT.jsp)
Permite recuperar información del documento desde la Plataforma, en
cuanto a su estado en la SUNAT

Requiere los siguientes parámetros:

e :(string) RUC de la empresa

t :(int) Código de Tipo de documento según la SUNAT

f:(string) Folio del documento consultado (Serie-Correlativo)

l :(string) Login del usuario

pw :(string) Password del usuario

La respuesta a la consulta tiene la siguiente estructura:

<?xml version="1.0" encoding="UTF-8" ?>

<Respuesta>
<Codigo>'Codigo de Estado'</CODIGO>
<Mensaje>'Detalle de la respuesta'</Mensaje>
</Respuesta>

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 ó mas tags, los que se
decriben 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:

<?xml version="1.0" encoding="UTF-8" ?>

<Respuesta>
<Codigo>1</CODIGO>
<Mensaje>
<Estado>Documento Aceptado en la SUNAT</Estado>
<Detalle>Documento ingresado correctamente</Detalle>
</Mensaje>
</Respuesta>

11. RECUPERACIÓN DEL PDF DE DOCUMENTOS VÍA HTTP

PÁGINA: ConsultaPDF.jsp (http:/ip/Facturacion/webservices/ConsultaPDF.jsp)

Permite recuperar el link del PDF del documento desde la Plataforma

Requiere los siguientes parámetros:

e :(string) RUC de la empresa

t :(int) Código de Tipo de documento según la SUNAT

f:(int) Folio del documento consultado (Serie-Correlativo)

l :(string) Login del usuario

pw :(string) Password del usuario

La respuesta a la consulta tiene la siguiente estructura:

<?xml version="1.0" encoding="UTF-8" ?>

<Respuesta>
<Codigo>'Codigo de Estado'</CODIGO>
<Mensaje>'Detalle de la respuesta'</Mensaje>
</Respuesta>

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