Transmisión de Documentos Tributarios Electrónicos a la SII a través de TSS y Signature.

Características del Requisito

Descripción 

Permitir el envío y recepción de los Documentos fiscales tales como : Factura Electrónica, Factura Exenta, Nota de Crédito y Débito, Guías de despacho y documentos de Exportación (Factura, Nota de crédito y Débito) entre Protheus y TSS.

Importante

(Solo para Microsiga Protheus, versiones anteriores a la 12)

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 el UPDMODMI 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 28/03/2016.
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 espresentada una pantalla para la selección de la actualización a aplicar. Seleccione la opción “Configuración NF, NCC, NCA Electrónico Chile”.
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. 1. Haga clic en Procesar para iniciar el procesamiento. El primer paso de la ejecución es la preparación de los archivos. 

1. 1. Se muestra un mensaje explicativo en la pantalla.
   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 los campos actualizados por el programa. El compatibilizador crea los campos que aún no existen en el diccionario de datos.
   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.61 o superior:

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. Importante: Si la versión de TSS mencionada en este documento no está disponible para su descarga, deberá solicitar con Help Desk el patch correspondiente con las rutinas de TSS mencionadas en la sección Características del Requisito.

   - 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

   [WFSIGNATURECHI]

   main= TSSSignatureCHI

   environment=sped

   
   

   ;start de job

   [onstart]

   jobs=WFSIGNATURECHI

   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)
  • UPDFATMI - Actualización del diccionario de datos (Facturación)
  • UPDNFCHI – Actualización diccionario de datos para Chile.
  • MATA485 – Transmisión electrónica
  • LOCXNF – Documentos Fiscales
  • LOCXNF2 - Cálculo de Valores para Nota Fiscal
  • NFAXMLCHI - XML de Documentos Fiscales para Transmisión Electrónica Chile.
  • NFECFGLOC - Cliente de Web Service NFECFGLOC
  • TSSWSSIGNATURE - cliente de Web Services TSSWSSIGNATURE

1. Ejecute UPDMODMI.
2. Revise la configuración de parámetros creados por el Actualizador.
3. Configure rutina en el menú correspondiente.
4. 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ónde Campos en el archivo SX3 – Campos:

• Tabla SF1 - Encabezado de NF de Entrada:

• Tabla SF2 - Encabezado de NF de Salida:

• Tabla SFB - Impuestos Variables

• Tabla SC5 - Pedidos de Venta

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:
   

   
   

NOTA: MV_SIGNUSR  y  MV_SIGNPAS son proporcionados al cliente por  SIGNATURE, son únicos y confidenciales. 

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_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 autorizados por la SII, tanto el xml enviado como el xml autorizado, así mismo el PDF para impresión.
   
   
3. Si el cliente emite facturas Excentas, debe configurarse el contenido del parámetro MV_TESEXE.  De lo contrario, estas serán identificadas como facturas normales y recibirá rechazo del documento por parte de la SII.
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. Cancelación de Documentos Electrónicos: SIGNATURE no cuenta con un Web Service para realizar este procedimiento, este proceso debe realizarse de manera manual en el portal de la SII.
6. El certificado Digital emitido por la SII, 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 Autorización de Documento Electrónico

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.
  • Facturación automática (MATA468N); facture algunos pedidos o guías de despacho.
  • Notas de crédito (MATA465N); capture algunas notas de crédito/débito.
    
    

Podrán generarse los registros correspondientes a cada documento.

1. Ingresar a la opción Transmisión Electrónica, en la ruta del menú “SIGAFAT | Actualizaciones | Facturación | Transmisión Electrónica” .
2. En los parámetros de inicio, indique el tipo de documento a revisar (Factura, Nota de Crédito, Nota de Débito o Guía de Despacho), informe además la serie de los documentos a visualizar.
3. La rutina muestra el browse con los documentos acorde a los parámetros.
4. 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.
5. 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.
6. 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.
7. Para observar si los documentos fueron autorizados por la SII, 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

En este monitor visualiza la fecha y hora de autorización del documento por la SII. En caso de documentos rechazados, se muestran las observaciones realizadas por la SII y la recomendación correspondiente.

8. Dentro de la funcionalidad del monitor, se encuentra la visualización del XML autorizado por la SII. 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 SII, de lo contrario se indica al usuario que la visualización no está disponible.

9. 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. Para el caso de los documentos autorizados, en la carpeta configurada en el parámetro MV_CFDDOCS  se genera el XML autorizado y el PDF de representación impresa de cada documento.

Punto de Entrada

Ejemplo:

#Include 'Protheus.ch'

User Function M485DOCEXP()

Local lRet          :=.F.

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

If alltrim(cSerieDoc)$"B*E*W*Y"

       lRet:=.T.               

EndIf      

Return lRet

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 M485REFNF()

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

Local cAlias :=getNextAlias()

Local cQuery:=""

Local cGuiaD:=""

Local cPV   :=""

Local cPC   :=""

Local nJ            :=0

Local aArea:=getArea()

Local aRef   :={}

Local aGuiaD:={}

Local aPV   :={}

Local aPC   :={}

Local nK            :=0

cQuery:=" SELECT D2_DOC,D2_SERIE,D2_PEDIDO,D2_ÍTEMPV,C6_NUMPCOM,C6_ÍTEMPC "

cQuery+=" FROM "+RetSqlName("SD2")+" SD2, "+RetSqlName("SC6")+" SC6 "

cQuery+=" WHERE SD2.D2_FILIAL='"+xFilial("SD2")+"' AND SD2.D_E_L_E_T_='' "

cquery+=" AND SD2.D2_DOC IN "

cQuery+=" (SELECT D2_REMITO "

cQuery+="   FROM "+RetSqlName("SD2")

cQuery+="   WHERE D2_FILIAL='"+xFilial("SD2")+"' AND D_E_L_E_T_='' "

cquery+="   AND D2_DOC='"+cNumDoc+"' AND D2_SERIE='"+cSerieDoc+"' AND D2_REMITO<>'' GROUP BY D2_REMITO) "

cQuery+=" AND SD2.D2_SERIE='R' AND SC6.C6_FILIAL='"+xFilial("SC6")+"' "

cQuery+= " AND SC6.D_E_L_E_T_='' AND SC6.C6_NUM = SD2.D2_PEDIDO AND SC6.C6_ÍTEM=SD2.D2_ÍTEMPV "

cQuery:=ChangeQuery(cQuery)

DbUseArea(.T.,"TOPCONN",TCGenQry(,,cQuery), cAlias,.T.,.F.)

(cAlias)->(dbgoTop())

If (cAlias)->(Eof())

       (cAlias)->(DbCloseArea())

       cQuery:=" SELECT D2_DOC,D2_SERIE,D2_PEDIDO,D2_ÍTEMPV,C6_NUMPCOM,C6_ÍTEMPC "

       cQuery+=" FROM "+RetSqlName("SD2")+" SD2, "+RetSqlName("SC6")+" SC6 "

       cQuery+=" WHERE SD2.D2_FILIAL='"+xFilial("SD2")+"' AND SD2.D_E_L_E_T_='' "

       cQuery+=" AND SD2.D2_DOC ='"+cNumDoc+"' AND SD2.D2_SERIE='"+cSerieDoc+"'"

       cQuery+=" AND SC6.C6_FILIAL='"+xFilial("SC6")+"' AND SC6.D_E_L_E_T_='' "

       cQuery+=" AND SC6.C6_NUM = SD2.D2_PEDIDO AND SC6.C6_ÍTEM=SD2.D2_ÍTEMPV"

       cQuery:=ChangeQuery(cQuery)

       DbUseArea(.T.,"TOPCONN",TCGenQry(,,cQuery), cAlias,.T.,.F.)

       (cAlias)->(dbgoTop())

EndIf

/* llenar aRef de la siguiente manera:

             1. Tipo documento REF             -> 52 Guia Despacho | 801 Orden de Compra

             2. Número de la referenica -> D2_DOC

             3. Fecha de Referencia            -> D2_EMISSAO con formato AAAA-MM-DDT00:00:00Z

             4. Código de Referencia    -> Dejar en blanco

             5. Razón de la Referencia  -> Dejar en blanco o colocar mensaje Genérico

*/

Do While (cAlias)->(!Eof())

       If aScan(aGuiaD,{|x|x[1]==(cAlias)->D2_DOC})==0

             aAdd(aGuiaD,{(cAlias)->D2_DOC})

             aAdd(aRef,{"52",;

                    (cAlias)->D2_DOC,;

                                        SUBSTR((cAlias)->D2_EMISSAO,0,4)+"-"+SUBSTR((cAlias)->D2_EMISSAO,5,2)+"-"+"T00:00:00Z",;

                                        "",;

                                        ""})

       EndIf

       If aScan(aPC,{|x|x[1]==(cAlias)->C6_NUMPCOM})==0.AND.!Empty((cAlias)->C6_NUMPCOM)

                    aAdd(aPC,{(cAlias)->C6_NUMPCOM})

                    aAdd(aRef,{"801",;

                                        (cAlias)->D2_DOC,;

                                        SUBSTR((cAlias)->D2_EMISSAO,0,4)+"-"+SUBSTR((cAlias)->D2_EMISSAO,5,2)+"-"+"T00:00:00Z",;

                                        "",;

                                        ""})

       EndIf

       (cAlias)->(DbSkip()

EndDo

cAlias)->(DbCloseArea())

For nK:=1 to len(aRef)

             cXML+='    <Referencia>'+cCRLF

             cXML+='           <NroLinRef>'+alltrim(STR(nK))+'</NroLinRef>'+cCRLF

             cXML+='           <TpoDocRef>'+aRef[nK,1]+'</TpoDocRef>'+cCRLF

             cXML+='           <NumeroRef>'+aRef[nK,2]+'</NumeroRef>'+cCRLF

             cXML+='           <FechaRef>'+aRef[nK,3]+'</FechaRef>'+cCRLF

             cXML+='           <RazonRef>'+aRef[nK,5]+'</RazonRef>'+cCRLF

             cXML+='    </Referencia>'+cCRLF                  

Next  

RestArea(aArea)

Return cXML