Manual Técnico

Manual Técnico
Manual Técnico
Manual Técnico
1. Organização de Pastas e Ficheiros
◦ \bin\xd
▪ Inclui o executável do Sistema e Librarias necessárias ao funcionamento:
• xdwin.exe – executável de arranque do sistema em ms-windows.
• Em Linux e MacOSX o executável encontra-se em (Pasta Instalação/Core/xd.sh)
◦ \cfg
▪ Inclui as configurações base do Sistema:
• xd.ini
◦ Inclui todas as configurações necessárias ao arranque do programa:
▪ Configuração do Posto.
▪ Tradução do Programa.
▪ Tipo de Base de Dados a utilizar.
▪ Dados de Acesso ao Sistema de Gestão de Base de Dados.
▪ Nome da Base de Dados a utilizar.
▪ Configuração da visualização.
▪ Configuração do Rato.
•
•
xd.lng - Tradução do Interface.
xd.lic – Licença.
◦ \db
▪ Inclui as bases de dados do Sistema (por padrão):
• xd.db - Base de dados em Formato SQLite.
◦ \dbconf
▪ Inclui os ficheiros de configurações de Páginas, Botões e Mesas:
• POS_COMBO_BOX_FUNCTION_BUTTON.xml - Listagem de Funções
Disponíveis.
• POS_COMBO_BOX_SCRIPT_BUTTON.xml - Listagem de Scripts
Disponíveis.
• POS_XML_ARRAY_OF_ROOMS.xml - Configuração das Mesas (Modo
Gráfico).
• POS_XML_BUTTON_BE.xml - Configuração dos Botões.
• POS_XML_BUTTON_MATRIX_BE.xml - Configuração das Páginas.
◦ \doclayout
▪ Inclui os Mapas de Impressão para formato de Talão (DOK).
▪ Lista de Mapas Disponíveis:
• cashier_operation.dok – Movimentos de Caixa.
• cashier_closure.dok – Fechos de Caixa.
• accounting.dok – Mapa de Contabilidade.
• customer_extract.dok – Extrato de Conta Corrente de Clientes.
• items.dok – Listagem de Artigos.
Manual Técnico
•
•
•
•
•
•
•
•
day_close.dok – Fecho / Consulta de Dia.
invoice.dok – Fecho de Conta.
subtotal.dok – Consulta de Mesa.
production_order.dok – Pedido.
items_barcodes.dok – Impressão de Códigos de Barras de Artigos.
tables_info.dok – Listagem de mesas abertas.
receipt_manual.dok – Recibo Manual de Conta Corrente.
reports.dok – Relatórios da Aplicação.
Nota: Podem ser criados diversos mapas ou alterados os exemplares.
◦ \doclayout\A4
▪ Inclui os Mapas de Impressão para formato A4 (XDR).
▪ Lista de Mapas Disponíveis:
• FACTURA_BASE.xdr
• GUIA_TRANSPORTE.xdr
• RECIBO_BASE.xdr
◦ \doclayout\Reports
▪ Inclui os Mapas para Relatórios em formato A4 (XDR). Nas instalações seguem
vários exemplares, tais como:
• AGEBALANCES – Relatório de Idades de Saldos.
• ANALYTICEXTRACT – Extrato Analítico.
• BASE_DUE_WARNING – Avisos de Vencimento.
• LISTA_CLIENTES – Listagem de clientes.
• LISTA_PRODUTOS – Listagem de Produtos.
• PLUTOTALxxx – Listagem de vendas de produtos por Bar/Mes/Ano.
• SALESBYSALESMAN – Relatório de Vendas por Vendedor.
• TOTALOFFER – Total de Ofertas.
• TOTALOFFERBYBAR – Total de Ofertas por Bar.
Nota: Podem ser criados novos relatórios ou editados os existentes a partir do módulo
XDReports. Os relatórios são executados na aplicação a partir da função “REPORTS”.
◦ \errorlog
▪ Inclui os Relatórios de Erros do Sistema:
• xd.log - Registo principal de ocorrências do Sistema.
◦ \images
▪ Inclui as imagens do Sistema:
• \images\common - todas as imagens comuns da aplicação.
• \images\user – todas as imagens personalizadas pelo utilizador.
◦ \images\user\buttons – Padrões de fundo para os botões.
◦ \images\user\items – Imagens para os artigos.
• \images\skins\ - localização das Skins da aplicação.
◦ \images\skins\base – Skin base da aplicação. As skins contêm todas as
imagens de personalização por módulo / função:
▪ \images\skins\(nome skin)\delivery – Módulo de Delivery
▪ \images\skins\(nome skin)\exchangetable – Módulo de Transferências
Manual Técnico
▪
▪
▪
▪
▪
▪
\images\skins\(nome skin)\menucombo – Módulo do Menu Combo
\images\skins\(nome skin)\reports – Módulo de Reports
\images\skins\(nome skin)\reserves – Módulo de Reservas
\images\skins\(nome skin)\roomdesign – Módulo de Mesas Gráficas
\images\skins\(nome skin)\system – Sistema Base
\images\skins\(nome skin)\tables – Módulo de Mesas
◦ \scripts
▪ Inclui Scripts do Sistema baseados em Csharp.
▪ Localização do Script de Arranque (INI.cs). Este script é executado no arranque da
aplicação.
2.
Configurações de Arranque (Ficheiro \cfg\xd.ini)
◦ LANG
▪ Descrição: Linguagem do Sistema
▪ Tipo: Alfanumérico.
▪ Exemplos:
• LANG=PT
• LANG=EN
(Inglês)
• LANG=ES
(Espanhol)
◦ TERMINAL
▪ Descrição: Número do Terminal
▪ Tipo: Numero Inteiro maior que 0.
▪ Exemplo:
• TERMINAL=1
◦ DBTYPE
▪ Descrição: Tipo de Servidor de Base de dados.
▪ Tipo: Numero Inteiro maior que 0.
▪ Valores Possíveis:
• 1- Servidor MYSQL.
• 2- SQLite V3.
• 3- Servidor PostgreSql.
• 4- MS-SQL Azure.
• 5- ODBC.
▪ Exemplo: DBTYPE=2
◦ DBSERVER
Manual Técnico
▪ Descrição: Servidor da Base de dados (IP ou Nome)
▪ Tipo: Alfanumérico.
▪ Exemplos:
• DBSERVER=localhost
• DBSERVER=SERVIDOR\XDREST
• DBSERVER=192.168.1.101
• DBSERVER=https://cloudDatabase/serviceId=1?user=admin?pass=1234
◦ DBPORT
▪ Descrição: Porta de Ligação do Servidor de Dados
▪ Tipo: Valor Inteiro maior que 0.
▪ Exemplo: DBPORT=1432
◦ DBNAME
▪ Descrição: Nome da Base de dados.
▪ Tipo: Alfanumérico.
▪ Exemplos:
• DBNAME=XDMYSQL
• DBNAME=C:\XDREST\DB\XDREST.DB
• DBNAME=F:\XDREST.DB
• DBNAME=\\SERVIDOR\DADOS\XDREST.DB
◦ DBUSER
▪ Descrição: Conta de Utilizador do Servidor de Base de Dados.
▪ Tipo: Alfanumérico.
▪ Exemplos:
• DBUSER=root
• DBUSER=sa
• DBUSER=postgres
root = conta de administração por padrão no servidor MySQL..
Sa= conta de administração por padrão no MS-SQLServer
postgres = conta de administração por padrão no PostgreSQL,
◦ DBPASSWORD
▪ Descrição: Password da Conta de Utilizador do Servidor de Base de Dados.
▪ Tipo: Alfanumérico.
▪ Exemplo: DBPASSWORD=pass123
◦ DBEXTRAOPTIONS
▪ Descrição: Opções Extra para a ligação (em especial para cloud e ODBC).
▪ Tipo: Alfanumérico.
▪ Exemplos:
• DBEXTRAOPTIONS=UseAutoConnection=True;
Manual Técnico
•
DBEXTRAOPTIONS=;Extended Properties=dBASE IV;User
ID=Admin;Password=x;
Nota: Esta opção é usada em exclusivo nas ligações ODBC.
◦ DBDRIVER
▪ Descrição: Driver a ser utilizado com ODBC.
▪ Tipo: Alfanumérico.
▪ Exemplos:
• DBDRIVER={SQL Server Native Client 10.0}
• DBDRIVER={mySql}
• DBDRIVER={Microsoft.Jet.OLEDB.4.0}
Nota: Esta opção é usada em exclusivo nas ligações ODBC.
◦ LOGMODE
▪ Descrição: Tipo de detalhe do registo de erro.
▪ Tipo: Alfanumérico.
▪ Valores Possíveis:
• NORMAL – Mensagem informal das anomalias.
• FULL – Mensagem técnica e detalhada das anomalias.
◦ LOGSIZE
▪ Descrição: Tamanho máximo do ficheiro de Registo de erros.
▪ Tipo: Numérico
▪ Exemplos:
• LOGSIZE=0
• LOGSIZE=1024
◦ em que 0 não limita o tamanho e 1024 elimina o ficheiro quando atingir
1MB.
◦ TEMPDATABASE
▪ Descrição: Nome da Base de dados Temporária.
▪ Tipo: Alfanumérico.
▪ Exemplos:
• TEMPDATABASE=temp.db
• TEMPDATABASE=c:\XDREST\db\temp.db
◦ SCREENMODE
▪ Descrição: Usar ou não modo Ecrã Completo.
▪ Tipo: Alfanumérico
▪ Valores Possíveis:
• SCREENMODE=NORMAL
• SCREENMODE=FULLSCREEN
◦ Full Screen é utilizado em configurações de postos para trabalharem
especificamente como POS. A aplicação equivale as dimensões pelas
especificadas no sistema operativo.
Manual Técnico
◦ MOUSECURSOR
▪ Descrição: Mostra ou não o ponteiro do Rato
▪ Tipo: Alfanumérico
▪ Valores Possíveis:
• MOUSECURSOR=ON
• MOUSECURSOR=OFF
◦ Útil quando é utilizado em configurações de postos que trabalham em
modo FULLSCREEN e possuem um ecrã Touch.
◦ MULTIPLEINSTACE
▪ Descrição: Permite iniciar várias instâncias da aplicação.
▪ Tipo: Booleano
▪ Valores Possíveis:
• MULTIPLEINSTANCE = ON
• MULTIPLEINSTANCE = OFF (Padrão)
◦ PRINTSPOOLER
▪ Descrição: Efetua sempre a impressão em processos separados.
▪ Tipo: Booleano
▪ Valores Possíveis:
• PRINTSPOOLER = ON
• PRINTSPOOLER = OFF (Padrão)
◦ VISUALINDICATORS
▪ Descrição: Mostra um gráfico visual do ciclo das rotinas de impressão e
hardware de ligação à aplicação (por exemplo comandos X64).
▪ Tipo: Booleano
▪ Valores Possíveis:
• VISUALINDICATORS = ON
• VISUALINDICATORS = OFF (Padrão)
◦ AUTOSCALE
▪ Descrição: As dimensões da aplicação no ecrã são definidas pelas mesmas do
sistema operativo.
▪ Tipo: Booleano
▪ Valores Possíveis:
• AUTOSCALE = ON
• AUTOSCALE = OFF (Padrão)
◦ SCALEWIDTH
▪ Descrição: Define a largura da aplicação no Ecrã.
▪ Tipo: Inteiro
Manual Técnico
▪ Valores Exemplo:
• SCALEWIDTH = 1024
• SCALEWIDTH = 800
◦ SCALEHEIGHT
▪ Descrição: Define a altura da aplicação no Ecrã.
▪ Tipo: Inteiro
▪ Valores Exemplo:
• SCALEHEIGHT = 768
• SCALEHEIGHT = 600
◦ SKIN
▪ Descrição: Define a Skin a ser utilizada. No caso de não existir é sempre
utilizada a skin BASE.
▪ Tipo: Alfanumérico
▪ Valores Exemplo:
• SKIN = BASE
• SKIN = CLASSIC
◦ CHECKDATABASE
▪ Descrição: Força a inserção dos valores padrão nas tabelas base da aplicação (por
exemplo, utilizador inicial, modos de pagamento, tipos de pagamento,
configurações de impostos, tipos de documentos, configurações de zona.)
NOTA: Não substitui configurações.
▪ Tipo: Booleano
▪ Valores Possíveis:
• CHECKDATABASE = ON
(após verificação automaticamente é colocado como OFF)
• CHECKDATABASE = OFF (Padrão)
◦ PATHDOCLAYOUT
▪ Descrição: Define a localização dos mapas de impressão. Esta configuração é útil
para partilhar os mapas numa rede.
▪ Tipo: Alfanumérico
▪ Valores Exemplo:
• PATHDOCLAYOUT = \\SERVER\DOCLAYOUT
• PATHDOCLAYOUT = E:\
◦ PATHDBCONF
▪ Descrição: Define a localização dos ficheiros de configuração do TouchScreen.
Esta configuração é útil para partilhar o layout do POS numa rede.
▪ Tipo: Alfanumérico.
▪ Valores Exemplo:
• PATHDBCONF = \\SERVER\DBCONF
• PATHDBCONF = E:\
Manual Técnico
◦ PATHIMAGES
▪ Descrição: Define a localização das imagens do Sistema.
Esta configuração é útil para partilhar, por exemplo, as imagens dos artigos do
POS numa rede.
▪ Tipo: Alfanumérico.
▪ Valores Exemplo:
• PATHIMAGES = \\SERVER\IMAGES
• PATHIMAGES = E:\
3. Configuração de Mapas de Impressão
◦ Após a instalação do XD, vários mapas exemplares são copiados para a pasta \doclayout.
Pode utilizar qualquer editor de texto para abrir os mapas ou utilizar o editor nas
configurações da aplicação.
◦
Os mapas de impressão têm o seguinte formato:
<<ALIGN=LEFT>>
<<FONTSIZE=14>>
<<FONTUNDERLINE=TRUE>>
X D R E S T
<<ALIGN=LEFT>>
<<FONTSIZE=10>>
<<FONTUNDERLINE=FALSE>>
PEDIDO Nr.[$ORDERNUMBER] [$DAY].[$MONTH].[$YEAR] H:[$HOUR].[$MINUTE]
----------------------------<<DBVAL = BEGIN>>
[*QUANTITY,8,LEFT,2] [*ITEMDESCRIPTION,25,LEFT]
<<DBVAL = END>>
<<FONTBOLD=TRUE>>
MESA : [$TABLENUMBER] EMPR : [$USERID]
Legenda :
Comandos de Impressora
Texto Livre
Variáveis
◦ Comandos de Impressora:
▪ O sistema de Impressão do XD gera a impressão baseado nas linhas do mapa de
configuração pelo que não é possível a mesma linha conter comandos e texto livre.
Por exemplo para configurar a 4ª linha do exemplo: X D R E ST para X D R E S T
(em que o primeiro caracter é negrito) seria necessário configurar da seguinte forma:
<<FONTSIZE=14>> define o tamanho da fonte para 14px
<<FONTBOLD=TRUE>> define a fonte como negrito
escreve a letra X em negrito
X
<<FONTBOLD=FALSE>> define a fonte para regular
<<ADDY= -14>>
recua 14px na impressão
Manual Técnico
DREST
escreve D R E S T
◦ Lista de Comandos:
▪ <<FONTNAME>>
• Define a fonte da impressora. Quando a impressora é configurada com modo
gráfico poderá especificar um tipo de fonte true type presente no seu sistema
operativo. Quando a impressora é configurada diretamente pela porta de
impressão consulte o manual da impressora para saber os tipos de letra
disponíveis.
◦ Exemplos :
▪ <<FONTNAME=Times New Roman>>
▪ <<FONTNAME=Arial>>
▪ <<FONTNAME=Fixed>>
▪ <<FONTSIZE>>
• Define o tamanho da letra (em pixéis) na impressão. No caso de a impressora ser
configurada em modo gráfico este tamanho é respeitado na integra mas no caso
de a impressora ser configurada diretamente na porta, por exemplo as
impressoras Epson TM's só possuem 3 tamanhos possíveis por isso o intervalo de
tamanho é aplicado:
◦ Menor ou igual a 10 = Tamanho 1
◦ Menor ou igual a 16 = tamanho 2
◦ Maior que 16 = Tamanho 3
▪ Exemplos:
• <<FONTSIZE=14>>
• <<FONTSIZE=20>>
▪ <<FONTBOLD>>
• Define se o tipo de letra é impresso a Negrito.
• Definições possíveis como exemplo:
◦ <<FONTBOLD=TRUE>>
◦ <<FONTBOLD=FALSE>>
▪ <<FONTUNDERLINE>>
• Define se o tipo de letra é sublinhado.
• Definições possíveis como exemplo:
◦ <<FONTUNDERLINE=TRUE>>
◦ <<FONTUNDERLINE=FALSE>>
Manual Técnico
▪ <<IMAGE>>
• Imprime uma imagem. É recomendado um tamanho de por exemplo 32x32 ou
64x64 mas no entanto é possível imprimir imagens maiores sem especificação de
tipo de ficheiro de imagem.
• Exemplos:
◦ <<IMAGE=exemplo.bmp>>
◦ <<IMAGE=exemplo.png>>
◦ <<IMAGE=exemplo.jpg>>
▪ NOTA: As imagens devem estar localizadas na pasta de imagens
(\IMAGES)
▪ <<ADDY>>
• Avança ou recua n Pixéis no eixo do Y (altura).
• Exemplos:
◦ <<ADDY=10>>
▪ avança 10 Pixéis.
◦ <<ADDY= -10>>
▪ recua 10 Pixéis.
▪ NOTA: No caso da impressora estar configurada diretamente na porta
COM o valor equivale ao numero de linhas.
▪ <<ADDX>>
• Avança ou recua n Pixéis no eixo do X (largura).
• Exemplos :
◦ <<ADDX=10>>
▪ avança 10 Pixéis.
◦ <<ADDX= -10>>
▪ recua 10 Pixéis.
▪ NOTA: No caso da impressora estar configurada diretamente na porta
COM o valor esta função não está disponível.
▪ <<ALIGN>>
• Define o alinhamento da Impressão. É possível iniciar a impressão à esquerda,
centro ou direita.
• Definições possíveis como exemplo:
◦ <<ALIGN=LEFT>> alinha a impressão à esquerda
◦ <<ALIGN=MIDDLE>> alinha a impressão ao centro
◦ <<ALIGN=RIGHT>> alinha a impressão à direita.
Manual Técnico
▪ <<MARW>>
• Define a margem de impressão.
• Exemplos :
◦ <<MARW=10>> inicia a impressão com uma margem de 10 pixéis.
◦ <<MARW=5>> inicia a impressão com uma margem de 5 pixéis.
▪ <<PAPERCUT>>
• Efetua o corte parcial de papel. Esta função só está disponível nas impressoras
configuradas diretamente na porta COM. Para obter o mesmo resultado com as
impressoras instaladas no sistema operativo terá de definir no Driver da
impressora para efetuar o corte de papel.
▪ <<DBVAL>>
• Define um bloco de informação da base de dados. Esta função é composta por
um comando de impressão Inicial e um comando de Impressão Final.
<<DBVAL=INI>>
campos a imprimir
<<DBVAL=END>>
•
Os campos a imprimir são definidos como:
[*Nome do Campo,comprimento em largura,alinhamento,numero de casas decimais (campos numéricos)]
▪ Exemplos:
•
•
•
[*Quantity,8,RIGHT,2]
[*Description,15,MIDDLE]
[*TAXVALUE,3,RIGHT,0]
Os campos devem ser definidos entre os blocos DBVAL INI e END.
Exemplo:
<<DBVAL=INI>>
[*Name,8,LEFT]
[*Address,20,LEFT] [*PostalCode,8,MIDDLE]
[*Balance,8,RIGHT,2]
<<DBVAL=END>>
O resultado seria:
John Doe
2nd Street from Test 1234-567
20,15
Jane Doe
1st Street from Test 10
150,00
Quando o sistema está a processar um bloco DBVAL é possível definir
condições IF da seguinte forma:
<<DBVAL=INI>>
[*IF:NAME|EQ|Teste] [*Name,8,LEFT]
<<DBVAL=END>>
Manual Técnico
Neste caso só seriam impressas as linhas em que a variável NAME seja
equivalente a “Teste”.
•
Lista de Campos disponíveis por função:
◦ Função FCONTA
▪
▪
▪
Valores em DBVAL,0
• ITEMKEYID
Código Artigo
• ITEMDESCRIPTION
Descrição Artigos
• ITEMTYPE
Tipo do artigo (Normal, Peso, Tempo,
Complemento)
• QUANTITY
Quantidade
• RETAILPRICE
Preço de Venda
• TAXVALUE
Valor da Taxa de IVA
• TOTALINCOME
Total Ilíquido
• TOTALTAXES
Total Taxas
• TOTAL
Total Liquido
Valores em DBVAL,1
• TAXID
ID associado à taxa.
• TAXVALUE
Valor da Taxa
• TOTALTAXES
Total por Taxa
• TAXDESCRIPTION
Descrição da Taxa.
• TAXDOCDESCRIPTION
Descrição específica para Documentos
(configurável através da opção IMPOSTOS no menu de configurações).
• TAXINCIDENCE
Valor da Incidência.
Valores em Variáveis
• BUSINESS_DATA_GLOBAL
Cabeçalho Impressão (Obrigatório)
• FISCAL_DATA
Certificação (Obrigatório)
• SERIE
Série do Documento Atual
• DOCUMENTTYPEID
Tipo de Documento Atual
(exemplo: 1 = Fatura, 11 = Fatura simplificada por padrão)
• DOCUMENTSHORTDESCRIPTION
Descrição Curta do Documento
(exemplo: FAC = Fatura, FS = FACTURA SIMPLIFICADA)
• DOCUMENTDESCRIPTION
Descrição do Documento
(exemplo: Fatura, Fatura Simplificada)
• TOTAL
Total do Documento
• TOTALHOLDINGTAXES
Total de Retenção na Fonte
• HOLDINGTAXVALUE
Percentagem da Retenção
• DOCUMENTNUMBER
Número do Documento
• NUMDOCCX
Número do Documento Caixa
• SHIFT
Turno Atual
• TABLE
Número da Mesa / Numero Cartão
• SIGNATUREPT
Assinatura do Documento (Obrigatório)
• TOTALCUSTOMERS
Número de Pessoas na Mesa
• CREATIONUSERID
Id do Empregado de criação.
• CREATIONDATE
Data de criação.
• CLOSEUSERID
Id do Empregado de Fecho.
• CLOSEDATE
Data de Fecho.
• CLOSEHOUR
Hora de Fecho.
• CLOSEMINUTES
Minutos de Fecho.
• CLOSESECONDS
Segundos de Fecho.
• ENTITYKEYID
Código do Cliente.
• ENTITYDESCRIPTION
Nome do Cliente.
• ENTITYADDRESS
Morada do Cliente.
• ENTITYPOSTALCODE
Código Postal do Cliente.
• ENTITYCITY
Cidade do Cliente.
• ENTITYSTATE
Localidade do Cliente.
Manual Técnico
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
◦
ENTITYVAT
NIF do Cliente.
DISCOUNTVALUE
Percentagem do Desconto
TOTALINCOME
Total Liquido
TOTALTAXES
Total Taxas no Documento
TOTALDISCOUNTS
Valor total de Descontos.
USERID
Id do Empregado Atual.
USERNAME
Nome do Empregado Atual.
TABLENUMBER
Número da Mesa / Numero do Cartão
SESSIONDATE
Data de Movimentação
PAYMENTTYPE
Tipo de Pagamento
(exemplo: 1=Dinheiro 2=Cheque. Valores personalizáveis definidos na configuração de
Tipos de Pagamento)
PAYMENTDESCRIPTION
Descrição do Tipo de Pagamento
SERVICETAXVALUE
Valor da Taxa de Serviço
DUEDATE
Data de Vencimento
LOADPLACEDATE
Data de Carga
LOADPLACETIME
Hora de Carga
LOADPLACEDESCRIPTION
Descrição do Local de Carga
UNLOADPLACEDESCRIPTION
Descrição do Local de Descarga
UNLOADPLACEDATE
Data de Descarga
UNLOADPLACETIME
Hora de Descarga
INVOICEOBS
Observações do Documento
NUMBERPERSONS
Número de Pessoas na Mesa
CURRENCYSYMBOL
Símbolo da Moeda
CURRENCYKEYID
Código da Moeda
DELIVERY_USER_NAME
Nome do Cliente em Delivery
ENTITYPHONE1
Telefone1 da ficha do Cliente
ENTITYPHONE2
Telefone2 da ficha do Cliente
ENTITYMOBILEPHONE1
Telemovel1 da ficha do Cliente
ENTITYMOBILEPHONE2
Telemovel2 da ficha do Cliente
ENTITYFAX1
Fax1 da ficha do Cliente
ENTITYFAX2
Fax2 da ficha do Cliente
ENTITYEMAIL1
Email1 da ficha do Cliente
ENTITYEMAIL2
Email2 da ficha do Cliente
ENTITYLATITUDE
Latitude definida na ficha do Cliente
ENTITYLONGITUDE
Longitude definida na ficha do Cliente
ENTITYCONTACTNAME
Nome de Contacto
ENTITYCONTACTPHONE
Telefone de Contacto
ENTITYCONTACTEMAIL
Email de Contacto
ORDERNUMBER
Número do Primeiro Pedido Associado
TOTALQNT
Total Quantidades
Função FDIA
▪
▪
▪
DBVAL,0 = Terminal
• TERMINAL
• PAGAMENTO
• TOTAL
Número do Terminal
Tipo de Pagamento
Total (por tipo de pagamento)
DBVAL,1 = Empregado
• NUMERO
• NOME
• TOTAL
Número do Empregado
Nome do Empregado
Total (por empregado)
DBVAL,2 = Taxas IVA
• TX
• INCIDENCIA
• IVA
• TOTAL
Valor da Taxa
Valor Incidente
Valor do Iva
Total (Liquido)
Manual Técnico
▪
▪
◦
DBVAL,3 = Famílias
• ID
• FAMILIA
• QNT
• VALOR
Número da Família
Nome da Família
Quantidade
Total (por família)
Variáveis
• DOCTYPE
Define o Tipo de Fecho
(exemplo: FDIA = Fecho de Dia, CDIA = Consulta de Dia)
• SESSIONDATE
Data de Movimentação
• DATAHORA
Hora atual
• TALOES
Número de Talões
• FIRST
Numero Primeiro Talão
• LAST
Numero Ultimo Talão
• TOTAL
Total do Fecho
• FIRSTHOUR
Hora inicial de Movimentação
• LASTHOUR
Hora final de Movimentação
• TOTALCASHIER
Total em Caixa
• CANCELEDROWS
Número de Documentos Anulados
• CREDITROWS
Número de Documentos Crédito
• DEBITROWS
Número de Documentos de Débito
• TOTALCREDIT
Total de Créditos
• TOTALDEBIT
Total de Débitos
• TOTALOFFERS
Total de Ofertas
• TOTALWITHOUTSERVICE
Total sem Taxas de Serviço
• SHIFT
Turno Atual
• TOTALPERSONS
Total de Pessoas atendidas
Função ENVIA
▪
▪
DBVAL,0
• ITEMKEYID,
• ITEMDESCRIPTION,
• QUANTITY,
• ORDERNUMBER,
• CREATIONUSERID,
• SALEZONEAREAOBJECT,
• DELETED
Código Artigo
Descrição Artigo
Quantidade
Número do Pedido
Numero Empregado
Mesa
Pedido Anulado?
Variáveis
• ORDERNUMBER
• ORDERTYPE
• TABLENUMBER
• USERNAME
• USERID
• SESSIONDATE
• ZONE
Número do Pedido
Tipo de Pedido
Número da Mesa
Nome do Empregado
Número do Empregado
Data de Movimentação
Descrição da Zona Atual
•
•
•
•
•
Quando em modo de Discoteca
MINIMUMCONSUMPTION
MAXIMUMCONSUMPTION
EXCEEDEDCONSUMPTION
CURRENTCONSUMPTION
Consumo Mínimo
Consumo Máximo
Consumo Excedido
Consumo Atual
Quando utilizado o módulo de Delivery:
Manual Técnico
•
•
•
•
•
•
•
•
•
DELIVERY_CUSTOMER_NAME
DELIVERY_CUSTOMER_ADDRESS
DELIVERY_CUSTOMER_POSTAL_CODE
DELIVERY_CUSTOMER_CITY
DELIVERY_CUSTOMER_PHONE
DELIVERY_CUSTOMER_MOBILE_PHONE
DELIVERY_EMPLOYEE_NAME
DELIVERY_EMPLOYEE_MOBILE_PHONE
Variáveis Comuns a todas as funções:
◦ As variáveis definidas no mapa são substituídas pelo valor corrente. Têm a
seguinte forma:
• [$NomeDaVariável]
◦ Exemplos:
▪ Hoje é dia [$DAY]
• O resultado será: Hoje é dia 20
▪ A hora atual é: [$HOUR].[$MINUTE]
• O resultado será: A hora atual é: 20.34
◦ Lista das variáveis disponíveis em todas as funções:
▪
▪
▪
▪
▪
▪
▪
▪
▪
▪
▪
▪
▪
▪
▪
[$DAY] - Dia atual no sistema.
[$MONTH] – Mês atual no sistema.
[$YEAR] – Ano atual no sistema.
[$HOUR] – Hora atual no sistema.
[$MINUTE] – Minutos atuais no sistema.
[$SECOND] – Segundos atuais no sistema.
[$LANG] – Língua definida para o XDRest
[$TERMINAL] – Numero do terminal que solicitou a impressão.
[$TERMINALNAME] – Nome do Terminal que solicitou a impressão.
[$TERMINALBAR] – Numero do Bar associado ao Terminal.
[$DBTYPE] – Tipo de base de dados que está a ser utilizado.
[$DBSERVER] – Servidor da base de dados.
[$DBPORT] – Porta do servidor de dados.
[$DBNAME] – Nome da base de dados.
[$DBUSERNAME] – Nome de utilizador da base de dados.
4. Configurações Avançadas
É possível utilizar condições para controlar ou selecionar os valores a imprimir. Os
comandos têm a seguinte forma:
Exemplo da Condição IF:
<<IF=[$NOMEVARIAVEL|EQ|10>>
IMPRIME SE A VARIÁVEL FOR EQUIVALENTE A 10
<<ELSE>>
IMPRIME SE A VARIÁVEL NÃO FOR EQUIVALENTE A 10
<<ENDIF>>
Manual Técnico
A condição é formada por:
NomeVariável |Condição|ValorComparar
O bloco é separado pelo caracter | (barra vertical).
As condições poderão ser:
• EQ
Equivalente
• >
Maior
• <
Menor
• <>
Diferente
• >EQ
Maior ou Igual
• <EQ
Menor ou Igual
Exemplos Práticos:
Colocar Cliente Manual. Esta configuração substitui o nome de cliente “Consumidor Final”
por duas linhas de forma a ser possível inserir manualmente os dados:
<<IF=[$ENTITYVAT]|EQ|999999990>>
Cliente : ________________________
Contribuinte : ___________________
<<ELSE>>
Cliente : [$ENTITYDESCRIPTION]
Contribuinte : [$ENTITYVAT]
<<ENDIF>>
Colocar o troco nos talões. Esta configuração apenas imprime o troco quando existe troco
efetuado. Desta forma evitamos que nos modos de pagamento que não estão sujeitos a troco
mostre as linhas:
Entregue: 0.00
Troco: 0.00
<<IF=[$DELIVERED]|<>|0.00>>
Entregue : [$DELIVERED]
Troco
: [$EXCHANGE]
<<ENDIF>>