Story Transcript
Oracle® Hospitality Simphony FIP – Uruguay Guia de Instalacion Release 2.7
November 2016
Copyright © 2016, Oracle and/or its affiliates. All rights reserved. This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited. The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing. If this software or related documentation is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable: U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government. This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners. Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group. This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.
Simphony FIP - Uruguay Guía de Instalación Aplica a Micros Simphony 2.7 Terminales POSReady WS5A/WS610(8.1), PCWS2015 Facturación Electrónica: Impresoras EPSON TM-T88IV/V (impresión QR soportada) Impresoras compatibles con Micros (impresión QR NO soportada) Agente Signature v15.2.1.6 Facturación Regular: Impresoras compatibles con Micros Importante: La información nueva o actualizada será remarcada en amarillo
Pg.
1
Tabla de Contenido
Extension Application ................................................................................................................. 3 Touchscreen – Page Design ...................................................................................................... 5 CAL Packages (Simphony v2.7)................................................................................................. 6 Archivos Locales ......................................................................................................................... 9 Configuración del FIP ............................................................................................................... 10 Plantilla de Impresión ............................................................................................................... 20 Introducción a PTPnet .............................................................................................................. 21 Detalle de Campos para FACTURACIÓN REGULAR ............................................................. 22 Sección Cabecera ..................................................................................................................... 22 Sección Detalle .......................................................................................................................... 25 Sección Subtotales ................................................................................................................... 27 Sección Totales ......................................................................................................................... 28 Sección Cola .............................................................................................................................. 29 Detalle de Campos para FACTURACIÓN ELECTRÓNICA ..................................................... 29 Sección Cabecera ..................................................................................................................... 29 Sección Detalle .......................................................................................................................... 31 Sección Subtotales ................................................................................................................... 33 Sección Totales ......................................................................................................................... 34 Sección Adenda......................................................................................................................... 36 Sección Cola .............................................................................................................................. 36 Importante .................................................................................................................................. 37
Pg.
2
Extension Application 1) Crear una carpeta dentro del Application Server, y copiar el package completo hacia la misma. 2) Abrir EMC. 3) Seleccionar el Scope deseado para la configuración de los Extension Applications (puede ser a nivel Enterprise, Property o RVC). 4) Ir a la solapa Setup y luego en el grupo Custom Content elegir la opción Extension Application. 5) Crear un nuevo registro. Ingresar “FIPURUGUAY” (sin comillas) en el campo Name y en el campo Description. 6) En los option bits del campo Options, seleccionar el que dice “Allow running extension applications on applications servers”.
- Figura 1 -
7) Ir al modo visual Form View haciendo doble click sobre el botón a la izquierda del número de registro (campo #) 8) Insertar los Application Content como se muestra en la Figura 2, a partir de los archivos copiados en el paso 1). Para ello se debe Como se trata de librerías DLL, el tipo de contenido debe ser: Content Type 3 DLL.
- Figura 2 -
Pg.
3
Se debe especificar el nombre de cada archivo en el campo Disk File Name. Al agregar todas las dll, esto generará en los clientes activos (luego de un refresh / update de la BD cliente) la carpeta: x:\Micros\Simphony\WebServer\wwwroot\EGateway\Handlers\ ExtensionApplications\FIPURUGUAY\, Donde finalmente aparecerán copiados todos los archivos correspondientes a los Application Content Agregados.
Pg.
4
Touchscreen – Page Design Editar la pantalla en el scope (Enterprise / Property) que se desee invocar las operaciones. Cambio de Rollo: Insertar un nuevo botón, agregarle la leyenda “Cambio de Rollo”. Definir en el campo Type que sea una tecla Function de tipo Run Extensibility App. En el campo Arguments debe ir la siguiente cadena (sin las comillas y sin espacios): “Type=DLL;AppName=FIPURUGUAY;FileName=FipUI.dll; Function=ButtonPressed;Arg=RollNumberMgr” Numeración de Comprobantes Fiscales: Insertar un nuevo botón, agregarle la leyenda “Alta Rangos Fiscales”. Definir en el campo Type que sea una tecla Function de tipo Run Extensibility App. En el campo Arguments debe ir la siguiente cadena (sin las comillas y sin espacios): “Type=DLL;AppName=FIPURUGUAY;FileName=FipUI.dll; Function=ButtonPressed;Arg=InvoiceControlMgr” Datos de Clientes: Insertar un nuevo botón, agregarle la leyenda “Datos de Clientes”. Definir en el campo Type que sea una tecla Function de tipo Run Extensibility App. En el campo Arguments debe ir la siguiente cadena (sin las comillas y sin espacios): “Type=DLL;AppName=FIPURUGUAY;FileName=FipUI.dll; Function=ButtonPressed;Arg=CustomerMgr”
Pg.
5
CAL Packages (Simphony v2.7) Copiar la carpeta Cal del paquete de instalación hacia la ruta donde se encuentran todos los Cal Package en el servidor de Simphony (x:\MICROS\Simphony2\EgatewayService). Suponiendo que el sistema está instalado en la unidad X:, debería quedar la nueva ruta conformada como se muestra en el siguiente esquema: X:\ └─MICROS └─Simphony2 └─EgatewayService └─CAL └─Win32 └─Packages └─FipUruguay2.0 ├─Setup.dat ├─DataWrapper.dll ├─FipCore.dll ├─ManualTaxEngine.dll ├─MicrosTaxEngine.dll ├─PTPnet.dll ├─TaxEngineMgr.dll ├─TWS.Helpers.dll ├─TWS.Tools.dll ├─TWS.UITools.dll ├─UIBase.dll ├─UY.AsyncClient.dll ├─UY.Common.W32.dll ├─UY.Configuration.W32.dll ├─UY.Core.W32.dll ├─UY.Signature.dll └─UY.UI.W32.dll
Abrir el EMC y posicionarse en la solapa Home; y a nivel Enterprise, acceder a la solapa Setup y luego seleccionar la opción CAL Packages (Hardware/Interfaces). Agregar un nuevo paquete CAL desde la opción Add Custom CAL Package, que se encuentra abajo a la izquierda. Se abrirá un diálogo para el ingreso del paquete, donde se deberá insertar la ruta completa donde se copió el paquete, en nuestro ejemplo sería:
Pg.
6
X:\ └─MICROS └─Simphony2 └─EgatewayService └─CAL └─Win32 └─Packages └─FipUruguay2.0 Por lo tanto completar el diálogo como se apreciar en la Fig. 3 y presionar OK para avanzar.
puede
- Figura 3 -
Luego se informa el package por agregar y se da la opción de modificar el nombre con el que será creado. Se debe cambiar la opción Name por el nombre Fip Uruguay (ver Fig. 4) y presionar el botón Upload para continuar. Se creará entonces un nuevo paquete de instalación y se verá reflejado en el Package Tree que se ve a la izquierda de la pantalla, debajo de la hoja Custom. Seleccionar el package Fip Uruguay haciendo click con el puntero sobre el nombre (ver fig. 5).
- Figura 4 –
Pg.
7
- Figura 5 -
Resta agregar una nueva tarea de instalación, para lo cual se debe acceder a la solapa Deployment Schedule. Una vez allí, crear un nuevo registro desde el link Add Deployment (Fig. 6). Definir en el campo Action to Take la opción Install. Luego se deberá especificar en el campo Deployment Type el scope deseado para la instalación, puede ser Property/Enterprise, o bien Specific Service Host. Si se elige la primera opción, completar el campo Property con la propiedad deseada (puede ser Enterprise, para todas las propiedades, o una específica. Ver fig. 7)
- Figura 6 –
- Figura 7 -
Pg.
8
Por el contrario si el scope es a nivel Specific Service Host, se deberá seleccionar el mismo en el campo Service Host (Fig. 8)
- Figura 8 -
Finalmente se debe correr la instalación CAL del lado del cliente para que se copien todos los archivos.
Archivos Locales Existen en el paquete de instalación archivos que necesariamente deben quedar excluidos del CAL PACKAGE porque estos pueden requerir variar su contenido en diferentes terminales. Tal es así el caso de los archivos de configuración y de las plantillas de impresión. Por ejemplo se podría necesitar que en dos terminales distintas los encabezados del documento fiscal impriman diferentes textos. Los archivos que deben copiarse manualmente se encuentran en la carpeta Local. La ruta destino deberá ser la misma que se genera cuando se instala la Extension Application: x:\Micros\Simphony\WebServer\wwwroot\EGateway\Handlers\ ExtensionApplications\FIPURUGUAY\ Pg.
9
Configuración del FIP El archivo de configuración de los parámetros del FIP es UYFip.config. Se detallan a continuación los campos que lo componen1.
Sección General NON_FISCAL_MIN_TENDER_OBJ_NUM: Mínimo valor del rango de Object Number de medios de pago (Tenders) que no generarán comprobante fiscal, sólo cerrando la cuenta en Micros. Ej.: 300 NON_FISCAL_MAX_TENDER_OBJ_NUM: Máximo valor del rango de Object Number de medios de pago (Tenders) que no generarán comprobante fiscal, sólo cerrando la cuenta en Micros. Ej.: 400 FOUR_DIGIT_CHECK_NUMBER: Determina si los Object Numbers de los cheques de Micros se deben truncar a 4 dígitos. Valores aceptados [true|false]. No modificar, sólo para usuarios avanzados. Ej.: true
1
Es recomendable que previo a la generación del CAL Package se modifique el archivo de configuración con los seteos deseados, de modo que cuando sea copiado a cada terminal, ya esté debidamente configurado. En caso de que se requiera una configuración diferente por cada terminal, no se deberá incluir el mismo en el CAL Package y se deberán copiar manualmente a cada terminal. Pg. 10
ASK_CUSTOMER_MIN_AMOUNT: Valor de una cuenta a partir del cual es obligatorio el ingreso de datos del cliente (0.00 para desactivar) Ej.: 10000
CURRENCY_CONVERTER_NUMBER: Number de la lista Currency Conversions (Columna #). Si el valor es 0 entonces el tipo de moneda por defecto es UYU Ej.: 1
Nota Importante 01: Columna Currency: Esta columna se considera moneda base. Columna Conversion Currency: Esta columna se considera moneda foranea. En
el
ejemplo
se
ha
seteado
con
el
valor
1
al
parámetro
CURRENCY_CONVERTER_NUMBER, entonces para el number # 1 la moneda base es Dolares y la moneda foranea es Pesos.
Pg.
11
SHOW_CURRENCY_CONVERTER: Determina si se mostrará el rate y el monto del currency foraneo Ej.: true Nota Importante 02: Si se activa esta opción es obligatorio asignar un valor diferente de cero al parametro CURRENCY_CONVERTER_NUMBER. Tomando encuenta lo especificado en la Nota Importante 01 sobre la moneda base: Pesos como moneda Base: Se mostrará el valor especificado en la columna Rate como el Tipo de Cambio. Otra moneda diferente a Pesos como moneda base: Se mostrará el valor de la columna Conversion Reverse como Tipo de Cambio.
Sección Facturación Electrónica ELECTRONIC_INVOICE_MODE: Determina si el facturador se utilizará en modo de Facturación Electrónica (Signature). Valores aceptados [true|false]. Ej.: true MIN_TAX_NUMBER: Máximo valor del rango de Object Number de medios de pago (Tenders) que no generarán comprobante fiscal, sólo cerrando la cuenta en Micros. Ej.: 400
Pg.
12
BASIC_TAX_NUMBER: Determina si los Object Numbers de los cheques de Micros se deben truncar a 4 dígitos. Valores aceptados [true|false]. No modificar, sólo para usuarios avanzados. Ej.: true ROUND_TOTAL: Determina si el monto total a pagar será redondeado a cero decimales. Valores aceptados [true|false]. Ej.: true SIGAGENT_IP: Dirección IP del dispositivo donde se ejecuta el Agente de Signature. Normalmente es la misma terminal, por lo que se puede utilizar la IP localhost. Ej.: 127.0.0.1 SIGAGENT_PORT: Puerto del dispositivo donde se ejecuta el Agente de Signature. Valor por default 11000. Ej.: 11000
Pg.
13
PRINT_EI_VOUCHER_ON_LOCAL: Determina si el voucher impreso de factura electrónica se hará utilizando la configuración de impresora desde la BD de Simphony, o bien el driver externo provisto con facturador. Debe desactivarse en caso de contar con impresoras SERIALES RS-232 (NO IDN) EPSON TM-T88IV/V si se desea la impresión del código QR. Ej.: false PRINT_42_COLS: Determina si el voucher impreso de factura electrónica será a 42 o a 32 columnas. Valores aceptados [true|false]. Ej.: Impresión a 42 columnas true QR_MODEL: Define el modelo (1 o 2) de código Valores aceptados [49(Moldelo 1)|50(modelo 2)].
QR.
Ej.: QR Model 2 50
QR_SIZE: Define el aceptados [1-16].
tamaño
del
código
QR.
Valores
Ej.: 4
Pg.
14
QR_ERROR_CORRECTION_LEVEL: Define el nivel de corrección del código QR. Valores aceptados: [0 (nivel L)| 1 (nivel M)| 2 (nivel Q)| 3 (nivel H)]. Ej.: 3
CUT_LF: Cantidad de líneas a avanzar en blanco antes de cortar el papel. Ej.: 5
E_INVOICE_LEGALS: Leyenda para e-Factura/NC e-Factura que será impresa luego del código de seguridad. Ej.: Res. DGI xx/20xx Puede verificar comprobantes en www.efactura.dgi.gub.uy IVA AL DIA SEGUN RES. DGI xxx/xx E_TICKET_LEGALS: Leyenda para e-Ticket/NC e-Ticket que será impresa luego del código de seguridad. Ej.: Res. DGI xx/20xx Puede verificar comprobantes en www.signature.uy/consultacfe Pg.
15
IVA AL DIA SEGUN RES. DGI xxx/xx
Para la facturación electrónica es obligatorio que los valores de la columna Symbol de las monedas (Currency) esten alineados al ISO-4217
Sección Impresión PRINT_UNIT_PRICE: Define si se debe imprimir o no el precio unitario de los ítems de menú. Valores aceptados [true|false]. Ej.: true PRINT_MI_NET_AMOUNTS: Determina si los montos de los 'Menu Item' serán impresos Netos o Brutos. Valores aceptados [true|false]. Ej.: true AUTO_SVC_LABEL: Define la leyenda imprimirán los Auto Service Charge.
con
la
que
Pg.
se
16
Ej.: Auto-svc PRINT_CONSOLIDATED_DSC_SVC: Determina si los descuentos y los servicios saldrán impresos consolidados o bien agrupados por tasa de IVA. Valores aceptados [true|false]. Ej.: false PRINT_ZERO_AMOUNT_ITEMS: Determina si se imprimen en el detalle los ‘Menu Items’ con monto cero. Valores aceptados [true|false]. Ej.: true
Sección Impresión - Encabezado HEADER_LINE_1 / HEADER_LINE_16: Líneas de encabezado a imprimir en los documentos fiscales. Ej.: Encabezado 1 Encabezado 2 … Pg.
17
Encabezado 16
Sección Impresión - Cola TRAILER_LINE_1 / TRAILER_LINE_16: Líneas de encabezado a imprimir en los documentos fiscales. Ej.: Cola 1 Cola 2 … Cola 16
Sección Acceso a Base de Datos (LDAS) LDAS_EXECUTE_ON_SERVER: Define si las operaciones a Base de Datos serán a nivel Enterprise o CAPS. Valores posibles: ‘true’ o ‘false’. (true = Enterprise, false = CAPS) Ej.: true LDAS_FIELD_SEPARATOR_CHAR: Define el caracter de separación entre campos (función changeSeparators). Valores posibles: [default] o cualquier caracter.
Pg.
18
Ej.: [default] LDAS_RECORD_SEPARATOR_CHAR: Define el caracter de separación entre registros (función changeSeparators). Valores posibles: [default] o cualquier caracter. Ej.: [default]
LDAS_POST_TO_BACKUP_DBS: Define si LDAS debe generar Backup (función postToBackUpDBs). Valores posibles: [default], ‘true’ o ‘false’. Ej.: [default]
LDAS_POST_TO_CAPS_BACKUP: Define si se debe generar backup sobre la Base de Datos CAPS Backup (función postToChkNPstBckp). Valores posibles: [default], ‘true’ o ‘false’. Ej.: [default]
LDAS_GENERATE_PENDING_QUERY: Define si se debe activar la cola de reintentos ante escrituras a Base de Datos fallidas (función genPendQryFiles). Valores posibles: [default], ‘true’ o ‘false’. Ej.: Pg.
19
[default] LDAS_SET_CMD_TIMEOUT: Especifica el timeout de acceso a (función setCmdTimeout)Valores posibles: [default] o algún valor numérico expresado en segundos. Ej.: [default] LDAS_MAX_PENDING_QUERY_BUFFER_SIZE: Especifica la cantidad máxima de queries en la cola de reintentos (función changeMaxBufferedPendLines). Valores posibles: [default] o algún valor numérico. Ej.: [default] LDAS_PENDING_QUERY_SEPARATOR: Define el carcater separador entre queries de reintento (función changeBufferedPendLinesRecSep). Valores posibles: [default] o algún caracter. Ej.: [default]
Plantilla de Impresión2 La interface fiscal cuenta con una plantilla de impresión configurable a través de los archivos UY_PTP.xml y UY_EI_PTP.xml.
Esta sección está pensada desarrolladores de Micros. 2
para
ser
utilizado
por
instaladores
Pg.
20
y
Introducción a PTPnet Esta sección describe los campos del componente PTPnet (Printer Template Parser net) utilizados por la solución fiscal. Se divide en secciones por una cuestión de organización lógica, pero cualquier campo puede ser definido en cualquier ubicación de la plantilla, sólo modificando las propiedades de ubicación (x_rel_pos / y_rel_pos). La ubicación impresa de un dato dependerá entonces del valor definido en los atributos de posición del campo de reemplazo, y no de la ubicación física del mismo dentro de la plantilla, es decir que por ejemplo el campo:
imprimirá la cabecera a partir de la primer fila y primer columna, independientemente si la definición se encontrara al final del archivo. Por una cuestión de facilidad de lectura se recomienda, no obstante, que el orden en el archivo se condiga con el orden definido en los atributos. Descripción de los atributos: name
Identifica el campo por su nombre (utilizado luego por el módulo PTPnet para ubicarlo).
label
Es la etiqueta que precede a la impresión del texto, es un texto fijo.
y_rel_pos
Determina la fila relativa en la que se ubicará el texto a imprimir. Fila relativa porque lo que en realidad describe es el orden a nivel renglón, y no el número de renglón en sí, porque se permite la impresión de múltiples líneas por cada campo, no está limitada a un solo renglón.
x_rel_pos
Determina la columna en la que se ubicará el texto a imprimir, el ancho de la columna se define mediante el atributo width. A diferencia del atributo de ubicación y_rel_pos, este campo define el número de columna exacto donde comenzará a imprimirse el texto.
width
Determina el ancho en caracteres de la línea a imprimir.
align
Define el tipo de alineación del texto dentro de la línea, los valores aceptados son: left | right | center Si no se define nada (align = “”) se considera alineación a Pg.
21
izquierda.
Cuando se quiere imprimir un texto fijo, se utiliza el campo [LABEL] y el texto se define dentro del atributo label del mismo
Detalle de Campos para FACTURACIÓN REGULAR Se describen los valores enviados por la solución fiscal al componente PTP para comprobantes de BOLETA y NOTA DE CREDITO. Archivo UY_PTP.xml
Sección Cabecera Esta sección contiene información de cabecera, como por ejemplo: número de cheque, fecha, hora, serie fiscal, etc. Campo
Valor/Formato
Observaciones
HEADER
Cabecera
Para todos los documentos
32 caracteres Alineación centrada Hasta 16 líneas INVOICE_TYPE
Tipo de documento fiscal. “Boleta” | “Nota de Crédito”
SERIE
Serie de Numeración 2 caracteres
Para todos los documentos
Para todos los documentos
Alineación a derecha NUMBER
Número de Documento Fiscal.
Para todos los documentos
6 dígitos. Alineación a derecha DATE
Fecha del DF dd/mm/yyyy
Para todos los documentos
Alineación a izquierda
Pg.
22
TIME
Hora del DF hh:mm:ss
Para todos los documentos
Alineación a derecha
Pg.
23
CHKNUM
Número de Cheque Micros
Para todos los documentos
“Chk: “ 999999 Alineación a izquierda WSID
ID de Terminal “Caja: 999999”
Para todos los documentos
Alineación a izquierda EMPL
ID de Cajero “Empl:” 9999
Para todos los documentos
Alineación a izquierda CHKID
ID del Cheque (Check Name)
Para todos los documentos
Alineación a izquierda NC_REF
Serie y Número del DF referenciado por la Nota de Crédito
Para Notas de Crédito
“AA-999999” Alineación a izquierda TAX_CLASS
Tipo de Contribuyente “CONSUMO FINAL” | “EMPRESA”
Para todos los documentos
Alineación centrada CUSTOMER_ID
ID del cliente Alineación a izquierda
CUSTOMER_NAME
Nombre del cliente Alineación a izquierda
CUSTOMER_ADDR_1
Línea 1 de domicilio del cliente
Para todos los documentos Para todos los documentos Para todos los documentos
Alineación a izquierda
Pg.
24
CUSTOMER_ADDR_2
Línea 2 de domicilio del cliente
Para todos los documentos
Alineación a izquierda CUSTOMER_PHONE
Teléfono del cliente Alineación a izquierda
CUSTOMER_MAIL
Correo electrónico del cliente
Para todos los documentos Para todos los documentos
Alineación a izquierda X_MARK
“X” Alineación a izquierda
Para documentos de tipo CONSUMO FINAL
CURRENCY_RATE
Tasa del tipo de cambio
Para todos los documentos
CURRENCY_CONVERT
Monto convertido por el tipo de cambio.
Para todos los documentos
Sección Detalle Esta sección contiene información de detalle, como por ejemplo: nombres de ítems, cantidades y precios. Campo
Valor/Formato
Observaciones
QT
Cantidad / Peso del ítem
Si está activa la impresión del precio unitario.
3 caracteres Alineación a derecha
Campo iterativo para cada ítem Para todos los documentos
ITEM_NAME
Nombre del ítem 8 caracteres Alineación a izquierda
Si está activa la impresión del precio unitario. Campo iterativo para cada ítem Para todos los documentos
EXMPT
“E” si el ítem es exento
Si está activa la impresión Pg.
25
1 carácter
del precio unitario. Campo iterativo para cada ítem Para todos los documentos
UPRICE
Precio unitario 8 caracteres Alineación a derecha
Si está activa la impresión del precio unitario. Campo iterativo para cada ítem Para todos los documentos
ITEM_TTL
Total de ítem 8 caracteres Alineación a derecha
Si está activa la impresión del precio unitario. Campo iterativo para cada ítem Para todos los documentos
QT_2
Cantidad / Peso del ítem 3 caracteres Alineación a derecha
Si no está activa la impresión del precio unitario. Campo iterativo para cada ítem Para todos los documentos
ITEM_NAME_2
Nombre del ítem 16 caracteres Alineación a izquierda
Si no está activa la impresión del precio unitario. Campo iterativo para cada ítem Para todos los documentos
EXMPT_2
“E” si el ítem es exento 1 carácter
Si no está activa la impresión del precio unitario. Campo iterativo para cada ítem Para todos los documentos Pg.
26
ITEM_TTL_2
Total de ítem 8 caracteres
Si no está activa la impresión del precio unitario. Campo iterativo para cada ítem Para todos los documentos
DSC_NAME
Nombre del descuento 22 caracteres Alineación a izquierda
DSC_TTL
Monto de descuento Alineación a derecha
Campo iterativo para cada descuento Para todos los documentos. Campo iterativo para cada descuento Para todos los documentos
SVC_NAME
Nombre del servicio 22 caracteres Alineación a izquierda
SVC_TTL
Monto de servicio Alineación a derecha
Campo iterativo para cada servicio Para todos los documentos Campo iterativo para cada servicio Para todos los documentos
Sección Subtotales Esta sección contiene información de subtotales, como por ejemplo: subtotales de impuesto, subtotal gravado, subtotal exento, etc. Campo
Valor/Formato
Observaciones
SUBT_DSC_NAME
"SUBTOTAL DESCUENTO"
Para todos los documentos
Alineación a izquierda SUBT_DSC_TTL
Suma de todos los descuentos
Para todos los documentos
Alineación a derecha Pg.
27
SUBT_SVC_NAME
"SUBTOTAL SERVICIO" Alineación a izquierda
SUBT_SVC_TTL
Suma de todos los servicios
Para todos los documentos Para todos los documentos
Alineación a derecha SUBTOTAL_AMOUNT
Suma neta de los ítems de menú
Para todos los documentos
Alineación a derecha
Sección Totales Esta sección contiene información de totales, como por ejemplo: Total del cheque, total de pagos efectuados, etc. Campo
Valor/Formato
Observaciones
TAX_NAME
“SUBT.IMP. ” + tasa (99.99)
Imprime si el total de impuesto es diferente de 0.00
Alineación a izquierda
Campo iterativo para cada tasa de impuesto Para todos los documentos TAX_TTL
Monto del impuesto Alineación a derecha
Imprime si el total de impuesto es diferente de 0.00 Campo iterativo para cada tasa de impuesto Para todos los documentos
TOTAL_AMOUNT
Monto total del cheque Alineación a derecha
TNDR_NAME
Para todos los documentos
Nombre del medio de pago
Campo iterativo para cada medio de pago aplicado
Alineación a izquierda
Para todos los documentos Pg.
28
TNDR_TTL
Monto del medio de pago Alineación a derecha
Campo iterativo para cada medio de pago aplicado Para todos los documentos
CHANGE_TTL
“VUELTO” Diferencia entre el monto total de la cuenta y el monto total abonado con los medios de pago
Para todos los documentos
Alineación a derecha
Sección Cola Esta sección contiene información de cola, como por ejemplo: Número de página, líneas de cola, etc. Campo
Valor / Formato
TRAILER
Cola
Observaciones
32 caracteres Alineación centrada Hasta 16 líneas
Detalle de Campos para FACTURACIÓN ELECTRÓNICA Se describen los valores enviados por la solución fiscal al componente PTP para comprobantes de e-Ticket, Nota de Crédito e-Ticket, e-Factura y Nota de Crédito e-Factura. Archivo UY_EI_PTP.xml
Sección Cabecera Esta sección contiene información de cabecera, como por ejemplo: número de cheque, fecha, hora, serie fiscal, etc.
Pg.
29
Campo
Valor/Formato
Observaciones
HEADER
Cabecera
Para todos los documentos
32 caracteres Alineación centrada Hasta 16 líneas INVOICE_TYPE
Tipo de documento fiscal. “e-Ticket” | “Nota de Crédito e-Ticket”| “e-Factura” | “Nota de Crédito e-Factura”
NUMBER
Serie y Número de Documento Fiscal.
Para todos los documentos
2 caracteres y 6 dígitos separados por un guión. Alineación a derecha PAYMENT_MODE
CONTADO | CRÉDITO
Para todos los documentos
CURRENCY
Moneda. Valor fijo:
Para todos los documentos
‘UYU’ DATE
Fecha del DF dd/mm/yyyy
Para todos los documentos
Alineación a izquierda TIME
Hora del DF hh:mm:ss
Para todos los documentos
Alineación a derecha NC_REF
Serie y Número del DF referenciado por la Nota de Crédito
Para Notas de Crédito
“AA-999999” Alineación a izquierda CUSTOMER_ID
ID del cliente: Tipo de Documento +
Para todos los documentos Pg.
30
Número de Documento + País de procedencia. Alineación a izquierda CUSTOMER_NAME
Nombre del cliente Alineación a izquierda
CUSTOMER_ADDR_1
Línea 1 de domicilio del cliente
Para todos los documentos Para todos los documentos
Alineación a izquierda CUSTOMER_ADDR_2
Línea 2 de domicilio del cliente
Para todos los documentos
Alineación a izquierda CURRENCY_RATE
Tasa del tipo de cambio
Para todos los documentos
CURRENCY_CONVERT
Monto convertido por el tipo de cambio
Para todos los documentos
Sección Detalle Esta sección contiene información de detalle, como por ejemplo: nombres de ítems, cantidades y precios. Campo
Valor/Formato
Observaciones
QT
Cantidad / Peso del ítem
Si está activa la impresión del precio unitario.
3 caracteres Alineación a derecha
Campo iterativo para cada ítem Para todos los documentos
ITEM_NAME
Nombre del ítem 8 caracteres Alineación a izquierda
Si está activa la impresión del precio unitario. Campo iterativo para cada ítem Para todos los documentos
EXMPT
“E” si el ítem es exento
Si está activa la impresión Pg.
31
1 carácter
del precio unitario. Campo iterativo para cada ítem Para todos los documentos
UPRICE
Precio unitario 8 caracteres Alineación a derecha
Si está activa la impresión del precio unitario. Campo iterativo para cada ítem Para todos los documentos
ITEM_TTL
Total de ítem 8 caracteres Alineación a derecha
Si está activa la impresión del precio unitario. Campo iterativo para cada ítem Para todos los documentos
QT_2
Cantidad / Peso del ítem 3 caracteres Alineación a derecha
Si no está activa la impresión del precio unitario. Campo iterativo para cada ítem Para todos los documentos
ITEM_NAME_2
Nombre del ítem 16 caracteres Alineación a izquierda
Si no está activa la impresión del precio unitario. Campo iterativo para cada ítem Para todos los documentos
EXMPT_2
“E” si el ítem es exento 1 carácter
Si no está activa la impresión del precio unitario. Campo iterativo para cada ítem Para todos los documentos Pg.
32
ITEM_TTL_2
Total de ítem 8 caracteres
Si no está activa la impresión del precio unitario. Campo iterativo para cada ítem Para todos los documentos
DSC_NAME
Nombre del descuento 22 caracteres Alineación a izquierda
DSC_TTL
Monto de descuento Alineación a derecha
Campo iterativo para cada descuento Para todos los documentos. Campo iterativo para cada descuento Para todos los documentos
SVC_NAME
Nombre del servicio 22 caracteres Alineación a izquierda
SVC_TTL
Monto de servicio Alineación a derecha
Campo iterativo para cada servicio Para todos los documentos Campo iterativo para cada servicio Para todos los documentos
ADJ_NAME
Leyenda “Ajuste”
Para todos los documentos
ADJ_TTL
Monto del ajuste
Para todos los documentos
Sección Subtotales Esta sección contiene información de subtotales, como por ejemplo: subtotales de impuesto, subtotal gravado, subtotal exento, etc. Campo
Valor/Formato
Observaciones
SUBT_DSC_NAME
"SUBTOTAL
Para todos los Pg.
33
DESCUENTO"
documentos
Alineación a izquierda SUBT_DSC_TTL
Suma de todos los descuentos
Para todos los documentos
Alineación a derecha SUBT_SVC_NAME
"SUBTOTAL SERVICIO" Alineación a izquierda
SUBT_SVC_TTL
Suma de todos los servicios
Para todos los documentos Para todos los documentos
Alineación a derecha SUBT_ADJ_NAME
Leyenda “Ajuste”
Para todos los documentos
SUBT_ADJ_TTL
Monto total de Ajustes
Para todos los documentos
SUBTOTAL_EXEMPT
Subtotal exento. Etiqueta: “SUBT. EXENTO”. Alineación a derecha.
SUBTOTAL_MINIMUM
Subtotal base, impuesto tasa mínima. Etiqueta: “SUBT. MINIMO”. Alineación a derecha.
SUBTOTAL_BASIC
Subtotal base, impuesto tasa básica. Etiqueta: “SUBT. BASICO”. Alineación a derecha.
Sección Totales Esta sección contiene información de totales, como por ejemplo: Total del cheque, total de pagos efectuados, etc. Pg.
34
Campo
Valor/Formato
Observaciones
TAX_NAME
“SUBT.IMP. ” + tasa (99.999)
Imprime si el total de impuesto es diferente de 0.00
Alineación a izquierda
Campo iterativo para cada tasa de impuesto Para todos los documentos TAX_TTL
Monto del impuesto Alineación a derecha
Imprime si el total de impuesto es diferente de 0.00 Campo iterativo para cada tasa de impuesto Para todos los documentos
TOTAL_AMOUNT
Monto total del cheque Alineación a derecha
PAYABLE_AMOUNT
Monto a pagar (puede diferir del total del cheque si se utiliza redondeo de decimales.
Para todos los documentos Para todos los documentos
Etiqueta: “MONTO A PAGAR”. Alineación a derecha. ROUNDING_AMOUNT
Redondeo de decimales, en caso de estar activo por configuración.
Para todos los documentos
Etiqueta: “REDONDEO”. Alineación a derecha. TNDR_NAME
TNDR_TTL
Nombre del medio de pago
Campo iterativo para cada medio de pago aplicado
Alineación a izquierda
Para todos los documentos
Monto del medio de pago
Campo iterativo para cada medio de pago aplicado
Alineación a derecha
Para todos los Pg.
35
documentos CHANGE_TTL
“VUELTO” Diferencia entre el monto total de la cuenta y el monto total abonado con los medios de pago
Para todos los documentos
Alineación a derecha
Sección Adenda Campo
Valor / Formato
Observaciones
CHKNUM
Número de Cheque Micros
Para todos los documentos
“Chk: “ 999999 Alineación a izquierda WSID
ID de Terminal
Para todos los documentos
“Caja: 999999” Alineación a izquierda EMPL
ID de Cajero
Para todos los documentos
“Empl:” 9999 Alineación a izquierda CHKID
ID del Cheque (Check Name)
Para todos los documentos.
Alineación a izquierda RVC_NAME
Nombre del RVC
Para todos los documentos.
Sección Cola Esta sección contiene información de cola, como por ejemplo: Número de página, líneas de cola, etc. Campo
Valor / Formato
Observaciones
LEGALS
Leyenda con textos
Para todos los Pg.
36
SEC_CODE
legales según tipo de documento electrónico
documentos. Se imprimen luego del Código de Seguridad.
Código de seguridad devuelto por Signature.
Para todos los documentos
Alineación a derecha QR_CODE
Código QR (en caso de ser soportado)
Para todos los documentos
CAE
CAE devuelto por Signature.
Para todos los documentos
INIT_NUMBER
Número inicial de documento fiscal.
Para todos los documentos
END_NUMBER
Número final de documento fiscal.
Para todos los documentos
EXP_DATE
Fecha de caducidad del CAE
Para todos los documentos
TRAILER
Cola
Para todos los documentos
32 caracteres Alineación centrada Hasta 16 líneas
Importante
Para la impresión de documentos fiscales generados en forma electrónica con soporte QR, se debe utilizar una EPSON TM-T88IV o TM-T88V controlada por el driver externo a Simphony, por lo que en la terminal no puede estar bloqueado el COM1.
Los componentes de Signature deberán ser instalados por la empresa Southconsulting, quedan fuera del alcance de este paquete de instalación.
Pg.
37