Sunteți pe pagina 1din 42

PROYECTO FACTURA ELECTRNICA

DOCUMENTO ESPECIFICACIN INTEGRACIN


MODALIDAD MIXTO

Versin 1.3

Fecha
25/03/2016
TABLA DE CONTENIDOS

1. BITCORA DE CAMBIOS .................................................................................... 1


2. INTRODUCCIN ................................................................................................ 1
3. GLOSARIO ......................................................................................................... 1
4. DESCRIPCIN GENERAL .................................................................................... 2
5. INTEGRACIN SISTEMAS BACK OFFICE ............................................................ 2
1.1 ESTADOS PPL - SUNAT ..................................................................................... 2
1.2 DEFINICIN ESTADO PPL Y ESTADO SUNAT ............................................................... 3
1.3 CASO ESPECIAL: RECHAZOS ................................................................................. 4
1.4 EMISIN ONLINE Y MASIVA DESDE SISTEMAS BACK OFFICE ...................................... 4
5.1.1 EMISIN ONLINE VA WS (OPCIN 1) ...................................................... 4
5.1.2 EMISIN ONLINE VA CARPETA COMPARTIDA (OPCION 2) .......................... 6
5.1.3 EMISIN MASIVA VA CARPETA COMPARTIDA (OPCION 3) ...................... 11
6. CONSIDERACIONES ESPECIALES .................................................................... 14
1.5 ADMINISTRACIN DE ESTADOS ............................................................................ 14
1.6 PROCESO DE IMPRESIN DE LOS DOCUMENTOS ......................................................... 14
7. INTEGRACIN - RECEPCIN ........................................................................... 14
1.7 INTERFAZ SISTEMAS BACK OFFICE (INYECCIN DE DOCUMENTO RECIBIDO DESDE PAPERLESS)
16
7.1.1 Recepcin Lista de Documentos va Carpeta Compartida ........................... 16
7.1.2 Recepcin Lista de Documentos va WS (mtodo OnlineRecoveryRecList) .... 17
1.8 INTERFAZ APROBACIN O RECHAZO COMERCIAL (DESDE SISTEMAS BACK OFFICE A
PAPERLESS) ............................................................................................................ 18
7.1.3 Aprobacin o Rechazo Comercial va Carpeta Compartida .......................... 18
7.1.4 Aprobacin o Rechazo Comercial va WS .................................................. 20
8. INTEGRACIN POS ......................................................................................... 22
1.9 COMUNICACIN .............................................................................................. 22
1.10 MENSAJERA.................................................................................................. 23
1.11 CONFIGURACIN POS ...................................................................................... 25
1.12 MODALIDADES DE GENERACIN DE DES ............................................................... 25
8.1.1 Modalidad Pre-Anulado .......................................................................... 25
8.1.2 Modalidad Pre-Confirmado ..................................................................... 26
1.13 SOLICITAR FOLIO ............................................................................................ 26
1.14 GENERAR DE................................................................................................. 27
1.15 CONFIRMAR DE .............................................................................................. 28
1.16 ANULAR DE .................................................................................................. 29
1.17 CDIGOS DE ERROR ........................................................................................ 30
1.1 IMPRESIN ................................................................................................... 31
1.2 SITUACIONES ESPECIALES ................................................................................. 31
2. CUADRATURA .................................................................................................. 32
2.1 FORMATO DE INTERCAMBIO CUADRATURA ............................................................. 33
2.2 FORMATO DE INTERCAMBIO NOMBRE DEL ARCHIVO .................................................. 34
2.3 FORMATO DE INFORME DE RESULTADO DE CUADRATURA ............................................... 35

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

Fecha de Versin Autor Detalle cambios


Cambio
29-05-2013 1.0 Fernando Creacin del Documento
Parcerisas
24-04-2014 1.1 Fernando Modificacin de Documento
Parcerisas
20-08-2014 1.2 Cristian Se agrega mensaje para el ePOS de
Rosas solicitud de folio.
25/03/2016 1.3 Miguel Se agrega consideraciones sobre el
Rojas encoding UTF-8 y estructura de los
archivos de carpetas compartidas y
flujos en los diagramas, as como
utilizacin de IPs y puerto en la
configuracin del ePOS

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

5. INTEGRACIN SISTEMAS BACK OFFICE


La integracin con los Sistemas BACK OFFICE del cliente comprende una
integracin para la emisin Online y Masiva de documentos electrnicos.
Adems considera la entrega de estados de generacin de documentos
electrnicos y de estados de la SUNAT de acuerdo a una estructura de
directorios compartidos o WS que estar configurada en el Servidor e-
Gateway de PPL.
Los procesos y las definiciones se indican a continuacin.

1.1 ESTADOS PPL - SUNAT


Para la correcta operacin de la integracin entre SISTEMAS BACK OFFICE y
Paperless se requiere considerar el almacenamiento en SISTEMAS BACK
OFFICE de dos estados como resultado de la emisin de DEs. Los estados
son los siguientes:

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

de la SUNAT para los procesos de contabilizacin de ellos en


SISTEMAS BACK OFFICE.

1.2 DEFINICIN ESTADO PPL Y ESTADO SUNAT

Los estados posibles son los siguientes:

Cdigo Descripcin Causa

ESTADOS PAPERLESS

0 Respuesta solicitada En este caso el proceso finaliza correctamente.

Error, archivo Xml No se puede recuperar informacin desde el archivo


-1
invlido. enviado, dado que est mal formado.

Error, el archivo debe El archivo contiene ms de 1 documento.


-2 contener solo 1
documento

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

Error, Emisor no El Emisor no existe.


-4
registrado

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


-5
Certificado de la Empresa servidor de aplicaciones.

Error al Foliar el Falla la solicitud de Serie y Correlativo, no se encontr


-6
documento. en el documento.

Error, no hay CAF para el No hay Serie y Correlativo registrado para el tipo de
-7
documento documento enviado.

Error al firmar el Falla al firmar el Documento.


-8
documento.

-9 Error al firmar el envo. Falla al firmar el Envo.

-10 Error al enviar No se pudo ingresar el documento a la aplicacin para


documento. ser enviado al 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.

Paperless Peru 3
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin

Cdigo Descripcin Causa

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


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

-13 Error al generar imagen Se da generalmente por que no se puede encontrar


del timbre. las libreras grficas del sistema.

-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 del
SUNAT. Algunas causas pueden ser: Certificado
invlido, 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 La opcin de retorno selecciona no es vlida.


invlida.

ESTADOS SUNAT

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

1.3 CASO ESPECIAL: RECHAZOS


En trminos generales, la emisin de DEs se realiza sin considerar la
respuesta de la SUNAT para la entrega al usuario final. Se debe definir en
base a los estado de la SUNAT los pasos administrativos y operativos que
permitan manejar los documentos con estado Rechazado en la SUNAT.

1.4 EMISIN ONLINE Y MASIVA DESDE SISTEMAS BACK OFFICE

5.1.1 EMISIN ONLINE VA WS (OPCIN 1)


La emisin OnLine comprende la emisin de un DE en lnea desde los
Sistemas BACK OFFICE del Cliente. Este proceso considera la emisin de
documentos en la modalidad Cliente Esperando, es decir, documentos que
deben ser emitidos y entregados de inmediato al cliente y a la SUNAT. Si

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.

La integracin OnLine se logra como se describe en el siguiente diagrama:

La secuencia de eventos para la generacin de documentos electrnicos es la


siguiente:

1. Un usuario emite un documento en SISTEMAS BACK OFFICE. Como


resultado de esto, SISTEMAS BACK OFFICE enva la informacin del
documento al servidor eGateway de Paperless a travs del mtodo de
WS correspondiente (revisar documento de especificacin de WS
WSDL_Integracionv1.1 Peru.pdf).
2. El eGateway procesa el documento y responde en lnea el resultado de la
operacin (xito o error). Este estado debe ser registrado en SISTEMAS
BACK OFFICE para gestiones futuras acciones. En caso de error, el usuario
debe ser advertido para solucionar el problema. (IMPORTANTE: a pesar

Paperless Peru 5
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin

que en el diagrama esto se ve como un mensaje separado, es la


respuesta de la ejecucin del punto 1).
3. El documento electrnico generado (XML) es enviado al servidor eServer
en la nube de Paperless
4. Opcionalmente, el DE es impreso en una impresora pre-configurada y/o
indicada por SISTEMAS BACK OFFICE en el archivo de intercambio (por
ejemplo, la impresora del usuario).
5. El documento electrnico se registra en el repositorio de archivos del
eServer y en la Base de Datos y se enva a el servidor de SUNAT para su
validacin
6. LA SUNAT responde el estado del documento electrnico. Si el documento
no es rechazado, opcionalmente, el mismo (XML) y su representacin
grfica (PDF) es enviado o distribuido va correo electrnico al receptor
del documento.
7. El Servidor eServer registra el estado de la SUNAT y devuelve el mismo al
servidor eGateway, el cual actualiza el estado del documento.
8. SISTEMAS BACK OFFICE consulta por el estado SUNAT del documento
electrnico y el Servidor eGateway entrega el Estado SUNAT a SISTEMAS
BACK OFFICE (revisar documento de especificacin de WS
WSDL_Integracionv1.1 Peru.pdf).

5.1.2 EMISIN ONLINE VA CARPETA COMPARTIDA (OPCION 2)

La emisin OnLine comprende la emisin de DE en lnea desde SISTEMAS


BACK OFFICE. Este proceso considera la emisin de documentos en la
modalidad asncrona a travs de directorios compartidos en el Servidor e-
Server.

La integracin se logra como se describe en el siguiente diagrama:

Paperless Peru 6
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin

La secuencia de eventos es la siguiente:

1. Un usuario emite un documento en SISTEMAS BACK OFFICE. Como


resultado de esto, SISTEMAS BACK OFFICE deja un archivo TXT en una
carpeta compartida en el eGateway de Paperless.
2. El agente de procesamiento identifica un archivo nuevo, lo recupera, lo
procesa para su generacin. Inmediatamente devuelve el estado PPL a la
carpeta correspondiente.
3. El documento electrnico generado (XML) es enviado al servidor eServer
en la nube de Paperless
4. Opcionalmente, el DE es impreso en una impresora pre-configurada y/o
indicada por SISTEMAS BACK OFFICE en el archivo de intercambio (por
ejemplo, la impresora del usuario).
5. El documento electrnico se registra en el repositorio de archivos del
eServer y en la Base de Datos y se enva a el servidor de SUNAT para su
validacin
6. LA SUNAT responde el estado del documento electrnico. Si el documento
no es rechazado, opcionalmente, el mismo (XML) y su representacin

Paperless Peru 7
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin

grfica (PDF) es enviado o distribuido va correo electrnico al receptor


del documento.
7. El Servidor eServer registra el estado de la SUNAT y devuelve el mismo al
servidor eGateway, el cual actualiza el estado del documento.
8. SISTEMAS BACK OFFICE consulta por el estado SUNAT del documento
electrnico en la carpeta compartida definida para esos efectos en el
Servidor eGateway.

Requisitos para implementar la integracin indicada:

1. Carpeta compartida entre SISTEMAS BACK OFFICE y el e-Gateway


(instalado en CLIENTE).

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:

RUC Empresa: Es el RUC de la empresa que genera el documento.

Consideraciones:

Para los archivos de texto se debe de utilizar el formato de encoding


UTF-8.
Los nombres de los archivos deben tener la siguiente estructura:

RUCEMPRESA_TIPODOC_SERIECORRELATIVO_AAAAMMDD.txt

Una vez que el archivo a procesar es dejado en la carpeta indicada en el


punto anterior, e-Server informar el estado de la generacin de los
documentos (Estado PPL) a travs de un archivo que se crear en el
directorio:

/home/ppldtepe/DTE/RUC Empresa/Online/Salida/

En donde:

RUC Empresa: Es el RUC de la empresa que genera el documento.

El nombre del archivo que entregar el Estado PPL del documento


generado ser:

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

El formato del archivo para su respuesta es:

Cdigo (Valor de tipo Entero con el cdigo de respuesta)


Mensaje (Valor de tipo string con la descripcin de la respuesta)

Ejemplo:

-1|Error, archivo XML no valido. Documento no tiene encabezado o esta mal


formado

El estado del documento en la SUNAT ser informado a travs de un


archivo que se creara en el directorio:

/home/ppldtepe/DTE/RUC Empresa/Estado/

En donde:

RUC Empresa: Es el RUC de la empresa que genera el documento.

El nombre del archivo ser:

SUNATYYYYMMDDHHmmss.TXT

Los Estados de los documentos en la SUNAT sern entregados en un


archivo txt separado por carcter PIPE (|) con la siguiente estructura:

Docid = Nmero del Registro del documento en la plataforma de PPL


TipoDoc = el Tipo de documento tributario electrnico generado.
Serie+Correlativo = Indicar la Serie y el Correlativo del Documento.
Fecha Emisin = aaaa-mm-dd. Fecha de emisin del documento
electrnico.
Cdigo Estado SUNAT = Cdigo indicado en la tabla de Estados de este
documento.
Glosa Estado SUNAT = Glosa del Cdigo de Estado de la SUNAT

Ejemplo:

392|01|F60000439646|2014-09-05|1|La Factura numero F600-439646, ha


sido aceptada

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.

5.1.3 EMISIN MASIVA VA CARPETA COMPARTIDA (OPCION 3)

La emisin masiva comprende la emisin de mltiples DE desde SISTEMAS


BACK OFFICE. Este proceso considera la emisin de documentos en la
modalidad Orden de Trabajo, es decir, varios documentos que deben ser
emitidos y enviados a la SUNAT a travs de la generacin de una orden de
trabajo.
Este proceso provee un rendimiento adecuado para volmenes muy grandes
de documentos a procesar de una sola vez.

La Emisin Masiva de Documentos se describe en el siguiente diagrama:

Paperless Peru 11
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin

1. Un usuario gatilla un proceso en SISTEMAS BACK OFFICE que emite un


archivo TXT con todos los documentos emitidos. Este archivo se deja en la
carpeta de documentos masiva correspondiente. Mediante un agente en el
eGateway que monitorea dicha carpeta, se toma el archivo y se genera
una orden de trabajo en la plataforma de Paperless (e-Gateway).
2. Esta Orden de Trabajo es registrada en el e-Gateway. El criterio de
generacin y envo a la SUNAT de la OT es que TODOS los documentos
del archivo masivo hayan sido generados sin errores. Si existe al menos 1
documento con error entonces ningn documento de la OT se enviar a la
SUNAT.
3. Los documentos electrnicos generados (XMLs) son enviados al servidor
eServer en la nube de Paperless
4. Opcionalmente, Los DEs son impresos en una impresora pre-configurada
y/o indicada por SISTEMAS BACK OFFICE en el archivo de intercambio
(por ejemplo, la impresora del usuario).

Paperless Peru 12
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin

5. Los documentos electrnicos se registran en el repositorio de archivos del


eServer y en la Base de Datos y se envan a el servidor de SUNAT para
su validacin
6. LA SUNAT responde el estado de los documentos electrnicos. Si el
documento no es rechazado, opcionalmente, el mismo (XML) y su
representacin grfica (PDF) es enviado o distribuido va correo
electrnico al receptor del documento. Esto para cada uno de los
documentos enviados
7. El Servidor eServer registra el estado de la SUNAT y devuelve el mismo al
servidor eGateway, el cual actualiza el estado del documento.
8. SISTEMAS BACK OFFICE consulta por el estado SUNAT de los documentos
electrnicos en la carpeta compartida definida para esos efectos en el
Servidor eGateway.

Requisitos para implementar la integracin indicada:

1. Carpeta compartida entre SISTEMAS BACK OFFICE y el e-Gateway


(instalado en CLIENTE).

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:

RUC Empresa: Es el RUC de la empresa que genera el documento.

Consideraciones:

Para los archivos de texto se debe de utilizar el formato de encoding UTF-


8.
Los nombres de los archivos deben tener la siguiente estructura:

RUCEMPRESA_AAAAMMDD.txt

Una vez que el archivo a procesar es dejado en la carpeta indicada en el


punto anterior, e-Server informar el estado de la generacin de los
documentos (Estado PPL) a travs de un archivo que se crear en el
directorio:

/home/ppldtepe/DTE/RUC Empresa/Masivo/Salida/

En donde:

Paperless Peru 13
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin

RUC Empresa: Es el RUC de la empresa que genera el documento.

El nombre del archivo que entregar el Estado PPL del documento


generado ser:

RUCEMPRESA_TIPODOC_SERIECORRELATIVO.TXT

En donde:

TIPODOC = cdigo de tipo de documento segn SUNAT, del primer


documento encontrado en el procesamiento masivo.
SERIECORRELATIVO = Serie y Correlativo del primer documento
encontrado en el procesamiento masivo.

El archivo de Estado PPL tendr la siguiente estructura:

Serie-Correlativo|codigo estado generacin|mensaje generacin

6. CONSIDERACIONES ESPECIALES
Para implementar la integracin anterior, correctamente con SISTEMAS
BACK OFFICE, se deben tener en cuenta las siguientes consideraciones:

1.5 ADMINISTRACIN DE ESTADOS


Se deben almacenar en SISTEMAS BACK OFFICE los estados resultantes de
la emisin de DEs que son el Estado PPL y el Estado SUNAT.

1.6 PROCESO DE IMPRESIN DE LOS DOCUMENTOS


Se debe de entregar al equipo de Produccin de Paperless, lo siguiente:
Nombre lgico de las impresoras que sern utilizadas para la impresin
de los documentos.
Ip de las impresoras.
Los Drivers de cada tipo de impresora deben de estar instalados en el
servidor.

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

ejecucin de la aprobacin/rechazo comercial de los documentos recibidos


desde los proveedores.

La recepcin se logra como se describe en el siguiente diagrama:

CLIENTE PAPERLESS PERU

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

SAP Paperless Paperless


e-Gateway e-Server

La secuencia es como sigue:

1. El Proveedor (Emisor del Documento Tributario Electrnico DE) enva un


DE en un mail a la casilla publicada por CLIENTE para recibir los DE.
2. El e-Server recibe el documento, lo valida tcnicamente y lo valida con la
SUNAT para verificar que sea un documento vlidamente emitido (que
tenga el Estado Aceptado o Aceptado con Observaciones).
3. SISTEMAS BACK OFFICE recibir una lista de los documentos recibidos en
la plataforma de PPL ms algunos datos de ellos (revisar punto 7.1) para
apoyar el proceso de aprobacin o rechazo comercial. Esta lista podr ser
obtenida va carpeta compartida o va WS. El SISTEMAS BACK OFFICE
deber obtener la lista de Documentos a aprobar o rechazar
comercialmente desde el eServer.

Paperless Peru 15
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin

4. El usuario aprobador valida la informacin del documento y realiza la


aprobacin o rechazo comercial desde SISTEMAS BACK OFFICE.
5. SISTEMAS BACK OFFICE informa al e-Server la aprobacin o rechazo
comercial del documento. Esto a travs de la interfaz
http://ip/Facturacion/webservices/statusAcDE.jsp o dejando un archivo
txt en una carpeta compartida.
6. El e-Server enva al Proveedor (Emisor del DE recibido por CLIENTE) el
comprobante de aceptacin o rechazo comercial segn corresponda.

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.

1.7 INTERFAZ SISTEMAS BACK OFFICE (INYECCIN DE DOCUMENTO


RECIBIDO DESDE PAPERLESS)

El proceso de entrega de los documentos recepcionados puede ser va


Carpeta compartida o va entrega interfaz WS.
A continuacin se detallan las alternativas indicadas.

7.1.1 Recepcin Lista de Documentos va Carpeta Compartida

La recepcin de los documentos que fueron validados con la SUNAT y que


tienen el estado Aceptado o Aceptado con observaciones puede ser va
Carpeta compartida.

Para lo anterior la lista de los documentos quedar entregada en la ruta:

/home/ppldtepe/DTE/RUC Empresa/Recepcion/

El nombre del Archivo que contendr la Lista de Documentos ser:

AAAAMMDDhhmmss.txt

Paperless Peru 16
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin

La lista contendr uno o ms registros que contendrn la siguiente


informacin:

Ruc Emisor del documento.


Tipo de documento (de acuerdo a codificacin SUNAT)
Serie del documento.
Correlativo del Documento.
Fecha de emisin del documento.
Monto Bruto (Monto Total del documento).
IGV.
Monto Neto.
Orden de Compra.
Moneda.
Tipo Documento Referencia
Serie del Documento Referencia
Correlativo del Documento Referencia

Ejemplo de archivo:

El archivo tendr la siguiente estructura:

20521886448|01|F001|1|2011-05-24|119|19|110|23478|PEN|01|F002|12

7.1.2 Recepcin Lista de Documentos va WS (mtodo


OnlineRecoveryRecList)

La interfaz de Paperless (OnlineRecoveryRecList) permite el envo de la


informacin de los DEs recibido a SISTEMAS BACK OFFICE. Para esto se
debe referenciar el mtodo: OnlineRecoveryRecList, descrito en el
documento WSDL_Integracionv1.0-Peru.doc.
Por lo anterior el flujo de operacin respecto de la inyeccin de documentos
recibidos es la siguiente:

1. SISTEMAS BACK OFFICE invoca el mtodo OnlineRecoveryRecList y


obtiene la lista de documentos recibidos junto con lo datos relevantes
definidos por CLIENTE para actualizar SISTEMAS BACK OFFICE. Los
documentos sern aquellos que estn aceptados o aceptados con
observaciones en la SUNAT.
2. Los datos que retornar el mtodo OnlineRecoveryRecList son los
siguientes:

Ruc Emisor
Tipo de documento

Paperless Peru 17
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin

Serie del documento


Correlativo del Documento.
Fecha de emisin del documento
Monto Bruto (Monto Total del documento)
IGV
Monto Neto
Orden de Compra
Moneda

El detalle del dato retornado y su obtencin desde el documento


recepcionado se indica en la tabla detallada a continuacin:

Dato Tag XML Consideraciones


Ruc Emisor
Tipo de documento
Folio
Fecha de emisin
Monto Bruto (Monto
Total)
IVA
Monto Neto
Orden de Compra
Moneda

1.8 INTERFAZ APROBACIN O RECHAZO COMERCIAL (DESDE SISTEMAS


BACK OFFICE A PAPERLESS)

El proceso de entrega aprobacin y rechazo comercial puede ser va Carpeta


compartida o va interfaz WS.

A continuacin se detallan las alternativas indicadas.

7.1.3 Aprobacin o Rechazo Comercial va Carpeta Compartida

La aprobacin o rechazo comercial va carpeta compartida se implementa de


acuerdo a los siguientes puntos.

SISTEMAS BACK OFFICE deber dejar en la siguiente ruta del Servidor e-


Server el archivo con el detalle de las aprobaciones o rechazos comerciales
ya sea de documentos uno a uno o en forma masiva:

/home/ppldtepe/DTE/RUC Empresa/ApRecComercial/

Paperless Peru 18
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin

7.1.3.1 Aprobacin Documentos uno a uno

El nombre del archivo de aprobacin o rechazo comercial, si la opcin es


aprobar o rechazar uno a uno es la siguiente:

RucEmisor_SerieCorrelativo.txt

La estructura del archivo txt con el registro de la aprobacin o rechazo


comercial debe ser con separador pipe | y debe tener la siguiente estructura:

Ruc Emisor (del documento recibido)


Serie y Correlativo del documento recibido
Descripcin de Estado (glosa explicativa de la aprobacin o rechazo)
Estado = que puede tener los valores:
o 1 Aprobacin Comercial
o 2 Rechazo Comercial

Ejemplo de archivo:

El archivo tendr la siguiente estructura:

20521886448|F001|1|Documento Aceptado|1

7.1.3.2 Aprobacin masiva de documentos (de uno a n)

El nombre del archivo de aprobacin o rechazo comercial, si la opcin es


aprobar o rechazar uno a uno es la siguiente:

AAAAMMDDhhmmss.txt

La estructura del archivo txt con el registro de la aprobacin o rechazo


comercial debe ser con separador pipe | y debe tener la siguiente estructura:

Ruc Emisor (del documento recibido)


Serie y Correlativo del documento recibido
Descripcin de Estado (glosa explicativa de la aprobacin o rechazo)
Estado = que puede tener los valores:
o 1 Aprobacin Comercial
o 2 Rechazo Comercial

Ejemplo de archivo:

Paperless Peru 19
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin

El archivo tendr la siguiente estructura:

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

7.1.4 Aprobacin o Rechazo Comercial va WS

La interfaz que utilizar SISTEMAS BACK OFFICE para aprobar o rechazar


comercialmente un documento recibido ser a travs de la interfaz
statusAcDE.jsp, que provee la aplicacin de Paperless.

Los parmetros que utiliza la interfaz statusAcDE.jsp son los siguientes:

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:

La siguiente es una direccin de ejemplo para rechazar comercialmente un


documento:

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

La respuesta del mensaje ser un XML con el resultado de la operacin con la


siguiente estructura:

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

En trminos generales la aplicacin PPL (e-Server) actuar como un servidor


y la aplicacin e-POS como cliente y, en este sentido, ser la responsable de
generar el intercambio de informacin.

La emisin de documentos desde POS se logra como se describe en el


siguiente diagrama:

CLIENTE PAPERLESS

Receptor

PUNTO DE VENTA LOCALES

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

Mensaje opcional: Solicitar Serie


Correlativo

Paperless Peru 22
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin

Descripcin del proceso:

1. Como primer mensaje cada vez que se inicializa la comunicacin con el


e-POS, la aplicacin POS debe enviar el mensaje de autenticacin. Esto
es por cada vez que se inicie o levante el Sistema POS del CLIENTE.
2. Este mensaje es opcional. Si el CLIENTE necesita tener antes de
generar el documento la Serie y Correlativo del documento a generar
puede enviar este mensaje al e-POS.
3. La aplicacin POS del Cliente enva un mensaje de generacin
incorporando el TXT del Documento a generar por el e-POS.
4. La aplicacin e-POS genera el archivo XML del documento y entrega la
Serie, el correlativo, el estado de generacin del documento y la
informacin que va en el timbre PDF 417 y hash. La aplicacin POS del
Cliente imprime el documento.
5. La aplicacin de POS confirma el documento al e-POS (modalidad
pre-anulado).
6. La aplicacin e-POS enva al e-Gateway el documento electrnico
generado (XML).
7. El e-Gateway enva el documento al eServer.
8. El eServer enva el documento a la SUNAT, si este fue confirmado por
el cliente.
9. La SUNAT retorna el Estado del Documento al e-Server.

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.

A continuacin se define la estructura y los mensajes que deben ser


implementados.

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:
:

MENSAJE = @**@Param1 + TAB + Param2 + TAB + .... + TAB + ParamN*@@*


RESPUESTA = STXRespuesta1 + TAB + .... + TAB + RespuestaNETX

El mensaje tiene 2 secuencias de caracteres de controla, una al inicio y otra


al fin del mensaje, @**@ y *@@* respectivamente.

La respuesta tiene 2 caracteres de inicio y fin, que corresponden a los


caracteres ascii de control STX y ETX.

En el caso de las respuestas, el primer parmetro corresponder siempre al


resultado (status) de la operacin, en donde:

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.

Por ejemplo, si el mensaje X se procesa correctamente, la respuesta ser:

RESPUESTA = STX + 0 + TAB + Respuesta2 + TAB + ... + TAB + RespuestaN + ETX

En caso contrario, si el mensaje es procesado con error, la respuesta ser:

RESPUESTA = STX + 4 + TAB + No hay folios disponibles + ETX

En la descripcin de los mensajes siguientes se omite el caso de error, ya


que la respuesta es estndar para todos los mensajes.
En cada invocacin de mensaje, se debe de considerar un timeout de 8
segundos
Hacer el flujo del cierre del socket y explicarlo aqu

Paperless Peru 24
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin

1.11 CONFIGURACIN POS


Configura el POS a partir de la informacin de configuracin del e-POS. Este
es el primer mensaje que debe ser enviado a la aplicacin PPL cuando se
inicialice la aplicacin de e-POS.

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

Ejemplo del mensaje de Configuracin:

@**@1 0 11111111111 1 700*@@*

Respuesta:
STX0 OKETX

1.12 MODALIDADES DE GENERACIN DE DES


Existen dos modalidades de operacin del e-POS para generar DEs las
cuales son Pre-Anulado y Pre-Confirmado. Se detallan a continuacin.

8.1.1 Modalidad Pre-Anulado


En esta modalidad, todos los documentos se consideran anulados a menos
que se reciba el mensaje de confirmacin por parte del Sistema de Venta del
cliente. El mensaje de confirmacin debe ser enviado por el Sistema de
Venta una vez que la impresin/contabilizacin del documento ha sido
exitosa. Una vez que el mensaje de confirmacin se recibe, el documento es
enviado por el e-POS hacia el Controlador/ASP para ser oficializado.

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.

8.1.2 Modalidad Pre-Confirmado


En esta modalidad, todos los documentos se consideran vlidos a menos que
se reciba un mensaje de anulacin por parte del Sistema de Venta. El
mensaje de anulacin debe ser enviado por el Sistema de Venta en aquellos
casos en que la impresin del documento no haya sido exitosa. Debido a la
estrategia de envo de documentos asncrona del e-POS hacia el
Controlador/ASP, es posible que al ser enviado el mensaje de anulacin, el
documento ya haya sido enviado al Controlador/ASP. En este caso, la
operacin de anulacin debe ser realizada por otros medios en el sistema
central.

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.

1.13 SOLICITAR FOLIO


Este mensaje permite solicitad la Serie y Correlativo del documento a
generar, para que la aplicacin POS del Cliente pueda usar esa informacin
para los propsitos que estime conveniente. El valor retornado debe ser
enviado en el archivo TXT del documento a generar. El archivo TXT es un
parmetro que es enviado en el mensaje 2 definido en el punto 8.6

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

Ejemplo del mensaje de Confirmacin:


@**@5 0 11111111111 1 01*@@*

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.

El primer paso de la generacin de un DE es el envo del documento a travs


del mensaje correspondiente al e-POS.

El e-POS toma el archivo txt incluido en el mensaje y genera el documento


electrnico.

Luego la aplicacin de Cliente deber confirmar la impresin del documento


al e-POS.

El documento generado (XML) se considerar anulado o no vlido a menos


que se reciba el mensaje de confirmacin. Dado lo anterior, ese mensaje
produce un aumento del correlativo asociado a la Serie.

Para el proceso de autenticacin del POS el mensaje es el siguiente:

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)

Mensaje de generacin de Documento, se deber utilizar la siguiente


mensajera:

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)

Ejemplo de Mensaje de Generacin (POS):

@**@2 0 11111111111 1 01 EN|01|F001-3|2011-03-


01|PEN|20521886448|6|Cliente|Cliente S. A.|070101|Calle Los Olivos 234 -
Callao|Lima|Callao|Callao|20507955437|6|DROGUERIA OMEGA
EIRL|38.10|7.24|||45.34
DN|SIMPLE GRAVADO - 1 ITEM
DE|1|2.54|CS|15|38.10
DEDI|CIPERMETRINA AL 15%
DEIM|7.24|38.10|7.24|19.0|A|01||10000|IGV|VAT
DI|7.24|7.24|10000|IGV|VAT*@@*

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

controlar errores ocurridos posteriores a la respuesta del mensaje 8.4 y la


impresin del DE.

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

Ejemplo del mensaje de Confirmacin:


@**@3 0 11111111111 1 01 F001-1*@@*

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

Ejemplo del mensaje de Confirmacin:


@**@4 0 11111111111 1 01 F001-1*@@*

Paperless Peru 29
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin

Respuesta:

STX0 OKETX

1.17 CDIGOS DE ERROR


A continuacin se describen los cdigos de error que se deben considerar:

CODIGO DESCRIPCION DESCRIPCIN


0 Operacin Exitosa El documento se gener
correctamente, sin problemas.
1 El cdigo de mensaje no corresponde El mensaje enviado al ePOS no
est de acuerdo a la codificacin
establecida en el documento de
integracin.
2 El mensaje est incompleto El mensaje enviado al ePOS no
viene completo con toda la
informacin solicitada en el
documento de integracin.
3 Error inesperado Este error indica que se gener
una falla en la comunicacin que
debe ser revisada en detalle en el
log del ePOS para determinar su
causa. Requiere un trabajo
operativo de bsqueda y revisin
del log de la aplicacin ePOS.
4 No hay Serie-Correlativo disponibles La aplicacin ePOS no tiene Serie
y Correlativo disponible para el
documento que se requiere
generar. Se debe revisar porqu
no existen series y correlativos
disponibles.
5 No se pudo generar documento (datos no Algn dato dentro del txt o dentro
vlidos) de los parmetros del mensaje no
corresponde al tipo y largo
definido en las especificaciones.
6 Error al firmar documento (XML generado Este es un error que implica una
no vlido) revisin del archivo txt enviado
por la aplicacin de POS del
cliente. Esto ya que alguno de los
datos enviados en el txt no est
de acuerdo al esquema de
definicin de la SUNAT.
7 No hay Serie-Correlativo Disponible La aplicacin ePOS no tiene Serie
y Correlativo disponible para el
documento que se requiere
generar. Se debe revisar porqu
no existen series y correlativos
disponibles.

Paperless Peru 30
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin

CODIGO DESCRIPCION DESCRIPCIN


8 Error al grabar documento No se pudo grabar el documento
XML en el storage de la aplicacin
ePOS.
9 Error al recuperar Serie-Correlativo Error de recuperacin de la serie y
correlativo que se asignara al
documento solicitado por generar.
10 Error al generar PDF417 y HASH Este es un error que implica una
revisin del archivo txt enviado
por la aplicacin de POS del
cliente. Esto ya que alguno de los
datos enviados en el txt no est
de acuerdo al esquema de
definicin de la SUNAT. Tambin
pueden haber otras causas que
implican revisar certificado y
mecanismo de firma del
documento.

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.

1.2 SITUACIONES ESPECIALES


Como parte de la emisin de DE en el POS, se debe considerar y definir los
siguientes casos especiales:

Falla en la comunicacin con el e-POS


Mecanismo de reintentos
Timeout en las comunicaciones
Condicin de error en Operacin Pre-Anulada

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.

La cuadratura contempla, inicialmente, el contraste de los documentos


emitidos en los POS y el sistema de Paperless como se describe a
continuacin.

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 Paperless Paperless


SAP e-POS e-POS e-POS

La secuencia de eventos es la siguiente:

1. Sistema de Punto de Venta (POS) emite documentos (DE y Boletas).


2. La informacin de las transacciones es enviada hacia los sistemas
de BackOffice.
3. El e-POS enva los documentos generados al e-Server para su
posterior envo a la SUNAT.

Paperless Peru 32
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin

4. Al final del da el BackOffice genera un archivo TXT (archivo de


cuadratura) con el detalle de las ventas realizadas en los POS. Este
archivo es cargado por un usuario en el e-Server de Paperless.
5. El e-Server realiza la cuadratura de los documentos y enva el
reporte con el detalle del procesamiento al usuario definido a travs
de un correo electrnico.
6. El e-Server enva los documentos electrnicos a la SUNAT.

Consideraciones

1. El archivo de cuadratura se debe generar diariamente y debe contener


nica y exclusivamente los documentos emitidos para el da
considerado. No se deben mezclar documentos de distintas fechas de
emisin en el mismo archivo.
2. Es responsabilidad de la empresa efectuar el proceso de cuadratura en
forma diaria, de tal forma de efectuar un control de los documentos
emitidos por los POS y que fueron procesados por Paperless.
3. En el caso, que previo al proceso de cuadratura llegase una transaccin
del da anterior y cuyo proceso ya haba sido generado, este debe ser
nuevamente generado incluyendo todas las transacciones del da
anterior, es decir, no se deben generar archivos parciales, slo existir
un archivo TXT por da.

2.1 FORMATO DE INTERCAMBIO CUADRATURA


El archivo de intercambio para realizar la cuadratura es un archivo TXT plano
con un documento por lnea y donde cada campo se separa por | (el
carcter pipe). El contenido del archivo es el siguiente:

Paperless Peru 33
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin

CAMPO TIPO DE DATO DESCRIPCION


RUC Alfanumrico Ruc del receptor del documento.
RECEPTOR
TIENDA Alfanumrico Identificador o cdigo de la
Tienda que emiti el documento.
POS Numrico Entero Identificador del POS que emiti
el documento.
FECHA Numrico Entero Fecha de Emisin del Documento
en el formato AAAA-MM-DD.
TIPODOC Numrico Entero Tipo de documento segn la
normativa de la SUNAT.
SERIE Alfanumrico Serie del documento
CORRELATIVO Numrico Entero Correlativo del documento
AFECTO Numrico Entero Monto Afecto del documento.
Campo 27 seccin EN.
EXENTO Numrico Entero Monto Exento del documento.
Este campo se considerar pero
al no existir tag o campo
asociado en el schema del UBL
liberado por SUNAT CLIENTE
deber informar valor 0.
Monto Numrico Entero Monto Impuestos del
Impuesto documento.
TOTAL Numrico Entero Monto Total del documento.

Una lnea de ejemplo sera la siguiente:


969153106|9|40|2009-01-01|01|F001|10000|0|190|1190

Que indica la Boleta serie F001 correlativo 10000 emitida en la Tienda 9 por
el Pos 40 y por un total de 1190 soles.

2.2 FORMATO DE INTERCAMBIO NOMBRE DEL ARCHIVO


El archivo debe dejarse en la carpeta definida para la cuadratura con el
siguiente nombre:

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.

2.3 FORMATO DE INFORME DE RESULTADO DE CUADRATURA


El informe de resultado del proceso de cuadratura es un archivo TXT plano
con un registro de cuadratura por lnea y donde cada campo se separa por
| (el carcter pipe).
Es importante indicar que el Informe tiene dos secciones, una donde se
muestra la informacin que registra los documentos informados por el
Cliente y otra que registra los documentos informados por Paperless.
El contenido del archivo es el siguiente:

CAMPO TIPO DE DATO DESCRIPCION


SECCIN CLIENTE
RUC Alfanumrico Ruc del receptor del documento
RECEPTOR
TIENDA Alfanumrico Identificador de la Tienda que
emiti el documento.
POSID Numrico Entero Identificador del POS que emiti
el documento.
TIPODOC Numrico Entero Tipo de documento segn la
normativa de la SUNAT
SERIE Alanumrico Serie del documento
CORRELATIVO Numrico Entero Correlativo del documento
FECHA Numrico Entero Fecha de Emisin del Documento
EMISION en el formato AAAA-MM-DD.
AFECTO Numrico Entero Monto Afecto del documento
EXENTO Numrico Entero Monto Exento del documento
IGV Numrico Entero Monto IGV del documento
TOTAL Numrico Entero Monto Total del documento
SECCIN PAPERLESS

Paperless Peru 35
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin

RUC Alfanumrico Ruc del receptor del documento


RECEPTOR
TIENDA Alfanumrico Identificador de la Tienda que
emiti el documento.
POSID Numrico Entero Identificador del POS que emiti
el documento.
TIPODOC Numrico Entero Tipo de documento segn la
normativa de la SUNAT
SERIE Alanumrico Serie del documento
CORRELATIVO Numrico Entero Correlativo del documento
FECHA Numrico Entero Fecha de Emisin del Documento
EMISION en el formato AAAA-MM-DD.
AFECTO Numrico Entero Monto Afecto del documento
EXENTO Numrico Entero Monto Exento del documento
IGV Numrico Entero Monto IGV del documento
TOTAL Numrico Entero Monto Total del documento
CODIGO Numrico Entero Cdigo del error del descuadre
ERROR en base a tabla del punto 11.
MENSAJE Alfanumrico Glosa y detalle del error de
ERROR descuadre.

Este reporte es enviado va correo al usuario administrador del proceso de


cuadratura para que procese la informacin entregada como estime
conveniente.

2.4 DEFINICIN CDIGOS DE ERROR EN EL INFORME DE CUADRATURA

Los cdigos posibles son los siguientes:

Cdigo Descripcin

0 Documento OK

1 Documento no existe en Plataforma Paperless

3 Error por diferencia en montos (neto, exento, igv, total)

Documento duplicado (Puede ser 2 veces informado por el cliente o 2 veces


4
registrado por PPL)

5 Documento existe en Paperless, pero no en existe en el Cliente.

Paperless Peru 36
Santo Toribio 115, Piso 4 San Isidro Lima Per
Documento de Integracin

3. INFORME DE BAJAS

En base al manual de informe de Bajas liberado por la SUNAT en el


documento INFORME+Comunicacin+de+baja.pdf se debe determinar los
documentos que cumplen con el concepto de baja.
Lo definido por SUNAT en el documento pdf referenciado es lo siguiente:

La comunicacin de baja contiene la relacin de informacin de


aquellas facturas y boletas de venta electrnicas que si bien pueden
haber sido generadas y numeradas por los sistemas del emisor
electrnico, no han sido otorgadas al adquirente o usuario. Las
especificaciones estn definidas en los Anexos N 9 y N 10 de la
Resolucin de Superintendencia N 097-2012/SUNAT.
En el caso de las facturas, aplica siempre que hayan sido informadas
previamente a SUNAT, es decir que cuenten con un CDR
ACEPTADO. Para el caso de las boletas de venta, la comunicacin de
baja puede ser respecto a boletas informadas en el resumen diario
de boletas o las no incluidas en ese resumen.
El plazo para realizar esta comunicacin es:
En el caso de factura electrnica y sus notas asociadas: a ms
tardar 72 horas contadas a partir del da siguiente de la fecha
consignada en el CDR (constancia de recepcin)
En el caso de boletas de venta electrnicas y sus notas
asociadas, informadas mediante Resumen Diario, a ms tardar
72 horas contadas a partir del da siguiente de la fecha
consignada en el CDR (constancia de recepcin)
En el caso de boletas de venta electrnicas y sus notas
asociadas no informadas, a ms tardar 72 horas contadas a
partir del da siguiente de la fecha de generacin

Esos documentos debern ser informados desde el Sistema Back Office de


CLIENTE a la aplicacin de Paperless para poder generar el Informe de Bajas
que, de ser necesario, debe ser informado a la SUNAT.

3.1 PROCESO DE GENERACIN DE INFORME DE BAJAS

El proceso de generacin del informe de bajas se muestra a continuacin:

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 secuencia es como sigue:

1. El usuario genera el archivo txt de bajas en SISTEMAS BACK


OFFICE.
2. El usuario va upload sube el archivo de bajas a la plataforma de
Paperless en el Servidor e-Server.
3. El usuario podr revisar este informe consolidado bajndolo desde
la plataforma en formato csv.
4. El usuario, una vez revisado el informe consolidado indicado en el
punto 3, enva a la SUNAT el informe de bajas del perodo.
5. La SUNAT informa del estado del envo del informe de bajas a
CLIENTE.

3.2 ESTRUCTURA DEL ARCHIVO TXT DE BAJAS SISTEMAS BACK OFFICE

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

CAMPO TIPO DE DESCRIPCION


DATO
RUC EMISOR Alfanumrico Ruc del emisor del informe de bajas.
INFORME DE
BAJAS
FECHA DE Alfanumrico Fecha en formato aaaammdd
EMISIN DE
DOCUMENTO
TIPO DE Alfanumrico De acuerdo al tipo de documento
DOCUMENTO informar:
01 Si el documento es Factura
03 Si el documento es Boletas de Venta
07 Si el documento es Nota de Crdito
08 Si el documento es Nota de Dbito
SERIE Alfanumrico Detalla la Serie del Documento dado de
baja.
CORRELATIVO Alfanumrico Detalle del correlativo del Documento
dado de baja.
FECHA DE Alfanumrico Fecha de generacin del Informe de
GENERACIN baja, en formato aaaa-mm-dd.
MOTIVO Alfanumrico Glosa explicativa del motivo de baja.

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

En la plataforma se debe de colocar la fecha del periodo y esta debe ser la


misma que la fecha de generacin

Paperless Peru 39
Santo Toribio 115, Piso 4 San Isidro Lima Per

S-ar putea să vă placă și