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><?xml version="1.0" encoding="ISO-8859-1"?>
<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 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>
<?xml version="1.0" encoding="ISO-8859-1"?>
<Respuesta>
<Codigo>0</Codigo>
<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 </Mensaje>
</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
