Micros TEF Engine programmer`s documentation

Oracle® Hospitality 9700 Point-of-Sale
Guía de Configuración para 9700 FIP de Uruguay (Winstation)
Release 3.00 SP2 or higher
July 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.
Guía de configuración para Micros 9700 FIP
de Uruguay (Winstation)
Aplica a
Micros 9700 v3.00 SP2 o superior
Clientes Winstation
Impresoras compatibles con Micros
Impresora EPSON TMU-950 (SLIP)
Importante: La información
remarcada en amarillo.
nueva
o
actualizada
será
Introducción
Tanto
para
PCWS
como
para
terminales
WS4,
el
comportamiento del FIP puede ser configurado editando un
solo archivo. Este documento provee información detallada
de cómo configurar dicho comportamiento, para poder adaptar
la solución a las necesidades de cada instalación.
FiscalURG.Cfg en detalle
Para poder configurar opciones específicas para todas
las terminales, se deberá editar el archivo FiscalURG.cfg
(utilizando cualquier aplicación de edición de texto, como
el NOTEPAD). Un acceso directo a este archivo será creado
por el instalador del FIP en el escritorio de Windows.
El archivo FiscalURG.cfg podrá ser encontrado en la
siguiente ruta:
1
X:\MICROS\LES\POS\9700\Cfg
Dicho archivo será tomado como archivo maestro para la
configuración de todos los clientes Winstation que sean
utilizados.
En
caso
de
necesitar
una
configuración
específica para cada cliente Winstation en particular, se
deberá utilizar un archivo de configuración con la
siguiente nomenclatura:
FiscalURG<WSID>.cfg
Por
ejemplo:
Si
clientes
Winstation
con
identificadores
(WSID)
1,
2,
4
y
7
necesitan
configuraciones individuales, los siguientes archivos
deberán ser creados en el directorio Cfg:
FiscalURG1.cfg
FiscalURG2.cfg
FiscalURG4.cfg
FiscalURG7.cfg
Si no se crean archivos de configuración adicionales, todas
los demás clientes Winstation leerán las opciones de
configuración del archivo FiscalURG.cfg maestro.
Se
encuentran
configurables:
disponibles
las
siguientes
opciones
Sección “Options”:
9 DB_TYPE: Especifica el motor utilizado por el servidor
de 9700. Ingrese "1" sí se trata de SQL Server, "2" si
es ORACLE.
9 PRINT_UNIT_PRICE: Activa o desactiva la impresión del
precio
unitario
para
cada
ítem
impreso
en
un
comprobante fiscal. Ingrese “1” para activar, “0” para
desactivar.
9 PRINT_WHEN_AMOUNT_IS_ZERO:
Activa
o
desactiva
la
impresión de un comprobante fiscal cuando el monto
total del cheque es 0 (cero). Ingrese “1” para
activar, “0” para desactivar.
2
9 ADD_CHARGED_TIP_TO_CHK_TOTAL: Si se activa, el monto
de “charged tip” asociado a una forma de pago (Tender)
será considerado como parte del monto total del
cheque. Sino, el “charged tip” será considerado como
cambio y no será agregado al monto total del cheque.
Ingrese “1” para activar, “0” para desactivar.
9 TAX_IS_INCLUSIVE:
Especifica
si
los
impuestos
configurados en la BD de 9700 son de tipo “Inclusive”
o no. Ingrese “1” para activar, “0” para desactivar.
(Esta opción debería estar desactivada si se están
utilizando impuestos de tipo “Add On”).
9 PRINT_ALT_CURRENCY: Si se activa, el FIP enviará al
driver de impresión información con el monto total de
la moneda alternativa configurada en el archivo de
configuración Ingrese “1” para activar, “0” para
desactivar.
9 ALT_CURRENCY_RATE: Especifica la tasa a utilizar para
calcular el monto total de la moneda alternativa a
imprimir.
9 ALT_CURRENCY_DESC: Especifica
moneda alternativa a imprimir.
la
descripción
de
la
9 MAX_PRINTABLE_ITEMS key: Especifica el número máximo
de items a ser impresos para un cheque. Si dicho
límite es superado, el FIP solicitará al usuario la
división (split) de la cuenta.
9 CF_INVOICE_LIMIT: Especifica el monto límite de una
boleta de tipo “Consumidor Final”, a partir del cual
serán solicitados los datos del cliente para ser
ingresados.
9 MIN_CC_TNDR_OBJ_NUM: Especifica el mínimo valor de
object_number de los tender media correspondientes a
las tarjetas de crédito.
9 MAX_CC_TNDR_OBJ_NUM: Especifica el máximo valor de
object number de los tender media correspondientes a
las tarjetas de crédito.
3
9 CONFIRM_NEXT_INVOICE_NUMBER: Si se activa, cada vez
que se quiera cerrar un cheque, le será requerido al
usuario que confirme o ingrese el número de la próxima
boleta a imprimir.
9 INV_NUMERATION_TYPE: Indica si el tipo de numeración
es por Sistema o PCWS (1 = Sistema, 2 = PCWS).
9 CC_IVA_DISCOUNT_LEGEND_LINE_1: Línea 1 de la leyenda a
mostrar en los documentos de tipo “Consumidor Final”,
cuando se paga con una tarjeta de crédito no
corporativa.
9 CC_IVA_DISCOUNT_LEGEND_LINE_2: Línea 2 de la leyenda a
mostrar en los documentos de tipo “Consumidor Final”,
cuando se paga con una tarjeta de crédito no
corporativa.
9 CC_IVA_DISCOUNT_LEGEND_LINE_3: Línea 3 de la leyenda a
mostrar en los documentos de tipo “Consumidor Final”,
cuando se paga con una tarjeta de crédito no
corporativa.
9 ADD_CC_TIP_TO_CHK_TENDER_TOTAL: Si no está activo,
restará de los pagos realizados con tarjeta de crédito
el monto del tip especificado, pero sólo en la
impresión de los tickets (no así en la base de datos).
9 PRINT_ON_SLIP:
si
está
activo
los
cupones
se
imprimirán a través del “Slip” de una impresora EPSON
950.
9 ORDER_TYPE_NAME_MAP / END_ORDER_TYPE_NAME_MAP: En esta
sección se deberán definir las correspondencias entre
los “object number” de los “order type” y sus nombres.
El formato es:
<Order Type Name>=<Order Type Object Number>
9 RVC_NAME_MAP / END_RVC_NAME_MAP: En esta sección se
deberán definir las correspondencias entre los “object
number” de los RVC y sus nombres. El formato es:
4
<RVC Name>=<RVC Object Number>
Sección “Non-FCR-emiting...”:
9 NON_FCR_MIN_TNDR_OBJ_NUM: Especifica
rango de formas de pago (Tenders)
comprobante fiscal.
el comienzo del
que no emitirán
9 NON_FCR_MAX_TNDR_OBJ_NUM: Especifica el final del
rango de formas de pago (Tenders) que no emitirán
comprobante fiscal.
Sección “...Info Lines”:
9 HEADER_INFO: Especifica las líneas a ser impresas como
cabecera (Header) de los comprobantes fiscales. El fin
de dichas líneas debe especificarse utilizando la
palabra clave "ENDHEADER_INFO". Máximo número de
líneas: 10. Máximo número de caracteres: 32.
9 TRAILER_INFO: Especifica las líneas a ser impresas
como cola (Trailer) de los comprobantes fiscales. El
fin de dichas líneas debe especificarse utilizando la
palabra clave "ENDTRAILER_INFO". Máximo número de
líneas: 10. Máximo número de caracteres: 32.
Templates de impresión PTP
El instalador de la solución fiscal copia, a modo de
ejemplo, un template de impresión PTP por cada tipo de
comprobante fiscal soportado.
Los templates de impresión pueden ser encontrados en
la siguiente ruta:
X:\MICROS\LES\POS\9700\Prnt
La nomenclatura de los templates es la siguiente:
BLT<WSID>.ptd -> Template para BOLETAS
5
FCT<WSID>.ptd -> Template para FACTURAS
CDT<WSID>.ptd -> Template para CREDITOS
Donde el atributo <WSID> indica la terminal a la que
pertenece dicho template.
6