Script de pruebas para generar timbre fiscal digital

Script de pruebas para generar timbre fiscal digital Pre-requisitos: 1. Aplicar el patch que proporciona la funcionalidad de la rutina Generación de Timbres Fiscales, utilice el archivo correspondiente a la versión de Protheus: ttts101_cfdfat.ptm = v10 ttts110_cfdfat.ptm = v11, 11.5 2. Agregar la rutina CFDFAT01 al menú Facturación (consulte anexo 1 Configuración de menú ). 3. Crear los nuevos campos F2_TIMBRE y F1_TIMBRE en las tablas de facturas de salida y de entrada respectivamente (consulte anexo 1 Campos nuevos ). 4. Crear los parámetros de acuerdo a los detalles que se mencionan en el anexo 1 Parámetros nuevos. Considere que la implementación de timbrado consiste en dos etapas: Pruebas y Producción. Debe configurar los parámetros correspondientes a cada ambiente cualquiera que sea el PAC, esto incluye la definición de los scripts de generación de los CFDi FATEMEX.INI y FATSMEX.INI. 5. En la ruta que se configure en el parámetro MV_CFDSMAR (en equipo local) se debe copiar el archivo TimbradoNombrePAC.exe (nombre del ejecutable que corresponde al PAC a implementar). 6. Quizá sea necesario instalar en la misma ruta del punto anterior el archivo de certificado/llave pública y el archivo de llave privada los cuales son requeridos en ciertos casos para el acceso al servicio web. Consulte la información proporcionada por el PAC. 7. El PAC establece si se debe realizar una instalación manual del certificado para autenticación al servicio web o si éste proceso es automático al acceder por primera vez al sitio correspondiente. En cualquier caso, siga las instrucciones que le proporcione el mismo PAC. 8. En el anexo 2 consulte el checklist de verificación para asegurarse de que la aplicación de timbrado se ejecuta correctamente. IMPORTANTE: - Este documento no contiene información sobre procedimientos de CFD / CFDi, el usuario y/o analista de proyectos deben tener conocimientos sobre el Anexo 20 de la Resolución Miscelánea Fiscal para 2010 emitido por el SAT. - El ambiente de Protheus en el que se realizará la implementación debe estar previamente configurado para generar facturas electrónicas por Internet (CFDi). FUNCIONALIDAD Una vez agregada la opción al menú y configurados los parámetros, entre al módulo de Facturación y seleccione la opción: Actualizaciones Facturación Generación Timbres Fiscales

Figura 1 Generación Timbres Fiscales Al seleccionar la opción, mostrará una pantalla con las facturas que se tienen registradas (Figura 2). Figura 2 Facturas emitidas, la marca en rojo indica una factura ya timbrada. Botones: BUSCAR

Esta ventana cuenta con un área de Búsqueda, para poder localizar facturas. Esta búsqueda se puede hacer por: Factura + Serie Tienda + Cliente + Factura + Serie Fecha de emisión Para buscar por alguno de estos índices, se debe seleccionar y posteriormente escribir la cadena que se requiere localizar y dar clic en el botón Buscar, en automático posicionará la barra de selección sobre el primer registro con el que encuentre coincidencia (Figura 3). Figura 3 Búsqueda factura LEYENDA Al seleccionar este botón muestra una pantalla con la descripción de la leyenda que le corresponde a cada factura según su status (si ya fue timbrada). Figura 3 Leyenda OK Para poder realizar el proceso de Generación de Timbres Fiscales, se debe tener al menos seleccionada una factura (de las que están pendientes por generar), si no se tiene seleccionada ninguna enviará un mensaje informando la situación (Figura 4), si tiene seleccionada al menos una comenzará el proceso mostrando una barra de proceso (Figura 5).

Figura 4 Mensaje Figura 5 Procesando Si se intenta marcar una factura a la que ya se le generó el Timbre, enviará un mensaje de que no es posible seleccionar: Figura 6 Factura generada Si se encuentra un error al procesar una factura, enviará un mensaje informando lo ocurrido y no se realizará el timbrado de esa factura (Figura 7). En caso de que se haya realizado el proceso correctamente, el PAC regresa el Timbre Fiscal Digital, éste se agregará automáticamente a la factura correspondiente dejando una copia del archivo xml original con el sufijo _ORIGINAL en el nombre (NF_UNI_00000000000001_ORIGINAL.XML) para diferenciarla de la factura que ya contiene el timbre. Figura 7 Ejemplos de algunos errores El manejo de los archivos xml, facturas electrónicas originales y timbradas, se realiza en la misma ubicación donde residen los documentos; ruta configurada en el parámetro MV_CFDDOCS.

Figura 8 Facturas electrónicas nf_a_00000000000000000002.xml nf_a_00000000000000000002_original.xml Factura con timbre fiscal Factura original (enviada al PAC para generar el timbre) Al finalizar la generación de los timbres fiscales, se visualizará algunos de siguientes mensajes dependiendo del número de timbres obtenidos: Figura 9 Avisos de fin de proceso ANULAR Botón para salir del proceso.

ANEXO 1 CONFIGURACIÓN DE MENÚ Agregar opción en el menú de facturación Para agregar la opción al menú se deben seguir las siguientes instrucciones: 1. Iniciar el módulo configurador (SIGACFG). 2. Entrar a la rutina Entorno Archivos Menú y seleccionar el menú Facturación (figura 1): 3. Agregar al menú la nueva opción (figura 2): Descripción: Generación Timbres Fiscales Módulo: Facturación Tipo: Función de usuario Programa: CFDFAT01 Figura1: Selección de menús 4. Graba el menú con la nueva opción. Figura2: Configuración de la rutina

CAMPOS NUEVOS Agregar los siguientes campos 1. Iniciar el módulo configurador (SIGACFG) 2. Acceder a la opción Base de datos Base de datos Diccionario de datos En la tabla de encabezado de facturas de salida crear el campo: Tabla Campo Tipo Descripción Observaciones SF2 F2_TIMBRE C(20) Timbre Fiscal Solo visualizar En la tabla de encabezado de facturas de entrada crear el campo: Tabla Campo Tipo Descripción Observaciones SF1 F1_TIMBRE C(20) Timbre Fiscal Solo visualizar PARÁMETROS NUEVOS Agregar los siguientes parámetros 1. Iniciar el módulo configurador (SIGACFG) y crear los parámetros: 2. Acceder a la opción Base de datos Base de datos Parámetros y definir los siguientes: Parámetros Tipo Contenido de ejemplo Descripción MV_ CFDSMAR C GetClientDir() Carpeta local en donde se procesaran las facturas para generar el timbre. MV_CFDUSER C 0000000001 Usuario para conectarse al Servicio Web de PAC 1 MV_CFDPASS C Pwd MV_CFDIPAC C ATEB MV_CFDIAMB C T Contraseña para conectarse al Servicio Web del PAC 1 Nombre del servicio a utilizar: ATEB, EDICOM, CONTPAQi, SEFACTURA, FormasDigitales, TimbreFiscal, DaySoft, Masteredi Ambiente de trabajo del PAC: T=(Teste) Pruebas P=Producción MV_CFDICER C Nombre y extensión del archivo del certificado (.cer) 2 MV_CFDIKEY C Nombre y extensión del archivo de la llave privada (.key) 2,3 MV_CFDICVE C Clave de autenticación o de la llave privada 2 Notas: La carpeta local a definir en el parámetro MV_CFDSMAR debe ser una ruta existente en la PC donde se realiza el timbrado, el nombre de la carpeta no debe contener espacios intermedios; en el ejemplo se emplea una función de ADVPL que devuelve la ruta del smartclient, otro ejemplo puede ser "C:\TimbradoCFD\". En esa ubicación se deben copiar el ejecutable TimbradoNombrePAC.exe y en algunos casos los archivos de certificado y llave privada. El usuario debe tener todos los derechos sobre la carpeta especificada. 1 Excepto: CONTPAQi, TimbreFiscal 2 CONTPAQi, SEFACTURA, FormasDigitales, TimbreFiscal 3 Masteredi: Nombre del archivo encriptado.pfx que contiene el certificado, llave privada y clave

ANEXO 2 Checklist de verificación de consumo del servicio web Con la finalidad de proveer una forma de verificar la funcionalidad del cliente del servicio web, a continuación se enumeran los puntos a validar: Verifique que los parámetros del proceso (anexo 1) estén definidos correctamente. Compruebe que el software de protección en el equipo no impida la ejecución del programa: - Firewall - Antivirus - Anti Spyware - Etc. La salida a Internet debe estar habilitada para esta aplicación. No se utiliza ningún puerto en especial. Las url s de los servicios web no deben estar bloqueadas por el explorador de Internet. Generalmente el PAC suministra un kit de conexión en el que se indican tales direcciones web, si no cuenta con esa información contáctelo para que le sean proporcionadas. Compruebe que el servicio web esté disponible accediendo a éste a través del explorador de Internet. Para esto simplemente tecleé la url (de pruebas o de producción, en algunos casos es única) en la barra de direcciones del explorador, el resultado debe ser similar a alguno de las siguientes imágenes:

En caso de ser necesario, asegúrese de haber instalado el certificado de autenticación al servicio web. El programa ejecutable de timbrado está desarrollado en ambiente de 32 bits, si se instala en un sistema operativo de 64 bits, a través del explorador de archivos: - Haga clic derecho sobre el ejecutable - Seleccione el modo de compatibilidad a 32 bits y acepte la configuración - Nuevamente haga clic derecho sobre el ejecutable - Deseleccione el modo de compatibilidad a 32 bits y acepte la configuración Ejecute la aplicación manualmente: - Copie uno o varios archivos xml de prueba a la ruta configurada en el parámetro MV_CFDSMAR (consulte el anexo 1) - Abra una ventana de comando y coloque el indicador en la carpeta mencionada - Sintaxis para ejecutar la solicitud de timbrado desde la línea de comandos: TimbradoPAC usuario clave cfdi.xml T certificado.cer llaveprivada.key clavellaveprivada uuid T RFC fecha Descripción de los parámetros: o usuario = Usuario para acceso al WS o clave = Contraseña del usuario para acceso al WS o cfdi.xml = Nombre del archivo del CFDi incluyendo la extensión o T = Ambiente: Teste o Productivo o certificado.cer = Nombre incluyendo extensión del archivo del certificado (llave pública) * o llaveprivada.key = Nombre del archivo con extensión de la llave privada * o clavellaveprivada = Clave de la llave privada * o uuid = Identificador único correspondiente al TFD; solo para cancelación * o T = Tipo de acceso: Timbrado o Cancelación o RFC = RFC del emisor; solo para cancelación * o Fecha = Fecha de emisión del CFDi, formato AAAAMMDD; solo para cancelación * Se deben utilizar los datos de prueba proporcionados por el PAC. (*) Estos parámetros no son necesarios sin embargo especifíquelos mediante al menos una letra o número. - El programa visualiza un mensaje respecto al resultado obtenido y en la mayoría de los casos genera un archivo conteniendo alguno de estos elementos: o o o El CFDi con el timbre fiscal digital ya incluido Los datos del TFD Mensaje de error proporcionado por el servicio web, éstos varían de acuerdo al PAC El nombre del archivo mencionado es el mismo que el CFDi más los caracteres.out Es importante considerar que en el caso de ser satisfactorio el proceso de timbrado por esta vía, el archivo original no es actualizado por lo que si se desea deberá reemplazarlo por el archivo conteniendo el timbre o modificarlo directamente integrando el elemento del timbre a través de un editor de textos tal como el bloc de notas de Windows.