Histórico da Página

Información General

   Leyenda: 1 – Innovación 2 – Mantenimiento

Objetivo

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

• Factura de Venta
• Boleta de Venta
• Nota de Crédito al Cliente
• Nota de Débito al Cliente
• Guia de Remisión

Hacia TSS en formato xml bajo el estándar UBL  que  solicita la SUNAT. Además deberá permitir envíar el Resumen Diario, Comunicaciones de Baja, así como generar la representación impresa de los documentos Factura. Boleta, nota de crédito y Débito

Definición de la Regla de Negocio

Al ingresar a la rutina, deberá permitir elegir el tipo de documento o modelo (Prototipo 1) con el que se estará trabajando así como la serie a manejar.  Estos son:

• Factura de Venta
• Nota de Crédito
• Nota de Débito
• Boleta de Venta
• Guía de Remisión

Visualizará el browse del rutina (Prototipo 2). Dentro de las opciones de la rutina, se encontrarán:

• 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_INSC
   • 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.
8. Si existió algún problema, indicar con mensaje al usuario.

 <En la tabla abajo, informe las rutinas involucradas, el tipo de operación, la opción de menú y, si necesario, una breve descripción de las regras de negocio relacionadas a la rutina>

Opción Transmitir.

Esta opción tiene como objetivo realizar el proceso de transmisión de un documento hacia TSS. Esta opción deberá permitir ser llamada desde cualquier otra rutina.

Al detonar esta opción, se mostrará el grupo de preguntas correspondiente según el tipo de documento a enviar. Para Factura de Venta mostrar grupo de preguntar MATA486A(Prototipo 5), para Nota de Crédito mostrar gropo de preguntas MATA486B, para notas de Crédito mostrar grupo de preguntas MATA486C, Para Boleta de Venta mostrar grupo de preguntas MATA486D y para guías de Remisión mostrar grupo de preguntas MATA486E. En todos los grupos de pregunta, se deberá indicar Serie del documento y rango 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 6).  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: “No se pudo realizar conexión con TSS. Asegúrese que TSS está online.” (Prototipo 7). 
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_NOME

4. Seleccionar aquellos documentos que se encuentren dentro del rango y serie indicada en parámetros y que no hayan sido autorizados previamente (Status <> ‘6’) y que no hayan sido inhabilitados (Status <>’7’) y que la fecha de emisión se encuentre en un rango de hasta 7 días anteriores a la fecha de transmisión. Por cada registro Validar:
   
   • Datos del cliente: Deberá revisar que el registro del cliente a quien se emitió el documento, tenga información en los siguientes campos:
     

     RUC (A1_CGC)

     Nombre(A1_NOME)

     Domicilio fiscal (A1_END, A1_EST,A1_BAIRRO, A1_MUN, A1_PAIS, A1_CEP)

     Tipo de documento de Indentificación(A1_TIPDOC)

     Email (A1_EMAIL)

      

     Para el caso del tipo de Identificación (A1_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 (A1_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  Cliente      Tienda       Detalle

     0000000001             A      000001 01     Información faltante registro cliente RUC (A1_CGC)

     0000000001             A      000001 01     Información faltante registro cliente País(A1_PAIS)

   • Validar la TES del documento.

     Por cada impuesto contenido en la TES deberá validar que el impuesto tenga configurados los campos Código de Impuesto (FB_CODIMP) y Tipo de Afectación del IGV(FC_TIPOIGV) o del ISC(FC_TIPOISC) y que además el contenido de estos campos exista en la tabla XR en SX5 para IGV o tabla XR del ISC según corresponda. Si no tiene configurados los campos, deberá agregar un registro al log de transmisión como a continuación:

      

     Documento        Serie  Cliente      Tienda Detalle

     0000000001        A        000001       01        Debe configurar Código de Afectación(FC_TIPOIGV) para impuesto IGV. TES 501

     0000000001        A        000001       01        Debe configurar Código de Impuesto(FB_TIPOIGV) para IGV.  TES 501

      

     Continuar con las validaciones.

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

     Ejemplo:

     Documento        Serie  Cliente      Tienda Detalle

     0000000001        A        000001       01        Configure Serie 2 (FP_SERIE2) 

    

5. 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. Véase sección Generación de XML.
     

     USERTOKEN: “TOTVS”

     IDENT: id de Entidad obtenido en los pasos anteriores.

     Modelo: Enviar según el tipo de Documento

                            S1- Factura Venta

                            S4 – Nota Crédito

                            S5 – Nota Débito

                            S6 – Guia Remision

                            S7- Comprobante Retención

                            SD - Boleta de Venta

      XML: Deberá enviarse XML Generado codificado en base 64.

      Si el retorno del Web Method es positivo agregar registro en el log de transmisión:

      Documento        Serie  Cliente      Tienda Detalle

     0000000001             A      000001 01     Transmisión Éxitosa a TSS.

   • Deberá Transmitir el XML a TSS consumiendo el Web Method SendDoc de la siguiente manera:
     

     USERTOKEN: “TOTVS”

     IDENT: id de Entidad obtenido en los pasos anteriores.

     Modelo: Enviar según el tipo de Documento

                            S1- Factura Venta

                            S4 – Nota Crédito

                            S5 – Nota Débito

                            S6 – Guia Remision

                            S7- Comprobante Retención

                            SD - Boleta de Venta

     XML: Deberá enviarse XML Generado codificado en base 64.

     Si el retorno del Web Method es positivo agregar registro en el log de transmisión:

     Documento           Serie  Cliente      Tienda  Detalle

     0000000001             A      000001       01         Transmisión Éxitosa a TSS.

      

     Continuar con el siguiente registro.

   • Si no, agregar registro en el log de transmisión con el mensaje retornado por el Web Method. Ejemplo:
     

     Documento              Serie  Cliente      Tienda Detalle

     0000000001             A        000001     01        El documento no cumple con Esquema Establecido. Rechazado TSS.

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.
7.  Al finalizar de Procesar y transmitir todos los registros:
8. Preguntar al usuario si desea monitorear los documentos Transmitidos a TSS (Prototipo 10). 
9. Indicar mediante mensaje al usuario la finalización del proceso. Ejemplo: “Transmisión a TSS Finalizada.” (Prototipo 11).
   
   

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*/

(Opcional)

Grupo de Preguntas

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

Nombre: FINSRF2

(Opcional)

Consulta Estándar

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

Consulta: AMB

(Opcional)

Estructura de Menú

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

Procedimientos

Programas

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