[email protected]

Manual de Mapeo – Sign@ture xDoc Mapping Tools V1.20061030

South Consulting Signature 

Bosque de Durazno No. 127, Piso 2. Col. Bosques de las Lomas. 11700 México DF. - Tel. Tel. (52-55) (52-55) 51483415 - Fax. Fax. (52-55) (52-55) 51483412 www.southconsulting.com

Manual Mapeo en xDoc – Sign@ture Mapping

Índice de Contenidos INTRODUCCIÓN .........................................................................................................................................................................3 MAPEADOR (MAPPING TOOL) .................................................................................................................................................4 MAPEO........................................................................................................................................................................................5 MAPEO DE CAMPOS .....................................................................................................................................................................6 PROPIEDADES DE LOS CAMPOS ......................................................................................................................................................7 TRADUCCIÓN ..............................................................................................................................................................................8 Agregar una traducción. .................................................................................................................................................8 Modificar una traducción. ..............................................................................................................................................8

CAMPOS PREDETERMINADOS. .......................................................................................................................................................9 CAMPOS POR PARÁMETROS (PERSONALIZADOS). ..........................................................................................................................10 DEFINICIÓN DE LAS ZONAS. .......................................................................................................................................................11 Zonas Dinámicas.............................................................................................................................................................12

IDENTIFICACIÓN DE CAMPOS EN LA ZONA DE MAPEO ......................................................................................................................13 REPLACE DE CARACTERES ..........................................................................................................................................................14 CREAR UNA NUEVA PLANTILLA ....................................................................................................................................................16 ELIMINAR UNA PLANTILLA ..........................................................................................................................................................17 MAPEO DE ADDENDAS ...........................................................................................................................................................17

South Consulting Signature Mejorando los procesos de negocio

2


Introducción El siguiente manual es una guía para apoyo en el mapeo de Comprobantes Fiscales Digitales y las Addendas requeridas por los socios comerciales.


3


Mapeador (Mapping Tool) El mapeador es un componente de Sign@ture xDoc, el cual es accesible desde la consola de administrador (Sign@ture xDoc Manager). Para acceder al mapeador deberá ingresar a Sign@ture xDoc y seleccionar el icono aplicación.

para abrir la

La siguiente imagen es la pantalla de la herramienta de mapeo, esta herramienta es utilizado por x.Doc para: • • • •

Paginación de los archivos (Servicio Sign@pager_xxxxx). Conversión de archivos de formato txt a xml. (Sign@converter_xxxxx_nn) Replace de caracteres en el spool por un valor asignado. Traducción de campos, para un campo especifico busca un valor a traducir.


4


Mapeo. El mapeo es la forma de interacción de Sign@ture xDoc con el spool generado por el ERP, ya sea por las Sign@print o directamente por Archivo. El proceso que hace xDoc es 1. El servicio PAGER (Paginación) y CONVERTER (Conversión) cargan la el archivo. 2. El servicio PAGER (Paginación) y CONVERTER cargan la plantilla de acuerdo al tipo de documento. 3. Comparan el archivo con la plantilla para. a. Pager, hacer la paginación (corte de archivo) en caso de que sean mas de un doc. por archivo. b. Converter, Busca los datos en la posición asignada, lee y genera el XML si están correctos. Las características que debe tener el archivo son. 1. El nombre debe ser XX_NPG_GUI.spf , donde. a. XX es el tipo de documento (ej: 33, 56, 61, etc). b. _NPG_ es el identificador de No PaGinado. c. GUI es un identificador único para cada archivo, para evitar sobrescribir archivos. d. SPF es la extensión para los archivos Sign@ture (Sign@ture Print File). ej: 33_NPG_5c574326-cf84-4652-9730-2d64cc987bea.spf Los archivos con estas características solo se procesaran en el directorio prnport. Cuando un archivo ya ha sido paginado cambia. e. _NPG_ --> _PAG_ que es PAGINADO. f. SPF --> TXT. Los archivos con estas características solo se procesaran en los directorios printed e inTXTtoXML. 2. Archivo posicional en todos sus datos. Los datos deben ser siempre posiciónales, es decir que el mismo dato SIEMPRE debe venir en la misma posición, ya que el mapeador (la plantilla) va a ir a buscar siempre a la misma posición el dato que le corresponde, si este esta mapeado. Si este dato no esta en la posición y es: a. Requerido : Dará un error de conversión. b. Opcional : No lo incorporara en el XML. 3. Formato de Campos. Cada campo debe cumplir con el formato de campos para el cual esta destinado, de lo contrario se provocará un error de conversión. a. Fecha : El campo debe cumplir un formato FECHA Internacional. b. String : El campo debe cumplir un formato STRING (Alfanumérico). c. Numero : El campo debe cumplir un formato NÚMERO. 4. Archivo por Zonas. Esto quiere decir que se identifican zonas para cada grupo de campos. a. Encabezado : Contiene los datos del encabezado del documento. b. Detalle : Contiene la información de detalle del documento. c. Referencia : Contiene las referencia del documento. d. Totales : Contiene la información de totales del documento.


5


Mapeo de Campos Para mapear deberá identificar los campos en el árbol de schema y arrastrarlos a la zona de mapeo, sobre el campo requerido. Para mapear un campo deberá realizar lo siguiente: 1. Abrir la aplicación Sign@ture xDoc. 2. 3. 4. 5. 6. 7. 8.

Seleccionar el icono del mapeador . Cargar una plantilla (Template). Cargar un spool (Archivo). Seleccionar el campo en el árbol de schema el campo y arrastrar a la zona de mapeo. Asignar el tamaño requerido al campo. Repetir tantas veces como sea necesario. Guardar los cambios en el mapeador.

3

4

Al seleccionar el campo se mostrara las propiedades del mismo.


6


Propiedades de los campos Cada campo tiene propiedades que se definen para el, de manera de dar una guía en sus propiedades y características. Descripción Muestra una leyenda descriptiva del campo. Nombre Xml Nombre del campo en lenguaje XML, este es el mismo nombre que lleva el campo en el XML. Fila Indica la fila en la cual comienza el campo. Columna Indica la columna en la cual comienza el campo. Tamaño. Indica el tamaño de campo en cuadros de mapeo. Máxima Ocurrencia Indica la máxima ocurrencia que soporta el campo. Mínima Ocurrencia Indica la mínima ocurrencia que soporta el campo. Predeterminado Indica el valor predeterminado que tiene el campo. Atributo 1 (Solo para campos personalizados o por parámetro). Este indica el nombre del campo con el cual se definirá en el XML. Ocurrencia: indica la cantidad de veces que un campo puede estar en el XML soportado por el schema, en el caso de campos este se muestra como en el ejemplo, para nodos la Max. y Min. ocurrencia debe verse en el nodo de los campos que lo componen.


7


Traducción. La traducción permite tomar un valor iniciar y asignar un valor final para es campo. Agregar una traducción. 1. 2. 3. 4. 5.

Identificar el campo en la zona de mapeo. Seleccionar “Traducción” (bajo el árbol de schema). Asignar el Valor Inicial en InicialValue y el Valor Final en FinalValue. Repetir tantas veces como sea necesario. Aceptar para confirmar los campos a traducir

6. Grabar los cambios en el mapeador

.

Modificar una traducción. 1. 2. 3. 4.

Identificar el campo en la zona de mapeo. Seleccionar “Traducción” (bajo el árbol de schema). Modificar los datos en requeridos. Aceptar.

Grabar los cambios en el mapeador

.

Si el o los valores que se busca(n) no esta(n) dentro de la lista, no se tomara el valor del spool, la traducción restringe los valores a asignar a los valores que estén declarados en InicialValue para asignar el FinalValue.


8


Campos Predeterminados. Los campos predeterminados son valores que se predeterminan a un campo del árbol de schema, para que se asigne en caso de que el valor en el mapeo no este en el spool o que el valor no se requiera del spool y simplemente se tome del valor predeterminado. 1. Identificar el campo en la zona de mapeo si esta mapeado, si no lo esta predeterminar en el árbol. 2. En propiedades del campo seleccionar con doble click en Predeterminado. 3. Asignar el valor predeterminado. 4. Grabar los cambios en el mapeador

.

En este caso se muestra que el RFC de Emisor esta mapeado pero no esta presente en el spool, como el RFC no esta disponible Sign@ture tomara el valor predeterminado para este campo. También es posible a modo de ejemplo que los campos del emisor pueden ser siempre los mimos, estos podrá determinarlos y no mapearlos.


9


Campos por Parámetros (Personalizados). Los campos por parámetros son campos que no están dentro del árbol de schema y por lo tanto tienen que ser mapeados como campos personalizados. 1. En el árbol de Schema seleccionar Elementos Personalizados. 2. Seleccionar el tipo de campo requerido (Alfanuméricos, Numéricos, Fecha) 3. Arrastrar el campo a la zona de mapeo y ajustar al tamaño requerido. 4. En Atributo1 seleccionar con doble click y asignar el nombre del campo. 5. Si requiere un valor predeterminado predeterminar (Pág. 8). 6. Repetir tantas veces como sea necesario. 7. Grabar los cambios en el mapeador

.

Para el siguiente caso se ha personalizado el monto en letras, este no es un campo que este por esquema en sign@ture, pero que puede ser mapeado e incorporado en el xml por la addenda Sign@ture.


10


Definición de las Zonas. La zona identifica los tipos de valores que corresponden a su uso y se define en su inicio por el inicio de la zona y el fin con el inicio de la siguiente zona. 1. Seleccionar la zona a modificar y mover en forma vertical. 2. Grabar los cambios en el mapeador


.

11


Zonas Dinámicas. En caso de que el tamaño de la zona de detalle no es fija, si no dinámica, se puede manejar por medio del mapeador la identificación del inicio y fin de cada zona. Lo que hace Sign@ture es buscar en el spool, leyendo en columna el campo, y si el valor asignado en predeterminado coincide con el leído, asume respectivamente, el inicio de la zona para inicio, fin de la zona para detalle para fin de detalle y fin de documento para el fin del documento. Para el uso de zonas dinámicas el spool deberá cumplir con etiquetas que indiquen el inicio y fin de cada zona. 1. En el árbol de Schema seleccionar Elementos Personalizados. 2. Seleccionar el tipo de campo alfanumérico. 3. En Atributo1 seleccionar con doble click y asignar el nombre xxxxxxxxx (ej: : XXX-INICIO). 4. Para detalle, referencia y final de documento deberá realizar el mismo procedimiento asignando los nombres correspondientes. a. Encabezado : Predeterminados: XXX- INICIO /Atributo1: _startofdoc b. Detalle : Predeterminados: XXX- FINDETALLE /Atributo1: _relativelavel c. Fin de documento : Predeterminados: XXX- FINAL /Atributo1: _endofdoc 5. Grabar los cambios en el mapeador


.

12


Identificación de campos en la zona de mapeo Para identificar un campo en la zona de mapeo basta con hacer doble click en el nombre del campo en el árbol de schema. Si el campo esta mapeado se mostrara la posición colocando en rojo el campo sobre la zona de mapeo. Si un campo esta mapeado bajo otro, lo llevara a la posición pero puede que no lo muestre en rojo si este esta bajo el otro campo.

Si el campo no esta mapeado dará el mensaje Este elemento no ha sido mapeado.


13


Replace de caracteres El REPLACE (reemplazo) de campos permite identificar uno o más campos en el spool sin necesidad de que estos estén mapeados y remplazarlos por un valor asignado. Esto es útil cuando se tiene un carácter de control o caracteres, no deseados o no soportados por el lenguaje XML, de esta manera se remplazan por campos soportados, tanto por la aplicación como por XML. Para esto deberá: 1. Cargar el mapeador, cargar la plantilla y el archivo que tiene los caracteres. 2. Ir a Elementos personalizados y seleccionar Elemento Personalizado Alfanumérico (recomendado), puede utilizarse cualquier campo del árbol. 3. Arrastrar sobre el campo que se desea reemplazar y asignar el tamaño exacto del campo. 4. Seleccionar Base64 para obtener la Base64 del campo, se conformara con el mensaje “La representación en base 64 ha sido copiada al clipboard” Aceptar. 5. Seguidamente deberá editar el archivo replace.xml del área, el cual esta en el directorio cnfg (\Signature .mx Desktop\Stores\areas\NorthSignature\cnfg). 6. Deberá eliminar los comentarios (), en OldValue deberá copiar el valor copiado al clipboard, y en NewValue asignar el nuevo valor. 7. Grabar los cambios en el archivo. 8. En el mapeador eliminar el campo utilizado para obtener Base64. 9. Cargar nuevamente la plantilla y el archivo, no debe aparecer el carácter remplazado, si no su valor asignado. 4

3 2


14


º Archivo replace.xml sin editar

Uso del replace.xml en xDoc Cargar nuevamente la plantilla y el archivo, deben presentarse los cambios del replace.

9


15


Crear una nueva plantilla Crear una nueva plantilla tiene la funcionalidad de poder manejar mas de una plantilla para el mimo tipo de documento, por ejemplo si para el mismo tipo de documento se tiene dos formatos distintos por que viene de distintos ERP, pero son el mismo emisor, o que cada plantilla debe leer información distinta a la otra pero de un mismo spool. Para crear la nueva plantilla deberá 1. Cargar una plantilla en el mapeador según el tipo de documento. 2. Definir un nombre para la nueva plantilla ej: NUEVA PLANTILLA (Bajo el tipo de documento). 3. En Identificadores deberá asignar el Identificador que buscara xDoc para asignar la plantilla, este identificador no debe ser mapeado, si no que xDoc buscara el nombre asignado como identificador en todo el spool, por esto el identificador debe ser un nombre de combinatorias difíciles de manera que no sea ocupado para otra función, ya que si viaja por otra razón xDoc lo leerá y asignara la plantilla correspondiente al identificador, este debe ser un nombre reservado. 4. Guardar para crear la plantilla y adecuar a los requerimientos de la nueva plantilla. 5. Reiniciar el servicio Sign@converter del área para que asuma la nueva plantilla. La nueva plantilla será almacenada en el directorio cnfg del área.

1 2 3


16


Eliminar una plantilla Para eliminar una plantilla deberá. 1. Cargar una plantilla en el mapeador según el tipo de documento. 2. Cargar la plantilla seleccionándola de la lista. 3. Seleccionar Eliminar.

1

3

2

Mapeo de Addendas El mapeo de addenda tiene la misma complejidad de mapear los campos requeridos para generar un CFD (Comprobante Fiscal Digital), a diferencia que se debe incorporar información adicional según el socio comercial a quien sean dirigidas, cada addenda es distinta a la otra, por lo que la información que manejan es distinta entre ellas. Las addendas deben contener información obligatoria y pueden contener información opcional o condicional, pero todos los mapeos deben manejar la información fiscal necesaria para generar el CFD. Para lograr mapear cada una de las addendas existe un documento de mapeo de addenda, el cual especifica el formato y la información para cada campo.


17


El presente manual está sujeto a mejoras constantes. Acogemos con agrado cualquier observación y sugerencia que Ud. pueda tener acerca de su contenido. También le alentamos a que nos envíe información sobre la experiencia obtenida con este manual , así como con otros aspectos que puedan servir para perfeccionar esta herramienta. Sírvase enviar sus contribuciones a:

North Signature Mexico S.A de C.V. Gerencia de Soporte Bosques de Durazno 127, Piso 2 Col. Bosques de las Lomas 11700, México, D.F. Teléfono: (55) 5148 3417

Correo electrónico: [email protected]


18

[email protected]

Recommend Documents