Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin
Este documento es un material de especificación de los requisitos de innovación. Se trata de un contenido sumamente técnico.      

                                                       

Información General

 

Especificación

Producto

Microsiga Protheus

Módulo

SIGAFAT

Segmento ejecutor

Servicios

Projeto1

Proyecto de Desarrollo_MEX

IRM/EPIC1

SERINN001-1143

Requisito/Story/Issue1

SERINN001-1144 /SIGAFAT

Subtarea1

SERINN001-1158

Chamado/Ticket2

 


País

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

(  ) EEUU  (  ) Colombia   ( X ) Perú.

Otros

Comprobante de Retención Electrónico Perú

XML Factura de Venta

XML Nota de Crédito

XML Nota de Débito

Anulación y Baja

   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
  • Guía de Remisión

 

Hacia TSS en formato xml bajo el estándar UBL 2.0. que solicita la SUNAT. Además deberá permitir enviar el Resumen Diario, Comunicaciones de Baja, así como generar la representación impresa de los documentos Factura/Boleta de venta, Nota de crédito y Nota de 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.

 

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


Opción Monitor

 

El objetivo de esta opción, es obtener el resultado de la transmisión de los documentos a TSS.  La funcionalidad podrá detonarse mediante selección en el menú (se considera que esta función no sea de tipo estática, para que pueda ser llamada desde cualquier otra rutina). Si la opción es llamada desde el menú del a rutina de documentos Electrónicos: 


  1. Deberá pedir el rango de documentos mostrando el grupo de preguntas MATA486A si es Factura (Prototipo 12), MATA486B si es nota de Débito, MATA486C si es nota de Crédito, MATA486D para Boletas de Venta y MATA486E para guías de Remisión. Si es llamada desde otro fuente, no debe mostrar el grupo de preguntas, pero si deberá recibir como parámetros el rango y serie de los documentos así como el tipo de documento a consultar.
  2. Al confirmar los parámetros, realizar consulta a SF1 si el documento es nota de crédito o a SF2 si los documentos consultados son Factura, Boleta, nota de Débito o guía de Remisión. Por cada registro, deberá realizar consulta al Web Method ConsultaDoc enviando los siguientes parámetros:

    USERTOKEN: "TOTVS"

    IDENT: Id de la Entidad

    IdDoc: Id del documento formado por serie + No. De documento

    Modelo: Enviar

    S1- Factura Venta

                           S4 – Nota Crédito

                           S5 – Nota Débito

                           S6 – Guia Remision

                           S7- Comprobante Retención

                           SD - Boleta de Venta

     


  3. Procesar el retorno del web Method y mostrar lisbox con las columnas Documento, Serie, Fecha Autorización, Hr de Autorización,  Mensaje y Recomendación (Prototipo 13) .  El retorno del Web Method será como a continuación:
    <body>
          < ConsultaDocResult>
                <idDoc>String</idDoc>
                <Status>boolean</Status>
                <Ambiente>boolean</Ambiente>
                <codigo>String</codigo>       
                <descripcion>String</descricao>
                 <recomendacion>String</recomendacion>     
                <FechaAut>Date</FechaAut>
                <HrAut>String</HrAut>
                <XML>Base64Binary</XML>   
          </ConsultaDocResult>                  
    </body>
     


    Status :

    Si el campo Satus  del retorno del web method corresponde con los siguientes códigos, deberá pintar según el color: 

    Si Status es 1 Recibido por TSS Color Azúl

    Si Status es 4 Aguardando procesamiento Color Amarillo

    Si Status es 5 Documento Rechazado Color Rojo

    Si Status es 6 Documento Autorizado Color Verde

     


    Documento: Mostar propiedad idDoc del retorno del Web Method.

    Ambiente: Si el retorno del campo Ambiente es 1 colocar "Producción", si es 2 colocar "Homologación".

    Fch. Aut. : Fecha de Autorización del Documento. Propiedad FechaAut

    Hr. Aut.: Hora de Autorización del documento. Propiedad HrAut

    Mensaje: Mensaje retornado. Propiedad Descripción.

    Recomendación: en esta columna será informado propiedad Recomendación. 


    Si el documento fue autorizado, deberá obtener de la propiedad XML el documento autorizado codificado en Base64 y decodificarlo. Guardarlo en la carpeta configurada en parámetro MV_CFDDOCS + "/autorizados/" +especie con nombre de archivo formado por Propiedad idDocumento + especie + extensión .xml 


  4. Tendrá 5 botones en la parte inferior.
    • Leyenda: Mostrará significado de status presentados:

Azul: Recibido TSS

Amarillo: Enviado SUNAT

Rojo: Rechazado SUNAT

Verde: Autorizado SUNAT

    • XML Envio: Al dar clic, mostrará el XML enviado a la SUNAT.
    • XML SUNAT: Al dar clic, mostrará XML Autorizado por SUNAT siempre y cuando el documento seleccionado haya sido autorizado. Tomar XML de la ruta MV_CFDDOCS + "/autorizados/" +especie con nombre de archivo formado por Propiedad idDocumento + especie + extensión xml.  Si el documento no ha sido autorizado, deberá enviar mensaje al usuario indicando "Opción Válida solo para documentos Autorizados."
    • Refresh: Permitirá realizar la consulta a TSS y actualizar en pantalla los datos.
    • Ok: Detonará la actualización de los datos obtenidos de TSS para Protheus. Llamará nuevamente el web Method ConsultaDoc, por cada registro mostrado en el monitor procesará el retorno y actualizará en Protheus:

F1_FLFTEXT/F2_FLFTEX := Propiedad Status

F1_FECAUT/F2_FECAUT := Propiedad FechaAut

    • Salir: Permitirá salir del monitor, sin afectar información en Protheus.  


Opción Imprimir

 


Esta opción permitirá generar la representación gráfica de un Documento Autorizado. La función deberá llamarse M486IMPDF y esta a su vez detonará la funcionalidad del fuente M486XMLPDF que a continuación se describe . Al seleccionar la opción del menú, deberá: 


  1. Desplegar cuadro de parámetros(M486PDF) para impresión  (Prototipo 14). 
  2. Permitir configurar el rango de documentos a imprimir y la serie de dichos documentos, además del formato de los documentos, el cuál podrá ser PDF o enviar directamente vía email.

    • Si el usuario elige PDF, deberá generar archivo PDF por cada documento siempre y cuando este haya sido aprobado por la SUNAT (F1_FLFTEXT/F2_FLFTEXT = '6'). El archivo PDF generado deberá nombrarse utilizando serie, número de documento y especie con extensión PDF.

      Ejemplo: "F0010000000009NF.PDF" (Prototipo 15)

      En el pdf, deberá generarse a partir del XML autorizado por la SUNAT como de describe en la siguiente tabla: 


      Sección

      Observaciones

      Contenido

      Ruta en XML

      1 – Datos del Emisor

       


      Nombre del Emisor

      <cac:AccountingSupplierParty> <cac:Party><cac:PartyName>

      Domicilio Fiscal

      <cac:PostalAddress>

      <cbc:ID>

      <cbc:StreetName>       

      <cbc:CityName>

       <cbc:District>

      <cac:Country>        

      2 – Datos del Documento

       


      RUC

      <cac:AccountingSupplierParty><cbc:CustomerAssignedAccountID>

      Tipo de Documento

      <cbc:InvoiceTypeCode>

      Serie y Correlativo

      <cbc:ID>

      3 – Datos del Receptor

       


      Cliente:

      <cac:AccountingCustomerParty>

      Dirección

      <cac:AccountingCustomerParty>

      <cac:Party>

            <cac:PostalAddress>       

              <cbc:StreetName>

              <cbc:CityName>

              <cbc:District>

              <cac:Country>

                <cbc:IdentificationCode>

      </cac:Country>

            </cac:PostalAddress>

      RUC

      <cac:AccountingCustomerParty>

          <cbc:CustomerAssignedAccountID>

      4 - Datos adicionales del documento

       


      Fecha de Emisión

      <cbc:IssueDate>

      Tipo de Moneda

      <cbc:DocumentCurrencyCode>

      5-Detalle del Documento.

      Deberá tener 1 línea por cada elemento <cac:InvoiceLine>

      Cantidad

      <cac:InvoiceLine><cbc:InvoicedQuantity >

      Unidad

      <cac:InvoiceLine><cbc:InvoicedQuantity > Propiedad UnitCode

      Código del producto

      <cac:InvoiceLine><cac:Item>

      Descripción

      <cac:InvoiceLine><cac:Item><cac:SellersItemIdentification>

      Precio Unitario

      <cac:InvoiceLine>

      <cac:Price>

            <cbc:PriceAmount currencyID="USD">

       


      Valor Unitario

      <cac:InvoiceLine>

      <cac:Price>

            <cbc:PriceAmount currencyID="USD">

      Total

      <cac:InvoiceLine>

      <cbc:LineExtensionAmount>

      6 - Totales

      Submonto 1001

      Operación Gravada

      <ext:UBLExtensions>

          <ext:UBLExtension>

            <ext:ExtensionContent>

              <sac:AdditionalInformation>

                <sac:AdditionalMonetaryTotal>            <cbc:PayableAmount>

      Submonto 1002

      Operación Inafecta

      <ext:UBLExtensions>

          <ext:UBLExtension>

            <ext:ExtensionContent>

              <sac:AdditionalInformation>

                <sac:AdditionalMonetaryTotal>            <cbc:PayableAmount>

      Submonto 1003

      Operación Exonerada

      <ext:UBLExtensions>

          <ext:UBLExtension>

            <ext:ExtensionContent>

              <sac:AdditionalInformation>

                <sac:AdditionalMonetaryTotal>            <cbc:PayableAmount>

      SubMonto 1004

      Operación Gratuita

      <ext:UBLExtensions>

          <ext:UBLExtension>

            <ext:ExtensionContent>

              <sac:AdditionalInformation>

                <sac:AdditionalMonetaryTotal>            <cbc:PayableAmount>

      Submonto 2001

      Percepciones

      <ext:UBLExtensions>

          <ext:UBLExtension>

            <ext:ExtensionContent>

              <sac:AdditionalInformation>

                <sac:AdditionalMonetaryTotal>            <cbc:PayableAmount>

      Submonto 2002

      Retenciones

      <ext:UBLExtensions>

          <ext:UBLExtension>

            <ext:ExtensionContent>

              <sac:AdditionalInformation>

                <sac:AdditionalMonetaryTotal>            <cbc:PayableAmount>

      Submonto 2003

      Detracciones

      <ext:UBLExtensions>

          <ext:UBLExtension>

            <ext:ExtensionContent>

              <sac:AdditionalInformation>

                <sac:AdditionalMonetaryTotal>            <cbc:PayableAmount>

       


      Importe de Descuento

      <ext:UBLExtensions>

          <ext:UBLExtension>

            <ext:ExtensionContent>

              <sac:AdditionalInformation>

                <sac:AdditionalMonetaryTotal>            <cbc:PayableAmount>

      Cuando el elemento <cac:TaxTotal>

      <cac:TaxSubtotal>

      <cac:TaxCategory>        <cac:TaxScheme>

                <cbc:ID>

      sea igual a 1000

      I.G.V

      <cac:TaxTotal>

          <cbc:TaxAmount>

       


      Importe Total

      <cac:LegalMonetaryTotal><cbc:PayableAmount>

      7- Pie de Documento

      Submonto 1000

      Total con Letra

      <ext:UBLExtensions>

          <ext:UBLExtension>

            <ext:ExtensionContent>

              <sac:AdditionalInformation>

      <sac:AdditionalProperty>

      <cbc:Value>

       


      Mesaje

       


      “Representación Impresa de Factura Electrónica”

       

       



      Código de Barras

      Deberá formarse según los siguientes lineamientos:

       


      Image Modified

       


      Image Modified

       


      Utilizar FWMSPrinter, ya que contiene la funcionalidad para generación de códigos de barra PDF417.

       


      Ejemplo :oPrinter:pdf417( nRow, nCol, cCodeBar, nSizeBar,nHeight )

       


      Para Notas de Débito (Prototipo 16) y Notas de Crédito (Prototipo 17), deberá considerar las facturas/boletas de venta a los que estos documentos hacen referencia. 


      Por cada documento referenciado, deberá generar una línea en el recuadro Referencias. 


      Sección

      Observaciones

      Contenido

      Ruta en XML

       8 – Referencias

      Por cada Documento referenciado, deberá generar una línea en el recuadro Referencias

      Tipo de documento

      Con el dato del elemento <cac:BillingReference>

          <cac:InvoiceDocumentReference>

            <cbc:DocumentTypeCode>

       


      Colocar:

       


      01 FACTURA

      03 BOLETA DE VENTA

      07 NOTA DE CREDITO

      08 NOTA DE DEBITO

      09 GUIA DE REMISIÓN REMITENTE

       


      No. De Documento de Referencia

      <cac:BillingReference>

          <cac:InvoiceDocumentReference>

            <cbc:ID>

       


      Motivo de Referencia

      <cac:BillingReference>

          <cac:InvoiceDocumentReference>

      <cbc:Description>

    • Si el usuario Elige la opción Email, deberá permitir realizar el envio al correo electrónico del contacto del Cliente (A1_EMAIL) incluyendo XML Autorizado y PDF  generado a partir del XML.
 


  1. Al finalizar enviar mensaje al usuario "Generación Representación Impresa Finalizada." Y el resumen de los documentos procesados (Prototipo 19)
 


Generación de XML 


Para generar el XML, deberá llamar la función correspondiente dependiendo del tipo de documento:

Si el documento es Factura o Boleta, deberá llamar la función M486NFXML.

Si el documento es Nota de Crédito, deberá llamar la función M486NCCXML.

Si el documento es Nota de Débito, deberá llamar la función M486NDCXML.

Si el documento es una Guía de Remisión, deberá llamar la función M485RFNXML.

Para Certificados de Retención revise el documento correspondiente. 


Opción Leyenda


Permitirá  visualizar cuadro de diálogo con los significados de cada color de los documentos mostrados en el browse (Prototipo 18).

 

Modificaciones otras Rutinas

 

MATA992

 

Se deberán agregar las siguientes validaciones a la rutina Control de Formularios (MATA992):

  

  • Al incluir, se deberá validar que no exista otro registro para la sucursal (FP_FILUSO), documento (FP_ESPECIE) para el campo FP_SERIE2.  Validación a campo FP_SERIE2.
  • Deberá validar que el campo SERIE2 no pueda ser modificado si ya tiene documentos utilizando esta serie2. Misma validación para eliminar un registro.

 

MATA468N

Se deberá modificar rutina de Generación de Notas fiscales para que al momento de generar la factura de venta, tome del control de formularios (SFP) el valor de la Serie 2. Esta funcionalidad existe actualmente en 11.8. 


LocXNF

Modificar el encabezado de los documentos Nota de Débito de Venta  y Nota de Crédito de Venta para mostrar el campo Motivo (F2_MOTIVO/F1_MOTIVO) y Tipos de Nota (F1_TIPREF/F2_TIPREF).  Prototipo 20 


LocXNF2

LocXNF2

Se debe agregar función LxExSer2 que contiene las validaciones para el uso de Serie 2 en la captura de documentos de Venta. Esta funcionalidad ya existe actualmente en Protheus 11.8 

 


Rutina

Tipo de Operación

Opción de Menú

Reglas de Negocio

MATA486

Creación

Actualizaciones|Facturación|Documentos Electronicos

-

MATA992

Modificación

Control de Formularios

-

MATA468N

Modificación

Generación de Notas Fiscales

-

LOCXNFModificación
  


LOCXNF2Modificación
 
 


M486XMLPDFCreaciónN/A será llamada desde MATA486

 

  

Tablas Utilizadas

  • SF1 – Encabezado de Fact. de Entrada.
  • SF2 - Encabezado de Fact. de Salida.
  • SA1 – Clientes.
  • SYA - Paises.
  • SFB - Impuestos Variables.
  • SFC - Vinculo Tes vs. Impuestos.
  • SD1 - Items de las Fact. de Entrada.
  • SD2 - Items de Venta de la Fact.
  • SAH - Unidades de Medida.
  • SB1 - Descripcion Generica Producto.


Prototipo de Pantalla

 

Prototipo 1


 


Prototipo 2

 

 

Prototipo 3

 

 

Prototipo 4 


 

 

Prototipo 5

 

 

Prototipo 6


 

 


Prototipo 7


  


Prototipo 8


  

 

Prototipo 9

 

 

Prototipo 10


  


Prototipo 11

 

 

Prototipo 12 


 


Prototipo 13

 

 

Prototipo 14


  


Prototipo 15


 


Prototipo 16


 

Prototipo 17

 

 

Prototipo 18


  


Prototipo 19


 

Prototipo 20

 

 

 

 


Diccionario de Datos

 

Campos Nuevos

 SFC– Detalle TES 


Campo

FC_TIPOIGV

Tipo

C

Tamaño

2

Decimal

0

Picture

@!

Contexto

Real

Propiedad

Modificar

Título

Afectación IGV

Descripción

Tipo de Afectación IGV

Help de Campo

Tipo de afectación del IGV según Catálogo No. 7

10           Gravado – Operación Onerosa

11           Gravado – Retiro por premio

12           Gravado – Retiro por donación

13           Gravado – Retiro

14           Gravado – Retiro por publicidad

15           Gravado – Bonificaciones

16           Gravado – Retiro por entrega a trabajadores

17           Gravado – IVAP

20           Exonerado – Operación Onerosa

21           Exonerado – Transferencia Gratuita

30           Inafecto – Operación Onerosa

31           Inafecto – Retiro por Bonificación

32           Inafecto – Retiro

33           Inafecto – Retiro por Muestras Médicas

34           Inafecto – Retiro por Convenio Colectivo

35           Inafecto – Retiro por premio

36           Inafecto – Retiro por publicidad 

40           Exportación

Informar solamente cuando el impuesto es IGV

Lista

 


Inicializa Estd

 


Validación

ExistCpo("SX5","XR"+M->FC_TIPOIGV)

Uso

Usado

F3

XR – Tipos Afectación del IGV

Obligatorio

Sí (  ) No (x  )

Campo

FC_TIPOISC

Tipo

C

Tamaño

2

Decimal

0

Picture

@!

Contexto

Real

Propiedad

Modificar

Título

Afectación ISC

Descripción

Tipo de Afectación ISC

Help de Campo

Tipo de sistema de cálculo de ISC según catálogo No. 08

01           Sistema al valor (Apéndice IV, lit. A – T.U.O IGV e ISC)

02           Aplicación del Monto Fijo (Apéndice IV, lit. B – T.U.O IGV e ISC)

03           Sistema de Precios de Venta al Público (Apéndice IV, lit. C – T.U.O IGV e ISC)

 


Informar solamente para ISC

Lista

 


Inicializa Estd

 


Validación

ExistCpo("SX5","XT"+M->FC_TIPOISC)

Uso

Usado

F3

XT – Tipos de sistema de Cálculo ISC

Obligatorio

Sí (  ) No (x  )
 


SFB- Impuestos Variables

Campo

FB_CLASSE

Tipo

C

Tamaño

1

Decimal

0

Picture

 


Contexto

Real

Propiedad

Modificar

Título

Clase Imp.

Descripción

Clase de impuesto

Help de Campo

Indica clase del impuesto.

Lista

I=Impuesto;P=Percepcion;R=Retencion

Inicializa Estd

 


Validación

PERTENCE("IPR")

Uso

Usado / Obligatorio

Obligatorio

Sí ( x ) No (  )
 

 



Campo

FB_CODIMP

Tipo

C

Tamaño

4

Decimal

0

Picture

 


Contexto

Real

Propiedad

Modificar

Título

Cod. Impuesto

Descripción

Codigo de Impuesto

Help de Campo

Código del impuesto según SUNAT Catálogo No. 5 Códigos de tipos de Tributo

1000

IGV IMPUESTO GENERAL A LAS VENTAS

VAT

2000

9999

ISC IMPUESTO SELECTIVO AL CONSUMO

OTROS CONCEPTOS DE PAGO

EXC

OTH

Lista

 


Inicializa Estd

 


Validación

ExistCpo("SX5","XS"+M->FB_CODIMP)

Uso

Usado

F3

XS – Códigos de Tipos de Tributo

Obligatorio

Sí ( x ) No (  )

 


SFP – Control de formularios

 

Campo

FP_SERIE2

Tipo

C

Tamaño

4

Decimal

0

Picture

@!

Contexto

Real

Propiedad

Modificar

Título

Serie 2

Descripción

Serie 2

Help de Campo

Serie a 4 digitos que será informada al SUNAT.

Lista

 


Inicializa Estd

 


Validación

NaoVazio()

Uso

Usado /Obligatorio

Obligatorio

Sí ( x ) No (  )

 

SF1- Encabezado de Factura Entrada

 

Campo

F1_FECAUT

Tipo

D

Tamaño

8

Decimal

0

Picture

 


Contexto

Real

Propiedad

Modificar

Título

Fch Aut

Descripción

Fecha de autorización

Help de Campo

Fecha de Autorización

Digital

del Documentos por parte de la SUNAT

Lista

 


Inicializa Estd

 


Validación

 


Uso

Usado

Obligatorio

Sí (  ) No (x  )

Campo

F1_FLFTEX

Tipo

C

Tamaño

1

Decimal

0

Picture

 


Contexto

Real

Propiedad

Modificar

Título

Status Trans

Descripción

Estatus transmission Electrónica

Help de Campo

Indica el estatus del documento una vez que ha sido enviado al TSS

Lista

0=No Enviado,1=Enviado a TSS,4=Esperando procesamiento,5=Rechazado,6=Autorizado.

Inicializa Estd

0

Validación

 


Uso

Usado

ObligatorioSí (  ) No (x  )

 

 



Campo

F1_MOTIVO

Tipo

Carácter

Tamaño

30

Decimal

0

Formato

@!

Título

Motivo

Descripción

Motivo

Usado

Si

Browse

No

Contexto

Real

Propiedades

Modificar

Orden

F3

Help De Campo

Motivo por el cuál se emite el documento.

ObligatorioSí (  ) No (x  )

               

Campo

F1_TIPREF

Tipo

C

Tamaño

1

Decimal

0

Picture

 


Contexto

Real

Propiedad

Modificar

Título

Tipo Nota de C

Descripción

Tipo de Nota de Crédito

Help de Campo

Tipo de Nota de Crédito Electrónica conforme a catálogo 10 de la SUNAT

F3

XO

Inicializa Estd

 


Validación

ExistCpo("SX5","XO"+M->F1_TIPREF)

Uso

Usado

Obligatorio

Si(X) No()

 


SF2 – Encabezado de Factura de Venta 


Campo

F2_FLFTEX

Tipo

Caracter

Tamaño

1

Decimal

0

Título

Status Trans

Descripción

Estatus transmisión Elec

Help de Campo

Indica el estatus del documento una vez que ha sido enviado al TSS

Usado 

Si

Browse

No

Opciones

0=No Enviado; 1=Enviado a TSS; 4=Esperando procesamiento; 5=Rechazado; 6=Autorizado

Inic. Esta.

0

Contexto

Real

Propiedades

Modificar

Inic. Browse

0

Orden

E9

Obligatorio

Si() No(x)

 

 

Campo

F2_FECAUT

Tipo

Data

Tamaño

8

Decimal

0

Título

Fch Aut

Descripción

Fecha de autorización

Help de CampoFecha de Autorización Digital

Usado

Si

Browse

No

Contexto

Real

Propiedades

Modificar

Orden

F0

Obligatorio

Si() No(x)

Campo

F2_MOTIVO

Tipo

Caracter

Tamaño

30

Decimal

0

Formato

@!

Título

Motivo

Descripción

Motivo

Help de CampoMotivo por el cuál se expide el documento

Usado

Si

Browse

No

Contexto

Real

Propiedad

Modificar

Orden

F3

Obligatorio

Si() No(x)

 

Campo

F2_TIPREF

Tipo

Caracter

Tamaño

1

Decimal

0

Picture

@!

Título

Tipo Nota D.

Descripción

Tipo Nota de Débito

Help de Campo

Tipo de Nota de Débito Electrónica conforme a catálogo 10 de la SUNAT

Uso

Si

Browse

No

F3

XP

Contexto

Real

Propiedad

Modificar

Inicial Estándar

 


Validación

ExistCpo("SX5","XP"+M->F2_TIPREF)

ObligatorioSi(X) No()
 


Campos Modificados

 


SF2 .- Encabezado Factura de Venta

 

Campo

F2_SERIE

Tipo

C

Tamaño

3

Decimal

0

Picture

 


Contexto

Real

Propiedad

Modificar

Título

Serie Docto

Descripción

Serie Del Documento

Help de Campo

Serie de la factura

Lista

 


Inicializa Estd

 


Validación

LxExSer2()

Uso

Usado

ObligatorioSi(x) No()

 

 

SA1 - Clientes 


Campo

A1_TIPDOC

Tipo

C

Tamaño

2

Decimal

0

Picture

 


Contexto

Real

Propiedad

Modificar

Título

Tipo Doc.

Descripción

Tipo Documento Identidad

Help de Campo

 


Lista

 


Inicializa Estd

 


Validación

ExistCpo("SX5","TB"+M->A1_TIPDOC)

F3

TB

Uso

Usado /Obligatorio

 

 

SFP – Control de formularios

 

Campo

FP_SERIE2

Tipo

C

Tamaño

4

Decimal

0

Picture

@!

Contexto

Real

Propiedad

Modificar

Título

Serie 2

Descripción

Serie 2

Help de Campo

Serie a 4 digitos que será informada al SUNAT.

Lista

 


Inicializa Estd

 


Validación

NaoVazio()

Uso

Usado /Obligatorio

 

Parámetros

 


Se deberán habilitar para Perú los siguientes parámetros:


Nombre

MV_WSRTSS

Tipo

Carácter

Descripción

URL de los WebServices del TSS.

Nombre

MV_SIGNUSR

Tipo

Carácter

Descripción

Usuario del sistema signature.

Nombre

MV_TESEXE

Tipo

Carácter

Descripción

TES utilizada para documentos Gratuitos

Nombre

MV_CFDDOCS

Tipo

Carácter

Descripción

Directorio donde se grabaran las facturas electrónicas.

 


Grupo de Preguntas

 


Nombre: MATA486

X1_ORDEM

01

X1_PERGUNT

Tipo Documento

X1_TIPO

C

X1_Tamaño

1

X1_GSC

 


X1_VAR01

MV_PAR01

X1_DEF01

Factura

X1_DEF02

Nota de Débito

X1_DEF03Nota de Crédito
X1_DEF04 Boleta de Venta

X1_HELP

Informe el tipo de documento con el que se estará trabajando durante la transmisión electrónica:

  1. Factura
  2. Nota de Débito
  3. Nota de Crédito
  4. Boleta de Venta
  5. Guía Remission
  6. Certificado Retención

X1_ORDEM

02

X1_PERGUNT

Serie

X1_TIPO

C

X1_Tamaño

3

X1_GSC

 


X1_VAR01

MV_PAR02

X1_F3SERNF

X1_HELP

Informe la serie del documento.

 


Nombre: MATA486A

X1_ORDEM

01

X1_PERGUNT

¿Serie de la Factura?

X1_TIPO

C

X1_Tamaño

3

X1_GSC

 


X1_VAR01

MV_PAR01

X1_F3SERNF

X1_HELP

Informe el número de Serie de la Factura.

X1_ORDEM

02

X1_PERGUNT

¿Factura Inicial?

X1_TIPO

C

X1_Tamaño

13

X1_GSC

 


X1_VAR01

MV_PAR02

X1_F3
 

X1_HELP

Informe el número Factura inicial.

X1_ORDEM

03

X1_PERGUNT

¿Factura Final?

X1_TIPO

C

X1_Tamaño

13

X1_GSC

 


X1_VAR01

MV_PAR03

X1_VALID !Empty(MV_PAR03)

X1_HELP

Informe el número Factura final.

 


Nombre: MATA486B

X1_ORDEM

01

X1_PERGUNT

¿Serie de Nota de Debito?

X1_TIPO

C

X1_Tamaño

3

X1_GSC

 


X1_VAR01

MV_PAR01

X1_F3SERNF

X1_HELP

Informe el número de Serie de la Nota de débito.

X1_ORDEM

02

X1_PERGUNT

¿Nota de Debito Inicial?

X1_TIPO

C

X1_Tamaño

13

X1_GSC

 


X1_VAR01

MV_PAR02

X1_F3
 

X1_HELP

Informe el número de Nota de Débito inicial.

X1_ORDEM

03

X1_PERGUNT

¿Nota de Debito Final?

X1_TIPO

C

X1_Tamaño

13

X1_GSC

 


X1_VAR01

MV_PAR03

X1_VALID !Empty(MV_PAR03)

X1_HELP

Informe el número de nota de Débito final.

 


Nombre: MATA486C

X1_ORDEM

01

X1_PERGUNT

¿Serie de Nota de Crédito?

X1_TIPO

C

X1_Tamaño

3

X1_GSC

 


X1_VAR01

MV_PAR01

X1_F3SERNF

X1_HELP

Informe el número de Serie de la Nota de crédito.

X1_ORDEM

02

X1_PERGUNT

¿Nota de Crédito Inicial?

X1_TIPO

C

X1_Tamaño

13

X1_GSC

 


X1_VAR01

MV_PAR02

X1_F3
 

X1_HELP

Informe el número de Nota de crédito inicial.

X1_ORDEM

03

X1_PERGUNT

¿Nota de Credito Final?

X1_TIPO

C

X1_Tamaño

13

X1_GSC

 


X1_VAR01

MV_PAR03

X1_VALID !Empty(MV_PAR03)

X1_HELP

Informe el número de nota de Crédito final.

 


Nombre: MATA486D

X1_ORDEM

01

X1_PERGUNT

¿Serie de Boleta de Venta?

X1_TIPO

C

X1_Tamaño

3

X1_GSC

 


X1_VAR01

MV_PAR01

X1_F3SERNF

X1_HELP

Informe el número de Serie de la Boleta de venta.

X1_ORDEM

02

X1_PERGUNT

¿Boleta de Venta Inicial?

X1_TIPO

C

X1_Tamaño

13

X1_GSC

 


X1_VAR01

MV_PAR02

X1_F3
 

X1_HELP

Informe el número de Boleta de Venta inicial.

X1_ORDEM

03

X1_PERGUNT

¿Boleta de Venta Final?

X1_TIPO

C

X1_Tamaño

13

X1_GSC

 


X1_VAR01

MV_PAR03

X1_VALID !Empty(MV_PAR03)

X1_HELP

Informe el número de Boleta de Venta final.

 


Nombre: MATA486E

X1_ORDEM

01

X1_PERGUNT

¿Serie de Guia Remision?

X1_TIPO

C

X1_Tamaño

3

X1_GSC

 


X1_VAR01

MV_PAR01

X1_F3SERNF

X1_HELP

Informe el número de Serie de la Guía de remisión.

X1_ORDEM

02

X1_PERGUNT

¿Guia Remision Inicial?

X1_TIPO

C

X1_Tamaño

13

X1_GSC

 


X1_VAR01

MV_PAR02

X1_F3
 

X1_HELP

Informe el número de Guia Remision inicial.

X1_ORDEM

03

X1_PERGUNT

¿Guia Remision Final?

X1_TIPO

C

X1_Tamaño

13

X1_GSC

 


X1_VAR01

MV_PAR03

X1_VALID !Empty(MV_PAR03)

X1_HELP

Informe el número de Guia Remision final.

 


Nombre: M486PDF

X1_ORDEM

01

X1_PERGUNT

¿Serie de documento?

X1_TIPO

C

X1_Tamaño

3

X1_GSC

G

X1_VAR01

MV_PAR01

X1_F3SERNF

X1_HELP

Informe serie del documento.

X1_ORDEM

02

X1_PERGUNT

¿Documento inicial?

X1_TIPO

C

X1_Tamaño

13

X1_GSC

G

X1_VAR01

MV_PAR02

X1_VALID
 

X1_HELP

Informe el número de documento inicial.

X1_ORDEM

03

X1_PERGUNT

¿Documento final?

X1_TIPO

C

X1_Tamaño

13

X1_GSC

G

X1_VAR01

MV_PAR03

X1_VALIDNaoVazio()

X1_HELP

Informe el número de documento final.

X1_ORDEM

04

X1_PERGUNT

¿Formato?

X1_TIPO

N

X1_Tamaño

1

X1_GSC

C

X1_VAR01

MV_PAR04

X1_DEF1PDF
X1_DEF2E-mail

X1_HELP

Informe formato de generación de representación impresa.

 

 



Tablas genéricas

 


XN – Tipo de Documento de Identidad (Catálogo No. 06)


Clave

Descripción

01

1

02

0

03

0

04

4

05

5

06

6

07

7

08

A

00

0

 


XO -  Tipos de Nota de Crédito (Catálogo No. 09)


Clave

Descripción

01

ANULACION DE LA OPERACIÓN

02

ANULACION POR ERROR EN EL RUC

03

CORRECCION POR ERROR EN LA DESCRIPCION

04

DESCUENTO GLOBAL

05

DESCUENTO POR ITEM

06

DEVOLUCION TOTAL

07

DEVOLUCION POR ITEM

08

BONIFICACIÓN

09

DISMINUSIÓN EN EL VALOR

10

OTROS CONCEPTOS

 


XP – Tipos de Nota de Débito (Catálogo No. 10)


Clave

Descripción

01

INTERESES POR MORA

02

AUMENTO EN EL VALOR

03

PENALIDADES

 


XQ – Monedas ISO-4217 (Catálogo No. 02)


Clave

Descripción

1

PEN

2

USD

 


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


Clave

Descripción

10

10 Gravado - Operación Onerosa

11

Gravado – Retiro por premio

12

Gravado – Retiro por donación

13

Gravado – Retiro

14

Gravado – Retiro por publicidad

15

Gravado – Bonificaciones

16

Gravado – Retiro por entrega a trabajadores

17

Gravado – IVAP

20

Exonerado - Operación Onerosa

21

Exonerado – Transferencia Gratuita

30

Inafecto - Operación Onerosa

31

Inafecto – Retiro por Bonificación

32

Inafecto – Retiro

33

Inafecto – Retiro por Muestras Médicas

34

Inafecto - Retiro por Convenio Colectivo

35

Inafecto – Retiro por premio

36

Inafecto - Retiro por publicidad 

40

Exportación

 


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


Clave

Descripción

01

Sistema al Valor

02

Aplicación del Monto fijo

03

Sistema de Precios de Venta al público

 


XS – Códigos de Tipos de Tributos (Catálogo No. 05)


Clave

Descripción

1000

IGV|VAT

2000

ISC|EXC

9999

OTROS|OTH

 


XU – Países ISO-3666 -1 (Catálogo No. 04)



Clave

Descripción

EC

ECUADOR

PE

PERU

 

 



Flujo del Proceso

 


Caso de TestesAcceso a la rutina
Finalidad TestesComprobar que la rutina elija correctamente el tipo de documentos que va a transmitir.
Estimativas
 


Teste do Programador( X ) Sim  ( ) Não
RecomendacionesTener un documento de cada tipo de los cuales se va a elegir.
Pré-condiciones
 

Pós-condiciones
 

Como verificar os resultadosSe mostrará el en browse los tipso de documentos elegidos.
ProcedimentosResultados Esperados

1. Detonar la rutina en la ruta en el menú Actualizaciones |Facturación|Doc. electrónicos

3. El usuario elige de entre las opciones: Factura de venta, nota de crédito, nota de débito,

guía remisión, boleta de venta y certificado de retención.

2. Se visualiza preguntas para iniciaizar la rutina en dónde el usuario debe seleccionar el tipo de documento a elegir.

4. Se visualiza browse de la rutina con documentos del tipo seleccionado.

Caso de TestesOpción Configuración
Finalidad TestesRealizar la configuración para la conexión con TSS
Estimativas
 


Teste do Programador(X ) Sim  ( ) Não
RecomendacionesTener certificado digital en formato pfx.
Pré-condiciones
 

Pós-condiciones
 

Como verificar os resultadosMensaje indicando  éxito del proceso.
ProcedimentosResultados Esperados

1. Seleccionar opción configuración de las opciones de la rutina MATA486.

3. Informar url de conexión con TSS, certificado digital y password.

4. Clic en avanzar

2. Se visualiza wizard de configuración.

5. Se visualiza mensaje de éxito o fracaso de la configuración

Caso de TestesOpción Transmisión
Finalidad TestesRealizar la transmisión de un rango de documentos hacia TSS
Estimativas
 


Teste do Programador(X ) Sim  ( ) Não
Recomendaciones

Tener registros de documentos (NF,NCC,NDC)

Tener configurados TES e Impuestos

Tener registros de clientes completos.

Pré-condiciones

Haber realizado la configuración de conexión hacia TSS.

Pós-condiciones
 

Como verificar os resultadosSe mostrará el en browse los tipos de documentos elegidos.
ProcedimentosResultados Esperados

1. Seleccionar opción Transmisión de las opciones de la rutina MATA486.

3. Informar rango de documentos a transmitir y serie.

4. Clic en ok

2. Se visualiza grupo de preguntas para informar rango de documentos a transmitir. 

5. Se transmiten los documentos a TSS.

6. Se muestra resumen de la Transmisión de documentos.


Caso de TestesOpción Monitor
Finalidad TestesRealizar la monitoreo  de un rango de documentos que han sido previamente enviados a TSS.
Estimativas
 


Teste do Programador(X ) Sim  ( ) Não
Recomendaciones

Tener registros de documentos (NF,NCC,NDC)

Tener configurados TES e Impuestos

Tener registros de clientes completos.

Pré-condiciones

Haber realizado envío previo de documentos a hacia TSS mediante opción transmitir.

Pós-condiciones
 

Como verificar os resultadosSe muestra en pantalla monitor.
ProcedimentosResultados Esperados

1. Seleccionar opción Monitor de las opciones de la rutina MATA486.

3. Informar rango de documentos a monitorear y serie.

4. Clic en ok

2. Se visualiza grupo de preguntas para informar rango de documentos a monitorear. 

5. Se obtiene la información de los documentos de la base de datos de TSS.

6. Se muestra información obtenida en pantalla.

 



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