Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Este documento es un material de especificación de los requisitos de innovación. Se trata de un contenido sumamente técnico.      

                                                       

<Los ítems obligatorios de este template no se deben borrar. Los ítems opcionales, así como los textos explicativos del template, pueden borrarse>.

(Obligatorio)

Información General

 

Especificación

Producto

Microsiga Protheus

Módulo

SIGACOM

Segmento ejecutor

Servicios

Projeto1

Proyecto de Desarrollo_MEX

IRM/EPIC1

SERINN001-1143

Requisito/Story/Issue1

 

Subtarea1

SERINN001-1144

Chamado/Ticket2

 

País

(  ) Brasil  (  ) Argentina  (  ) México  (  ) Chile  (  ) Paraguay  (  ) Ecuador

(  ) EEUU  (  ) Colombia   ( X ) Otro PERU.

Otros

<Si necesario, informe otras referencias que sean pertinentes a esta especificación. Ejemplo: enlaces de otros documentos o subtareas vinculadas>.

   Leyenda: 1 – Innovación 2 – Mantenimiento (Los demás campos se deben completar en ambos los procesos). 

(Obligatorio)

Objetivo

 

Crear la función  M486CERXML para generar XML del resumen diario así como realizar el envío de este XML a TSS.

Modificar FINA085A para que guarde el contenido del parámetro MV_CRSERIE en el campo FE_SERIE2 al generarse el Comprobante de Retención.

 

Modificar MATA486 para tratamiento de monitoreo y transmisión de comprobante de retención.

(Obligatorio)

Definición de la Regla de Negocio

 

Modificar la rutina Documentos Electrónicos (MATA486) , que permita realizar la transferencia y monitoreo de  los documentos fiscales:

 

  • Certificados de Retención

 

Generar y enviar hacia TSS en formato xml bajo el estándar UBL  que  solicita la SUNAT.

Al ingresar a la rutina, deberá válidar que si es detonada desde el módulo de Libros Fiscales(SIGAFIS) o Compras(SIGACOM)  no preguntar tipo de documento, mostrar directamente los comprobantes de Retención. 

Visualizará el browse del rutina (Prototipo 1)  con los Comprobantes de Retención(SFE). Dentro de las opciones de la rutina, se encontrarán(Prototipo 2):

 

  • Configuración
  • Ambiente
  • Transmitir
  • Monitor
  • Imprimir PDF
  • Visualizar
  • Leyenda

 

Opción Configuración:

 

Esta opción Configuración (Prototipo 3) permitirá configurar la conexión de Protheus con TSS. Se abrirá un wizard (Prototipo 4) en dónde pedirán los siguientes datos:

 

  • Informe la URL del Servidor Totvs Services: Se deberá informar la url para conexión con los Web services de TSS. Campo tipo carácter de 100 caracteres, obligatorio.   Ejemplo: http://localhost:8081/ws
  • Informe ruta Certificado digital: Con la función cgetfile, deberá permitir buscar la ruta del certificado digital en formato pfx.
  • Informe Contraseña Certificado Digital: Contraseña del Certificado digital.  
  • Ambiente: Homologación/Producción en una lista desplegable.

Al dar clic en “Avanzar”,  deberá detonar la siguiente funcionalidad:

 

  1. Validar que los datos  de URL de TSS, Certificado y password no estén vacíos, de lo contrario deberá enviar mensaje al usuario indicando qué dato está vacío y no deberá permitir continuar con el proceso.
  2. Validar que los datos siguientes estén registrados en el sigamat (SM0):
    • SM0->M0_CIDCOB
    • SM0->M0_ESTENT
    • SM0->M0_ENDENT
    • SM0-> M0_CEPENT
    • SM0->CIDENT
    • SM0->M0_NOME
    • SM0->M0_FAX
    • SM0->M0_TEL
    • SM0->M0_INS
    • SM0->M0_NOMECOM
    • SM0->M0_CGC

    Si alguno de los datos está vació, deberá enviar mensaje al usuario y no continuar con el proceso.

  3. Si las validaciones anteriores están ok, deberá guardar en el parámetro MV_WSRTSS,  el url de los web services de TSS.
  4. Detonar Web Method ADMEMPLOC para crear entidad en TSS.
    • Usertoken : “TOTVS”
    • Empresa:
      • BAIRRO = SM0->M0_BAIRENT
      • CIDADE = SM0->M0_CIDCOB
      • COD_PAIS=604
      • CODFIL = FWGETCODFILIAL
      • CODPROVINC = SM0->M0_ESTENT
      • COMPL= FisGetEnd(SM0->M0_ENDENT)[4]
      • CP=vacio
      • CUIT = vacio
      • DDN= vacio
      • DESCPROVINC= SM0->CIDENT

    El idEnt que retorna el web Method, deberá ser utilizado en el siguiente paso.

     
  5. Detonar Web Method CFGLOCCERTPFX para enviar y guardar el certificado digital y el password en TSS.


    Usertoken : “TOTVS”
    ID_ENT: Id Ent obtenido en el paso anterior.
    Certificate: Archivo de certificado
    Password: Contraseña del Certificado.

  6. Detonará Web Method CFGAMBLOC para enviar la configuración de ambiente seleccionada por el usuario hacia TSS. Realizar el consumo de la siguiente manera:

    • USERTOKEN : "TOTVS"
    • ID_ENT    : Id Ent obtenido en el paso anterior
    • Ambiente  := Opción seleccionada por el usuario.
  7. Si todo es Ok, Indicar mensaje de éxito al usuario. Prototipo 5
  8. Si existió algún problema, indicar con mensaje al usuario.

Opción Transmitir.

 

Esta opción tiene como objetivo realizar el proceso de transmisión de un documento hacia TSS. Esta función deberá ser independiente y puede ser llamada desde un menú o dentro de otra función.  Al detonar esta opción, se mostrará el grupo de preguntas MATA485E para Comprobantes de Retención(Prototipo 6). Se deberá indicar rango de documentos a transmitir. Al dar clic en ok, deberá:

 

  1. Deberá validar que el parámetro MV_WSTSS no esté vacío, de lo contrario deberá enviar mensaje en pantalla al usuario indicando: “No se realizó la Configuración de conexión con TSS. Ejecute opción de configuración” (Prototipo 7).  Si el parámetro está ok, continuar al siguiente paso.
  2. Deberá validar que exista conexión con TSS. (Revisar funcionalidad de Argentina) Si la conexión es Ok, deberá seguir al paso siguiente, de lo contrario enviar mensaje al usuario indicando lo siguiente: “Imposible establecer conexión con Totvs Services Server. TSS offline.” (Prototipo 8)
  3. Validar que los siguientes campos del sigamat, tengan contenido:
    • SM0->M0_CIDCOB
    • SM0->M0_ESTENT
    • SM0->M0_ENDENT
    • SM0-> M0_CEPENT
    • SM0->CIDENT
    • SM0->M0_NOME
    • SM0->M0_FAX
    • SM0->M0_TEL
    • SM0->M0_INSC
    • SM0->M0_NOMECOM
    • SM0->M0_CGC 

      Si alguno se encuentra vacío, se deberá informar al usuario y no permitir seguir con el proceso. Ejemplo “Falta informar Código Postal del Emisor. Revise Datos de la Empresa:” + SM0->SM0_NOM

  4. Seleccionar aquellos comprobantes de retención que se encuentren dentro del rango indicado en parámetros y que no hayan sido autorizados previamente (FE_STATUS <> ‘6’) y que no hayan sido RECHAZADOS por la SUNAT (FE_STATUS<>’5’) y que la fecha de emisión(FE_EMISSAO) se encuentre en un rango de hasta 7 días anteriores a la fecha de transmisión. Por cada registro Validar:
    • Datos del PROVEEDOR: Deberá revisar que el registro del cliente a quien se emitió el documento, tenga información en los siguientes campos:
    • Deberá Validar  que tenga contenido el campo Serie 2, de lo contrario agregar registro en el  log de Transmisión.
  5. Si el documento cumple con las validaciones anteriores, se debe generar el XML en formato UBL indicado por la SUNAT.

  6. Si no cumplió las validaciones mencionadas en el paso 2, no debe generarse XML y validar el siguiente registro. Si cumple con las validaciones continuar al siguiente paso.


    • RUC (A2_CGC)

      Nombre(A2_NOME)

      Domicilio fiscal (A2_END, A2_EST,A2_BAIRRO, A2_MUN, A2_PAIS, A2_CEP)

      Tipo de documento de Indentificación(A2_TIPDOC)

      Email (A2_EMAIL)

       Para el caso del tipo de Identificación (A2_TIPDOC), deberá revisar que el código exista en la tabla XN- Tipos de Identificación. Así mismo, deberá validar que el Código de País (A2_PAIS) contenga su equivalente en el campo YA_CODERP y que además este código se encuentre contenido en la tabla XT – Códigos de Países. 

      Si alguno de los datos anteriores falta deberá agregar un registro al log de transmisión indicando el dato faltante para el documento. Ejemplo:

       

      Documento        Serie  Proveedor    Tienda       Detalle

      00000001         R001   000001        01     Información faltante registro cliente RUC(A2_CGC)

      00000001         R001   000001 01     Información faltante registro cliente País(A2_PAIS)

    • Deberá Validar  que tenga contenido el campo Serie 2, de lo contrario agregar registro en el  log de Transmisión.

      Ejemplo:

      Documento        Serie  Proveedor Tienda Detalle

      0000000001        R001  000001        01       Serie del Comprobante vacía(FE_SERIE2)



  7. Si el documento cumple con las validaciones anteriores, se debe generar el XML en formato UBL indicado por la SUNAT.

    • Generar XML dependiendo del tipo de documento Comprobante de Retención. Véase sección Generación de XML.
    • Deberá Transmitir el XML a TSS consumiendo el Web Method SendDoc de la siguiente manera:
    • Si no, agregar registro en el log de transmisión con el mensaje retornado por el Web Method. Ejemplo:
      Documento        Serie  Proveedor    Tienda Detalle

      00000001         R001   000001        01     El documento no cumple con Esquema

      Establecido. Rechazado TSS.

  8. Si no cumplió las validaciones mencionadas en el paso 2, no debe generarse XML y validar el siguiente registro. Si cumple con las validaciones continuar al siguiente paso.

  9. Al finalizar de Procesar y transmitir todos los registros:

    • Preguntar al usuario si desea visualizar log de Transmisión (Prototipo 9).
    • Si la respuesta es positiva mostrar diálogo de impresión (Prototipo 10)
    • Al dar clic en ok, mostrar informe en pantalla como  a continuación (Prototipo 11). Deberá mostrar en e lencabezado el tipo de documento a Transmitir.

      Tipo de documento Transmitido: Comprobante de Retención

       

      Documento        Serie  Proveedor    Tienda       Detalle

       

      00000001         R001   000001        01     Información faltante registro proveedor

      RUC (A1_CGC)

      00000001         R001   000001        01     Información faltante registro proveedor

      (A2_PAIS)

      00000003         R001   000001        01     El documento no cumple con Esquema

      Establecido. Rechazado TSS.

      00000002         R001   000001        01     Transmisión Éxitosa a TSS.

       

      Documentos procesados: 3

      Documentos con error : 2

      Documentos transmitidos:      1

    • Si la respuesta es negativa, continuar con el proceso.

     Al finalizar de Procesar y transmitir todos los registros:

  10. Preguntar al usuario si desea monitorear los comprobantes de Retención Transmitidos a TSS (Prototipo 12).
    Si la respuesta es positiva, mostrar Monitor (Prototipo 13).  Para mayor detalle véase opción Monitor
    Si la respuesta es negativa retornar al browse principal..

 

 

 

Rutina

Tipo de Operación

Opción de Menú

Reglas de Negocio

[ACAA040 – Parámetros]

[Modificación]

[Actualizaciones -> Académico-> Tesorería]

-

[ACAA050 – Negociación Financiera]

[Involucrada]

[Actualizaciones -> Académico-> Tesorería]

-

[ACAA060 – Archivo de Pedidos]

[Creación]

[Actualizaciones -> Académico-> Archivos]

-

 

Ejemplo de aplicación:

  • Crear el campo “% Mínimo Efectivo” (AAA_PERESP), en que el usuario informará el % que el alumno pagará en efectivo (dinero). Ese % podrá modificarse durante la negociación.
  • Crear el campo “Referencia Mínima para Cálculo” (AAA_REFCAL), en que el usuario informará uno de los 4 valores disponibles para pago de las mensualidades  como la referencia mínima para calcular el débito total del alumno.
  • Crear el parámetro MV_ACPARNE, que definirá si la información de “% Mínimo Efectivo” y “Referencia Mínima para Cálculo” será obligatoria.
  • El parámetro MV_ACPARNE debe tener las opciones: 1=Obligatorio y 2=Opcional. Se debe inicializar como opcional>.

 

Tablas Utilizadas

  • SE2 – Archivo de Cuentas por Pagar
  • FI9 – Control de Emisión de DARF>.

Opcional

Prototipo de Pantalla

 

<Si necesario, incluirprototipos de pantallas con el objetivo de facilitar la comprensión del requisito, presentar conceptos y funcionalidades del software>.

 

Prototipo 01

 

 

 

 

 

 

 

Opcional

Flujo del Proceso

 

<En esta etapa, incluir representaciones gráficas que describan el problema por solucionar y el sistema que se desarrollará. Ejemplo: Diagrama - Caso de Uso, Diagrama de Actividades, Diagrama de Clases, Diagrama de Entidad y Vínculo y Diagrama de Secuencia>. 

Opcional

Diccionario de Datos

 

Archivo o Código del Script: AAA – Negociación Financiera o /*Versao=CP.2014.12_03*/

 

Índice

Clave

01

<FI9_FILIAL+FI9_IDDARF+FI9_STATUS>

02

<FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_EMISS+FI9_IDDARF>

03

<FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_PREFIX+FI9_NUM+FI9_PARCEL+FI9_TIPO>

Campo

<AAA_PERESP>

Tipo

<N>

Tamaño

<6>

Valor Inicial

<Varia de acuerdo con el tipo informado. Por ejemplo, cuando el campo “tipo” es date, en este campo se puede informar una fecha>. 

Obligatorio

Sí (  ) No (  )

Descripción

<Referencia mínima para cálculo>

Título

<Ref.Calc.>

Picture

<@E999.99>

Help de Campo

<Informar el % que el alumno pagará en efectivo (dinero). Ese % podrá modificarse durante la negociación>


(Opcional)

Grupo de Preguntas

 

<Información utilizada en la línea Protheus>.

 

Nombre: FINSRF2

X1_ORDEM

01

X1_PERGUNT

Emisión De

X1_TIPO

D

X1_TAMANHO

8

X1_GSC

G

X1_VAR01

MV_PAR01

X1_DEF01

Común

X1_CNT01

'01/01/08'

X1_HELP

Fecha inicial del intervalo de emisiones de los formularios de DARF que se considerarán en la selección de los datos para el informe.

(Opcional)

Consulta Estándar

<Información utilizada en la línea Protheus>

 

Consulta: AMB

Descripción

Configuraciones de planificación.

Tipo

Consulta estándar.

Tabla

“AMB”

Índice

“Código”

Campo

“Código”; ”Descripción”

Respuesta

AMB->AMB_CODIGO

(Opcional)

Estructura de Menú

 

<Información utilizada en la línea Datasul>.

 

Procedimientos

 

Procedimiento

 

 

 

Descripción

(Max 40 posiciones)

(Max 40 posiciones)

(Max 40 posiciones)

Módulo

 

 

 

Programa base

 

 

 

Nombre Menú

(Max 32 posições)

(Max 32 posições)

(Max 32 posições)

Interfaz

GUI/WEB/ChUI/Flex

GUI/WEB/ChUI/Flex

GUI/WEB/ChUI/Flex

Registro estándar

Visualiza Menú

Sí/No

Sí/No

Sí/No

Release de Liberación

 

 

 

 

 

 

Programas

 

Programa

 

 

 

Descripción

(Max 40 posiciones)

(Max 40 posiciones)

(Max 40 posiciones)

Nombre Externo

 

 

 

Nombre Menú/Programa

(Max 32 posiciones)

(Max 32 posiciones)

(Max 32 posiciones)

Nombre Verbalizado[1]

(Max 254 posiciones)

(Max 254 posicionees)

(Max 254 posiciones)

Procedimiento

 

 

 

Template

(Verificar la lista de opciones en el man01211)

(Verificar la lista de opciones en el man01211)

(Verificar la lista de opciones en el man01211)

Tipo[2]

Consulta/Mantenimiento/ \Informe/Tareas

Consulta/Mantenimiento/ Informe/Tareas

Consulta/Mantenimiento/ Informe/Tareas

Interfaz

GUI/WEB/ChUI/Flex

GUI/WEB/ChUI/Flex

GUI/WEB/ChUI/Flex

Categoría[3]

 

 

 

Ejecuta vía RPC

Sí/No

Sí/No

Sí/No

Registro Estándar

Otro Producto

No

No

No

Visualiza Menú

Sí/No

Sí/No

Sí/No

Query on-line

Sí/No

Sí/No

Sí/No

Log Ejec.

Sí/No

Sí/No

Sí/No

Rutina (EMS)

 

 

 

Subrutina (EMS)

 

 

 

Ubicación dentro de la subrutina (EMS)

 

 

 

Compact[4]

Sí/No

Sí/No

Sí/No

Home[5]

Sí/No

Sí/No

Sí/No

Posición del Portlet[6]

0 – Top Left

1 – Top Right

2 – Bottom Left

3 – Bottom Right

0 – Top Left

1 – Top Right

2 – Bottom Left

3 – Bottom Right

0 – Top Left

1 – Top Right

2 – Bottom Left

3 – Bottom Right

Informar los papeles con los que el programa se debe vincular

 

 

 

 

Archivo de Papeles

<El archivo de papeles es obligatorio para los proyectos de desarrollo FLEX a partir del Datasul 10>.

<Recordatorio: el nombre de los papeles en inglés que se describe en este punto del documento se deben homologar por el equipo de traducción>.

 

Código Papel

(máx 3 posiciones)

Descripción en Portugués*

 

Descripción en Inglés*

 



[1] Es obligatorio el desarrollo del Nombre Verbalizado a partir del Datasul 10.

[2] Es obligatorio desarrollar el Tipo a partir del Datasul 10.

[3] Categorías son obligatorias para los programas FLEX.

[4] Obligatorio cuando el proyecto es FLEX.

[5] Obrigatorio cuando el proyecto es FLEX.

[6] Obligatorio cuando el proyecto es FLEX.

Este documento es un material de especificación de los requisitos de innovación. Se trata de un contenido sumamente técnico.