manual integração.pdf

Manual do Integrador - Importao 1 Verso 1.00

SIAC Sistema Itautec de Automao Comercial


Informaes Gerais

Leia antes de utilizar o software:

O Manual do Integrador descreve todo o processo de integrao do sistema.


Reviso Data Alterao 1.0 15/06/2012 Definio inicial.

02/07/2012 Unificar manual de importao e exportao. 2.0 16/07/2012 Alterao nas tabelas de integrao de

importao de produtos e conjunto de produtos para permitir cdigo interno e de venda com at 14 dgitos e outros novos campos.

Incluso das tabelas de integrao de importao de promoo.

Incluso de novos campos nas tabelas de exportao de cupons e cancelamentos, e intItensCupons

Incluso da tabela intItensCuponsCesta Incluso das tabelas de integrao de

exportao de promoo e descontos. Incluso de novos layouts dos arquivos

de exportao TXT. Incluso do WebService de cliente, pr-

venda e baixa de pr-venda.


ndice Informaes Gerais ........................................................................................................... 2 ndice .................................................................................................................................. 4 1 Prefcio ......................................................................................................................... 9

1.1 Descrio do Produto ....................................................................................................................... 9 1.1.1 Objetivo ........................................................................................................................................ 9 1.1.2 Verso SIAC ................................................................................................................................ 9 1.1.3 Conceito ....................................................................................................................................... 9 1.1.4 Benefcios .................................................................................................................................... 9

1.2 A quem se destina ............................................................................................................................ 9

2 Requisitos ................................................................................................................... 10 2.1 Plataformas Compatveis ............................................................................................................... 10 2.2 Requisitos de HW ........................................................................................................................... 10 2.3 Requisitos de SW ........................................................................................................................... 10

3 Importao .................................................................................................................. 11 3.1 Arquitetura para Importao........................................................................................................... 12 3.2 Via BD tabelas de integrao ...................................................................................................... 13

3.2.1 Controle de Importao ............................................................................................................. 14 3.2.1.1 IntControle ............................................................................................................................................ 14 3.2.1.2 Consulta ao log de importao ............................................................................................................. 15

3.2.2 Cadastro de Produtos ................................................................................................................ 17 3.2.2.1 IntPluProduto ........................................................................................................................................ 17 3.2.2.2 IntPluCodigo ......................................................................................................................................... 19 3.2.2.3 IntPluDun .............................................................................................................................................. 19 3.2.2.4 IntPluProdutoAssociado ....................................................................................................................... 19 3.2.2.5 IntPluInsumo ......................................................................................................................................... 20 3.2.2.6 IntPluProdutoInsumo ............................................................................................................................ 20 3.2.2.7 IntPluProdutoLoja ................................................................................................................................. 21 3.2.2.8 IntPluPrecoLoja .................................................................................................................................... 21 3.2.2.9 IntPluVersaoPrecoLoja ......................................................................................................................... 22 3.2.2.10 IntPluPrecoAtacadoLoja ....................................................................................................................... 22 3.2.2.11 IntPluUnidadeConversao ...................................................................................................................... 23 3.2.2.12 IntPluProdutoLojaEtiqueta .................................................................................................................... 23 3.2.2.13 IntPluCestaLoja .................................................................................................................................... 24 3.2.2.14 IntPluCestaComponente ....................................................................................................................... 24 3.2.2.15 IntPluCestaCompPrecoLoja ................................................................................................................. 24

3.2.3 Pesquisa .................................................................................................................................... 25 3.2.3.1 IntPesquisa ........................................................................................................................................... 25 3.2.3.2 IntPesquisaPergunta ............................................................................................................................ 26 3.2.3.3 IntPesquisaMsgFim .............................................................................................................................. 27 3.2.3.4 IntPesquisaCategoriaCli ....................................................................................................................... 27 3.2.3.5 IntPesquisaGrupoTerminal ................................................................................................................... 28 3.2.3.6 IntPesquisaResposta ............................................................................................................................ 28

3.2.4 Conjunto de Produtos ................................................................................................................ 29 3.2.4.1 IntBaseAgrupProduto ........................................................................................................................... 29 3.2.4.2 IntBaseAgrupProdutoEstrMerc ............................................................................................................. 29 3.2.4.3 IntBaseAgrupProdutoPlu ...................................................................................................................... 30

3.2.5 Cadastro de Promoes ............................................................................................................ 30 3.2.5.1 IntProAgrupProduto .............................................................................................................................. 30 3.2.5.2 IntProAplicGift ....................................................................................................................................... 30 3.2.5.3 IntProBin ............................................................................................................................................... 31 3.2.5.4 IntProCartaoCredito .............................................................................................................................. 31 3.2.5.5 IntProCartaoCreditoBin ......................................................................................................................... 32 3.2.5.6 IntProClienteDiferenciado ..................................................................................................................... 32 3.2.5.7 IntProClienteDifPergunta ...................................................................................................................... 33 3.2.5.8 IntProCupomLayout .............................................................................................................................. 34 3.2.5.9 IntProCupomLayoutLinha ..................................................................................................................... 34 3.2.5.10 IntProCupomLayoutPromocao ............................................................................................................. 35 3.2.5.11 IntProDescParcialNoTotalFaixa ............................................................................................................ 35 3.2.5.12 IntProDescProgressivo ......................................................................................................................... 36 3.2.5.13 IntProDescProgressivoAgrup ............................................................................................................... 36


3.2.5.14 IntProDescProgressivoListaDesc ......................................................................................................... 36 3.2.5.15 IntProDescProgressivoProdutos ........................................................................................................... 37 3.2.5.16 IntProDisparo ........................................................................................................................................ 37 3.2.5.17 IntProEstruturaMercadologica .............................................................................................................. 39 3.2.5.18 IntProMensagemAssociada .................................................................................................................. 40 3.2.5.19 IntProPackVirtual .................................................................................................................................. 40 3.2.5.20 IntProPackVirtualAgrup ........................................................................................................................ 41 3.2.5.21 IntProPagtoParcialNoTotal ................................................................................................................... 41 3.2.5.22 IntProPagtoParcialNoTotalMsg ............................................................................................................ 42 3.2.5.23 IntProPagtoParcialTotCheq .................................................................................................................. 42 3.2.5.24 IntProPagtoTotal ................................................................................................................................... 42 3.2.5.25 IntProParamPlanoSugeridoTotal .......................................................................................................... 43 3.2.5.26 IntProPlanoTEF .................................................................................................................................... 43 3.2.5.27 IntProPlanoTEFParcelas ...................................................................................................................... 44 3.2.5.28 IntProPrecoDifCartao............................................................................................................................ 44 3.2.5.29 IntProPremio ......................................................................................................................................... 45 3.2.5.30 IntProPremioPorFaixa .......................................................................................................................... 47 3.2.5.31 IntProProduto ....................................................................................................................................... 47 3.2.5.32 IntProPromocao .................................................................................................................................... 48 3.2.5.33 IntProPromocaoCartaoCredito ............................................................................................................. 49 3.2.5.34 IntProPromocaoCategoria .................................................................................................................... 49 3.2.5.35 IntProPromocaoLoja ............................................................................................................................. 50 3.2.5.36 IntProPromocaoRelampagoProduto ..................................................................................................... 50 3.2.5.37 IntProSimulaDesc ................................................................................................................................. 50 3.2.5.38 IntProSimulaDescBin ............................................................................................................................ 51 3.2.5.39 IntProSimulaDescLoja .......................................................................................................................... 52 3.2.5.40 IntProTEF ............................................................................................................................................. 52 3.2.5.41 IntProTEFBin ........................................................................................................................................ 52 3.2.5.42 Orientaes para preenchimento ......................................................................................................... 53

3.3 Via Arquivo Texto ........................................................................................................................... 68 3.3.1 Cadastro de Produtos ................................................................................................................ 69

3.3.1.1 CADASTRO.ASC Principal ................................................................................................................ 69 3.3.1.2 CADASTRO.DUN Embalagem / Pack ............................................................................................... 71 3.3.1.3 CADASTRO.PRV Verso de preos ................................................................................................. 72 3.3.1.4 9999PRECO.ASC Alterao de preos ............................................................................................. 72 3.3.1.5 XXXXXXXXXXXXX.ETQ Etiqueta ..................................................................................................... 73 3.3.1.6 CADASTRO.CES Cesta de produtos ................................................................................................ 73

3.3.2 Cadastro de Promoo .............................................................................................................. 74 3.3.2.1 Instrues ............................................................................................................................................. 74 3.3.2.2 Header do arquivo (comum a todos os arquivos de importao) ......................................................... 77 3.3.2.3 Footer do arquivo (comum a todos os arquivos de importao) ........................................................... 77 3.3.2.4 Registro de categorias comum a todas as promoes (podem vir vrios) ........................................ 78 3.3.2.5 Registro de mensagem genrica para promoo de Pagamento Parcial no Total (Natal) ................... 78 3.3.2.6 Registro de parmetros genricos da promoo Plano Sugerido no Total........................................... 79 3.3.2.7 Parmetros gerais do Carto GifT ........................................................................................................ 79 3.3.2.8 Registro dos Bins para promoes Gift (podem vir vrios) ................................................................... 80 3.3.2.9 Promoo Pagamento parcial no total .................................................................................................. 81 3.3.2.10 Promoo Preo diferenciado .............................................................................................................. 86 3.3.2.11 Promoo Desconto no produto ........................................................................................................... 87 3.3.2.12 Promoo Desconto no total ................................................................................................................ 89 3.3.2.13 Promoo Relmpago .......................................................................................................................... 90 3.3.2.14 Promoo Pontuao no produto ......................................................................................................... 91 3.3.2.15 Promoo Pontuao no total .............................................................................................................. 92 3.3.2.16 Promoo Pontuao parcial no total ................................................................................................... 93 3.3.2.17 Promoo Pontuao no cupom .......................................................................................................... 94 3.3.2.18 Promoo Pontuao no Produto por Valor ......................................................................................... 95 3.3.2.19 Promoo Mensagem associada ......................................................................................................... 96 3.3.2.20 Promoo Cupom de desconto ............................................................................................................ 97 3.3.2.21 Promoo Desconto parcial no total por faixa ...................................................................................... 99 3.3.2.22 Promoo Condio de pagamento ................................................................................................... 101 3.3.2.23 Promoo Vale Brinde no total ........................................................................................................... 102 3.3.2.24 Promoo Vale Brinde Parcial ............................................................................................................ 107 3.3.2.25 Promoo Vale Brinde Parcial + Total ................................................................................................ 112 3.3.2.26 Promoo Vale Brinde por agrupamento............................................................................................ 118 3.3.2.27 Promoo Medicamentos com Receita .............................................................................................. 123 3.3.2.28 Promoo Pack Virtual ....................................................................................................................... 124 3.3.2.29 Promoo Plano Sugerido no total ..................................................................................................... 126 3.3.2.30 Promoo Compra Premiada ............................................................................................................. 128 3.3.2.31 Promoo Desconto Progressivo ....................................................................................................... 130


3.3.2.32 Promoo Preo Diferenciado com Carto ........................................................................................ 131 3.3.2.33 Parmetros Gerais para Simulao de Desconto ............................................................................... 133 3.3.2.34 Layout de impresso do cupom de ressarcimento (Mximo 10 registros) .......................................... 133 3.3.2.35 Cadastro de Bins para impresso do cupom de ressarcimento ......................................................... 134 3.3.2.36 Cadastro de Loja X Categoria Simulada............................................................................................. 134 3.3.2.37 Registro promoo X Loja .................................................................................................................. 135

3.3.3 Cadastro de Clientes ............................................................................................................... 135 3.3.3.1 Detalhe layout 00000 ....................................................................................................................... 135

3.3.4 Cadastro de Categoria de Clientes .......................................................................................... 136 3.3.5 Cadastro de Vendedores ......................................................................................................... 137

3.3.5.1 Header layout 00000 ....................................................................................................................... 137 3.3.5.2 Detalhe layout 00000 ....................................................................................................................... 137

3.3.6 Cadastro de Convnios ........................................................................................................... 137 3.3.6.1 XXXXXXXX.CNV Empresas conveniadas ....................................................................................... 137 3.3.6.2 XXXXXXXX.DSC Produtos com desconto ...................................................................................... 139 3.3.6.3 XXXXXXXX.BLQ Produtos bloqueados ........................................................................................... 140

3.3.7 Conjunto de Produtos .............................................................................................................. 141 3.3.7.1 cadastro.agr conjunto de produtos .................................................................................................. 141

4 Exportao ................................................................................................................ 143 4.1 Via BD tabelas de integrao .................................................................................................... 143

4.1.1 Dados disponibilizados atravs de tabelas de integrao ....................................................... 143 4.1.2 Criao e utilizao das tabelas de integrao ....................................................................... 145 4.1.3 Controle de exportao ............................................................................................................ 145

4.1.3.1 intControleExportao ........................................................................................................................ 145 4.1.4 Cupons de Vendas e Cancelamentos ..................................................................................... 145

4.1.4.1 intCupons Cupons de Vendas e Cancelamentos ............................................................................ 145 4.1.4.2 intItensCupons Itens de Cupons de Vendas e cancelamentos ........................................................ 148 4.1.4.3 intItensCuponsCesta Itens de uma Cesta ....................................................................................... 150

4.1.5 Pagamentos ............................................................................................................................. 151 4.1.5.1 intPagamentos Pagamentos ............................................................................................................ 151

4.1.6 Recebimentos .......................................................................................................................... 156 4.1.6.1 intRecebimentos Recebimentos ...................................................................................................... 156 4.1.6.2 intItensRecebimentos Itens de recebimentos .................................................................................. 157 4.1.6.3 intEstornoRecebimentos Estornos de recebimentos ....................................................................... 158 4.1.6.4 intEstornoItensRecebimentos Estornos de itens de recebimentos .................................................. 159

4.1.7 Recarga de celulares ............................................................................................................... 161 4.1.7.1 intRecargasCelulares Recargas de celulares .................................................................................. 161

4.1.8 Operadores .............................................................................................................................. 162 4.1.8.1 intOperador Operador ...................................................................................................................... 162 4.1.8.2 intOperadorFinaliz Operador por finalizadora .................................................................................. 164 4.1.8.3 intOperadorTipoRecebto Operador por tipo de recebimento ........................................................... 166 4.1.8.4 intOperadorTrib Operador por tributao ......................................................................................... 167

4.1.9 Sangria ..................................................................................................................................... 168 4.1.9.1 intSangria Sangria ........................................................................................................................... 168 4.1.9.2 intSangriaFinaliz Sangria por finalizao .......................................................................................... 169

4.1.10 Fechamento de movimentos.................................................................................................... 170 4.1.10.1 intFechoMovto .................................................................................................................................... 170

4.1.11 Reduo Z................................................................................................................................ 171 4.1.11.1 intReducaoZ ....................................................................................................................................... 171 4.1.11.2 intReducaoZTrib ................................................................................................................................. 172 4.1.11.3 intReducaoZRegistradores ................................................................................................................. 173

4.1.12 Promoo ................................................................................................................................. 173 4.1.12.1 intEPromocao ..................................................................................................................................... 174 4.1.12.2 intEPromocaoRelampago ................................................................................................................... 175 4.1.12.3 intEPromocaoPrecoDifCartao ............................................................................................................. 176 4.1.12.4 intEPromocaoPontos .......................................................................................................................... 176 4.1.12.5 intEPromocaoPlanoPreferencial ......................................................................................................... 177 4.1.12.6 intEPromocaoPackVirtual ................................................................................................................... 178 4.1.12.7 intEPromocaoPagtoParcialTotal (Natal) ............................................................................................. 179 4.1.12.8 intEPromocaoDescProgressivo .......................................................................................................... 180 4.1.12.9 intEPromocaoDescFaixa .................................................................................................................... 181 4.1.12.10 intEPromocaoDesc ........................................................................................................................ 183 4.1.12.11 intEPromocaoBrinde ...................................................................................................................... 188

4.1.13 Desconto .................................................................................................................................. 189 4.1.13.1 intEDesconto ...................................................................................................................................... 189 4.1.13.2 intEDescConvenioFX.......................................................................................................................... 190 4.1.13.3 intEDescCobertura ............................................................................................................................. 192


4.1.13.4 intEDescConvenioOPC ...................................................................................................................... 193 4.1.13.5 intEDescPBMS ................................................................................................................................... 194 4.1.13.6 intEDescBonusFidelidade ................................................................................................................... 195

4.2 Via Arquivo Texto ......................................................................................................................... 196 4.2.1 Estrutura do header padro ..................................................................................................... 197 4.2.2 Operadores .............................................................................................................................. 197

4.2.2.1 OPER.ASC Layout 23/24/25 ........................................................................................................... 198 4.2.3 Anlise de Vendas ................................................................................................................... 198

4.2.3.1 FINAL.ASC Layouts 23/24/25 .......................................................................................................... 198 4.2.3.2 AVD.ASC Layouts 23/24/25 ............................................................................................................ 199 4.2.3.3 TOTSECAN.ASC Layouts 23/24/25 ............................................................................................... 199 4.2.3.4 TOTSECVD.ASC Layouts 23/24/25 ............................................................................................... 199

4.2.4 Movimento de Itens .................................................................................................................. 199 4.2.4.1 ITEM.ASC Layout 30 ....................................................................................................................... 200 4.2.4.2 ITEAN.ASC Layout 30 .................................................................................................................... 200 4.2.4.3 ITEMANU.ASC Layout 30 ............................................................................................................... 201

4.2.5 Totais por terminal ................................................................................................................... 201 4.2.5.1 ECF.ASC Layout 23/24/25 ............................................................................................................. 201

4.2.6 Cheques/TEF recebidos .......................................................................................................... 202 4.2.6.1 CHCOMPL.ASC Layout 23/24/25 .................................................................................................... 202 4.2.6.2 TEFDET.ASC Layout 24/25 ............................................................................................................. 203

4.2.7 Recebimentos efetuados ......................................................................................................... 204 4.2.7.1 RECEBE.ASC Layout 23/24/25 ...................................................................................................... 204 4.2.7.2 ESTORNO.ASC Layout 23/24/25 .................................................................................................... 204

4.2.8 Milhagens ................................................................................................................................. 205 4.2.8.1 PONTOS.ASC Layout 23/24/25 ..................................................................................................... 205

4.2.9 Movimento do Dia .................................................................................................................... 205 4.2.9.1 MOVIMENT.ASC Layout 30 ............................................................................................................ 205

4.2.10 Movimento de anulados ........................................................................................................... 235 4.2.10.1 MOVIMANU.ASC Layouts 30 .......................................................................................................... 235

4.2.11 Cooperados.............................................................................................................................. 236 4.2.11.1 COOPEPAR.ASC Layout 23/24/25 ................................................................................................. 236

4.2.12 Vendedores .............................................................................................................................. 237 4.2.12.1 VENDD.ASC Layout 30 ................................................................................................................... 237 4.2.12.2 RESVEND.ASC Layout 23/24/25 .................................................................................................... 237

4.2.13 Vendas por PDV/Seo ........................................................................................................... 238 4.2.13.1 PDVSEC.ASC Layout 23/24/25 ....................................................................................................... 238

4.2.14 Vendas por Seo/Tributao ................................................................................................. 238 4.2.14.1 STRIBVD.ASC Layouts 23/24/25 .................................................................................................... 238 4.2.14.2 STRIBAN.ASC Layouts 23/24/25 .................................................................................................... 238

4.2.15 Vendas por Faixa Horria ........................................................................................................ 238 4.2.15.1 FAIXALOJ.ASC Layouts 23/24/25 ................................................................................................... 238

4.2.16 Sangria ..................................................................................................................................... 239 4.2.16.1 SANGRIA.ASC Layout 23/24 .......................................................................................................... 239

4.2.17 Recarga de celulares ............................................................................................................... 239 4.2.17.1 RECARGA.ASC ................................................................................................................................. 239

4.2.18 Pesquisa .................................................................................................................................. 239 4.2.18.1 PESQUISA.ASC Layout 23/24/25 .................................................................................................. 239

4.2.19 Ponto do Funcionrio ............................................................................................................... 240 4.2.19.1 PTOFUNC.ASC Layouts 23/24 ....................................................................................................... 240

4.2.20 Tabela de ndices Tcnicos ..................................................................................................... 240 4.2.20.1 TABPROD.TXT .................................................................................................................................. 241

4.2.21 Estoque .................................................................................................................................... 241 4.2.21.1 ESTOQUE.TXT .................................................................................................................................. 241

4.2.22 Fisco ......................................................................................................................................... 241 4.2.23 Arquivo de promoes ............................................................................................................. 241

4.2.23.1 MOVPROMO.ASC Layout compatvel com MOVIMENT.ASC ........................................................ 241

5 Transao Webservice ............................................................................................. 243 5.1 Proposta de layouts dos servios consumidos ............................................................................ 243

5.1.1 Consulta Cliente Estrutura 1 ................................................................................................. 244 5.1.2 Pr-venda Estrutura 2 ........................................................................................................... 247 5.1.3 Baixa na Pr-venda Estrutura 2 ............................................................................................ 252

6 Apndice A Tabelas .............................................................................................. 254 6.1 Tabela de Finalizadoras Unificadas ............................................................................................. 254 6.2 Tabela de tipos de promoo e desconto .................................................................................... 255


7 Histricos Anteriores ............................................................................................... 258


1 Prefcio

1.1 Descrio do Produto 1.1.1 Objetivo

Este documento tem como objetivo explicar todo o processo de integrao de dados no Sistema Itautec de Automao Comercial (SIAC).

1.1.2 Verso SIAC Este documento compatvel com a verso 4.05.00.05 do SIAC Store.

1.1.3 Conceito O SIAC Store um sistema WEB multiloja, com banco de dados centralizado, que permite

um controle no sistema da matriz de todas as lojas. Possui parte Server e client, com servidor centralizado e de lojas, de forma que as informaes podem ser acessadas de qualquer estao que possua um browser.

1.1.4 Benefcios

O SIAC Store um sistema para automao comercial que oferece ao empresrio, diversos recursos para auxililo na administrao de sua empresa e nas tomadas de decises em seu diaadia.

1.2 A quem se destina Este manual destinado a todos os tcnicos, desenvolvedores e suporte que utilizam o SIAC Store para realizar tarefas rotineiras de gesto e operao do sistema.


2 Requisitos

2.1 Plataformas Compatveis Sistema Operacional Microsoft Windows Server 2003 SP2 e Microsoft Windows Server 2008.

2.2 Requisitos de HW Os requisitos de hardware variam conforme arquitetura desejada no ambiente do cliente. O SIAC suporta uma arquitetura distribuda com um servidor Matriz, um ou mais servidores de Lojas e um ou mais servidores de Banco de Dados, todos conectados por uma rede com endereamento IP e uma combinao dessa distribuio, existindo inclusive a possibilidade de virtualizao para a aplicao Matriz, outra para a aplicao Lojas, etc.

2.3 Requisitos de SW Sistema Operacional: Microsoft Windows 2003 (Server) SP2 ou Microsoft Windows 2008 (Server). A base de dados instalada deve ser SQL Server 2000 SP4, SQL Server 2008 R2 ou Oracle 10G.


3 Importao

A importao de dados no SIAC Store pode ser feita de duas formas: por banco de dados ou por arquivo texto. O termo tabelas de integrao ser utilizado para denominar as tabelas BD do SIAC Store que fazem interface com sistemas externos. A interface via arquivo TXT est gradativamente sendo convertida para banco de dados. O mdulo Integrao SIAC atende os sistemas que mantm a interface via texto, convertendo e inserindo estes dados nas tabelas de integrao. O quadro nos itens Via BD tabelas de integrao, indica os tipos de dados que permitem atravs do Banco de dados.


3.1 Arquitetura para Importao

APLIC POS

BD SiacStore

Captura

BD SiacStore

MATRIZ/ LOJA

BD SiacStore

Tabelas de

integrao

Arquivos

para PDV

processamento

BD SiacStore

Movimento

processado

Arquivos texto

para Importao

------------------------------

Produtos

Etiquetas

Insumos

Cestas

Conjunto de Produtos

Promoo

Arquivos texto

para Importao

-----------------------

Convnio

Clientes

Vendedores

Categoria de Clientes

Siincronizao

Importao

pelo

SIAC Store

Importao

atravs do mdulo

Integrao SIAC


3.2 Via BD tabelas de integrao

Breve descrio

Tabelas de integrao so tabelas que fazem parte do banco de dados do SIAC Store e so utilizadas como interface entre o sistema SIAC STORE e um sistema externo para permitir a transferncia de dados entre os dois sistemas. Para importao de dados o sistema externo deve inserir os dados nas tabelas conforme o tipo de cadastro que ser atualizado.

Para acesso as tabelas do banco de dados o usurio/user siacext e a senha/password siacstore.

A tabela a seguir relaciona os cadastros que podem ser atualizados por importao de arquivo texto.

Tipo de Dados: Permite importao via BD:

Tabelas utilizadas:

Cadastro de Produtos Sim

IntPluProduto IntPluCodigo IntPluProdutoAssociado IntPluProdutoLoja IntPluPrecoLoja

Alterao de preo Sim IntPluPrecoLoja Embalagem/Pack/DUN Sim IntPluDun Verso de preo de produto Sim IntPluVersaoPrecoLoja

Insumos Sim IntPluInsumo IntPluProdutoInsumo

Etiquetas Sim IntPluUnidadeConverso IntPluProdutoLojaEtiqueta

Cesta Sim IntPluCesta IntPluComponente IntPluComponentePrecoLoja

Regras Fiscais NFe Disponvel via arquivo texto

Cadastro de Promoes Sim Tabelas que iniciam com IntPro


Cadastro de Clientes Disponvel via arquivo texto

Cadastro de Categoria de Clientes Disponvel via arquivo texto

Cadastro de Vendedores Disponvel via arquivo texto

Cadastro de Convnios Disponvel via arquivo texto

Pesquisa Sim

IntPesquisa IntPesquisaPergunta IntPesquisaMsgFim IntPesquisaCategoriaCli IntPesquisaGrupoTerminal IntPesquisaResposta

Conjunto de produtos Sim

IntBaseAgrupamentoProduto IntBaseAgrupamentoProdutoEstrMerc IntBaseAgrupamentoProdutoPlu

3.2.1 Controle de Importao

3.2.1.1 IntControle

Esta tabela permite o controle do processo de importao via BD de um ou vrios mdulos. O sistema externo informa o incio e o fim da insero de dados nas tabelas de integrao, atravs do campo codStatus. O SIAC atravs da consulta a esta tabela pode constatar que a insero de dados foi concluda para iniciar a importao dos dados para a tabela definitiva do BD.

Tabela de Controle do Processo de Importao IntControle

Descrio Formato Oracle

Formato SQL

Observao

idProcesso (PK) NUMBER(10) BIGINT Nmero incremental, nico e circular, valor >= 1 Campo autonumerado pelo prprio banco de dados que incrementa o valor deste campo toda vez que um novo registro inserido. Este campo utilizado para controlar o processo de importao, separando o contedo total a ser importado em contedos menores.

codModulo NUMBER(2) TINYINT codModulo da tabela caModulo


14 Produto 31 Pesquisa 32 Promoo 34 Conjunto de produtos

codLoja NUMBER(4) SMALLINT Deve conter o cdigo de uma loja ou o nmero zero quando se referenciar a todas as lojas.

=0 Dados a todas as lojas >0 Cdigo da loja. Para Produtos (codModulo=14) o cdigo da loja deve ser sempre > 0. Para Pesquisa este campo no utilizado

codStatus NUMBER(1) TINYINT 1 Incluso em processo (alterado pelo cliente) 2 Incluso finalizada (alterado pelo cliente) 3 Processado (alterado pelo SIAC STORE)

dtHrProcesso TIMESTAMP DATETIME

Data e hora de incluso do processo para importao pelo sistema externo.

indicImpIntegracaoSiac

CHAR(1) CHAR(1) Indica se os dados nas tabelas de integrao foram inseridos pelo mdulo IntegraoSIAC S Sim N No este valor deve ser usado pelos sistemas externos que inserem dados diretamente nas tabelas de integrao.

Os campos abaixo fazem parte de algumas tabelas de integrao detalhadas a seguir e so usadas para controle da importao de dados. Esto descritas aqui, pois tem tratamento padro independente da tabela a que pertencem.

Descrio Formato Oracle

Formato SQL

Observao

idProcesso (PK) NUMBER(10) BIGINT Identifica em qual processo de importao (idProcesso da IntControle) o registro pertence. Atravs deste campo mapeia o conjunto de registros e tabelas pertencentes ao mesmo processo de importao.

codOperacao CHAR(1) CHAR(1) Indica IIncluso e EExcluso do registro. codValidado NUMBER(1) NUMERIC(

1) Cdigo que indica se o registro foi validado: 1 invlido 0 inserido pelo cliente 1 reconhecido 2 processado

3.2.1.2 Consulta ao log de importao

Para o sistema externo consultar o resultado da importao, deve executar as Stored Procedures abaixo atravs do usurio de login siacext:

SP_ConsultaResultImportacao

Parmetro Formato Oracle

Formato SQL

Valores vlidos


idProcesso NUMBER(10) NUMERIC(10)

Se =0, a consulta de qualquer processo Seno >0, especifica qual o processo.

codModulo NUMBER(2) NUMERIC(2)

Se =0 a consulta para todos os mdulos =14 Produto, =31 Pesquisa, =34 Conjunto de produto

codLoja NUMBER(4) NUMERIC(4)

Se =0, a consulta referese a qualquer loja Seno >0, especifica qual a loja.

Essa Stored Procedure retornar um ou mais registros contendo as seguintes informaes:

Campos Formato Oracle

Formato SQL

Observao


Nmero do processo da importao


Cdigo da loja


Cdigo do Mdulo

codStatus NUMBER(1) TINYINT 1"Importando..." 2"Importado com ocorrncias." 3"Importado." 4"Falha na importao."

dataInicio CHAR(8) VARCHAR(8)

Data incio da importao no formato aaaammdd.

dataFim CHAR(8) VARCHAR(8)

Data Fim da importao no formato aaaammdd pode ser NULL quando ainda est com status importando.

horaInicio CHAR(6) VARCHAR(8)

Hora Incio da importao no formato hh:mm:ss.

horaFim CHAR(6) VARCHAR(8)

Hora Fim da importao no formato hh:mm:ss, pode ser NULL quando ainda est com status importando.

descErro VARCHAR (255)

VARCHAR(255)

Descrio do Erro ser NULL quando no houver nenhum erro. Principalmente quando o status est em: 1Importando ou 3Importado.

SP_ConsultaInfoImportacao


Formato SQL

Valores vlidos





Se =0 a consulta para todos os mdulos =14 Produto, =31 Pesquisa, =34 Conjunto de produto



Essa Stored Procedure retornar um ou mais registros contendo as seguintes informaes:


Formato SQL

Valores vlidos


Nmero do processo da importao


Cdigo do Mdulo


Cdigo da loja

codStatus NUMBER(1) TINYINT 1"Importando..." 2"Importado com ocorrncias." 3"Importado." 4"Falha na importao."

descInformativa VARCHAR2(255)

VARCHAR(255)

Descrio das Informativas

qtdeRegistros NUMBER(10) INT Quantidade de registros por informativa.

3.2.2 Cadastro de Produtos

3.2.2.1 IntPluProduto Sero descritos o domnio dos campos dos campos das tabelas de integrao de produtos, que devero ser preenchidas pelo Sistema Externo.

Campo Formato Oracle

Formato SQL

Descrio

idProcesso (PK) NUMBER(10) INT Identificao do processo de importao codInterno (PK) NUMBER(19) BIGINT Cdigo interno de at 14 dgitos codElemento NUMBER(10) INT Seo do produto descEmbalagem VARCHAR2(

11) VARCHAR(11)

Embalagem

codUnidade VARCHAR2(2)

VARCHAR(2)

Unidade M metro KG quilograma L litro M3 metro cbico UN unidade

descProduto VARCHAR2 (40)

VARCHAR(40)

Descrio completa: a descrio completa do produto no cadastro de PLU.


descResumida VARCHAR2 (20)

VARCHAR(20)

Descrio resumida: a descrio no cadastro de PLU que ser enviada ao PDV para descrio do produto impressa no cupom, etiquetas etc.

indicMarcaPropria CHAR (01) CHAR(1) Produto de marca prpria: SSim NNo

indicPisCofinsZero CHAR(01) CHAR(1) Pis/Cofins 0% : SSim NNo

codTipoProduto NUMBER(05)

SMALLINT Tipo do produto: 00 Normal 01 Peso varivel 02 Combustvel 03 Cesta 04 Quantidade varivel 05 Revista 06 Medicamentos c/ receita 07 Genrico 08 Estacionamento 09 Vale 10 Normal c/controle quantidade

codOrigemProduto CHAR(1)

CHAR(1) Origem do produto: 0 Nacional 1 Estrangeira direta 2 Estrangeira no mercado interno

codGrupo NUMBER(05) SMALLINT Cdigo do Grupo 0000 Grupo no definido >0000 define um grupo para o conjunto de produtos. Se o campo codSubgrupo>0000, este campo tambm deve ser >0000

codSubGrupo NUMBER(05) SMALLINT Cdigo do Subgrupo 0000 SubGrupo no definido >0000 define um SubGrupo para o conjunto de produtos

indicGerarCodPesoVar CHAR(01) CHAR(1) Flag se gera cd. peso varivel: SSim NNo

indicPesagemObrigatoria CHAR(01) CHAR(1) Flag se quant. Obrigatria: SSim NNo

dtForaLinha TIMESTAMP DATETIME

Data no formato yyyymmdd

indicProducaoPropria CHAR(01) CHAR(1) Produto de produo prpria: SSim NNo (default)

NCM NUMBER(10) NUMERIC(10)

NCM

codValidado NUMBER(01) NUMERIC(1)

Cdigo que indica se o registro foi validado: 1 invlido 0 inserido pelo cliente 1 reconhecido 2 processado

percPis NUMBER(6,4)

NUMERIC(6,4)

Alquota do PIS para o produto

percCofins NUMBER(6,4)

NUMERIC(6,4)

Alquota do COFINS para o produto

indicAlertaQuantidade CHAR(01)

CHAR(1) Indica se o sistema deve apresentar o alerta de quantidade para o operador: SSim


NNo

3.2.2.2 IntPluCodigo Associa cdigos de venda a um produto identificado pelo cdigo interno.


Formato SQL

Descrio

idProcesso (PK) NUMBER(10) INT Identificao do processo de importao codVenda (PK) NUMBER(19)

BIGINT Cdigo EAN: Se codTipo=1 ento codVenda um EAN e tem no mximo 14 dgitos. Se codTipo=2 ento codVenda um cdigo PLU e tem no mximo 4 dgitos. Se codTipo=3 ento codVenda um cdigo interno e tem no mximo 14 dgitos.

codInterno NUMBER(19) BIGINT Cdigo interno de at 14 dgitos codTipo CHAR(1)

CHAR(1) Indica se o codVenda um EAN ou um cdigo de PLU. Onde: 1Tipo EAN 2Tipo PLU 3Tipo Interno

codOperacao CHAR(1) CHAR(1) Tipo de operao efetuada: I Insero E Excluso



3.2.2.3 IntPluDun Associa cdigos de embalagem (codDun) (cdigos de venda +quantidade)


Formato SQL

Descrio

idProcesso (PK)

NUMBER(10) INT Identificao do processo de importao

codDun (PK) NUMBER(19) BIGINT Pode ser um EAN ou um DUN de at 14 dgitos.

codVenda NUMBER(19) BIGINT Cdigo de venda do produto de at 14 dgitos.

qtdeProduto SMALLINT Quantidade de produtos pertencentes ao DUN. O intervalo vlido de 2 a 999




3.2.2.4 IntPluProdutoAssociado Associa um produto a um produto principal.


Exemplo: Bebida(produto principal) + vasilhame(produto associado) Campo Formato

Oracle Formato

SQL Descrio

idProcesso (PK) NUMBER(10) INT Identificao do processo de importao codInterno (PK) NUMBER(19) BIGINT Cdigo interno de at 14 dgitos codInternoAssociado

NUMBER(19) BIGINT Produto associado, no pode ser um produto que est como codInterno (PK) nesta tabela, de at 14 dgitos




3.2.2.5 IntPluInsumo Define os produtos que sero usados como insumo de outro produto manufaturado. Exemplo: produto po usa como insumo farinha, acar, etc.


Formato SQL

Descrio

idProcesso (PK)


codInternoProduto (PK)

NUMBER(19) BIGINT Cdigo interno de at 14 dgitos descricao VARCHAR2(

40) VARCHAR(40)

Descrio do produto insumo

Unidade CHAR (2) CHAR(2) Unidade do produto insumo

3.2.2.6 IntPluProdutoInsumo Define os insumos com quantidade utilizado na produo de um produto.


Formato SQL

Descrio

idProcesso (PK) NUMBER(10) INT Identificao do processo de importao codInternoProduto (PK)

NUMBER(19) BIGINT Cdigo interno de at 14 dgitos

codigoInsumo (PK)

NUMBER(19) BIGINT Produto Insumo Cdigo interno de at 14 dgitos

vlrQuantidade NUMBER(9,3)

NUMERIC(9,3)

Quantidade de insumo com 3 casas decimais.





3.2.2.7 IntPluProdutoLoja Define os atributos especficos de um produto por loja.


Formato SQL

Descrio

idProcesso (PK) NUMBER(10) INT Identificao do processo de importao codInterno (PK) NUMBER(19) BIGINT Cdigo interno de at 14 dgitos codLoja (PK) NUMBER(4) NUMERIC(

4) Identificao da loja

indicPermiteDigitacaoPreco

CHAR(1) CHAR(1) Flag se digita preo: SSim NNo

indicPermiteDigitacaoDesconto

CHAR(1) CHAR(1) Flag se permitido desconto: SSim NNo

codDigitaQtde CHAR(1)

CHAR(1) Flag se permite digitao da quantidade: 0No Permite 1Obrigatria 2Autorizada




codLegenda VARCHAR2(3)

VARCHAR(3)

Tributao: FSubstituio Tributria IIsento NNo Antecipado T0...T4Tributao

IndicVendeCodInterno

CHAR(1) CHAR(1) Flag se permite vender produto pelo cdigo interno SSim NNo

indicPermitePorPreVenda

CHAR(1) CHAR(1) Indica se o produto s pode ser vendido dentro de uma pr venda SSim NNo (default)

3.2.2.8 IntPluPrecoLoja Define os preos do produto a serem praticados na loja.


Formato SQL

Descrio

idProcesso (PK)


codInterno (PK) NUMBER(19) BIGINT Cdigo interno de at 14 dgitos dtInicioValidade(PK)

TIMESTAMP DATETIME

Data no formato yyyymmdd, a hora deve ser preenchida com zeros.

codLoja (PK) NUMBER(4) NUMERIC(4)

Identificao da loja

valorPrecoVenda NUMBER(11,3)

NUMERIC(11,3)

Preo, com 3 casas decimais.

valorPrecoCusto NUMBER(11,2)

NUMERIC(11,2)

Custo, com 2 casas decimais.





3.2.2.9 IntPluVersaoPrecoLoja Esta tabela para uma necessidade exclusiva e no impacta na operao de venda de produtos. Permite associar mais de um preo para produtos de preo de peso varivel.


Formato SQL

Descrio

idProcesso (PK)


codInterno (PK) NUMBER(19) BIGINT Cdigo interno de at 14 dgitos. Somente para produtos de peso varivel.

dtInicioValidade (PK)

TIMESTAMP DATETIME

Data no formato yyyymmdd, a hora deve ser preenchida com zeros

codLoja (PK) NUMBER(4) NUMERIC(4)

Identificao da loja

valorPrecoVersao1

NUMBER(11,2)

NUMERIC(11,3)

Preo, com 2 decimais.

valorPrecoVersao2

NUMBER(11,2)

NUMERIC(11,3)


valorPrecoVersao3

NUMBER(11,2)

NUMERIC(11,3)





3.2.2.10 IntPluPrecoAtacadoLoja


Formato SQL

Descrio

idProcesso (PK)


codInterno (PK) NUMBER(19) BIGINT Cdigo interno de at 14 dgitos. Somente para produtos de peso varivel.


TIMESTAMP DATATIME

Data no formato yyyymmdd, a hora deve ser preenchida com zeros

codLoja(PK) NUMBER(4) SMALLINT Identificao da loja quantidade NUMBER(6,3

) NUMERIC(6,3)

Quantidade de produtos que determina a venda pelo preo de atacado, com 3 casas decimais.


valorPrecoAtacado

NUMBER(10,2)

NUMERICO(10,2)

Preo de atacado, com 2 decimais.




3.2.2.11 IntPluUnidadeConversao Campo Formato

Oracle Formato

SQL Descrio

idProcesso (PK) NUMBER(10) INT Identificao do processo de importao codInterno (PK) NUMBER(19) BIGINT Cdigo interno de at 14 dgitos qtde NUMBER(6) NUMERIC(

6) Quantidade unitrio do produto

unidade VARCHAR2(3)

VARCHAR(3)

Unidade do Produto: l, ml, mcg, g, Kg, etc.

qtdeConversao NUMBER(6) NUMERIC(6)

Quantidade usada para o clculo da converso em outra unidade do produto

unidadeConversao

VARCHAR2(3)

VARCHAR(3)

Unidade para a qual o produto ser convertido




3.2.2.12 IntPluProdutoLojaEtiqueta Define os atributos para o mdulo de emisso de etiquetas.


Formato SQL

Descrio

idProcesso (PK) NUMBER(10) INT Identificao do processo de importao codInterno (PK) NUMBER(19) BIGINT Cdigo interno de at 14 dgitos codLoja (PK) NUMBER(4) NUMERIC(


qtdeEtiqueta NUMBER(5) SMALLINT Quantidade de etiquetas. Intervalo vlido de 1 a 99.

descInformacaoExtra

VARCHAR2(50)

VARCHAR(50)

Informaes extras


codValidado CHAR(1) NUMERIC(1)



3.2.2.13 IntPluCestaLoja Campo Formato

Oracle Formato

SQL Descrio

idProcesso (PK) NUMBER(10) INT Identificao do processo de importao codCesta (PK) NUMBER(19) BIGINT Cdigo interno da cesta de at 14 dgitos codLoja (PK) NUMBER(4) NUMERIC(


codOperacao CHAR(01) CHAR(1)

Tipo de operao efetuada: I Insero E Excluso

codValidado NUMBER(1)

NUMERIC(1)


3.2.2.14 IntPluCestaComponente


Formato SQL

Descrio

idProcesso (PK) NUMBER(10) INT Identificao do processo de importao codCesta (PK) NUMBER(19) BIGINT Cdigo da cesta de at 14 dgitos codInternoProduto (PK)

NUMBER(19) BIGINT Produto da cesta de at 14 dgitos

qtdeProduto NUMBER(6,3)

NUMERIC(6,3)

Quantidade de produtos, com 3 casas decimais.




3.2.2.15 IntPluCestaCompPrecoLoja


Formato SQL

Descrio

idProcesso (PK) NUMBER(10) INT Identificao do processo de importao codCesta (PK) NUMBER(19) BIGINT Cdigo da cesta de at 14 dgitos codInternoProduto (PK)

NUMBER(19) BIGINT Produto da cesta de at 14 dgitos codLoja (PK) NUMBER(4) NUMERIC(



TIMESTAMP DATETIME

Data no formato yyyymmdd, a hora deve ser preenchida com zeros.

valorPrecoComponenteCesta

NUMBER(11,3)

NUMERIC(11,3)

Preo unitrio do componente da cesta, com 3 casas decimais.





3.2.3 Pesquisa

As tabelas de integrao descrevem os dados para importao para mdulo de pesquisas. A tabela intControle permite o controle do processo de insero de dados das tabelas a seguir.

3.2.3.1 IntPesquisa


Formato SQL

Descrio

IdProcesso(PK) NUMBER(10) BIGINT Identificao do processo de importao CodPesquisa(PK)

NUMBER(10) INT Cdigo da pesquisa de at 6 dgitos

codOperacao CHAR(1) CHAR(1) I (incluso) E (excluso)

descPesquisa VARCHAR2(35)

VARCHAR(35)

Descrio da pesquisa

dtInicio TIMESTAMP DATETIME

Data incio do perodo de vigncia da pesquisa. Formato yyyymmdd, a hora deve ser preenchida com zeros.

dtFim TIMESTAMP DATETIME

Data fim do perodo de vigncia da pesquisa

IndicAtivacaoAutomatica

NUMBER(1) TINYINT 1 (automtica) 0 (manual)

qtdeEntrevista NUMBER(5) INT Quantidade mxima de pesquisa em um dia de movimento

indicAplicarInicioCupom

NUMBER(1) TINYINT Define se aplicao automtica ou ativada pelo operador 1 (automtica) 0 (manual)

codDiaSemana VACHAR2(7) VARCHAR(7)

A primeira posio esquerda representa o domingo, depois a segundafeira, e assim at o sbado. O valor de cada posio : 1 (executar a pesquisa) 0 (no executar a pesquisa)

codTipoTerminal VARCHAR2(3)

VARCHAR(3)

A primeira posio esquerda representa o tipo supermercado, depois magazine e por ltimo o posto. O valor de cada posio : 1 (executar a pesquisa) 0 (no executar a pesquisa)

codFaixaHoraria VARCHAR2(24)

VARCHAR(24)

Este campo representa os 24 intervalos de 1 hora existente num dia. A primeira posio esquerda representa a faixa 00:00, depois a faixa 01:00, e assim at a ltima faixa 23:00. O valor de cada posio : 1 (executar a pesquisa)


0 (no executar a pesquisa) valorReferencia NUMBER(13,

2) NUMERIC(13,2)

Valor base para comparao com valor da compra cujo critrio est definido no campo indicSuperiorInferior

indicSuperiorInferior

NUMBER(1) TINYINT 1 (indica que a compra deve ser maior ou igual ao valor de referncia) 0 (indica que a compra deve ser menor ou igual ao valor de referncia)

indicTrataQtdeCancel

NUMBER(1) TINYINT 1 (trata a qtde de cancelamentos consecutivos da pesquisa) 0 (no trata)

qtdeCancel NUMBER(3) SMALLINT Quantidade de cancelamentos consecutivos indicMsgFim NUMBER(1) TINYINT 1 (existir mensagem de agradecimento)

0 (no existir mensagem) qtdeTempoMsgFim

NUMBER(3) SMALLINT Tempo de exibio da mensagem em segundos

indicInterrompeMsgFim

NUMBER(1) TINYINT 1 (mensagem de agradecimento poder ser interrompida por tecla) 0 (mensagem de agradecimento no poder ser interrompida)

indicRespostaNoPinPad

NUMBER(1) TINYINT 1 (indica que as respostas das perguntas sero obtidas no PinPad) 0 (indica que as respostas das perguntas sero obtidas pelo teclado operador)

OBS: Este campo ser tratado na validao, mas a sua funcionalidade no ser criada neste projeto.

indicIdentPorCPFObrigatoria

NUMBER(1) TINYINT 1 (indica que o cliente deve ter sido identificado pelo CPF para que a pesquisa possa ser concedida a ele) 0 (indica que no h a necessidade do cliente deve ter sido identificado pelo CPF para que a pesquisa possa ser concedida a ele)

OBS: Este campo ser tratado na validao, mas a sua funcionalidade no ser criada neste projeto.

Obs.: - Se o campo codOperacao tiver o valor E, nenhum outro campo ser validado

desta tabela ou das demais tabelas de integrao, e os registros relacionados a esta pesquisa na base de dados do SIAC STORE sero eliminados;

- Se o campo codOperacao tiver o valor I e j existir uma pesquisa de mesmo cdigo na base de dados do SIAC STORE, ocorrer uma alterao de todos os atributos que compem a pesquisa (dados gerais, perguntas, repostas, categoria de clientes, grupos de terminais associados pesquisa), isto , os dados atuais sero descartados e sero assumidos os dados desta importao;

3.2.3.2 IntPesquisaPergunta


Formato SQL

Descrio

idProcesso(PK) NUMBER(10) BIGINT Identificao do processo de importao codPesquisa(PK) NUMBER(10) INT Cdigo da pesquisa de at 6 dgitos codPergunta(PK) NUMBER(3) TINYINT Cdigo da pergunta de at 2 dgitos codLoja(PK) NUMBER(4) SMALLINT Deve ser igual a zero quando a

pergunta/resposta da pesquisa for


independente de loja especfica. descPerguntaLinha1

VARCHAR2(35)

VARCHAR(35)

Texto da pergunta para linha 1 do display cliente

descPerguntaLinha2

VARCHAR2(35)

VARCHAR(35)

Texto da pergunta para linha 2 do display cliente

codTipoResposta CHAR(1) CHAR(1) S (seleo) D (digitao)

descRotuloOperador

VARCHAR2(15)

VARCHAR(15)

Mensagem para Operador

codTipoDigitacao CHAR(1) CHAR(1) D (data) N (numrico) V (valor) (em branco se o tipo da resposta for seleo)

numTamanhoDigitacao

NUMBER(3) SMALLINT Define o tamanho da resposta (quando TipoResposta = D)

3.2.3.3 IntPesquisaMsgFim Permite definir uma mensagem de agradecimento de at 11 linhas


Formato SQL

Descrio

idProcesso(PK) NUMBER(10)

BIGINT Identificao do processo de importao

codPesquisa(PK)

NUMBER(10)

INT Cdigo da pesquisa de at 6 dgitos

numLinha(PK) NUMBER(2)

SMALLINT Nmero da linha de apresentao da mensagem de agradecimento na tela do display cliente 1 a 11

descLinha VARCHAR2(35)

VARCHAR(35)

Mensagem de agradecimento na tela do display cliente

3.2.3.4 IntPesquisaCategoriaCli

Existem as seguintes categorias prdefinidas geradas pelo aplicativo de PDV em funo da operao de identificao do cliente: 9999 cliente que se identifica no incio da compra e no tem um grupo definido na transao de fidelidade; 0000 cliente que no se identificou no incio da compra, isto , a identificao foi cancelada com a tecla ;


Formato SQL

Descrio

idProcesso NUMBER(10)



codPesquisa NUMBER(10)


codCategoriaCliente

NUMBER(5) INT Cdigos de categoria de 4 dgitos

3.2.3.5 IntPesquisaGrupoTerminal

Esta tabela est desnormalizada.


Formato SQL

Descrio

idProcesso(PK) NUMBER(10)


codPesquisa(PK)

NUMBER(10)


codLoja(PK) NUMBER(4) SMALLINT Deve ser igual a zero quando a pergunta/resposta da pesquisa for independente de loja especfica.

numTerminal(PK)

NUMBER(3) SMALLINT Nmero de terminal cadastrado na loja

codGrupoTerminal

NUMBER(5) INT Define um nmero para o grupo de terminais para pesquisa.

qtdeClienteDisparo

NUMBER(5) INT Define a quantidade de clientes para disparo dentro do grupo de terminais

3.2.3.6 IntPesquisaResposta Campo Formato

Oracle Formato

SQL Descrio

IdProcesso(PK) NUMBER(10)


codPesquisa(PK)

NUMBER(10)


codPergunta(PK)

NUMBER(3) TINYINT Cdigo da pergunta de at 2 dgitos

codLoja(PK) NUMBER(4) SMALLINT Deve ser igual a zero quando a pergunta/resposta da pesquisa for independente de loja especfica.

codResposta(PK)

NUMBER(3) TINYINT Cdigo da resposta de 1 dgito. (Tipo Seleo) 1 a 9

descResposta VARCHAR2(35)

VARCHAR(35)

Texto da resposta associada ao cdigo da resposta


3.2.4 Conjunto de Produtos

Este conjunto de tabelas para integrao do cadastro de Conjunto de produtos. O Conjunto de Produtos fica associado a uma forma de pagamento como restrio de compra.

3.2.4.1 IntBaseAgrupProduto


Formato SQL

Descrio

IdProcesso (PK) NUMBER(19) BIGINT Identificao do processo de importao CodAgrupamento (PK)

NUMBER(19)

BIGINT Cdigo do conjunto de produtos De at 6 dgitos. Preencher com zeros esquerda ex.: 000001

codOperacao CHAR(1) CHAR(1) Tipo de Operao I Insero D Excluso

nomeAgrupamento

VARCHAR2(20)

VARCHAR(20)

Alfanumrico Ex.: Carto Mame Campo informativo Se no vier preenchido, o sistema ir assumir o cdigo do Conjunto como o nome.

indicHabilitado CHAR(1) CHAR(1) Habilitado S sim N no

3.2.4.2 IntBaseAgrupProdutoEstrMerc


Formato SQL

Descrio


NUMBER(19) BIGINT Cdigo do conjunto de produtos De at 6 dgitos. Preencher com zeros esquerda ex.: 000001

CodElemento (PK)

NUMBER(4) INT Cdigo da seo selecionada para o conjunto de produtos

CodGrupo (PK) NUMBER(4) SMALLINT 0000 indica que no ser consistido o Grupo >0000 define um grupo para o conjunto de produtos. Se o campo codSubgrupo >0000 este campo tambm deve ser >0000

codSubGrupo (PK)

NUMBER(4) SMALLINT 0000 indica que no ser consistido o SubGrupo >0000 define um SubGrupo para o conjunto de produtos

indicMarcaPropria

CHAR(1) CHAR(1) Indica se o conjunto de produtos considera marca prpria 0 Todos Default 1 Sim 2 No

codTipoProdutoAgrupamento

CHAR(1) CHAR(1) Cdigo do tipo de conjunto fixo para esta tabela 1 Estrutura mercadolgica (seo)


3.2.4.3 IntBaseAgrupProdutoPlu


Formato SQL

Descrio


NUMBER(19) BIGINT Cdigo do conjunto de produtos codInterno (PK) NUMBER(19) BIGINT Cdigo interno do produto de at 14 dgitos. codAutorizador NUMBER(9) INT Cdigo do autorizador de at 5 dgitos.

Para utilizao futura pelo TicketCard codTipoProdutoAgrupamento

CHAR(1) CHAR(1) Cdigo do tipo de conjunto fixo para esta tabela 0 cdigo interno do produto

3.2.5 Cadastro de Promoes

Sero descritos o domnio dos campos das tabelas de integrao de promoes, que devero ser preenchidas pelo Sistema Externo.

3.2.5.1 IntProAgrupProduto

Armazena os agrupamentos de produtos para as promoes.


Formato SQL

Descrio

idProcesso (PK) NUMBER(10) NUMERIC(10)

Identificao do processo de importao (FK IntProPromocao -> idProcesso)

codOperacao (PK) CHAR(1) CHAR(1)

Tipo de operao efetuada: I Insero E Excluso (FK IntProPromocao -> codOperacao)

codPromocao (PK)

NUMBER(10)

NUMERIC(10)

Cdigo da promoo de at 8 dgitos. (FK IntProPromocao -> codPromocao)

codProduto (PK) NUMBER(14) NUMERIC(14) Cdigo interno de at 14 dgitos.

codAgrup NUMBER(7) NUMERIC(7) Cdigo do agrupamento at 7 dgitos.

3.2.5.2 IntProAplicGift

Representa a configurao do carto gift.


Formato SQL

Descrio



Identificao do processo de importao (FK IntProCartaoCredito -> idProcesso)


Tipo de operao efetuada: I Insero E Excluso (FK IntProCartaoCredito -> codOperacao)

codProduto (PK) NUMBER(14) NUMERIC(14) Cdigo interno de at 14 dgitos

codCartaoCredito NUMBER(6) NUMERIC(6) Cdigo do carto de crdito de at 6 dgitos. (FK IntProCartaoCredito -> codCartaoCredito)

promptCartaoGift VARCHAR2(30) VARCHAR(30) Prompt do carto gift.

3.2.5.3 IntProBin

Representa os Bins da promoo.


Formato SQL

Descrio





codPromocao (PK)

NUMBER(10)

NUMERIC(10)


nroBin (PK) VARCHAR2(6) VARCHAR (6) Nmero do Bin de at 6 dgitos. nroLogo VARCHAR2(2)

VARCHAR(2) Nmero do Logo de at 2 dgitos.

3.2.5.4 IntProCartaoCredito

Representa os cartes de crdito da promoo.


Formato SQL

Descrio

idProcesso (PK) NUMBER(10) NUMERIC(10) Identificao do processo de importao



codCartaoCredito (PK) NUMBER(6)

NUMERIC(6) Cdigo do carto de crdito de at 6 dgitos.

indicHabilitado VARCHAR2(1) VARCHAR(1)

Indica que o carto de crdito est habilitado. S Sim N - No


codModificador NUMBER(1) NUMERIC(1) Cdigo do modificador. 1 Disparo 2 Prmio

codTipoOperacao NUMBER(1) NUMERIC(1) Cdigo tipo operao. 1 Soma 2 Multiplicao

nroFator NUMBER(10, 2)

NUMERIC (10, 2)

Nmero fator. Vlido somente se o campo codModificador for igual a 2 (Prmio)

codTipoPagtoMinimo

NUMBER(1) NUMERIC(1) Cdigo tipo pagamento mnimo. 1 Percentual 2 Valor

valorPagtoMinimo NUMBER(11, 2)

NUMERIC(11, 2) Valor pagamento mnimo.

codTipoConsulta NUMBER(1) NUMERIC(1) Cdigo tipo consulta. 0 No consulta 1 Consulta fidelidade

3.2.5.5 IntProCartaoCreditoBin

Representa os Bins associados aos cartes de crdito da promoo.


Formato SQL

Descrio


Identificao do processo de importao (FK IntProCartaoCredito -> idProcesso)


Tipo de operao efetuada: I Insero E Excluso (FK IntProCartaoCredito -> codOperacao)

codCartaoCredito (PK) NUMBER(6)

NUMERIC(6)

Cdigo do carto de crdito de at 6 dgitos. (FK IntProCartaoCredito -> codCartaoCredito)

nroBin (PK) VARCHAR2(6) VARCHAR(6) Nmero do Bin de at 6 dgitos.

nroLogo VARCHAR2(2) VARCHAR(2) Nmero do Logo de at 2 dgitos.

3.2.5.6 IntProClienteDiferenciado

Representa a associao do layout de cupom para Cliente Diferenciado.


Formato SQL

Descrio


Identificao do processo de importao (FK IntProPromocao -> idProcesso) (FK IntProCupomLayout -> idProcesso)



Tipo de operao efetuada: I Insero E Excluso (FK IntProPromocao -> codOperacao) (FK IntProCupomLayout -> codOperacao)

codPromocao (PK)

NUMBER(10)

NUMERIC(10)


codLayout NUMBER(6) NUMERIC(6) Cdigo do layout de at 6 dgitos. (FK IntProCupomLayout -> codLayout)

indicHabilitado VARCHAR2(1) VARCHAR(1)

Indica se est habilitado. S Sim N - No

indicApresentaPergunta

VARCHAR2(1)

VARCHAR(1)

Indica se deve apresentar pergunta. S Sim N - No

descMsg1Oper VARCHAR2(40) VARCHAR(40) Descrio da mensagem 1 de operao.

descMsg2Oper VARCHAR2(40) VARCHAR(40) Descrio da mensagem 2 de operao.

nroRespValidas NUMBER(1) NUMERIC(1) Nmero de respostas vlidas. [2..9]

indicImpCupomDiferenciado

VARCHAR2(1)

VARCHAR(1)

Indicador de impresso de cupom diferenciado. S Sim N - No

codCondImp NUMBER(1) NUMERIC(1) Cdigo da condio de impresso. 1 Se responder a pergunta 2 Sempre

3.2.5.7 IntProClienteDifPergunta

Representa as perguntas para Cliente diferenciado.


Formato SQL

Descrio


Identificao do processo de importao (FK IntProClienteDiferenciado-> idProcesso)


Tipo de operao efetuada: I Insero E Excluso (FK IntProClienteDiferenciado-> codOperacao)

codPromocao (PK)

NUMBER(10)

NUMERIC(10)

Cdigo da promoo at 8 dgitos. (FK IntProClienteDiferenciado-> codPromocao)

nroLinha (PK) NUMBER(2) NUMERIC(2) Nmero da linha. [1..99]

descLinha VARCHAR2(40) VARCHAR(40) Descrio da linha.


3.2.5.8 IntProCupomLayout

Representa o layout de Cupom.


Formato SQL

Descrio

idProcesso (PK) NUMBER(10) NUMERIC(10) Identificao do processo de importao



codLayout (PK) NUMBER(6) NUMERIC(6) Cdigo do layout at 6 dgitos

codTipo NUMBER(1) NUMERIC(1)

Cdigo do tipo de cupom : 1 - Cupom de Pontos. 2 - Vale Brinde. 3 - Cliente Diferenciado. 4 - Cupom de Ressarcimento.

descLayout VARCHAR2(40) VARCHAR(40) Descrio do layout.

dataInicio TIMESTAMP DATETIME Data de incio de validade do cupom.

indicPontuacaoOnline CHAR(1) CHAR(1)

Indicador de pontuao online. S Sim N - No

indicSomenteIdentOnline CHAR(1) CHAR(1)

Indica somente identificao online. S Sim N - No

3.2.5.9 IntProCupomLayoutLinha

Representa as linhas do layout de Cupom.


Formato SQL

Descrio


Identificao do processo de importao (FK IntProCupomLayout-> idProcesso)


Tipo de operao efetuada: I Insero E Excluso (FK IntProCupomLayout-> codOperacao)

codLayout (PK) NUMBER(6) NUMERIC(6) Cdigo do layout at 6 dgitos (FK IntProCupomLayout-> codLayout)

numLinha (PK) NUMBER(2) NUMERIC(2) Nmero da linha [1..99]

descLinha VARCHAR2(40) VARCHAR(40) Descrio da linha.


alinhamento VARCHAR2(1) VARCHAR(1)

Indicador de tipo de alinhamento. E esquerda C centralizado D direita

expandido VARCHAR2(1) VARCHAR(1)

Indicador de expanso. N Normal E Expandido

3.2.5.10 IntProCupomLayoutPromocao

Associao do layout de cupom com uma determinada promoo.


Formato SQL

Descrio


Identificao do processo de importao (FK IntProCupomLayout-> idProcesso) (FK IntProPromocao -> idProcesso)


Tipo de operao efetuada: I Insero E Excluso (FK IntProCupomLayout-> codOperacao) (FK IntProPromocao -> codOperacao)

codPromocao (PK)

NUMBER(10)

NUMERIC(10)

Cdigo da promoo at 8 dgitos. (FK IntProPromocao -> codPromocao)

codLayout NUMBER(6) NUMERIC(6) Cdigo do layout at 6 dgitos. (FK IntProCupomLayout-> codLayout)

3.2.5.11 IntProDescParcialNoTotalFaixa

Armazena informaes da promoo Desconto parcial no Total por Faixa.


Formato SQL

Descrio





codPromocao (PK)

NUMBER(10)

NUMERIC(10)


indicImprimeCupomPromocao

VARCHAR2(1)

VARCHAR(1)

Indicador imprime cupom da promoo. S Sim N - No


3.2.5.12 IntProDescProgressivo

Armazena informaes da promoo Desconto Progressivo.


Formato SQL

Descrio





codPromocao (PK)

NUMBER(10)

NUMERIC(10)


codAgrup NUMBER(10) NUMERIC(10) Cdigo do agrupamento at 7 dgitos.

qtdeDisparo NUMBER(10) NUMERIC(10) Quantidade disparo at 10 dgitos.

3.2.5.13 IntProDescProgressivoAgrup

Associa a promoo ao cdigo de agrupamento.


Formato SQL

Descrio


Identificao do processo de importao (FK IntProDescProgressivo-> idProcesso)


Tipo de operao efetuada: I Insero E Excluso (FK IntProDescProgressivo-> codOperacao)

codPromocao (PK)

NUMBER(10)

NUMERIC(10)

Cdigo da promoo at 8 dgitos. (FK IntProDescProgressivo-> codPromocao)

codAgrup (PK) NUMBER(10) NUMERIC(10) Cdigo do agrupamento at 7 dgitos.

3.2.5.14 IntProDescProgressivoListaDesc

Descontos de cada agrupamento da promoo Desconto Progressivo .


Formato SQL

Descrio



Identificao do processo de importao (FK IntProDescProgressivoAgrup -> idProcesso)


Tipo de operao efetuada: I Insero E Excluso (FK IntProDescProgressivoAgrup -> codOperacao)

codPromocao (PK)

NUMBER(10)

NUMERIC(10)

Cdigo da promoo at 8 dgitos. (FK IntProDescProgressivoAgrup -> codPromocao)

codAgrup (PK) NUMBER(10) NUMERIC(10)

Cdigo do agrupamento at 7 dgitos. (FK IntProDescProgressivoAgrup -> codAgrup)

numItem (PK) NUMBER(2) NUMERIC(2) Nmero do item [1..99]

valorPremio NUMBER(11, 3)

NUMERIC(11, 3) Valor do prmio.

3.2.5.15 IntProDescProgressivoProdutos

Produtos de cada agrupamento da promoo Desconto Progressivo .


Formato SQL

Descrio


Identificao do processo de importao (FK IntProDescProgressivoAgrup -> idProcesso)


Tipo de operao efetuada: I Insero E Excluso (FK IntProDescProgressivoAgrup -> codOperacao)

codPromocao (PK)

NUMBER(10)

NUMERIC(10)

Cdigo da promoo at 8 dgitos. (FK IntProDescProgressivoAgrup -> codPromocao)

codAgrup (PK) NUMBER(10) NUMERIC(10)

Cdigo do agrupamento at 7 dgitos. (FK IntProDescProgressivoAgrup -> codAgrup)

codProduto (PK) NUMBER(14) NUMERIC (14) Cdigo interno do produto at 14 dgitos.

3.2.5.16 IntProDisparo

Armazena as informaes de disparo para todas as promoes associadas..

Campo Formato Formato Descrio


Oracle SQL

idProce

manual integração.pdf

Documents