RE DEL REQUISITO

Características del Requisito

Descripción 

Permitir el envío y recepción de Documentos Comprobantes de Retención entre Protheus y TSS.

Importante

Antes de ejecutar el compatibilizador, UPDMODMI es imprescindible:

• Realizar la copia de seguridad de la base de datos del producto que ejecutará el compatibilizador (directorio PROTHEUS_DATA\DATA, si es la versión 10, o \PROTHEUS11_DATA\DATA, si es la versión 11) y de los diccionarios de datos SX (directorio PROTHEUS_DATA_SYSTEM, si es la versión 10, o \PROTHEUS11_DATA\SYSTEM, si es la versión 11).
• Los directorios mencionados anteriormente corresponden a la instalación estándar del Protheus, por lo tanto, deben modificarse de acuerdo con el producto instalado en la empresa.
• Esta rutina debe ejecutarse de modo exclusivo, es decir, ningún usuario debe estar utilizando el sistema.
• Si los diccionarios de datos tienen índices personalizables (creados por el usuario), antes de ejecutar el compatibilizador, asegúrese de que están identificados por el nickname. Si el compatibilizador necesita crear índices, los agregará a partir del orden original instalado por el Protheus, lo que podrá ocasionar la superposición de índices personalizados, si no están identificados por el nickname.
• El compatibilizador debe ejecutarse con la Integridad referencial desactivada*.

1. En Microsiga Protheus TOTVS Smart Client(si la versión es 10) o ByYou Smart Client (si la versión es 11), digite UPDMODMI en el campo Programa Inicial. Describa si el compatibilizador debe tener una fecha específica o superior para que la actualización en los diccionários se efectúe correctamente. Importante: Para que se actualice correctamente el diccionario de datos, asegúrese de que la fecha del compatibilizador sea igual o superior al 10/10/2016.
2. Se muestra un mensaje de advertencia sobre la copia de seguridad y la necesidad de su ejecución de modo exclusivo.Haga clic en Sí para continuar.
3. Después de confirmar, aparece una pantalla para seleccionar el módulo en la cual se encuentra la actualización correspondiente. Seleccione el módulo SIGACOM- Compras.
4. De la lista de actualizaciones mostradas, seleccione "Comprobantes de Retención Signature/TSS Perú."
5. Al confirmar, 

1. 1. Inicia el procesamiento.
   2. A continuación, se muestra la ventana Actualización concluida con el historial (log) de todas las actualizaciones procesadas. En este log de actualización se muestran únicamente las tablas afectadas  por el programa. 
   3. Haga clic en Grabar para guardar el historial (log) mostrado.
   4. Haga clic en OK para finalizar el procesamiento.

Como premisa, es necesario contar con la correcta instalación de TSS versión 2.63 o superior, de lo contrario, deberá solicitar por llamado el parche con las rutinas para TSS  mencionadas en características del Requisito.

1. Instalación TSS
   
   

   - Realizar la instalación del TSS a través del instalador disponible en la sección de download del portal del cliente: https://suporte.totvs.com/download, en la  línea de Protheus, buscar por el nombre del instalador TSS.

   - Verificar la generación  del archivo de Schema (DTE_v1.0.xsd) en la pasta de Schemas de TSS creada durante la instalación.
   
   

   
   

2. Configuración de procesamiento.
   
   Después de la Instalación, configurar y habilitar el Job de procesamiento de los documentos en el archivo appserver.ini de TSS con las siguientes instrucciones:

   ; Sección de declaración del Job

   [WFSIGNATUREPER]

   main= TSSSignPERU

   environment=sped

    

   ;start de job

   [onstart]

   jobs=WFSIGNATUREPER

   En seguida bajar y subir nuevamente el server de  TSS.

    

3. Verificar el funcionamiento de los Web Services en TSS.
   
   

   Acceda al URL configurado para los Web Services de TSS mediante algún Explorador de Internet. Verifique que se encuentre el Web Service TSSSignature en el Index de Servicios Web mostrados.

    

4. Verificar el acceso a los Web Services de SIGNATURE.
   
   

   El URL para conexión con SIGNATURE, deberá probarse de la siguiente manera: En cualquier explorador de Internet coloque la URL proporcionada. Deberá mostrarse la definición del Web Service con los métodos que lo componen.

Procedimiento de Implantación 

1. Realice la aplicación del paquete de actualizaciones (patch) asociado a este llamado. El patch contiene la actualización de los siguientes fuentes:
   
   • UPDMODMI– Actualización del diccionario de datos.
   • UPDCOMMI– Actualización del diccionario de datos Compras)
   • UPDCREPER – Actualización diccionario de datos para Perú.
   • MATA485 – Transmisión electrónicA.
   • CRXMLPER– Generación XML Comprobantes de Retención Perú.
   • FINA085A – Orden de Pago
   • NFECFGLOC– Cliente de Web Service NFECFGLOC
   • TSSWSSIGNATURE - cliente de Web Services TSSWSSIGNATURE
2. Ejecute UPDMODMI.
3. Revise la configuración de parámetros creados por el Actualizador.
4. Configure rutina en el menú correspondiente. SIGACOM->Actualizaciones->Movimientos->Transmisión Electrónica(MATA485)

• • XD – Tipos de Documentos Identidad SUNAT

Esta tabla, contiene la equivalencia de los Tipos de documentos de los registros en Tabla Genérica TB vs Catálogo 06 Códigos Tipos de Documentos de Identidad que el SUNAT acepta:

• • Tabla TB: Tipos de documento de Identidades

• • Tabla XD: Tipos de Identidad SUNAT
    
    
  • Tabla XF – Tipos de Monedas ISO-4217
    

Esta tabla contiene la relación entre el catálogo 02 Códigos de Monedas aceptadas por la SUNAT y la monedas utilizadas por el Protheus según corresponda.

5. Genere Registros de comprobantes de retención a partir del siguiente procedimiento.

• • Generar factura de entrada
  • En el módulo de Financiero, Ir a la rutina Actualizaciones->Cuentas por Pagar->Orden de pago y efectuar el pago correspondiente.
  • Se informará sobre la creación del Comprobante de Retención correspondiente.

6. Ejecute procedimiento de Transmisión de Comprobantes de Retención Electrónicos.

Actualizaciones del Compatibilizador 

(Solamente para Microsiga Protheus, versiones anteriores a la versión 12).

1.  Creación de Preguntas en el archivo SX1 – Archivo de Preguntas:
   
   

 MATA485D

2.Creación de tabla en el archivo SX2– Tablas:

N/A
3.  Creación  de Tablas Genéricas en el archivo SX5 – Tablas Genéricas:

N/A
4.  Creación  de Campos en el archivo SX3 – Campos:

• Tabla SFE - Comprobantes de Retención

Importante:

El tamaño de los campos que disponen de grupo puede variar de acuerdo con el entorno en uso.

5.  Creación o modificación de Consulta Estándar en el archivo SXB – Consulta Estándar:

• N/A

6.  Creación o modificación de Índices en el archivo SIX – Índices:

• N/A

7.  Creación o modificación de Parámetros en el archivo SX6 – Parámetros:

8.  Creación de Disparadores en el archivo SX7 – Disparadores:

• N/A

Procedimiento de Configuración

CONFIGURACIÓN DE PARÁMETROS

1. En el Configurador (SIGACFG), acceda a Entornos/Archivos/Parámetros (CFGX017). Configure los parámetros a continuación:
   

   
   
   

   Ítems/Carpetas	Descripción
   Nombre:	MV_SIGNADM
   Tipo:	Caracter
   Cont. Esp.:	Ej. admin@totvs,com.br
   Descripción:	Email del administrador del sistema Signature

    

    

   Ítems/Carpetas	Descripción
   Nombre:	MV_SIGNUSR
   Tipo:	Caracter
   Cont. Esp.:	admin
   Descripción:	Usuario del sistema SIGNATURE

   Ítems/Carpetas	Descripción
   Nombre:	MV_SIGNPAS
   Tipo:	Caracter
   Cont. Esp.:	Ej. Tilkkkxv
   Descripción:	Password del Usuario del sistema SIGNATURE

   Ítems/Carpetas	Descripción
   Nombre:	MV_CFDDOCS
   Tipo:	Caracter
   Cont. Esp.:	GetSrvProfString('startpath','')+'\cfd\facturas\'
   Descripción:	Directorio donde se graban las facturas electrónicas

    

   Ítems/Carpetas	Descripción
   Nombre:	MV_CRSERIE
   Tipo:	Caracter
   Cont. Esp.:	R001
   Descripción:	Serie Comprobantes de Retencion a 4 caracteres que sera reportada a SUNAT.

   
   

CONFIGURACIÓN DE MENÚS

2.  En el Configurador (SIGACFG), acceda a Entornos/Archivo/Menú (CFGX013). Informe la nueva opción de menú del SIGACOM, conforme las instrucciones a continuación:

Procedimiento de Utilización 

1. Es indispensable realizar la configuración de los parámetros siguientes que fueron creados por el compatibilizador: MV_SIGUSR, MV_SIGNPAS. El primero contendrá el usuario para conectar a SIGNATURE y el segundo la contraseña encriptada. Estos datos son proporcionados por SIGNATURE y son diferentes por cliente.

2. La carpeta en el servidor definida en el parámetro MV_CFDDOCS debe ser una ruta existente, los nombres de las carpetas en la ruta no deben contener espacios intermedios; por ejemplo, se puede emplear la expresión GetSrvProfString('startpath','') la cual devuelve la ruta del System del ambiente donde está instalado Protheus. Ejemplo: GetSrvProfString('startpath','')+'\cfd\facturas\'. Esta carpeta contendrá los archivos de aquellos documentos que son enviados por SIGNATURE a la SUNAT.
3. Configurar parámetro MV_CRSERIES, el cuál contendrá la serie de los comprobantes de Retención, Esta serie deberá iniciar con la letra 'R' seguida de un correlativo de 3 dígitos alfanuméricos. Se deberá colocar valor en el parámetro MV_CRSERIE, ya que de lo contrario el xml generado para enviar a TSS no llevará este dato y el documento será rechazado. Ejemplo de contenido : R001.
4. SIGNATURE debe proporcionar el URL para envío de documentos ya que esta es personalizada por cada cliente. Así mismo el Área de conexión y la contraseña de la misma para autenticar la conexión para envío de documentos.
5. El certificado Digital emitido por la SUNAT, es administrado exclusivamente por SIGNATURE por lo tanto, ni Protheus ni TSS necesitan dicho archivo para la ejecución del proceso de Transmisión de documentos electrónicos.

Procedimiento de Emisión de Factura Electrónica.

1. En el módulo Comprar (SIGACOM), en el menú Actualizaciones, dentro del grupo  Movimientos, y a través de alguna de las rutinas Factura de Entrada, generar registros de facturas para proveedores.
2. En el módulo FINANCIERO, en el Menu Actualizaciones, dentro del grupo Cuentas por Pagar, y a través de la rutina Orden de Pago (FINA085A) generar el pago correspondiente a las facturas de entrada se generarán los registros de comprobantes de Retención.
3. Ingresar a la opción Transmisión Electrónica, en la ruta del menú “SIGACOM | Actualizaciones | Movimientos| Transmisión Electrónica” .
4. La rutina muestra el browse con los documentos Comprobantes de Retención.
5. La primera vez que se accede a la rutina, es necesario realizar la configuración de conexión con TSS. Para ello, seleccione la opción de Configuración del menú de la rutina. Registre la URL donde están ubicados los WS de TSS, URL de conexión a los Web Services de SIGNATURE, área y la contraseña de conexión ambos datos proporcionados por SIGNATURE. Seleccione la opción “Avanzar”,  y espere el mensaje que puede ser exitoso o de falla. Este paso solo es necesario la primera vez o en caso de que algunos de los datos informados cambie.
6. Dentro de la misma rutina, se debe configurar el ambiente con el cuál TSS estará transmitiendo los documentos. Del menú de la rutina Transmisión Electrónica, seleccione la opción Ambiente.  Podrá seleccionar entre 1-Produccion 2-Homologación, este último es para hacer la transmisión de los documento a un ambiente de pruebas de SIGNATURE. Una vez seleccionado el ambiente recibirá confirmación de la selección en pantalla.
7. Si los pasos anteriores, dieron como resultado un mensaje de éxito, entonces puede comenzar a transmitir documentos a TSS. Para ello, del menú de la rutina Transmisión Electrónica, seleccione la opción Transmitir.  En el diálogo, se indica el propósito de la opción así como el botón de parámetros.  Seleccione botón de Parámetros, registre la serie y el número inicial y final de los comprobantes que serán transmitidos. De clic Ok, para confirmar los datos. Después clic Ok, para iniciar el proceso de transmisión, si no existe problema con los XML generados, enviara un mensaje de éxito, indicando que los documentos fueron encolados entre los documentos a transmitir por TSS a SIGNATURE a través del Job.
8. Para observar si los documentos fueron autorizados por la SUNAT, seleccione del menú la opción Monitor. Configure los parámetros de visualización. Registre la serie y el numero inicial y final de los Comprobantes de Retención que quiere monitorear, de clic en Ok. Podrá visualizar los documentos con los posibles estatus :
   
   
   • Azul – Recibido (Esta en TSS, pendiente de ingresar al proceso de timbrado)
   • Amarillo  – Esperando ser procesada (En proceso de timbrado). 
   • Rojo – Documento rechazado. 
   • Verde – Documento autorizado
9. En este monitor visualiza la fecha y hora de autorización del documento por la SUNAT. En caso de documentos rechazados, se muestran las observaciones realizadas por la SUNAT y la recomendación correspondiente.
10. Dentro de la funcionalidad del monitor, se encuentra la visualización del XML autorizado por la SUNAT. Para visualizar XML autorizado, dé clic en el botón Schema ubicado en la parte inferior de la opción Monitor. El XML será desplegado siempre y cuando el documento seleccionado haya sido aprobado por la SUNAT, de lo contrario se indica al usuario que la visualización no está disponible. Al salir de la opción monitor con el botón OK, se detona la actualización de todos los documentos con la información obtenida de TSS hacia Protheus. 

Punto de Entrada

Ejemplo:

#Include 'Protheus.ch'
User Function M485CRPER()

Local cXML := ""
Local cCRLF := (chr(13)+chr(10) )

Local cFilDoc := PARAMIXB[1] // Filial NF
Local cNumDoc := PARAMIXB[2] // Número de Documento
Local cSerieDoc := PARAMIXB[3] // Serie del Documento
Local cEspDoc := PARAMIXB[4] // Especie
Local cCodCli := PARAMIXB[5] // Código de Cliente
Local cCodLoj := PARAMIXB[6] // código de tienda
Local cNroCert := PARAMIXB[7] // Nro Comprobante Ret
Local cSerComp := PARAMIXB[8] // Serie Compro de Ret a 4 Digitos

cXML += '<Personalizados>' + cCRLF
cXML += ' <campoString name="CampoTexto">Esto es un texto</campoString>' + cCRLF
cXML += ' <campoNumero name="CampoNumerico">1</campoNumero>' + cCRLF
cXML += ' <campoFecha name="CampoFecha">2016-01-31</campoFecha>' + cCRLF
cXML += '</Personalizados>' + cCRLF

Return cXML