====== Suite CFDI Nóminas======
* [[migracion_suite_40|Migración a 4.0]]
* [[migracion_suite_33|Migración a 3.3]]
=== Manual de Usuario ===
== Suite CFDI ==
La suite cfdi permite generar y administrar los archivos XML de las nóminas generadas en protheus. Entre otras cosas permite:
* Generar XML de manera sencilla (configuración de plantillas)
* Administrar los XML en el servidor por directorio
* Timbrar de manera selectiva
* Imprimir los recibos de nomina
* Ver el XML directamente
* Descargar los XML y en su caso los archivos PDF
* Imprimir reportes de totales timbrados (con opción a exportacion a excel)
* Cancelar recibos de manera selectiva
* Reprocesar XML timbrados previamente
=== Manual de Administrador ===
=== Configuración ===
La suite CFDI para protheus permite de manera sencilla poder configurar la generación, gestión e impresión de sencilla de los archivos XML
=== Tablas ===
== Tablas de configuración ==
^ Tabla ^ Descripción ^
| ZD0 | Definición de documento XML |
| ZD1 | Namespaces del documento XML|
| ZD2 | Nodos del documento XML |
| ZD3 | Atributos de los nodos del documento XML|
| ZD4 | Variables previas del documento XML |
| ZD5 | Conceptos con calculo gravados y exentos |
| ZD6 | Variables de conceptos |
== Tablas operativas ==
^ Tabla ^ Descripción ^
| ZA1 | Recibos Timbrados |
| ZA2 | Recibos Cancelados |
=== Parámetros Suite CFDI===
^ Concepto ^ Tipo ^ Descripción ^ Uso en Especificación XML ^ T
|MV_CINACU| Texto|CFDI: Concepto de ingresos acumulables| SeparacionIndemnizacion -> IngresoAcumulable |
|MV_CINNAC| Texto|CFDI: Concepto de ingresos no acumulables| SeparacionIndemnizacion -> IngresoNoAcumulable |
|MV_CANSER| Texto|CFDI: Conceptos de años de servicio| SeparacionIndemnizacion -> NumAñosServicio |
|MV_CULSUE| Texto|CFDI: Conceptos de último sueldo mensual| SeparacionIndemnizacion -> UltimoSueldoMensOrd |
|MV_CSLDAA| Texto|CFDI: Concepto saldo a favor| CompensacionSaldosAFavor -> SaldoAFavor |
|MV_CFEXPAR| |CFDI: Habilitar parámetros extra | |
|MV_CFSHXML| Boleano |CFDI: Habilitar botón para visualización de XML| .T. |
|MV_XMLUSE| Boleano |CFDI: Indica que tipo de objeto utilizar para lectura XML | .T. = TXMLManager / .F.= XmlParserFile |
|ES_DIRLOG| Texto| Logo| | |
|MV_CFCADE| Boleano| Indica si total percepciones y total deducciones se calculan de los nodos totales (.T.)o de cada uno de los registros individuales (.F.) para el registro en la base de datos | |
|MV_USESE3| Bolenao| Indica si se habilita la suite completa (.T.) o solo la generación de los XMLs| |
|MV_CFDXSLT| Texto | Nombre de archivo XSLT para generar la cadena original | cadenaoriginal_3_3.xslt |
|MV_CFDHASH| Texto | Tipo de algoritmo HASH a usar para el timbrado SHA1 o SHA256 | SHA256 |
|MV_CFDHFUN| Texto | Tipo de funcion para generar HASH 'EVP' o 'STD' | STD |
|MV_CFDUSEQ| Texto | Inidica si usara el control de secuencia por folio | |
|MV_CFDCSEQ| Texto | Secuencia por defecto de la tabla ZR2 | "00001" |
=== Parámetros Estándar Nóminas===
^ Tipo ^ Concepto ^ Tipo ^ Descripción ^ Uso en Especificación XML ^
| Protheus |MV_CFDRECN| Texto | Ruta del almacén de recibos de nómina (\Protheus_data\System\)| |
| Certificado (CSD) |MV_CFDI_CS| Texto | Número de certificado de sello digital | |
| ::: |MV_CFDI_KP| Texto | Nombre y extensión del archivo de la llave privada (.PEM) | |
| ::: |MV_CFDI_CP| Texto | Nombre y extensión del archivo del certificado (.PEM) | |
| ::: |MV_CFDI_CE| Texto | Nombre y extensión del archivo del certificado (.cer) | |
| ::: |MV_CFDI_PR| Texto | Nombre y extensión del archivo de la llave privada (.key/.pfx) | |
| ::: |MV_CFDI_CL| Texto | Clave de autenticación o de la llave privada | |
| PAC |MV_CFDI_CO| Texto | Contraseña para conectarse al Servicio Web del PAC| |
| ::: |MV_CFDI_US| Texto | Usuario para conectarse al Servicio Web de PAC| |
| Ejecutable timbrado |MV_CFDI_AM| Texto | Ambiente de trabajo con el PAC: T=(Teste) Pruebas, P=Producción | |
| ::: |MV_CFDI_PA| Texto | Nombre del servicio web a utilizar: Ateb, Edicom, DaySoft, DigitalFactura, FormasDig| |
=== Parámetros Estándar Correos===
^ Concepto ^ Tipo ^ Descripción ^ Uso en Especificación XML ^
|MV_RELACNT| Texto | Cuenta a ser utilizada en el envio de E-Mail para los informes. | |
|MV_RELSERV| Texto | Nombre de Servidor de Envio de E-mail utilizado en los informes. | |
|MV_RELAPSW| Texto | Contrasena para autenticacion en servidor de e-mai | |
|MV_RELAUTH| Texto | El servidor de EMAIL requiere Autenticacion | |
|MV_RELAUSR| Texto | Usuario para Autenticacion en el Servidor de Email | |
|MV_RELSSL| Texto | Define si debe habilitarse el SSL en el envio y recepcion de e-mails | |
|MV_SRVPORT| Texto | Puerto de salida de servidor de correo | |
=== Parámetros Estándar Facturas===
^ Tipo ^ Concepto ^ Tipo ^ Descripción ^ Uso en Especificación XML ^
| Protheus |MV_CFDRECN| Texto | Ruta del almacén de recibos de nómina (\Protheus_data\System\) | |
| ::: |MV_CFDDIRS| Texto | Directorio donde se grabaran los archivos con claves privadas y publicas. | |
| Ejecutable Timbrado |MV_CFDIAMB| Texto | Ambiente de trabajo del PAC: T=(Teste) Pruebas P=Producción| |
| ::: |MV_CFDIPAC| Texto | Nombre del PAC | |
| PAC |MV_CFDUSER| Texto | Usuario para Conectarse con PAC| |
| ::: |MV_CFDPASS| Texto | Password para que el sistema realice la conexion con el PAC del Timbrado de CFD | |
| Certificado (CSD)|MV_CFDCPUB| Texto | Nombre del archivo con la clave publica en formato PEM | |
| ::: |MV_CFDARQS| Texto | Nombre del archivo con la clave privada en formato PEM | |
| ::: |MV_CFDICER| Texto | Nombre de archivo del certificado (.CER) | |
| ::: |MV_CFDIKEY| Texto | Nombre de archivo del la llave privada (.KEY) | |
| ::: |MV_CFDICVE| Texto | Contraseña de la llave privada | |
=== Actualizar Certificado ===
Pasos para actualizar un certificado
- [[conversion_certificados_pem|Convertir el nuevo certificado a formato PEM]]
- Cargar al directorio de llaves 4 archivos
* Certificado en formato .cer y .pem
* Llave privada en formato .key y .pem
- Modificar los siguientes parámetros con los valores correctos de acuerdo a los nuevos certificados.
* MV_CFDI_CE
* MV_CFDI_CL
* MV_CFDI_CP
* MV_CFDI_CS
* MV_CFDI_KP
* MV_CFDI_PR
=== Control de secuencias ===
Para habilitar el control se secuencias es necesario usar los parámetros MV_CFDUSEQ y MV_CFDCSEQ ademas del uso de las tablas ZR0 y ZR2.
También es necesario configurar el campos Folio del XML en la tabla ZD3 con la siguiente función:
AllTrim(Str(U_SeqNext("00001",cPeriodo,cSemana,cProcesso,cRoteiro)))
=== Diccionario de datos ===
{{ :zda.7z |ZDA}}
=== ANEXO ===
== Actualizaciones ==
16/02/2020
* Separación para 2 nodos en caso de liquidaciones.
* Se tiene que modificar el nodo complemento de oRecNom:ToText(.F.) a 'cCompl01 + " " + cCompl02'
* Ajustar el parámetro MV_CFDNLIQ para indicar las nóminas donde se realizará el doble complemento.
* Crear parámetro MV_CFLDLIQ para nombre de campo en conceptos donde indica que el concepto es para liquicación SI;NO
* Crear parámetro MV_CFVLLIQ para valor que debe contener el campo para indicar que el concepto es de liquidación.
* Crear parametro MV_ENSPLIQ para habilitar la separación de complemento de liquicación vs complemento normal.
* Poner en 2 todos los conceptos de la SRV y en 1 solo los que aplican para Liquidaciones
* Los conceptos contenidos en los parametros siguientes ponerlos en tipo liquicación 2 (RV_COMPRO='S'):
* MV_CINACU
* MV_CANSER
* MV_CINNAC
* MV_CULSUE
* Modificar TotalSueldos por variable nTotSuel
* Cambiar tipo regimen con variable lIsLiq
* Cambiar Regla para tipo contrato a que tome 09 - Otros para liquidacion
* IF(lIsLiq,"09",SRA->RA_TIPCON)
=== Ejecutables de timbrado/cancelacion ===
* Ejecutar timbrado
StampFormasDigitales40 pruebasWS pruebasWS 010120160203_01020062.xml T T
* Ejecutar cancelacion
StampFormasDigitales40 pruebasWS pruebasWS cancelaciones.ini T C archivo.cer archivo.key passkey AAA010101AAA
StampFormasDigitales40 pruebasWS pruebasWS C:\opt\totvs\Protheus_Data\system\cfd\recibos\cancel\99\01\cancellist_20220528183734_01.ini T C C:\opt\totvs\Protheus_Data\system\cfd\llaves\30001000000400002434.cer C:\opt\totvs\Protheus_Data\system\cfd\llaves\30001000000400002434.key 12345678a EKU9003173C9