Versin 1.3
Fecha
25/03/2016
TABLA DE CONTENIDOS
i
2.4 DEFINICIN CDIGOS DE ERROR EN EL INFORME DE CUADRATURA ................................. 36
3. INFORME DE BAJAS ........................................................................................ 37
3.1 PROCESO DE GENERACIN DE INFORME DE BAJAS ...................................................... 37
3.2 ESTRUCTURA DEL ARCHIVO TXT DE BAJAS SISTEMAS BACK OFFICE ............................. 38
ii
Documento de Integracin
1. BITCORA DE CAMBIOS
2. INTRODUCCIN
El presente documento describe la integracin y el modelo de operacin de la
aplicacin de Factura Electrnica de Paperless. Se describe en detalle la
integracin con los Sistemas BACK OFFICE del Cliente y si aplica en los
Puntos de Venta del Cliente.
3. GLOSARIO
TERMINO DESCRIPCION
Datagrama Formato de intercambio de datos entre los sistemas
externos y Paperless.
DE Documento Tributario Electrnico
DTT Documento Tributario Tradicional
OT Orden de Trabajo de Paperless. Est asociada con el
proceso de facturacin masivo y con la emisin de Libros.
POS Point of Sale (Punto de Venta)
SUNAT Superintendencia Nacional de Administracin Tributaria
WS WebService
XML eXtensible Markup Language
Paperless Peru 1
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
4. DESCRIPCIN GENERAL
La integracin comprende los siguientes sistemas con las siguientes
funcionalidades:
SISTEMAS POS
mbito/Sistema BACK
OFFICE
Emisin OnLine
Emisin Masiva
Informacin de Estados
SUNAT
Informe de Bajas
ESTADO DESCRIPCION
Comprende el estado de generacin de un DE por parte de
la plataforma de Paperless. Este estado es retornado en
lnea a los sistemas que estn integrados de esta manera
con Paperless y comprende una prevalidacin del
Estado PPL
documento. En caso de xito, indica que el documento ser
enviado al SUNAT. En caso contrario, la operacin ha fallado
y se considera que el documento no existe. Es anlogo a
imprimir un documento en una impresora sin papel.
Estado Comprende el estado del documento que es informado por la
SUNAT SUNAT. Es importante considerar el estado del documento
Paperless Peru 2
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
ESTADOS PAPERLESS
Error, falta informacin Falta registrar algunos datos del Emisor o No Existe.
-3
del emisor
Error, no hay CAF para el No hay Serie y Correlativo registrado para el tipo de
-7
documento documento enviado.
Paperless Peru 3
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
-19 Error de Schema. Este error indica que el documento XML generado por
la plataforma de PPL no cumple con el Schema del
SUNAT. Algunas causas pueden ser: Certificado
invlido, error en el formateo de un dato como por
ejemplo fechas, etc.
ESTADOS SUNAT
Paperless Peru 4
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
bien es cierto este proceso se puede realizar mltiples veces para simular
procesos de facturacin masivos, no provee un rendimiento adecuado para
volmenes muy grandes de emisin de DEs.
Paperless Peru 5
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
Paperless Peru 6
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
Paperless Peru 7
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
El directorio para dejar archivos txt desde SISTEMAS BACK OFFICE, que
sern procesados de forma Online por el e-Gateway, es el siguiente:
/home/ppldtepe/DTE/RUC Empresa/Online/Entrada/
En donde:
Consideraciones:
RUCEMPRESA_TIPODOC_SERIECORRELATIVO_AAAAMMDD.txt
/home/ppldtepe/DTE/RUC Empresa/Online/Salida/
En donde:
Paperless Peru 8
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
RUCEMPRESA_TIPODOC_SERIECORRELATIVO.TXT
En donde:
TIPODOC = cdigo de tipo de documento segn SUNAT
Paperless Peru 9
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
Ejemplo:
/home/ppldtepe/DTE/RUC Empresa/Estado/
En donde:
SUNATYYYYMMDDHHmmss.TXT
Ejemplo:
Paperless Peru 10
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
La generacin del archivo con los estados de la SUNAT ser cada X horas (en
donde X es un parmetro configurable).
En este archivo se entregarn los estados en la SUNAT de todos los
documentos para los cuales se obtuvo respuesta desde la SUNAT y que no
hayan sido informados an al cliente en un archivo anterior (no es
incremental ni acumulable).
En el archivo se informarn tanto documentos que hayan sido generados en
forma Masiva u Online.
Paperless Peru 11
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
Paperless Peru 12
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
El directorio para dejar archivos txt desde SISTEMAS BACK OFFICE, que
sern procesados de forma Masiva por el e-Gateway, es el siguiente:
/home/ppldtepe/DTE/RUC Empresa/Masivo/Entrada/
En donde:
Consideraciones:
RUCEMPRESA_AAAAMMDD.txt
/home/ppldtepe/DTE/RUC Empresa/Masivo/Salida/
En donde:
Paperless Peru 13
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
RUCEMPRESA_TIPODOC_SERIECORRELATIVO.TXT
En donde:
6. CONSIDERACIONES ESPECIALES
Para implementar la integracin anterior, correctamente con SISTEMAS
BACK OFFICE, se deben tener en cuenta las siguientes consideraciones:
7. INTEGRACIN - RECEPCIN
La integracin de recepcin contempla la habilitacin de las interfaces para la
inyeccin de los documentos recibidos a SISTEMAS BACK OFFICE y la
Paperless Peru 14
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
Aprobador
4
2
BACKOFFICE
Proveedor
Lista Lista (Emisor del DTE)
3 DTE 3 1
DTE DTE
5 A/RC 5 A/RC
6 A/RC
Paperless Peru 15
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
Importante:
El WSDL que retornar la lista de documentos recibidos y sus datos a
SISTEMAS BACK OFFICE desde el e-Server de Paperless es el mtodo
OnlineRecoveryReclist.
Otro punto importante es que por solicitud de CLIENTE los documentos que
e-Server enviar a SISTEMAS BACK OFFICE slo sern aquellos documentos
recibidos que tengan estado Aprobado y Aprobado con Observaciones en la
SUNAT.
Las interfaces requeridas para la operacin del flujo anterior son las
siguientes.
/home/ppldtepe/DTE/RUC Empresa/Recepcion/
AAAAMMDDhhmmss.txt
Paperless Peru 16
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
Ejemplo de archivo:
20521886448|01|F001|1|2011-05-24|119|19|110|23478|PEN|01|F002|12
Ruc Emisor
Tipo de documento
Paperless Peru 17
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
/home/ppldtepe/DTE/RUC Empresa/ApRecComercial/
Paperless Peru 18
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
RucEmisor_SerieCorrelativo.txt
Ejemplo de archivo:
20521886448|F001|1|Documento Aceptado|1
AAAAMMDDhhmmss.txt
Ejemplo de archivo:
Paperless Peru 19
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
20521886448|F001|1|Documento Aceptado|1
20521886448|F001|2|Documento Rechazado por no coincidir con orden de compra|2
20521886448|F001|3|Documento Aceptado|1
PARAMETRO DESCRIPCION
E Ruc de la empresa receptora.
Ee Ruc de la empresa que emiti el documento. Esta empresa emiti el
documento a la empresa receptora especificada en el parmetro anterior.
T Tipo de documento. Corresponde al tipo del documento segn la norma de
la SUNAT.
F Serie y Correlativo del documento.
Ac Tipo de operacin. Si tiene valor "1" indica que se quiere aprobar el
documento. Si tiene valor "2" indica que se quiere rechazar el documento.
Mr Motivo de rechazo. Obligatorio si tipo de operacin es "2" (rechazo).
L Login del usuario en el Servidor en la que se llamo la interfaz.
Pw Password del usuario en la mquina en la que se llam la pgina. Si no
viene el parmetro "l" (login), debe venir el hash de identificacin del
usuario.
Ejemplos de invocacin:
http://10.42.31.75:8080/Facturacion/webservices/statusAcDE.jsp?e=205218
86448&ee=20507955437&t=01&f=F0010000034&ac=2&mr=Documento no
coincide con Orden de Compra
<Respuesta>
<Codigo>CODIGO</Codigo>
<Mensaje>MENSAJE</Mensaje>
</Respuesta>
Paperless Peru 20
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
En donde:
NODO DESCRIPCION
CODIGO Cdigo es un nmero entero que indica el resultado de la
operacin.
0 = xito
<> 0 = Error
MENSAJE Mensaje descriptivo del error y/o valor requerido por la
consulta.
Paperless Peru 21
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
8. INTEGRACIN POS
El presente captulo describe la comunicacin y la mensajera propuesta para
la comunicacin entre la aplicacin de SWPOS de Cliente y la aplicacin e-
POS de Paperless.
1.9 COMUNICACIN
La comunicacin entre las aplicaciones se realizar mediante el intercambio
de mensajes a travs de sockets TCP/IP, utilizando el puerto 5500.
CLIENTE PAPERLESS
Receptor
DE
1 Configuracin POS
2 Solicitar Serie DE
Correlativo DE
3 Generacin de
Aplicacin 6 7
Documento
Ventas Cliente Timbre, serie,
correlativo Estado 4 e-POS
4 Generacin Paperless Paperless
Confirmacin e-Gateway e-Server
5
8
E
SUNAT DE
Paperless Peru 22
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
NOTA:
Como resultado del punto 2 y 3, el Cliente asume el total control de la serie
ms el correlativo entregado por e-POS y, por tal razn, cualquier prdida,
reutilizacin y/o error en el uso de la serie/correlativo no ser controlado por
parte de la aplicacin e-POS de Paperless.
1.10 MENSAJERA
Los mensajes de intercambio estn descritos de la siguiente manera:
MENSAJE
ORDEN PARAMETRO DESCRIPCION
1 Param1 Descripcion1
2 Param2 Descripcion2
: : :
Paperless Peru 23
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
N ParamN DescripcinN
RESPUESTA
ORDEN PARAMETRO DESCRIPCION
1 Respuesta1 Descripcin1
: : :
N RespuestaN DescripcinN
Importante:
El mensaje y la respuesta sern construidos como una secuencia de
caracteres en donde cada valor estar separado por un carcter TAB (ASCII
9), no importando su tamao. El mensaje y la respuesta anteriores, sern
representados as:
:
STATUS DESCRIPCION
0 xito. El mensaje fue procesado correctamente.
<> 0 Error. Se produjo un error al procesar el mensaje. En el parmetro siguiente se
entrega un mensaje descriptivo del error.
Paperless Peru 24
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
Consideracin:
La IP asignada a la caja debe ser nica. Esta no debe variar una vez
autenticada. La primera vez que se autentica, el ePOS guarda dicha
IP, y en las siguientes autenticaciones, valida esta IP, contra la que
es enviada internamente.
MENSAJE
PARAMETRO TIPO DE DATO DESCRIPCION
IDENTIFICADOR Numrico 1
Entero
TRAINING MODE Numrico Indicador para modo Entrenamiento (1 = Si, <> 1 =
Entero No )
RUC Alfanumrico RUC Emisor
POS Alfanumrico Identificador del POS
TIENDA Alfanumrico Cdigo de Tienda o Local (interno de CLIENTE)
RESPUESTA
PARAMETRO TIPO DE DATO DESCRIPCION
STATUS Numrico Entero Status de la operacin
Respuesta:
STX0 OKETX
Paperless Peru 25
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
Importante:
Cliente define que la modalidad de generacin de los documentos es
Pre-anulado.
Importante:
En las modalidades anteriores, slo se considera como evento de
confirmacin/anulacin la impresin exitosa o no del documento. El pago y la
autorizacin con medios de pago externos debe ser realizada previo al envo
del documento al e-POS.
MENSAJE
PARAMETRO TIPO DE DATO DESCRIPCION
IDENTIFICADOR Numrico Entero 3
TRAINING MODE Numrico Entero Indicador para modo Entrenamiento
(1 = Si, <> 1 = No )
RUC Alfanumrico RUC Emisor
POS Alfanumrico Identificador del POS
TIPODOC Numrico Entero Tipo de Documento segn la
normativa del SUNAT
RESPUESTA
PARAMETRO TIPO DE DATO DESCRIPCION
STATUS Numrico Entero Status de la operacin
Paperless Peru 26
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
Respuesta:
STX0 OK F001-1ETX
1.14 GENERAR DE
Consideracin:
Cuando se genera el primer Documento Electrnico, la aplicacin
generar un mensaje de error. De all en adelante la generacin de
documentos se realizar de manera transparente.
MENSAJE
PARAMETRO TIPO DE DATO DESCRIPCION
IDENTIFICADOR Numrico Entero 1
TRAINING MODE Numrico Entero Indicador para modo Entrenamiento (1 = Si,
<> 1 = No )
RUC Alfanumrico RUC Emisor
POS Alfanumrico Identificador del POS
CODIGO TIENDA O Alfanumrico Cdigo de Tienda o Local (interno de
LOCAL CLIENTE)
Paperless Peru 27
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
MENSAJE
PARAMETRO TIPO DE DATO DESCRIPCION
IDENTIFICADOR Numrico Entero 2
TRAINING MODE Numrico Entero Indicador para modo Entrenamiento
(1 = Si, <> 1 = No )
RUC Alfanumrico RUC Emisor
POS Alfanumrico Identificador del POS
TIPODOC Numrico Entero Tipo de Documento segn la
normativa del SUNAT
DOCUMENTO Alfanumrico TXT plano que contiene la
informacin para construir el
documento electrnico segn el
campograma definido en el
proyecto.
RESPUESTA
PARAMETRO TIPO DE DATO DESCRIPCION
STATUS Numrico Entero Status de la operacin
MENSAJE Alfanumrico Mensaje de Estado de generacin
PPL
SERIE- Alfanumrico Serie y Correlativo asignado al
CORRELATIVO Documento.
TIMBRE PDF Alfanumrico Informacin para el timbre del
417 documento (IMPRESORA TERMICA)
HASH Alfanumrico Informacin para el timbre del
documento (IMPRESORA
MATRICIAL)
Respuesta:
STX0 La operacin ha sido exitosa F001-3 PDF 417 HASHETX
1.15 CONFIRMAR DE
Este mensaje permite confirmar un DE generado para su posterior envo y
publicacin en la gestin documental. Se requiere esta confirmacin para
Paperless Peru 28
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
MENSAJE
PARAMETRO TIPO DE DATO DESCRIPCION
IDENTIFICADOR Numrico Entero 3
TRAINING MODE Numrico Entero Indicador para modo Entrenamiento
(1 = Si, <> 1 = No )
RUC Alfanumrico RUC Emisor
POS Alfanumrico Identificador del POS
TIPODOC Numrico Entero Tipo de Documento segn la
normativa del SUNAT
SERIE- Alfanumrico Serie y Correlativo del Documento
CORRELATIVO
RESPUESTA
PARAMETRO TIPO DE DATO DESCRIPCION
STATUS Numrico Entero Status de la operacin
Respuesta:
STX0 OKETX
1.16 ANULAR DE
Este mensaje permite anular un DE ya generado por el ePOS. Este mensaje
puede ser utilizado en documento que no han sido enviados an por el ePOS
al Servidor eGateway de Paperless.
MENSAJE
PARAMETRO TIPO DE DATO DESCRIPCION
IDENTIFICADOR Numrico Entero 4
TRAINING MODE Numrico Entero Indicador para modo Entrenamiento
(1 = Si, <> 1 = No )
RUC Alfanumrico RUC Emisor
POS Alfanumrico Identificador del POS
TIPODOC Numrico Entero Tipo de Documento segn la
normativa de SUNAT
SERIE- Alfanumrico Serie y Correlativo del Documento
CORRELATIVO
Paperless Peru 29
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
Respuesta:
STX0 OKETX
Paperless Peru 30
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
1.1 IMPRESIN
La impresin considera la impresin del DEs en impresoras del POS (ya
sean boletas, facturas, notas de crdito o notas de dbito) en formato
definido por el cliente. La impresin en ese formato es responsabilidad de la
aplicacin de venta del cliente.
Paperless Peru 31
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
2. CUADRATURA
El proceso de cuadratura contempla la revisin diaria de los documentos
emitidos de manera de contrastar la informacin registrada en los sistemas
de BackOffice (documentos electrnicos generados en los POS) y los
sistemas de Paperless.
Operador
Alarma
PAPERLESS e-Server
Carga va
upload
W 6
DTE/
Archivo S BOL
Cuadratura D
L
DTE/
4 BOL
BACKOFFICE 3
2
1
Paperless Peru 32
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
Consideraciones
Paperless Peru 33
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
Que indica la Boleta serie F001 correlativo 10000 emitida en la Tienda 9 por
el Pos 40 y por un total de 1190 soles.
PPL_RUC_AAAAMMDD.VERSION.txt
Donde:
Paperless Peru 34
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
VALOR DESCRIPCION
RUC Ruc de la empresa a la que corresponden los archivos.
AAAA Ao de la fecha de emisin de todos los documentos
informados.
MM Mes de la fecha de emisin de todos los documentos
informados.
DD Da de la fecha de emisin de todos los documentos informados.
VERSION Versin o Correlativo del archivo. Este correlativo se utiliza en
caso de que se generen ms de un archivo para un da
determinado. Se puede utilizar un secuencial y/o la hora en
algn formato que permita identificar la ltima versin. Los
archivos no son complementarios.
Paperless Peru 35
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
Cdigo Descripcin
0 Documento OK
Paperless Peru 36
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
3. INFORME DE BAJAS
Paperless Peru 37
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
CLIENTE SUNAT
SAP
BACK OFFICE Informe de
Bajas
4 consolidado
Estado 5
Paperless
Envo Informe de
e-Server
Bajas
Bajas
txt
1 2
Usuario
La estructura del archivo txt que deber generar SISTEMAS BACK OFFICE se
indica a continuacin:
Paperless Peru 38
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin
Ejemplo de un archivo:
20521886448|20150521|01|F001|00000001|2015-05-22|Documento no otorgado
20521886448|20150521|03|B002|00000001|2015-05-22|Documento no otorgado
Paperless Peru 39
Santo Toribio 115, Piso 4 San Isidro Lima Per