WebServices

Interfaces de Facturacin
On Line
Versin 1.1
Fecha 18/05/2011

1. BITCORA DE CAMBIOS
Fecha de Cambio
05/04/2011
18/05/2011

Versin
Autor
1.0
Fernando
Parcerisas
1.1
Fernando
Parcerisas

Detalle cambios
Creacin del documento.
Se
agrega
mtodo
OnlineRecoveryRecList.

2. INTRODUCCIN.
El presente documento tiene por finalidad entregar la informacin para la
implementacin Online desde los sistemas actuales y el ambiente de
facturacin, a travs de tecnologas WebServices.
Para todos los mtodos se retorna un String en formato XML, con la
informacin del proceso.

3. GENERACIN (INYECCIN) DE DOCUMENTOS EN LA PLATAFORMA

Importante:
Los archivos WSDL sern publicados en una url por confirmar.
MTODO: OnlineGeneration
Permite la generacin de documentos en forma OnLine (1 por vez), y los
parmetros 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 generacin de folios (automtica -> 1, manual -> 2)

param5:(int)

Tipo de devolucin de respuesta, el que pueden ser:

0
1
2
3
4

=
=
=
=
=

ID asignado
URL del XML
URL del PDF
Estado en la SUNAT
Folio Asignado (Serie-Correlativo)

Ejemplo invocacin:
Request
<?xml version="1.0" encoding="UTF-8" ?>
<ns1:OnlineGeneration xmlns:ns1="http://webservices.online.webapp.paperless.cl">
<ns1:param0>20100070970</ns1:param0>
<ns1:param1>gen_paperless</ns1:param1>
<ns1:param2>abc123</ns1:param2>
<ns1:param3>EN|01|340000000283|2008-06-06||||20080706|833827006|PAPERLESS|GRANDES TIENDAS |803020|CAMINO EL
ALBA12.575|PROVIDENCIA|SANTIAGO||709123009|0709123009|CORP.EDUCACIONAL DE LA CONSTRUCCIN|EDUCACIN||ALFREDO
BARROS ERRAZURIZ 1954|PROVIDENCIA|||0| 4140.00|19.00|0|
4140.00|@#Linea#@DE| 1||||Patrocinio o
Beca|1608101021@#Lindet#@"0000000132|1|| 540.00|||60.25|||
540.00|@#Linea#@DE| 2||||Patrocinio o
Beca|1608101021000000013216081010210000000133|1|| 3600.00|||60.25|||

3600.00|@#Linea#@PE|||||||||CUATRO MIL CIENTOCUARENTA

PESOS|</ns1:param3>
<ns1:param4>1</ns1:param4>
<ns1:param5>6</ns1:param5>
</ns1:OnlineGeneration>
NOTA: La respuesta es un XML en formato String, no una estructura compleja.

4. RECUPERACIN DE INFORMACIN DE DOCUMENTOS DE LA

PLATAFORMA
MTODO: OnlineRecovery
Permite recuperar informacin del documento, los parmetros son:
param0:(string)

RUC de la empresa

param1:(string)

Login del usuario

param2:(string)

Password del usuario

param3:(string)

Tipo de documento Electrnicos segn la SUNAT

01 = Factura
XX = Boleta
XX = Boleta Exenta
XX = Nota de Crdito
XX = Nota de Dbito

param4:(string)

Folio del documento consultado (Serie-Correlativo). Por ejemplo:

F00001-1

param5:(int)

Tipo de devolucin 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-Correlativo)

Ejemplo invocacin
Request
<?xml version="1.0" encoding="UTF-8" ?>
<ns1: OnlineRecovery xmlns:ns1="http://webservices.online.webapp.paperless.cl">
<ns1:param0>20100070970</ns1:param0>
<ns1:param1>gen_paperless</ns1:param1>
<ns1:param2>abc123</ns1:param2>
<ns1:param3>01</ns1:param3>
<ns1:param4 >12345<ns1:param4 />
<ns1:param5 />5<ns1:param5 />

</ns1: OnlineRecovery >

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

5. INFORMACIN DE DOCUMENTOS RECIBIDOS WS

MTODO: OnlineRecoveryRec
Permite recuperar informacin de los documentos Recibidos, los parmetros
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 Electrnicos segn la SUNAT

01 = Factura
XX = Boleta
XX = Boleta Exenta
XX = Nota de Crdito
XX = Nota de Dbito
Folio del documento consultado (Serie-Correlativo). Por ejemplo:
F001-1
Tipo de devolucin de respuesta, el que pueden ser:
0 = ID asignado
1 = URL del XML
2 = URL del PDF
3 = Estado en SUNAT

param5:(string)
Param6:(int)

Ejemplo invocacin
Request
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAPENC="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</m:param4>
<m:param5>F001-234</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>&lt;?xml version="1.0" encoding="ISO-8859-1"?>
&lt;Respuesta>
&lt;Codigo>8&lt;/Codigo>
&lt;Mensaje>DOCUMENTO ACEPTADO POR LA SUNAT&lt;/Mensaje>
&lt;/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 codificacin del caracter <.
MTODO: OnlineRecoveryRecList
Retorna informacin de los datos principales de los documentos recibidos en
1 da determinado.
Los parmetros son:
param0:(string)

RUC de la empresa

param1:(string)

Login del usuario

param2:(string)

Password del usuario

param3:(string)

Fecha de recepcin

Ejemplo invocacin:
Request
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAPENC="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:
Cdigo: el cdigo de retorno de la consulta. Ver detalle en Tabla de Cdigos
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-MMDD|99999999-9;99;9999;AAAA-MM-DD;9999999;9999999; 9999999; 9999999; XXXXXXX; AAAA-MMDD

999999999: RUC Emisor
99: Tipo de documento segn SUNAT
9999: Serie - Correlativo
AAAA-MM-DD: Fecha de Emisin del documento
9999999: Monto Bruto (Monto total Documento)
9999999: IGV
9999999: Monto Neto
9999999: Orden de Compra
XXXXXXX: Moneda
AAAA-MM-DD: Fecha de Recepcin 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
vaco 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
especificacin del SII, respecto de la normativa de cada uno de los campos indicados. El detalle de la
especificacin de los datos est en el documento de integracin de SPSA.
En caso de no encontrar documentos en el da consultado, el mensaje retornado es:
Error, documento no encontrado.: No hay documentos recibidos para la fecha consultada

6. LOS CDIGOS DE RETORNO SON

Cdigo
0
-1

-2

Descripcin

Causa

Respuesta solicitada

En este caso el proceso finaliza correctamente.

Error, archivo Xml invlido.

No se puede recuperar informacin desde el archivo

enviado, dado que est mal formado.

Error, el archivo debe

contener solo 1 documento

El archivo contiene ms de 1 documento.

Cdigo

Descripcin

Causa

-3

Error, falta informacin del

emisor

Falta registrar algunos datos del Emisor o No Existe.

-4

Error, Emisor no registrado

El Emisor no existe.

-5

Error al recuperar el
Certificado de la Empresa

No se encuentra el certificado de la empresa en el servidor

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 envo.

Falla al firmar el Envo.

-10

Error al enviar documento.

No se pudo ingresar el documento a la aplicacin para ser

enviado a la SUNAT. Esto se debe principalmente a errores
de schema del archivo ingresado.

-11

Error de conexin DB.

Se debe a un problema con la Base de Datos.

-12

Error, documento no
encontrado.

Se trata de consultar un documento que no existe (al

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.

-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 comunicacin webservices.

-99

Error, opcin de retorno

invlida.

La opcin de retorno selecciona no es vlida.

Documento Aceptado por la

SUNAT

El documento fue enviado a la SUNAT y se recibi

respuesta de Aceptacin por mail.

Documento Aceptado con

Reparos por la SUNAT

El documento fue enviado al SUNAT y se recibi respuesta

de Reparo por mail. (En el Xml de Respuesta generado por
la aplicacin, se agrega el motivo del reparo).

Documento Aceptado con

Reparos Leves por el SUNAT

El documento fue enviado al SUNAT y se recibi respuesta

de Reparo Leve por mail. (En el Xml de Respuesta
generado por la aplicacin, se agrega el motivo del
reparo).

Documento Rechazado

El documento fue enviado al SUNAT y fue rechazado.

7. GENERACIN (INYECCIN) DE DOCUMENTOS EN LA PLATAFORMA

VIA HTTP
PGINA: Online.jsp (http:/ip:puerto/Facturacion/webservices/Online.jsp)
Permite la generacin de documentos en forma OnLine (1 por vez) a partir
de informacin del archivo enviado va POST.
Requiere los siguientes parmetros:
e :(string)

RUC de la empresa

t :(int)

Cdigo de Tipo de documento segn la SUNAT

tr:(int)

Tipo de devolucin de respuesta, el que pueden ser:

0
1
2
3
4

=
=
=
=
=

ID asignado
URL del XML
URL del PDF
Estado en SUNAT
Folio Asignado (Serie y Correlativo)

a :(string)

Documento en formato archivo Plano (mtodo 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:
Cdigo: el cdigo de retorno de la consulta. Ver detalle en Tabla de Cdigos
Mensaje: Respuesta solicitada segn el tipo de devolucin definido

8. RECUPERACIN DE INFORMACIN DE DOCUMENTOS DE LA

PLATAFORMA VIA HTTP
PGINA: ConsultaEstadoSUNAT.jsp
(http:/ip/Facturacion/webservices/ConsultaEstadoSUNAT.jsp)
Permite recuparar informacin del documento desde la Plataforma, en
cuanto a su estado en la SUNAT
Requiere los siguientes parmetros:
e :(string)

RUC de la empresa

t :(int)

Cdigo de Tipo de documento segn 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:
Cdigo: el cdigo de retorno de la consulta. Ver detalle en Tabla de Cdigos
Mensaje: el mensaje estar conformado de 2 mas tags, los que se
decriben a continuacin:
Estado: Descripcin del estado general de la respuesta
Detalle (1 a n): Pueden ser varios elementos de este tag, e indican
informacin adicional del documento

Ejemplo para un documento aprobado:

<?xml version="1.0" encoding="UTF-8" ?>
<Respuesta>
<Codigo>8</CODIGO>
<Mensaje>
<Estado>Documento Aceptado en la SUNAT</Estado>
<Detalle>Documento ingresado correctamente</Detalle>
</Mensaje>
</Respuesta>

9. RECUPERACIN DEL PDF DE DOCUMENTOS VA HTTP

PGINA: ConsultaPDF.jsp (http:/ip/Facturacion/webservices/ConsultaPDF.jsp)
Permite recuperar el link del PDF del documento desde la Plataforma
Requiere los siguientes parmetros:
e :(string)

RUC de la empresa

t :(int)

Cdigo de Tipo de documento segn 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:
Cdigo: el cdigo de retorno de la consulta. Ver detalle en Tabla de Cdigos
de Retorno.
Mensaje: El link del PDF del documento