tps://tdn.totvs.com/x/ub8fIgUBL SIGNATURE

Emisión de Factura Electrónica con Integración a Signature - Perú.

Características del Requisito.

Descripción 

Permitir el envío y recepción de los documentos fiscales tales como : Factura Electrónica, Boleta de Venta, Nota de Crédito y Débito , Comprobantes de Retención y Documentos de Exportación (Factura, Nota de Crédito y Débito) entre Protheus y TSS.

Importante

Antes de ejecutar el compatibilizador, MODDDMI es imprescindible:

• Realizar la copia de seguridad de la base de datos del producto que ejecutará el compatibilizador (directorio SYSTEM ).
• 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 SmartClient (solo para version 12), digite el MODDDMI en el campo Programa Inicial. Se exhibirá una pantalla en la cual se deberá elegir el módulo SIGAFAT- Facturación. Una vez seleccionado dar clic en OK. Importante: Para que se actualice correctamente el diccionario de datos, asegúrese de que la fecha del compatibilizador sea igual o superior al 20/10/2017.
2. Haga clic en OK para continuar.
3. Después de la confirmación es presentada una ventana para la selección de la empresa en que el diccionario de datos será modificado o es presentada una pantalla para la selección de la actualización a aplicar. Seleccione la opción “Configuración NF, NCC, NCA Electrónica”.
4. Al confirmar, se muestra un mensaje de advertencia sobre la copia de seguridad y la necesidad de su ejecución de modo exclusivo.
   1. Haga clic en Procesar para iniciar el procesamiento. El primer paso de la ejecución es la preparación de los archivos. 
   2. Se muestra un mensaje explicativo en la pantalla.
   3. 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 los campos actualizados por el programa. El compatibilizador crea los campos que aún no existen en el diccionario de datos.
   4. Haga clic en Grabar para guardar el historial (log) mostrado.
   5. Haga clic en OK para finalizar el procesamiento.

Como premisa, es necesario contar con la correcta instalación de TSS versión 2.61 para versión 11.8 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.
   

   - 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 requisito. El patch contiene la actualización de los siguientes fuentes:

• • UPDMODMI - Actualización del diccionario de datos (Facturación)
  • UPDNFPE – Actualización diccionario de datos para Perú.
  • MATA485 – Transmisión electrónica
  • LOCXNF – Documentos Fiscales
  • LOCXNF2 - Cálculo de Valores para Nota Fiscal
  • FINA085A - Orden de Pago
  • MATA468N - Generacion de Notas fiscales
  • MATA992 - Control de Formularios
  • NFAXMLPER - XML de Documentos Fiscales para Transmisión Electrónica Perú.
  • CRXMLPER - XML Comprobantes de Retención
  • NFECFGLOC - Cliente de Web Service NFECFGLOC
  • TSSWSSIGNATURE - cliente de Web Services TSSWSSIGNATURE

2. Ejecute MODDDMI.

3. Revise la configuración de parámetros creados por el Actualizador.

4. Configure rutina en el menú correspondiente.

5. El compatibilizador creará en Tablas Genéricas (SX5) las siguientes Tablas:

• • • XN – 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 XN: Tipos de Documento de Identidad SUNAT.

• • • XO – Tipos DE Nota de Crédito.
      
      Esta tabla obedece a los códigos expresados en el catálogo 09  Códigos de Tipos de Nota de Crédito Electrónica aceptados por la SUNAT:

• • • XQ – 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:

• • • XP - Tipos de Nota de Débito.

Esta tabla obedece a los códigos  expresados en el catálogo 10 Códigos de Tipos de Nota de Débito Electrónica aceptados por la SUNAT:

• • • XR – Tipos Afectación del IGV (Catálogo No. 07)

• • XT – Tipos de Sistema de cálculo del ISC (Catálogo No. 08)

 6. Configure impuestos Variables.

La SUNAT disponibiliza en el catálogo 05 Códigos  de tipos de Tributos para los Impuestos, como se muestra a continuación:

Estos códigos deberán configurarse en Impuestos variables, según el impuesto informe en el campo FB_CODIMP, además deberá informar el campo FB_CLASSE cómo ‘I’. La SUNAT exige también el uso de los Códigos de Afectación de IGV e ISC, definidos en los catálogos 07 y 08 respectivamente:

Este código deberá ser informado en el campo FB_CODTAR, de no informarse, generará inconsistencias en el xml y será rechazado por la SUNAT.

7. Configure Control de formularios. Deberá informar la serie 2(FP_SERIE2) para cada serie registrada según el tipo de documento. Ejemplo:

8. Genere facturas mediante la rutina Generación de Notas Fiscales(MATA468N) o bien, de manera manual por la Rutina Factura de Venta (MATA467N). Este ajuste implica, que al introducir la serie, se llena el campo F1_SERIE2/F2_SERIE2  a partir de lo registrado en SFP Control de formularios, para el campo FP_SERIE2 según la especie del documento a generar. 

9. Ejecute procedimiento de Transmisión de Documentos Electrónicos.

Actualizaciones del Compatibilizador 

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

GRUPO: MATA485

GRUPO: MATA485A

GRUPO: MATA485B

GRUPO: MATA485C

GRUPO: MATA485D

2.  Creación de Campos en el archivo SX3 – Campos:

• Tabla SF1 - Encabezado de NF de Entrada:

• Tabla SF2 - Encabezado de NF de Salida:

• Tabla SFB - Impuestos Variables

• SFP -Control de formularios

3.  Modificación de Campos en el archivo SX3 – Campos:

Tabla SF1 - Encabezado de NF de Entrada:

Tabla SF2 - Encabezado de NF de Salida:

Importante:

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

4.  Creación de Parámetros en el archivo SX6 – Parámetros:

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:
   
   

CONFIGURACIÓN DE MENÚS

2.  En el Configurador (SIGACFG), acceda a Entornos/Archivo/Menú (CFGX013). Informe la nueva opción de menú del informe el nombre del módulo, 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_CRSERIE, MV_TESEXE. El primero contendrá serie a 4 dígitos para comprobantes de Retención que se enviará a la SUNAT, el segundo contendrá las TES utilizadas para documentos gratuitos. 

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\xml\'. Esta carpeta contendrá los archivos de aquellos documentos que son enviados por SIGNATURE a la SUNAT.
3. Si el cliente maneja documentos de exportación, el cliente deberá estar identificado como Extranjero (A1_EST='EX') y la TES utilizada no deberá estar ligada a ningún impuesto.
4. Si la TES utilizada en los items de la factura no tiene asignado impuestos y el cliente no está identificado como Extranjero, el documento será procesado como factura gratuita.
5. 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.
6. 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 Facturación (SIGAFAT), en el menú Actualizaciones, dentro del grupo  Facturación, y a través de alguna de las rutinas siguientes:
   
   
   • Facturación (MATA467N); registre varias facturas de ventas y/o boletas de venta.
   • Facturación automática (MATA468N); facturas algunos pedidos.
   • Notas de Crédito (MATA465N); capture algunas notas de Crédito/Débito.
     
     
   Podrán generarse los registros correspondientes a cada documento. Deberá asegurarse que el campo SERIE 2(FP_SERIE2) en la tabla Control de Formularios tenga contenido, pues esta es la serie que el SUNAT tomará como oficial. 
   Información General: Las series admitidas por la SUNAT están conformadas por 4 dígitos comenzando con la letra "F" para Facturas y para aquellos documentos relacionados a la misma (Nota de Crédito y Débito). Es decir, si se emite una Nota de Crédito al Cliente para anular una factura, la serie de la nota(FP_SERIE2) debe comenzar con la letra F, de lo contrario recibirá rechazo por parte de la SUNAT. Para Boletas de Venta, deberá indicar la serie(FP_SERIE2)  iniciando con la letra "B", para documentos relacionados con la boleta de venta, la serie de los mismos deberá iniciar con la letra "B", de lo contrario recibirá rechazo por parte de la SUNAT. El dato informado en el campo FP_SERIE2, será heredado a los campos F1_SERIE2/F2_SERIE2 según corresponda.
2. Ingresar a la opción Transmisión Electrónica, en la ruta del menú “SIGAFAT | Actualizaciones | Facturación | Transmisión Electrónica” .
3. En los parámetros de inicio, indique el tipo de documento a revisar (Factura, Nota de Crédito, Nota de Débito o Boleta de Venta), informe además la serie de los documentos a visualizar.
4. La rutina muestra el browse con los documentos acorde a los parámetros.
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-Producción 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 documento 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 documento que quiere monitorear, de clic en Ok. Podrá visualizar los documentos con los posibles status:
   
   • 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 M485NCC()

Local cXML := ""

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

Local cFilDoc       := PARAMIXB[1] // Filial

Local cNumDoc       := PARAMIXB[2] // Número de Documento

Local cSerieDoc:= PARAMIXB[3] // Serie

Local cEspDoc       := PARAMIXB[4] // Especie

Local cCodCli       := PARAMIXB[5] // Código de Cliente

Local cCodLoj       := PARAMIXB[6] // código de tienda

cXML += '<Personalizados>' + cCRLF

cXML += '    <campoNumero name="CampoNumerico">1</campoNumero>' + cCRLF

cXML += '    <campoString name="CampoTexto">Esto es un texto</campoString>' + cCRLF

cXML += '    <campoFecha name="CampoTexto">2016-01-31</campoFecha>' + cCRLF

cXML += '</Personalizados>' + cCRLF

Return cXML

Ejemplo:

#Include 'Protheus.ch'

User Function M485NDC()

Local cXML := ""

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

Local cFilDoc       := PARAMIXB[1] // Filial

Local cNumDoc       := PARAMIXB[2] // Número de Documento

Local cSerieDoc:= PARAMIXB[3] // Serie

Local cEspDoc       := PARAMIXB[4] // Especie

Local cCodCli       := PARAMIXB[5] // Código de Cliente

Local cCodLoj       := PARAMIXB[6] // código de tienda      

cXML += '<Personalizados>' + cCRLF

cXML += '    <campoNumero name="CampoNumerico">1</campoNumero>' + cCRLF

cXML += '    <campoString name="CampoTexto">Esto es un texto</campoString>' + cCRLF

cXML += '    <campoFecha name="CampoTexto">2016-01-31</campoFecha>' + cCRLF

cXML += '</Personalizados>' + cCRLF

Return cXML

Ejemplo:

#Include 'Protheus.ch'

User Function M485NF()

Local cXML := ""

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

Local cFilDoc       := PARAMIXB[1] // Filial

Local cNumDoc       := PARAMIXB[2] // Número de Documento

Local cSerieDoc:= PARAMIXB[3] // Serie

Local cEspDoc       := PARAMIXB[4] // Especie

Local cCodCli       := PARAMIXB[5] // Código de Cliente

Local cCodLoj       := PARAMIXB[6] // código de tienda        

cXML += '<Personalizados>' + cCRLF

cXML += '    <campoNumero name="CampoNumerico">1</campoNumero>' + cCRLF

cXML += '    <campoString name="CampoTexto">Esto es un texto</campoString>' + cCRLF

cXML += '    <campoFecha name="CampoTexto">2016-01-31</campoFecha>' + cCRLF

cXML += '</Personalizados>' + cCRLF

Return cXML

Ejemplo:

#Include 'Protheus.ch'

User Function M485NFE()

Local cXML := ""

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

Local cFilDoc       := PARAMIXB[1] // Filial

Local cNumDoc       := PARAMIXB[2] // Número de Documento

Local cSerieDoc:= PARAMIXB[3] // Serie

Local cEspDoc       := PARAMIXB[4] // Especie

Local cCodCli       := PARAMIXB[5] // Código de Cliente

Local cCodLoj       := PARAMIXB[6] // código de tienda          

cXML += '<Personalizados>' + cCRLF

cXML += '    <campoNumero name="CampoNumerico">1</campoNumero>' + cCRLF

cXML += '    <campoString name="CampoTexto">Esto es un texto</campoString>' + cCRLF

cXML += '    <campoFecha name="CampoTexto">2016-01-31</campoFecha>' + cCRLF

cXML += '</Personalizados>' + cCRLF

Return cXML

aU