WSDL Integracionv1.6 Peru
WSDL Integracionv1.6 Peru
WSDL Integracionv1.6 Peru
Interfaces de Facturación
On Line
Versión 1.6
Fecha 30/03/2016
Bitácora de Cambios
Fecha de Cambio Versión Autor Detalle cambios
05/04/2011 1.0 Fernando Parcerisas Creación del documento.
18/05/2011 1.1 Fernando Parcerisas Se agrega método
OnlineRecoveryRecList.
17/06/2014 1.1 Fernando Parcerisas Se modifica la tabla de 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 Parcerisas Se corrige el salto de línea declarado
originalmente como @#Lindet#@
por @#Linea#@
27/06/2014 1.2 Fernando Parcerisas 1. Se agrega el método
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
29/03/2016 1.5 Hugo Blanco Cambios en la presentación y se
añaden incide y los métodos:
CARGAINFORMEBAJAS, ONLINEARC.
30/03/2016 1.6 Hugo Blanco Se excluye el método
CARGAINFORMEBAJAS no es parte
de la operatividad del producto.
Contenido
INTRODUCCIÓN. ...................................................................................................... 4
CONSIDERACIÓN GENERAL ..................................................................................... 4
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:
Importante:
MÉTODO OnlineGeneration
Permite la generación de documentos en forma OnLine (1 por
vez), y los parámetros son:
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
- La Respuesta Paperless se obtiene en: <Codigo>0</Codigo>
2. RECUPERACIÓN DE INFORMACIÓN DE DOCUMENTOS –
ONLINERECOVERY
MÉTODO OnlineRecovery
Permite recuperar información del documento, los parámetros
son:
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.
3. INFORMACIÓN DE DOCUMENTOS EMITIDOS (POR RANGO DE
FECHAS) - ONLINECONSULTAESTADO
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:
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 más de 1 mes.
Ejemplo invocación - OnlineConsultaEstado:
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>
4. LOS CÓDIGOS DE RETORNO SON
Error, falta información del Falta registrar algunos datos del Emisor o No Existe.
-3
emisor
-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.
-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.
Response
<?xml version="1.0" encoding="UTF-8" ?>
<Respuesta>
<Codigo>0</CODIGO>
<Mensaje>42</Mensaje>
</Respuesta>
Nota:
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.
Response
<?xml version="1.0" encoding="UTF-8" ?>
<Respuesta>
<Codigo>'Codigo de Estado'</CODIGO>
<Mensaje>'Detalle de la respuesta'</Mensaje>
</Respuesta>
Nota:
Código: el código de retorno de la consulta. Ver detalle en Tabla de Códigos
Mensaje: el mensaje estará conformado de 2 o 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
PÁGINA ConsultaPDF.jsp
(http:/ip/Facturacion/webservices/ConsultaPDF.jsp)
Permite recuperar el link del PDF del documento desde la
Plataforma.
Response
<?xml version="1.0" encoding="UTF-8" ?>
<Respuesta>
<Codigo>'Codigo de Estado'</CODIGO>
<Mensaje>'Detalle de la respuesta'</Mensaje>
</Respuesta>
Siendo:
MÉTODO OnlineRecoveryRec
Permite recuperar información de los documentos Recibidos, los
parámetros son:
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 <
corresponden a la codificación del carácter “<”.
2. DATOS PRINCIPALES DE DOCUMENTOS RECIBIDOS -
ONLINERECOVERYRECLIST
MÉTODO OnlineRecoveryRecList
Retorna información de los datos principales de los documentos
recibidos en 1 día determinado.
Los parámetros son:
Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://ws.online.asp.core.paperless.cl">
<soapenv:Header/>
<soapenv:Body>
<ws:OnlineRecoveryRecList>
<!--Optional:-->
<ws:ruc>20524119553</ws:ruc>
<!--Optional:-->
<ws:login>admin</ws:login>
<!--Optional:-->
<ws:clave>abc123</ws:clave>
<!--Optional:-->
<ws:fecha>2016-03-07</ws:fecha>
</ws:OnlineRecoveryRecList>
</soapenv:Body>
</soapenv:Envelope>
Response
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<ns:OnlineRecoveryRecListResponse xmlns:ns="http://ws.online.asp.core.paperless.cl">
<ns:return><![CDATA[<?xml version="1.0" encoding="UTF-8" ?>
<Respuesta>
<Codigo>0</Codigo>
<Mensaje>20380336384;3;BPPL-22;2016-03-07;2950.0;450.0;2500.0;0;PEN;2016-03-
07;;http://asp4demos.paperless.com.pe/Facturacion/PDFServlet?id=Bpr4de34OjY(IgU)&o=R;0;1234567890
;GR-00610-0011013;;09;;;;;|20380336384;7;FPPL-23;2016-03-07;2950.0;450.0;2500.0;0;PEN;2016-03-
07;;http://asp4demos.paperless.com.pe/Facturacion/PDFServlet?id=fODOYxl1ays(IgU)&o=R;0;1234567890
;GR-00610-0011013;;09;FPPL-21;2016-03-07;01;380;|20380336384;8;FPPL-24;2016-03-
07;0.0;450.0;0.0;0;PEN;2016-03-
07;;http://asp4demos.paperless.com.pe/Facturacion/PDFServlet?id=B2iAOwkIfjE(IgU)&o=R;0;1234567890
;GR-00610-0011013;;09;FPPL-21;2016-03-07;01;380;|20110200201;7;FPPL-42;2016-03-
07;2436.699951171875;371.70001220703125;2065.0;0;USD;2016-03-
07;;http://asp4demos.paperless.com.pe/Facturacion/PDFServlet?id=ZY4HEFNBUnk(IgU)&o=R;0;ZPAN100%_F
INAL1;;;;FPPL-40;2016-03-07;01;380;|20110200201;8;FPPL-43;2016-03-
07;0.0;371.70001220703125;0.0;0;USD;2016-03-
07;;http://asp4demos.paperless.com.pe/Facturacion/PDFServlet?id=0Z2IBDBqDZU(IgU)&o=R;0;ZPAN100%_F
INAL1;;;;FPPL-40;2016-03-07;01;380;|20110200201;8;FPPL-45;2016-03-
07;0.0;371.70001220703125;0.0;0;USD;2016-03-
07;;http://asp4demos.paperless.com.pe/Facturacion/PDFServlet?id=LfWRz3hKAhk(IgU)&o=R;0;OC-
000000001;GR-00610-0011013;;09;FPPL-40;2016-03-07;01;380;|</Mensaje>
</Respuesta>]]></ns:return>
</ns:OnlineRecoveryRecListResponse>
</soapenv:Body>
</soapenv:Envelope>
Nota:
20380336384;3;BPPL-22;2016-03-07;2950.0;450.0;2500.0;0;PEN;2016-03-
07;;http://asp4demos.paperless.com.pe/Facturacion/PDFServlet?id=Bpr4de34OjY(IgU)&o=R;0;1234567890;
GR-00610-0011013;;09;;;;;|20380336384;7;FPPL-23;2016-03-07;2950.0;450.0;2500.0;0;PEN;2016-03-
07;;http://asp4demos.paperless.com.pe/Facturacion/PDFServlet?id=fODOYxl1ays(IgU)&o=R;0;1234567890;
GR-00610-0011013;;09;FPPL-21;2016-03-07;01;380;|20380336384;8;FPPL-24;2016-03-
07;0.0;450.0;0.0;0;PEN;2016-03-
07;;http://asp4demos.paperless.com.pe/Facturacion/PDFServlet?id=B2iAOwkIfjE(IgU)&o=R;0;1234567890;
GR-00610-0011013;;09;FPPL-21;2016-03-07;01;380;|20110200201;7;FPPL-42;2016-03-
07;2436.699951171875;371.70001220703125;2065.0;0;USD;2016-03-
07;;http://asp4demos.paperless.com.pe/Facturacion/PDFServlet?id=ZY4HEFNBUnk(IgU)&o=R;0;ZPAN100%_FI
NAL1;;;;FPPL-40;2016-03-07;01;380;|20110200201;8;FPPL-43;2016-03-
07;0.0;371.70001220703125;0.0;0;USD;2016-03-
07;;http://asp4demos.paperless.com.pe/Facturacion/PDFServlet?id=0Z2IBDBqDZU(IgU)&o=R;0;ZPAN100%_FI
NAL1;;;;FPPL-40;2016-03-07;01;380;|20110200201;8;FPPL-45;2016-03-
07;0.0;371.70001220703125;0.0;0;USD;2016-03-
07;;http://asp4demos.paperless.com.pe/Facturacion/PDFServlet?id=LfWRz3hKAhk(IgU)&o=R;0;OC-
000000001;GR-00610-0011013;;09;FPPL-40;2016-03-07;01;380;|
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.
MÉTODO OnlineARC
Acepta o Rechaza Comercialmente un Documento Recibido.
Los parámetros son:
Param5:(string) Folio
Rechazo Comercial
Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://ws.online.asp.core.paperless.cl">
<soapenv:Header/>
<soapenv:Body>
<ws:OnlineARC>
<!--Optional:-->
<ws:ruc>20524119553</ws:ruc>
<!--Optional:-->
<ws:login>admin</ws:login>
<!--Optional:-->
<ws:clave>abc123</ws:clave>
<!--Optional:-->
<ws:rucEmisor>20101087647</ws:rucEmisor>
<!--Optional:-->
<ws:tipoDoc>01</ws:tipoDoc>
<!--Optional:-->
<ws:folio>F004-12345</ws:folio>
<!--Optional:-->
<ws:estado>1</ws:estado>
<!--Optional:-->
<ws:version>0</ws:version>
</ws:OnlineARC>
</soapenv:Body>
</soapenv:Envelope>
Response
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<ns:OnlineARCResponse xmlns:ns="http://ws.online.asp.core.paperless.cl">
<ns:return><![CDATA[<?xml version="1.0" encoding="UTF-8" ?>
<Respuesta>
<Codigo>0</Codigo>
<Mensaje>Documento rechazado exitosamente</Mensaje>
</Respuesta>]]></ns:return>
</ns:OnlineARCResponse>
</soapenv:Body>
</soapenv:Envelope>
Aprobación Comercial
Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://ws.online.asp.core.paperless.cl">
<soapenv:Header/>
<soapenv:Body>
<ws:OnlineARC>
<!--Optional:-->
<ws:ruc>20524119553</ws:ruc>
<!--Optional:-->
<ws:login>admin</ws:login>
<!--Optional:-->
<ws:clave>abc123</ws:clave>
<!--Optional:-->
<ws:rucEmisor>20101087647</ws:rucEmisor>
<!--Optional:-->
<ws:tipoDoc>01</ws:tipoDoc>
<!--Optional:-->
<ws:folio>F004-12345</ws:folio>
<!--Optional:-->
<ws:estado>1</ws:estado>
<!--Optional:-->
<ws:version>0</ws:version>
</ws:OnlineARC>
</soapenv:Body>
</soapenv:Envelope>
Response
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<ns:OnlineARCResponse xmlns:ns="http://ws.online.asp.core.paperless.cl">
<ns:return><![CDATA[<?xml version="1.0" encoding="UTF-8" ?>
<Respuesta>
<Codigo>0</Codigo>
<Mensaje>Documento aprobado exitosamente</Mensaje>
</Respuesta>]]></ns:return>
</ns:OnlineARCResponse>
</soapenv:Body>
</soapenv:Envelope>