Instalación del facturador Puerto Rico – Simphony

Transcripción

Instalación del facturador Puerto Rico – Simphony
Oracle® Hospitality Simphony
FIP – Uruguay
Guia de Instalacion
Release 2.7
September 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 (Win32)
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 .............................................................................................................. 20
Detalle de Campos para FACTURACIÓN REGULAR ............................................................. 22
Sección Cabecera ..................................................................................................................... 22
Sección Detalle .......................................................................................................................... 24
Sección Subtotales ................................................................................................................... 26
Sección Totales ......................................................................................................................... 27
Sección Cola .............................................................................................................................. 28
Detalle de Campos para FACTURACIÓN ELECTRÓNICA ..................................................... 29
Sección Cabecera ..................................................................................................................... 29
Sección Detalle .......................................................................................................................... 30
Sección Subtotales ................................................................................................................... 33
Sección Totales ......................................................................................................................... 34
Sección Adenda......................................................................................................................... 35
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.:
<setting name="NON_FISCAL_MIN_TENDER_OBJ_NUM">
<value>300</value>
</setting>
 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.:
<setting name="NON_FISCAL_MAX_TENDER_OBJ_NUM">
<value>400</value>
</setting>
 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.:
<setting name="FOUR_DIGIT_CHECK_NUMBER">
<value>true</value>
</setting>
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.:
<setting name="ASK_CUSTOMER_MIN_AMOUNT">
<value>10000</value>
</setting>
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.:
<setting name="ELECTRONIC_INVOICE_MODE">
<value>true</value>
</setting>
 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.:
<setting name="NON_FISCAL_MAX_TENDER_OBJ_NUM">
<value>400</value>
</setting>
 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.:
<setting name="FOUR_DIGIT_CHECK_NUMBER">
<value>true</value>
</setting>
Pg.
11
 ROUND_TOTAL: Determina si el monto total a pagar será
redondeado
a
cero
decimales.
Valores
aceptados
[true|false].
Ej.:
<setting name="ROUND_TOTAL">
<value>true</value>
</setting>
 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.:
<setting name="SIGAGENT_IP">
<value>127.0.0.1</value>
</setting>
 SIGAGENT_PORT: Puerto del dispositivo donde se ejecuta
el Agente de Signature. Valor por default 11000.
Ej.:
<setting name="SIGAGENT_PORT">
<value>11000</value>
</setting>
 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.:
<setting name="PRINT_EI_VOUCHER_ON_LOCAL">
<value>false</value>
</setting>
Pg.
12
 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
<setting name="PRINT_42_COLS">
<value>true</value>
</setting>
 QR_MODEL: Define el modelo (1 o 2) de código
Valores aceptados [49(Moldelo 1)|50(modelo 2)].
QR.
Ej.: QR Model 2
<setting name="QR_MODEL">
<value>50</value>
</setting>
 QR_SIZE: Define el
aceptados [1-16].
tamaño
del
código
QR.
Valores
Ej.:
<setting name="QR_SIZE">
<value>4</value>
</setting>
 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.:
<setting name="QR_ERROR_CORRECTION_LEVEL">
<value>3</value>
</setting>
 CUT_LF: Cantidad de líneas a avanzar en blanco antes
de cortar el papel.
Ej.:
<setting name="CUT_LF">
<value>5</value>
</setting>
Pg.
13
 E_INVOICE_LEGALS: Leyenda para e-Factura/NC e-Factura
que será impresa luego del código de seguridad.
Ej.:
<setting name="E_INVOICE_LEGALS">
<value>
Res. DGI xx/20xx
Puede verificar comprobantes en
www.efactura.dgi.gub.uy
IVA AL DIA SEGUN RES. DGI xxx/xx
</value>
</setting>
 E_TICKET_LEGALS: Leyenda para e-Ticket/NC e-Ticket que
será impresa luego del código de seguridad.
Ej.:
<setting name="E_TICKET_LEGALS">
<value>
Res. DGI xx/20xx
Puede verificar comprobantes en
www.signature.uy/consultacfe
IVA AL DIA SEGUN RES. DGI xxx/xx
</value>
</setting>
 PRINT_ZERO_AMOUNT_ITEMS: Determina si se imprimen en
el detalle los „Menu Items‟ con monto cero. Valores
aceptados [true|false].
Ej.:
<setting name="PRINT_ZERO_AMOUNT_ITEMS">
<value>
true
</value>
</setting>
Pg.
14
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.:
<setting name="PRINT_UNIT_PRICE">
<value>true</value>
</setting>
 PRINT_MI_NET_AMOUNTS: Determina si los montos de los
'Menu Item' serán impresos Netos o Brutos. Valores
aceptados [true|false].
Ej.:
<setting name="PRINT_MI_NET_AMOUNTS">
<value>true</value>
</setting>
 AUTO_SVC_LABEL: Define la leyenda
imprimirán los Auto Service Charge.
con
la
que
se
Ej.:
<setting name="AUTO_SVC_LABEL">
<value>Auto-svc</value>
</setting>
 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.:
<setting name="PRINT_CONSOLIDATED_DSC_SVC">
<value>false</value>
</setting>
Pg.
15
Sección Impresión - Encabezado
 HEADER_LINE_1 / HEADER_LINE_16: Líneas de encabezado a
imprimir en los documentos fiscales.
Ej.:
<setting name="HEADER_LINE_1">
<value>Encabezado 1</value>
</setting>
<setting name="HEADER_LINE_2">
<value>Encabezado 2</value>
</setting>
…
<setting name="HEADER_LINE_16">
<value>Encabezado 16</value>
</setting>
Sección Impresión - Cola
 TRAILER_LINE_1 / TRAILER_LINE_16: Líneas de encabezado
a imprimir en los documentos fiscales.
Ej.:
<setting name="TRAILER_LINE_1">
<value>Cola 1</value>
</setting>
<setting name="TRAILER_LINE_2">
<value>Cola 2</value>
</setting>
…
<setting name="TRAILER_LINE_16">
<value>Cola 16</value>
</setting>
Pg.
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.:
<setting name="LDAS_EXECUTE_ON_SERVER">
<value>true</value>
</setting>
 LDAS_FIELD_SEPARATOR_CHAR:
Define
el
caracter
de
separación entre campos (función changeSeparators).
Valores posibles: [default] o cualquier caracter.
Ej.:
<setting name="LDAS_FIELD_SEPARATOR_CHAR">
<value>[default]</value>
</setting>
 LDAS_RECORD_SEPARATOR_CHAR: Define el caracter de
separación entre registros (función changeSeparators).
Valores posibles: [default] o cualquier caracter.
Ej.:
<setting name="LDAS_RECORD_SEPARATOR_CHAR">
<value>[default]</value>
</setting>
 LDAS_POST_TO_BACKUP_DBS: Define si LDAS debe generar
Backup (función postToBackUpDBs). Valores posibles:
[default], „true‟ o „false‟.
Ej.:
<setting name="LDAS_POST_TO_BACKUP_DBS">
<value>[default]</value>
</setting>
Pg.
17
 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.:
<setting name="LDAS_POST_TO_CAPS_BACKUP">
<value>[default]</value>
</setting>
 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.:
<setting name="LDAS_GENERATE_PENDING_QUERY">
<value>[default]</value>
</setting>
 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.:
<setting name="LDAS_SET_CMD_TIMEOUT">
<value>[default]</value>
</setting>
 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.:
<setting name="LDAS_MAX_PENDING_QUERY_BUFFER_SIZE">
<value>[default]</value>
</setting>
Pg.
18
 LDAS_PENDING_QUERY_SEPARATOR:
Define
el
carcater
separador
entre
queries
de
reintento
(función
changeBufferedPendLinesRecSep).
Valores posibles: [default] o algún caracter.
Ej.:
<setting name="LDAS_PENDING_QUERY_SEPARATOR">
<value>[default]</value>
</setting>
Pg.
19
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.
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.
2
Esta sección está pensada
desarrolladores de Micros.
para
ser
utilizado
por
instaladores
Pg.
y
20
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
izquierda.
Cuando se quiere imprimir un texto fijo, se utiliza el
campo [LABEL] y el texto se define dentro del atributo
label del mismo
Pg.
21
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
TIME
Hora del DF
hh:mm:ss
Para todos los
documentos
Alineación a derecha
Pg.
22
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.
23
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
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
1 carácter
Si está activa la impresión
del precio unitario.
Campo iterativo para
cada ítem
Para todos los
documentos
Pg.
24
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.
25
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.
26
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.
27
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
Pg.
28
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.
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
Pg.
29
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 +
Número de Documento +
País de procedencia.
Para todos los
documentos
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
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
Pg.
30
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
1 carácter
Si está activa la impresión
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
Pg.
31
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
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
Pg.
32
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
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.
Pg.
33
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.
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.
Pg.
34
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
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
Pg.
35
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
legales según tipo de
documento electrónico
Para todos los
documentos. Se imprimen
luego del Código de
Seguridad.
SEC_CODE
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
Pg.
36
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

Documentos relacionados