Projeto

Geral

Perfil

Manual de Integração » Histórico » Versão 250

giovanni, 12/03/2024 09:06 h

1 23 Anônimo
h1. Manual de Integração
2 1 Anônimo
3 193 luis
[[Documentações]]
4 147 luis
5 36 Anônimo
[[Envio de Duplicatas]]
6 87 victor.klemann
[[Portal de Clientes - API]]
7 40 vinidalmagro
[[CRM]]
8 52 Anônimo
[[Digitação de Pedidos]]
9 75 vinidalmagro
[[Digitação de Pedidos - Imagens dos Produtos]]
10 129 alexandre
[[Loja Virtual - B2B]]
11 130 alexandre
[[Loja Virtual - B2C]]
12 79 Anônimo
[[Loja Virtual - Imagens]]
13 90 johny
[[Loja Virtual - Estilos (Layout Personalizado)]]
14 96 alexandre
[[Loja Virtual - Login Externo]]
15 67 ivo
[[Produção]]
16 76 victor.klemann
[[Gestão de Cobrança]]
17 81 victor.klemann
[[Gestão de Crédito]]
18 241 maikeu
[[Força de Vendas - Malharia]]
19 241 maikeu
20 23 Anônimo
21 1 Anônimo
*Índice* 
22 139 comin
# [[Manual de Integração#Condição de Vendas|Condição de Vendas]]
23 156 comin
# [[Manual de Integração#País|País]]
24 23 Anônimo
# [[Manual de Integração#Introdução|Introdução]] 
25 23 Anônimo
# [[Manual de Integração#Acesso-via-JDBC|Acesso via JDBC]] 
26 23 Anônimo
# [[Manual de Integração#Tabelas-de-Integração|Tabelas de Integração]] 
27 23 Anônimo
## [[Manual de Integração#Representantes|Representantes]] 
28 192 luis
## [[Manual de Integração#Representante-Gerente|Representante Gerente]] 
29 23 Anônimo
## [[Manual de Integração#Municípios-do-Representante|Municípios do Representante]] 
30 127 victor.klemann
## [[Manual de Integração#Municípios-do-ERP|Municípios do ERP]] 
31 23 Anônimo
## [[Manual de Integração#Clientes-e-Prospects|Clientes e Prospects]] 
32 224 paulo
## [[Manual de Integração#Representantes-dos-Clientes|Representantes dos Clientes ]] 
33 60 victor.klemann
## [[Manual de Integração#Marcas-do-Cliente|Marcas do Cliente]] 
34 23 Anônimo
## [[Manual de Integração#Coleções|Coleções]] 
35 23 Anônimo
## [[Manual de Integração#Linhas-de-Produto|Linhas de Produto]] 
36 47 Anônimo
## [[Manual de Integração#Marcas|Marcas]] 
37 23 Anônimo
## [[Manual de Integração#Vendas|Vendas]] 
38 1 Anônimo
## -[[Manual de Integração#Liquidez|Liquidez]]- (depreciado)
39 103 victor.klemann
## [[Manual de Integração#Faturamento-Contrato|Faturamento - Contrato]]
40 102 victor.klemann
## [[Manual de Integração#Meta-do-Representante|Meta do Representante]]
41 237 paulo
## [[Manual de Integração#Meta-do-Representante-Linha-de-Produto|Meta do Representante - Linha de Produto]]
42 203 erik
## [[Manual de Integração#Meta-do-Cliente|Meta do Cliente]]
43 236 paulo
## [[Manual de Integração#Meta-do-Cliente-Linha-de-Produto|Meta do Cliente - Linha de Produto]]
44 1 Anônimo
## [[Manual de Integração#Meta-do-Escritório|Meta do Escritório]]
45 172 paulo
## [[Manual de Integração#Estoque Centralizado|Estoque Centralizado]]
46 185 paulo
## [[Manual de Integração#Clientes Inadimplentes|Clientes Inadimplentes]]
47 199 paulo
## [[Manual de Integração#Transportadoras|Transportadoras]]
48 215 paulo
## [[Manual de Integração#Ranking de referências|Ranking de referências]]
49 103 victor.klemann
50 1 Anônimo
h1. Introdução
51 1 Anônimo
52 212 paulo
O presente documento tem por objetivo orientar as empresas de ERP na geração dos arquivos e/ou tabelas necessárias para integração com o GEOvendas.
53 1 Anônimo
54 207 julia.p
*Atenção!! Os campos que estiverem com a descrição "Campo Específico" retornar null, salvo se for combinado algo diferente com a GEOvendas durante o processo.*
55 92 ivo
56 202 paulo
*Atenção!! Cabe ao desenvolvedor das Views retornar nas views os campos obrigatórios e os campos não obrigatórios que forem pertinentes ao processo do Cliente, ou a informação que o cliente deseja enxergar.*
57 202 paulo
58 209 marcos
Dúvidas ou maiores esclarecimentos podem ser obtidos pelo e-mail atendimento@geovendas.com ou pelo telefone (47) 3370-0504. atendimento whatsapp 47 99950146
59 1 Anônimo
60 150 matheusk
h1. Conexões DB
61 1 Anônimo
62 150 matheusk
*JDBC pré-requisito:* Suporte por parte do Banco de Dados da Empresa fornecedora do ERP a acesso JDBC.
63 1 Anônimo
64 207 julia.p
Na integração via JDBC a fornecedora de ERP deve disponibilizar para a GEOvendas tabelas (ou visões) conforme os layouts especificados neste documento, também deverá fornecer um usuário e senha que tenha permissão de consulta nas referidas tabelas ou visões. A GEOvendas fará acesso via JDBC à base de dados do cliente para extrair as informações.
65 150 matheusk
66 208 marcos
*API:* Para conexões via API ou outra solução que não seja JDBC favor entrar em contato com a GEOvendas pelo e-mail atendimento@geovendas.com ou pelo telefone fixo (47) 3370-0504. atendimento whatsapp 47 99950146
67 150 matheusk
68 23 Anônimo
h1. Tabelas de Integração
69 23 Anônimo
70 23 Anônimo
Todas as tabelas/visões tem um campo chamado “codEmpresa” que separa a geração dos dados entre as possíveis várias empresas que o cliente tenha na mesma base de ERP.
71 23 Anônimo
72 23 Anônimo
*Observação:* Os campos com asterisco (*) compõem a “primaryKey” e podem ser enviados como String ou Integer dependendo da necessidade do cliente.
73 23 Anônimo
74 23 Anônimo
Seguem os layouts das tabelas/visões
75 23 Anônimo
76 23 Anônimo
h2. Representantes
77 23 Anônimo
78 23 Anônimo
Esta tabela/visão será utilizada para carregar no IGS a lista de representantes. Não é uma integração obrigatória, pois o cliente pode digitar os representantes diretamente no IGS.
79 23 Anônimo
80 166 andreg
|_.num|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |
81 165 andreg
|1| codEmpresa * | String/Integer   | 10         | Código da Empresa origem dos dados |
82 165 andreg
|2| codRepres *  | String/Integer   | 255        | Código do Representante no ERP |
83 165 andreg
|3| nome         | String   | 255        | Nome do Representante |
84 165 andreg
|4| telefone     | String   | 255        | Telefone de Contato |
85 165 andreg
|5| email        | String   | 255        | E-Mail |
86 165 andreg
|6| endereco     | String   | 255        | Rua + Número do endereço do Representante |
87 165 andreg
|7| bairro       | String   | 255        | Bairro do Endereço do Representante |
88 165 andreg
|8| CEP          | String   | 8          | CEP do endereço do Representante |
89 165 andreg
|9| Cidade       | String   | 255        | Nome da Cidade do Endereço do Representante |
90 165 andreg
|10| UF           | String   | 2          | Sigla da UF da Cidade |
91 207 julia.p
|11| codIBGE      | String   | 7          | Código do IBGE da Cidade |
92 165 andreg
|12| situacao     | Integer |          | Situação do cadastro do representante: 0 - Inativo, 1 - Ativo |
93 207 julia.p
|13| Cod Repres Agrupador | String   | 255        | *Campo Específico*. Retornar null , salvo alguma orientação diferente da GEOvendas |
94 165 andreg
|14| telefone 2     | String   | 255        | Telefone de Contato 2 |
95 165 andreg
|15| telefone 3     | String   | 255        | Telefone de Contato 3 |
96 165 andreg
|16| codigoAdministrador    | String   | 255        | Código do administrador do representante no erp |
97 165 andreg
|17| cnpj     | String   | 255        | CNPJ do representante |
98 207 julia.p
|18| codAgrupadorEscritorio     | String   | 255        | *Campo Específico*. Retornar null , salvo alguma orientação diferente da GEOvendas |
99 207 julia.p
|19| flagAgrupadorMaster     | Integer   |         | 0 - Não, 1 - Sim (Somente um por grupo) / *Campo Específico*. Retornar null , salvo alguma orientação diferente da GEOvendas   |
100 207 julia.p
|20| percComissa | Double   |            | Percentual de comissão |
101 207 julia.p
|21| codigoPessoaFisica    | String   | 255        | Código que representa o cadastro da pessoa física do representante |
102 207 julia.p
|22| nomePessoaFisica    | String   | 255        | Nome da pessoa física |
103 165 andreg
|23| senhaAPi    |    |         | Senha API |
104 165 andreg
|24| Origem    |    |         | Origem |
105 165 andreg
|25| fantasia    | String   | 255        | Nome fantasia |
106 165 andreg
|26| empresaIntegracaoPedido | String   | 255        | Código da empresa que será integrado os pedidos |
107 165 andreg
|27| marcas | String   | 255        | Códigos das marcas do representante, separados por *','* e sem *espaços*. Ex..: '10,20,30' |
108 170 martin
|28| flagPermiteVendaPorFamilia     | Integer   |         | 0 - Não, 1 - Sim / *Campo Específico*. Retornar null |
109 201 luis
|29| depositosDivisao | String |         | Depósitos de para divisão de pedidos do representante |
110 227 mateus.m
|30| regionalDesconto | String   | 255        | Desconto regional do representante |
111 167 gusthawo
112 167 gusthawo
*As duas colunas abaixo são utilizadas apenas na Kyly Exportação, e para que funcione para eles, essas informações precisam estar nas respectivas posições. Quando nacional (projeto principal) essas colunas não precisam ser informadas, a menos que haja uma alteração.*
113 167 gusthawo
114 165 andreg
|28| codTabelaPrecoFOB | String   | 255        | Tabela preço FOB do representante |
115 227 mateus.m
|29| codTabelaPrecoLanded | String   |            | Tabela preço Landed do representante |
116 192 luis
117 192 luis
h2. Representante Gerente
118 192 luis
119 192 luis
Na integração que temos hoje apenas o código, nome e telefone são usados;
120 192 luis
121 192 luis
|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |
122 192 luis
| codEmpresa * | String/Integer  | 10         | Código da Empresa origem dos dados |
123 192 luis
| Codigo Gerente *  | String/Integer   | 255        | Código do Representante no ERP |
124 207 julia.p
| Nome * | String   | 7          | Código do IBGE da Cidade |
125 192 luis
| Telefone       | String   | 255        | Nome da Cidade ou Distrito |
126 192 luis
127 192 luis
Lista de Parâmetros:
128 192 luis
129 192 luis
|_. Campo  |_. Parâmetro  |_. Tipo         |_. Precisão |_. Descrição     |
130 192 luis
|  codEmpresa | :p1    | String          | 255           | Código da Empresa  |
131 192 luis
| codigoGerente | :p2 | String | 255 | Código do Gerente |
132 192 luis
133 23 Anônimo
134 23 Anônimo
h2. Municípios do Representante
135 1 Anônimo
136 23 Anônimo
Tabela/visão com a relação dos municípios que o representante atende. Esta não é uma integração obrigatória.
137 126 victor.klemann
*Atenção! Tabela não obrigatória. Retornar apenas se existir no ERP.*
138 23 Anônimo
139 23 Anônimo
|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |
140 23 Anônimo
| codEmpresa * | String/Integer  | 10         | Código da Empresa origem dos dados |
141 23 Anônimo
| codRepres *  | String/Integer   | 255        | Código do Representante no ERP |
142 207 julia.p
| codIBGE      | String   | 7          | Código do IBGE da Cidade |
143 1 Anônimo
| nomeDistrito       | String   | 255        | Nome da Cidade ou Distrito |
144 126 victor.klemann
145 128 victor.klemann
h2. Municípios do ERP
146 126 victor.klemann
147 126 victor.klemann
Tabela/visão com a relação dos municípios do ERP. Esta não é uma integração obrigatória.
148 126 victor.klemann
*Atenção! Tabela não obrigatória. Retornar apenas se for solicitada.*
149 126 victor.klemann
150 126 victor.klemann
|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |
151 207 julia.p
| codIBGE*    | String   | 7          | Código do IBGE da Cidade |
152 126 victor.klemann
| codCidadeERP*  | String   | 255        | Código da Cidade no ERP |
153 126 victor.klemann
| codIBGERegiao   | String   | 255        | Código da sub-região no ERP _(somente quando trabalha com sub-regiões / distritos)_ |
154 23 Anônimo
155 23 Anônimo
h2. Clientes e Prospects
156 23 Anônimo
157 23 Anônimo
Tabela/visão com a relação dos clientes e prospects.
158 23 Anônimo
Podem ser listados clientes ativos ou inativos dependendo da necessidade do cliente.
159 23 Anônimo
160 23 Anônimo
*Situação:* O conceito de situação do cliente para o IGS é:
161 23 Anônimo
* 0-Inativo: Cliente que não está comprando, mas pode voltar a comprar
162 23 Anônimo
* 1-Ativo: Cliente com compra regular
163 23 Anônimo
* 2-Bloqueado: Cliente com restrições (ex: crédito) ou "Clientes que não interessam a empresa"
164 23 Anônimo
Caso seu ERP tenha somente os clientes ativos e inativos, retorne desta forma.
165 23 Anônimo
166 23 Anônimo
*Representante:* Só usar os campos codRepres2 e codRepres3 caso o cliente tenha variação de representante por linha de produto
167 23 Anônimo
168 151 andreg
|num |_. Campo      |_. Tipo   |_. Precisão |_. Descrição |
169 151 andreg
|1| codEmpresa * | String/Integer   | 10         | Código da Empresa origem dos dados |
170 207 julia.p
|2| codIBGE     | String   | 7          | Código do IBGE da Cidade |
171 207 julia.p
|3| codCliente *    | String/Integer   | 255          | Código do Cliente ou Prospect no ERP.  |
172 151 andreg
|4| tipo      | Integer   |           | Tipo de registro: 1 - Cliente, 2 - Prospect |
173 151 andreg
|5| nome         | String   | 255        | Nome do cliente |
174 151 andreg
|6| situacao     | Integer |          | Situação do cadastro do cliente: 0 - Inativo, 1 - Ativo, 2 - Bloqueado |
175 151 andreg
|7| codRepres1   | String   | 255        | Código do Representante Principal no ERP |
176 198 alex.a
|8| codRepres2  | String   | 255        | Código do Representante 2 no ERP (Opcional, habilitar Clientes do representante caso tenha mais de 3 rep por cliente.) |
177 197 alex.a
|9| codRepres3   | String   | 255        | Código do Representante 3 no ERP (Opcional, habilitar Clientes do representante caso tenha mais de 3 rep por cliente.) |
178 151 andreg
|10| telefone     | String   | 255        | Telefone de Contato |
179 151 andreg
|11| email        | String   | 255        | E-Mail |
180 151 andreg
|12| endereco     | String   | 255        | Rua |
181 151 andreg
|13| bairro       | String   | 255        | Bairro do Endereço do cliente |
182 151 andreg
|14| CEP          | String   | 8          | CEP do endereço do cliente |
183 151 andreg
|15| dataCadastro | Date    |          | Data de Cadastro do Cliente |
184 151 andreg
|16| cnpjCpf | String | 255 | CNPJ ou CPF do cliente |
185 151 andreg
|17| emailCobranca | String | 255 | Endereço de e-mail de cobrança. Não Obrigatório |
186 151 andreg
|18| nomeDistrito       | String   | 255        | Nome do Distrito (para o caso de São Paulo, os bairros – para o caso de Brasília, os Distritos)
187 43 ivo
Se o seu sistema não tiver esta informação, retornar o bairro. |
188 151 andreg
|19| celular       | String   | 255        | Numero do Celular |
189 151 andreg
|20| inscricaoEstadual       | String   | 255        | Inscrição estadual do cliente |
190 151 andreg
|21| enderecoNumero       | String   | 255        | Número do endereço do cliente  |
191 151 andreg
|22| complemento       | String   | 255        | Complemento do endereço |
192 207 julia.p
|23| IndicePontualidade       | Number   | 5,2       | Indice de Pontualidade. *Campo Específico*. Retornar null , salvo alguma orientação diferente da GEOvendas|
193 151 andreg
|24| telefone2       | String   | 255        | Telefone 2. Se não existir o campo, retornar null |
194 151 andreg
|25| telefoneCobranca       | String   | 255        | Telefone de cobrança. Se não existir o campo, retornar null |
195 151 andreg
|26| grupoCliente | String | 255 | Grupo Economico do Cliente (conforme regra de negócio de cada empresa). Se o seu ERP não tem isso, retornar null |
196 207 julia.p
|27| codClientePrincipal | String | 255 | Código do cliente principal do Grupo Ecônomico (conforme regra de negócio de cada empresa). Se o seu ERP não tem isso, retornar null |
197 195 alex.a
|28| situacaoEdt     | String |   255       | Descrição da Situação ERP |
198 151 andreg
|29| nomeGrupoCliente | String | 255 | Nome do Grupo Economico do Cliente (conforme regra de negócio de cada empresa). Se o seu ERP não tem isso, retornar null |
199 151 andreg
|30| flagInadimplente| Integer| | 0 - Não / 1 - Sim. Conforme regra da empresa. Não obrigatório para o GeoVendas |
200 151 andreg
|31| cidade| String| | cidade do cliente |
201 151 andreg
|32| uf| String| | UF do cliente |
202 151 andreg
|33| nomeFantasia| String| | Nome Fantasia do cliente. Não obrigatório |
203 151 andreg
|34| ramoAtividade| String| | Descrição do Ramo de atividade do cliente. Não obrigatório. Se não tiver retornar null |
204 151 andreg
|35| dataPrimeiraCompra| Date| | Não obrigatório. Retornar apenas se for um campo fácil de ser buscado. Se não tiver retornar null |
205 151 andreg
|36| dataUltimaCompra| Date| | Não obrigatório. Retornar apenas se for um campo fácil de ser buscado. Se não tiver retornar null |
206 151 andreg
|37| maiorCompra| Double| |  Retornar o valor da maior Compra do Cliente. Não obrigatório. Retornar apenas se for um campo fácil de ser buscado. Se não tiver retornar null |
207 151 andreg
|38| maiorAcumulado| Double| |  Retornar o valor do maior Acumulo deste cliente. Não obrigatório. Retornar apenas se for um campo fácil de ser buscado. Se não tiver retornar null |
208 207 julia.p
|39| codClienteERP| String |255| *Campo Específico*. Retornar null , salvo alguma orientação diferente da GEOvendas. Código do cliente dentro do ERP. Retornar apenas se for um campo fácil de ser buscado. Caso contrário, retornar null. Geralmente, é o mesmo valor do campo  codCliente. |
209 245 andreg
|40| DataFundacao| Data |255| Data de Fundação do cliente nâo obrigatório. Se não tiver retornar null. |
210 207 julia.p
|41| limiteCredito | Double | | *Campo Específico*. Retornar null , salvo alguma orientação diferente da GEOvendas. Limite de crédito do cliente. |
211 151 andreg
|42| ultimoFaturamento | Date |       |        |
212 151 andreg
|43| dataReativacao | Date |       |        |
213 151 andreg
|44| codSitCreditoERP | Integer | 10 |        |
214 151 andreg
|45| descSitCreditoERP | String | 255 |        |
215 1 Anônimo
|46| motivoInativo | String | 255 | Motivo cujo o qual o cliente foi inativado no ERP.  Não obrigatório. Se não tiver retornar null|
216 1 Anônimo
|47| diasVencimentoTitulo | Integer | | Dias Vencimento de Titulo. |
217 1 Anônimo
|48| socios | String | | Sócios, separdos por vírgula. |
218 207 julia.p
|49| cidadeGrupoCliente | String | 255 | Cidade do Grupo Ecônomico do Cliente (conforme regra de negócio de cada empresa). Se o seu ERP não tem isso, retornar null |
219 160 gusthawo
|50| classificacaoERP | String | 255 | Classificação do Cliente segundo o ERP. Se o seu ERP não tem isso, retornar null |
220 162 gusthawo
|51| instagram | String | 255 | Instagram do Cliente segundo o ERP. Se o seu ERP não tem isso, retornar null |
221 162 gusthawo
|52| facebook | String | 255 | Facebook do Cliente segundo o ERP. Se o seu ERP não tem isso, retornar null |
222 164 alexandre
|53| marcasLiberadas | String | 255 | Campo especifico Retornar Null, salvo orientação |
223 168 vinidalmagro
|54| emailNfe        | String   | 255        | E-Mail de NFe |
224 220 paulo
|55| observacao        | String   | 255        | Observação do cliente, campo não é mostrado em nenhum local, utilizado somente caso precise de alguma informação em cubo |
225 243 luana
|56| colecaoPrimeiraCompra        | String  | 255        | Nome da coleção correspondente à primeira compra do cliente, informação mostrada na tela Dashboard Prospects |
226 243 luana
|57| qtdePrimeiraCompra        | Double | |Quantidade de itens referente a primeira compra do cliente, informação mostrada na tela Dashboard Prospects |
227 243 luana
|58| vlrPrimeiraCompra        | Double | |Valor do pedido referente a primeira compra do cliente, informação mostrada na tela Dashboard Prospects |
228 157 andreg
229 217 alex.a
h2. Representantes dos Clientes 
230 158 andreg
231 159 andreg
integracao utilizada para quando existir mais de 1 cliente por representante
232 157 andreg
233 157 andreg
|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |
234 207 julia.p
| codEmpresa  |  String | 255  | Código da Empresa | 
235 196 alex.a
| codigoCliente |  String | 255  | Código do Cliente |
236 196 alex.a
| codigoRepres |  String | 255  | Código do Representante |
237 196 alex.a
| flagEPrincipal |  int | | Flag, 1 é o representante principal, 0 é preposto. Se na tabela existir somente representantes (Ex.: MPL, Latreille) não informar esta coluna. Caso informado, ocasionará duplicação de valores na consulta de vendas se um cliente possuir mais de um representante principal |
238 86 victor.klemann
239 1 Anônimo
h2. Cliente e Prospect - Histórico
240 207 julia.p
*Atenção! Tabela específica. Retornar apenas se for combinado algo com a GEOvendas*
241 62 victor.klemann
242 62 victor.klemann
|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |
243 62 victor.klemann
| dataAlteracao | Date |             | Data da Alteração | 
244 62 victor.klemann
| horaAlteracao | Date  |           | Hora da Alteração |
245 62 victor.klemann
| codUsuario     |  String | 255  | Código do Usuário |
246 62 victor.klemann
| nomeUsuario  | String | 255  | Nome do usuário |
247 62 victor.klemann
| situacao           | String | 255  | Código da Situação |
248 62 victor.klemann
| situacaoEdt     | String | 255  | Descrição da Situação |
249 62 victor.klemann
250 94 ivo
251 62 victor.klemann
Lista de Parâmetros:
252 63 victor.klemann
253 62 victor.klemann
|_. Campo  |_. Parâmetro  |_. Tipo         |_. Precisão |_. Descrição     |
254 63 victor.klemann
|  codEmpresa | :p1    | String          | 255           | Código da Empresa  |
255 63 victor.klemann
| codCliente | :p2 | String | 255 | Código do Cliente |
256 63 victor.klemann
257 63 victor.klemann
258 62 victor.klemann
h2. Marcas do Cliente
259 207 julia.p
*Atenção! Tabela específica. Retornar apenas se for combinado algo com a GEOvendas*
260 59 victor.klemann
261 94 ivo
Tabela com a relação de marcas do cliente, conforme vendas.
262 59 victor.klemann
263 59 victor.klemann
|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |
264 59 victor.klemann
| codEmpresa * | String | 255         | Código da Empresa origem dos dados |
265 207 julia.p
| codCliente *    | String   | 255          | Código do Cliente |
266 59 victor.klemann
| codMarca * | String   | 255          | Código da Marca |
267 59 victor.klemann
268 23 Anônimo
h2. Coleções
269 23 Anônimo
270 23 Anônimo
Tabela/visão com a relação das coleções.
271 23 Anônimo
272 23 Anônimo
|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |
273 23 Anônimo
| codEmpresa * | String/Integer   | 10         | Código da Empresa origem dos dados |
274 207 julia.p
| codColecao *     | String   | 255          | Código da coleção |
275 23 Anônimo
| nome      | String   | 255          | Nome da coleção |
276 149 victor.klemann
| situacaoForcaVendas | Integer | 255 | Campo responsável por ativar a coleção para o força de vendas. 0 - Coleção inválida para venda 1 - Coleção válida para venda. |
277 148 luis
| qtdReferencia | Integer | 255 | Quantidade de Referências por coleção |
278 23 Anônimo
279 23 Anônimo
h2. Linhas de Produto
280 23 Anônimo
281 23 Anônimo
Lista das linhas de produtos que tiveram dados gerados.
282 23 Anônimo
Entendesse como Linha de Produto a forma adotada pela empresa detentora do ERP para dividir seus produtos em grupos! Em caso de confecções, por exemplo, pode-se utilizar os critérios de (Infantil, Masculino, Feminino,etc.)
283 23 Anônimo
284 23 Anônimo
|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |
285 23 Anônimo
| codEmpresa * | String/Integer  | 10   | Código da Empresa origem dos dados |
286 207 julia.p
| codLinha *     | String  | 255        | Código da linha de produto |
287 23 Anônimo
| nome      | String   | 255          | Nome da linha de produto |
288 46 Anônimo
289 46 Anônimo
h2. Marcas
290 46 Anônimo
291 207 julia.p
_Integração Opcional - Confirme com a GEOvendas a necessidade de criar esta integração._
292 46 Anônimo
Lista de marcas por empresa.
293 46 Anônimo
294 46 Anônimo
|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |
295 46 Anônimo
| codEmpresa * | String/Integer  | 10   | Código da Empresa origem dos dados |
296 46 Anônimo
| codMarca *     | String  | 255        | Código da marca |
297 46 Anônimo
| nome      | String   | 255          | Nome da marca |
298 23 Anônimo
299 23 Anônimo
h2. Vendas
300 23 Anônimo
301 23 Anônimo
Esta é a principal tabela do processo de integração. Ela deverá armazenar os dados necessários para apresentação dos valores relativos às vendas realizadas.
302 23 Anônimo
Geralmente é gerada em cima dos pedidos de venda. Caso o ERP não consiga gerar os dados com base nos pedido de venda, deveremos acionar o cliente para definir outra tabela para extração dos dados (Exemplo: Notas Fiscais).
303 23 Anônimo
Caso a geração seja por coleção (no caso de Confecções, por exemplo), a fornecedora de ERP deve manter uma configuração onde o cliente deverá informar de quais coleções as informações devem ser geradas.
304 23 Anônimo
Caso a geração seja por período, deve-se definir com o cliente de qual período ele quer as informações (ultimo ano, últimos 2 anos, etc).
305 23 Anônimo
306 23 Anônimo
*Prazo Médio:* Média em dias do prazo de pagamento (condição de pagamento). Por exemplo, condição 30/60/90: 30+60+90 = 180, 180 / 3 parcelas = 60 dias.
307 23 Anônimo
308 23 Anônimo
*Campos Coringa:* Os campos coringa são definidos no momento da implantação, para a primeira integração deve-se retornar nestes campos valor nulo (NULL).
309 23 Anônimo
310 23 Anônimo
*Observação:* Os campos com asterisco (*) deverão ser agrupados(group by) e os demais somados (sum).
311 23 Anônimo
312 154 andreg
|_. Col |_. Campo          |_. Tipo   |_. Precisão |_. Descrição |
313 154 andreg
|_. 1 | codEmpresa *     | String/Integer   | 10         | Código da Empresa origem dos dados |
314 154 andreg
|_. 2 | codColecao *     | String | 255        | Código da Coleção sobre a qual estamos gerando os dados. |
315 154 andreg
|_. 3 | dataReferencia * | Date     | 255        | Armazena a data de emissão do Pedido de Venda. (Caso a geração seja em cima das notas fiscais, deverá armazenar a data de emissão da Nota Fiscal) |
316 154 andreg
|_. 4 | codLinha *       | String   | 255        | Código da Linha de Produto. Define-se com o cliente o que ele quer gerar como linha de produto.  |
317 154 andreg
|_. 5 | codRepres *      | String/Integer   | 255        | Código do Representante no ERP |
318 207 julia.p
|_. 6 | codCliente *     | String/Integer   | 255        | Código do Cliente |
319 207 julia.p
|_. 7 | codIBGE *        | String  | 7          | Código do IBGE da Cidade do Cliente |
320 154 andreg
|_. 8 | UF *             | String  | 2          | Sigla da UF da Cidade do Cliente |
321 154 andreg
|_. 9 | valorBruto       | Double   |            | Valor Bruto das Vendas |
322 154 andreg
|_.10 | valorLiquido     | Double   |            | Valor Liquido das Vendas (ex: Valor Bruto - Valor Descontos) |
323 154 andreg
|_.11 | valorDesconto    | Double   |            | Valor de Descontos das Vendas |
324 154 andreg
|_.12 | valorComissao    | Double   |            | Valor de Comissão das Vendas |
325 154 andreg
|_.13 | prazoMedioXValor | Double   |            | Valor Líquido das Vendas multiplicado pelo Prazo Médio de pagamento. |
326 154 andreg
|_.14 | quantidade       | Double   |            | Quantidade de Peças das Vendas |
327 154 andreg
|_.15 | nomeCliente *    | String   | 255        | Nome do Cliente |
328 154 andreg
|_.16 | codPedido *      | String   | 255        | Código do Pedido |
329 249 paulo
|_.17 | codProduto *     | String   | 255        | Código do produto ou referência *(Utilizado somente para MIX, não é utilizado, manter NULL)* |
330 207 julia.p
|_.18 | campoCoringa1 *  | String   | 255        | Campo valores diversos, inicialmente retornar NULL - Ver com GEOvendas |
331 207 julia.p
|_.19 | campoCoringa2 *  | String   | 255        | Campo valores diversos, inicialmente retornar NULL - Ver com GEOvendas |
332 207 julia.p
|_.20 | campoCoringa3 *  | String   | 255        | Campo valores diversos, inicialmente retornar NULL - Ver com GEOvendas |
333 154 andreg
|_.21 | dataPrevFaturamento | Date    |        | Data de Previsão de Faturamento |
334 155 andreg
|_.22 | nomeDistrito *       | String   | 255        |  Nome do Distrito (para o caso de São Paulo, os bairros – para o caso de Brasília, os Distritos)
335 65 victor.klemann
Se o seu sistema não tiver esta informação, retornar o bairro. |
336 155 andreg
|_.23 | grupoCliente       | String   | 255        | Grupo Econômico do Cliente (conforme regra de negócio de cada empresa). Se o seu ERP não tem isso, retornar null |
337 207 julia.p
|_.24 | valorRentabilidade | Double   |            | *Campo Específico*. Retornar null , salvo alguma orientação diferente da GEOvendas. Valor da Rentabilidade do Pedido. Se o seu ERP não tem rentabilidade por pedido, retornar null |
338 207 julia.p
|_.25 | dataUltFaturamento | Date   |            | *Campo Específico*. Retornar null , salvo alguma orientação diferente da GEOvendas. Data do último faturamento do Pedido. Retornar apenas se for uma informação fácil|
339 207 julia.p
|_.26 | valorFaturado | Double   |            | *Campo Específico*. Retornar null , salvo alguma orientação diferente da GEOvendas. Valor já Faturado do pedido |
340 207 julia.p
|_.27 | valorSaldo | Double   |            | *Campo Específico*. Retornar null , salvo alguma orientação diferente da GEOvendas. Valor Saldo |
341 155 andreg
|_.28 | codMarca *       | String   | 255        | Código da Marca do Produto |
342 155 andreg
|_.29 | nomeGrupoCliente | String | 255 | Descrição do Grupo do Cliente |
343 155 andreg
|_.30 | dataEmissao | Date | | Data de Emissão do Pedido |
344 207 julia.p
|_.31 | codRepresAgrupador | String | 255 | *Campo Específico*. Retornar null , salvo alguma orientação diferente da GEOvendas. Código do representante agrupador (atacado) |
345 207 julia.p
|_.32 | flagPolitica | Integer| | *Campo Específico*. Retornar null , salvo alguma orientação diferente da GEOvendas. Pedido de acordo com a politica comercial (0 - não / 1 - sim) |
346 155 andreg
|_.33 | codTabPreco | String | 255 | Código da Tabela de Preço |
347 207 julia.p
|_.34 | qtdeItens | Double | | *Campo Específico*. Retornar null , salvo alguma orientação diferente da GEOvendas. Quantidade de Itens do Pedido |
348 207 julia.p
|_.35 | qtdeEmQuilos | Double | | *Campo Específico*. Retornar null , salvo alguma orientação diferente da GEOvendas. Quantidade de Peças das Vendas em Quilos |
349 155 andreg
|_.36 | cidadeGrupoCliente | String | 255 | Cidade do Grupo Economico do Cliente (conforme regra de negócio de cada empresa). Se o seu ERP não tem isso, retornar null |
350 207 julia.p
|_.37 | campoCoringa4 *  | String   | 255        | Campo valores diversos, inicialmente retornar NULL - Ver com a GEOvendas |
351 207 julia.p
|_.38 | campoCoringa5 *  | String   | 255        | Campo valores diversos, inicialmente retornar NULL - Ver com a GEOvendas |
352 207 julia.p
|_.39 | campoCoringa6 *  | String   | 255        | Campo valores diversos, inicialmente retornar NULL - Ver com a GEOvendas |
353 155 andreg
|_.40 | situacaoPedido | String   | 255        | Situacao do Pedido no ERP |
354 222 alex.a
|_.41 | dataUltimaNF | Date     | 255        | Data da ultima nota fiscal do pedido (Alguns bancos não aceitam null, usar data padrão '1900-01-01' nesses casos)|
355 155 andreg
|_.42 | numeroUltimaNF | String   | 255        | Numero da ultima nota fiscal do pedido |
356 155 andreg
|_.43 | pedidoCliente | String | 255 | Código do Pedido de controle do cliente |
357 155 andreg
|_.44 | pedidoRepresentante | String | 255 | Codigo do Pedido de controle do representante |
358 155 andreg
|_.45 | percComissaoAtendente    | Double   |            | Percentual de comissão do atendente |
359 194 lucas
|_.46 | observacao | String | Indef. | Observação |
360 221 vinidalmagro
|_.47 | valorFrete       | Double   |            | Valor do Frete |
361 233 mateus.m
|_.48 | flagPedidoPrincipal       | Integer |            | *Campo Específico*. Retornar null. Flag Pedido Principal (0 - não / 1 - sim) |
362 23 Anônimo
363 218 alex.a
h2. Coringa
364 218 alex.a
365 218 alex.a
Configuração de campos coringas.
366 218 alex.a
367 218 alex.a
368 218 alex.a
|_. Campo                    |_. Tipo  |_. Precisão |_. Descrição |
369 218 alex.a
| codCoringa                 | String  | 255        | Código do Coringa    |
370 218 alex.a
| descCoringa                | String  | 255        | Descrição do Coringa |
371 218 alex.a
| flagParticipaContrato      | String  | 255        | Aparece no Contrato? 0 = Não 1 = Sim |
372 218 alex.a
373 218 alex.a
374 95 ivo
h2. Liquidez (Deprecated)
375 23 Anônimo
376 95 ivo
377 32 ivo
Listar dados totalizando os valores a receber e os valores recebidos agrupando por representante. Normalmente estes registros são provenientes do cadastro de contas a receber.
378 32 ivo
A Liquidez resume-se a:
379 32 ivo
- O Valor a vencer no período e pago dividido pelo a vencer no período.
380 23 Anônimo
- Não entra no cálculo da Liquidez os títulos pagos fora do período de vencimento.
381 1 Anônimo
382 1 Anônimo
*Importante!* Este SQL possui parâmetros.
383 1 Anônimo
384 1 Anônimo
Layout da tabela/visão:
385 23 Anônimo
386 23 Anônimo
|_. Campo          |_. Tipo   |_. Precisão |_. Descrição |
387 23 Anônimo
| codRepres *      | String/Integer   | 255        | Código do Representante no ERP |
388 23 Anônimo
| valorAReceber    | Double   |            | Valor a receber acumulado por representante |
389 1 Anônimo
| valorRecebido    | Double   |            | Valor recebido acumulado por representante |
390 1 Anônimo
391 1 Anônimo
Lista de Parâmetros:
392 23 Anônimo
393 1 Anônimo
_Formato sugerido de data: dd/mm/yyyy (31/12/2013)_
394 23 Anônimo
395 23 Anônimo
|_. Parâmetro      |_. Tipo   |_. Precisão |_. Descrição |
396 23 Anônimo
| :pCodEmpresa     | String/Integer   | 10         | (opcional) Código da empresa no ERP |
397 23 Anônimo
| :pDataInicio     | String   | 10         | Data inicial para filtrar o vencimento e pagamento (formato a combinar) |
398 1 Anônimo
| :pDataFim        | String   | 10         | Data final para filtrar o vencimento e pagamento (formato a combinar) |
399 23 Anônimo
400 1 Anônimo
*Exemplo:*
401 23 Anônimo
402 1 Anônimo
Supondo que o ERP possua duas tabelas/visões, uma para Contas a Receber e outra para Contas Recebidas. Então devera ser feito um UNION das duas tabelas a fim de facilitar a manutenção do SQL:
403 23 Anônimo
404 207 julia.p
*Observação:* Note que usamos uma função “to_date” que converte o valor String para o formato data, utilize uma função compatível com o seu banco. Caso seja necessário utilizar outro formato, favor entrar em contato com a GEOvendas para configuração.
405 23 Anônimo
406 23 Anônimo
<pre>
407 23 Anônimo
SELECT codRepres, sum(valorAReceber), sum(valorRecebido)
408 23 Anônimo
FROM (
409 23 Anônimo
		SELECT codRepres,
410 23 Anônimo
				valorTitulo as valorAReceber,
411 23 Anônimo
				0.0 as valorRecebido
412 23 Anônimo
		FROM ContasAReceber
413 23 Anônimo
		WHERE codempresa = :pCodEmpresa
414 23 Anônimo
		AND dataVecto >= to_date(:pDataInicio,'dd/mm/yyyy')
415 23 Anônimo
		AND dataVecto <=to_date(:pDataFim,'dd/mm/yyyy')
416 23 Anônimo
		UNION ALL
417 23 Anônimo
		SELECT codrepres,
418 23 Anônimo
				0.0 as valorAReceber,
419 23 Anônimo
				sum(valorTitulo) as valorRecebido
420 23 Anônimo
		FROM ContasRecebidas
421 23 Anônimo
		WHERE codempresa = :pCodEmpresa
422 23 Anônimo
		AND dataPagto >= to_date(:pDataInicio,'dd/mm/yyyy')
423 23 Anônimo
		AND dataPagto <=to_date(:pDataFim,'dd/mm/yyyy')
424 23 Anônimo
		AND dataVecto >= to_date(:pDataInicio,'dd/mm/yyyy')
425 23 Anônimo
		AND dataVecto <=to_date(:pDataFim,'dd/mm/yyyy')
426 23 Anônimo
)
427 23 Anônimo
GROUP BY codRepres
428 69 victor.klemann
</pre>
429 1 Anônimo
430 69 victor.klemann
h2. Faturamento - Contrato
431 104 victor.klemann
432 207 julia.p
*Atenção! Tabela específica. Retornar apenas se for combinado algo com a GEOvendas*
433 69 victor.klemann
434 69 victor.klemann
|_. Campo          |_. Tipo   |_. Precisão |_. Descrição |
435 69 victor.klemann
| codRepres *      | String/Integer   | 255        | Código do Representante no ERP |
436 69 victor.klemann
| qtdeFaturada | Double   |            | Quantidade Faturada |
437 69 victor.klemann
| valorFaturado    | Double   |            | Valor Faturado |
438 69 victor.klemann
439 69 victor.klemann
Lista de Parâmetros:
440 69 victor.klemann
441 74 Anônimo
|_. Parâmetro      |_. Tipo   |_. Precisão |_. Descrição |
442 74 Anônimo
| :p1     | String/Integer   | 10         | (opcional) Código da empresa no ERP |
443 74 Anônimo
| :p2     | String   | 10         | Data inicial para filtrar a emissão da nota fiscal |
444 69 victor.klemann
| :p3        | String   | 10         | Data final para filtrar a emissão da nota fiscal |
445 69 victor.klemann
| #COLECOES  | String   | 10         | Coleção da nota fiscal |
446 88 victor.klemann
| #MARCAS       | String   | 10         | Marca da nota fiscal |
447 70 victor.klemann
| #LINHAS   | String   | 10         | Linha da nota fiscal |
448 207 julia.p
| #CORINGA1   | String   | 10         | Campo valores diversos, inicialmente retornar NULL - Ver com GEOvendas |
449 207 julia.p
| #CORINGA2   | String   | 10         | Campo valores diversos, inicialmente retornar NULL - Ver com GEOvendas |
450 207 julia.p
| #CORINGA3   | String   | 10         | Campo valores diversos, inicialmente retornar NULL - Ver com GEOvendas |
451 97 gabriel
452 99 victor.klemann
h2. Meta do Representante
453 105 victor.klemann
454 207 julia.p
*Atenção! Tabela específica. Retornar apenas se for combinado algo com a GEOvendas*
455 99 victor.klemann
456 99 victor.klemann
|_. Campo          |_. Tipo   |_. Precisão |_. Descrição |
457 99 victor.klemann
| codEmpresa * | String/Integer | 255 | Código da empresa |
458 99 victor.klemann
| codColecao * | String | 255 | Código da coleção no ERP. |
459 99 victor.klemann
| codMarca  | String | 255 | Código da marca no ERP. |
460 99 victor.klemann
| codRepres *      | String/Integer   | 255        | Código do Representante no ERP |
461 99 victor.klemann
| metaValor | Double   |            | Meta em valor do representante |
462 99 victor.klemann
| metaQtde | Double   |            | Meta em quantidade do representante |
463 131 andrey
| metaPrecoMedio | Double   |            | Meta em preco médio do representante |
464 190 erik
| metaQtdeClientes | Double   |            | Meta em quantidade por clientes do representante |
465 228 erik
| periodoVendaIni | Date   |            | Data inicial de venda |
466 228 erik
| periodoVendaFim | Date   |            | Data final de venda |
467 190 erik
468 1 Anônimo
h2. Meta do Representante - Linha de Produto
469 206 erik
470 207 julia.p
*Atenção! Tabela específica. Retornar apenas se for combinado algo com a GEOvendas*
471 99 victor.klemann
472 99 victor.klemann
|_. Campo          |_. Tipo   |_. Precisão |_. Descrição |
473 99 victor.klemann
| codEmpresa * | String/Integer | 255 | Código da empresa |
474 99 victor.klemann
| codColecao * | String | 255 | Código da coleção no ERP. |
475 99 victor.klemann
| codMarca  | String | 255 | Código da marca no ERP. |
476 99 victor.klemann
| codRepres *      | String/Integer   | 255        | Código do Representante no ERP |
477 99 victor.klemann
| codLinha | Double   |            | Código da linha de produto no ERP. |
478 99 victor.klemann
| percMeta | Double   |            | Percentual de representatividade da linha sobre a meta geral |
479 229 erik
| periodoVendaIni | Date   |            | Data inicial de venda |
480 229 erik
| periodoVendaFim | Date   |            | Data final de venda |
481 203 erik
482 203 erik
h2. Meta do Cliente
483 203 erik
484 207 julia.p
*Atenção! Tabela específica. Retornar apenas se for combinado algo com a GEOvendas*
485 203 erik
486 203 erik
|_. Campo          |_. Tipo   |_. Precisão |_. Descrição |
487 203 erik
| codEmpresa * | String/Integer | 255 | Código da empresa |
488 203 erik
| idContrato * | Long |            | ID do contrato de resultado. |
489 203 erik
| codCliente * | String | 255 | Código do Cliente. |
490 203 erik
| codRepres *      | String/Integer   | 255        | Código do Representante no ERP. |
491 203 erik
| tipoCalcMeta | Integer   |            | Tipo de calculo meta (0 - Manual / 1 - Somatório). |
492 213 erik
| sitContrato | Integer   |            | Situação em relação ao Contrato (0 - Inativo / 1 - Ativo). |
493 203 erik
| metaValor | Double   |            | Meta em valor do cliente. |
494 203 erik
| metaQtde | Double   |            | Meta em quantidade do cliente. |
495 247 giovanni
| metaQtdeRefs | Double   |            | Meta em quantidade de referências do cliente. |
496 203 erik
497 216 luis
Lista de Parâmetros:
498 216 luis
499 216 luis
|_. Parâmetro      |_. Tipo   |_. Precisão |_. Descrição |
500 216 luis
| #CONTRATO_ID     | Long | 10         | (opcional) Código do contrato a ser importado |
501 216 luis
502 203 erik
h2. Meta do Cliente - Linha de Produto
503 205 erik
504 207 julia.p
*Atenção! Tabela específica. Retornar apenas se for combinado algo com a GEOvendas*
505 203 erik
506 203 erik
|_. Campo          |_. Tipo   |_. Precisão |_. Descrição |
507 203 erik
| codEmpresa * | String/Integer | 255 | Código da empresa |
508 203 erik
| idContrato * | Long |            | ID do contrato de resultado. |
509 203 erik
| codCliente * | String | 255 | Código do Cliente. |
510 203 erik
| codLinhaProduto * | String | 255 | Código da linha de produto. |
511 203 erik
| codRepres *      | String/Integer   | 255        | Código do Representante no ERP. |
512 214 erik
| sitContrato | Integer   |            | Situação em relação ao Contrato (0 - Inativo / 1 - Ativo). |
513 203 erik
| metaValor | Double   |            | Meta em valor do cliente. |
514 203 erik
| metaQtde | Double   |            | Meta em quantidade do cliente. |
515 248 giovanni
| metaQtdeRefs | Double   |            | Meta em quantidade de referências do cliente. |
516 216 luis
517 216 luis
Lista de Parâmetros:
518 216 luis
519 216 luis
|_. Parâmetro      |_. Tipo   |_. Precisão |_. Descrição |
520 216 luis
| #CONTRATO_ID     | Long | 10         | (opcional) Código do contrato a ser importado |
521 99 victor.klemann
522 99 victor.klemann
h2. Meta do Escritório
523 106 victor.klemann
524 207 julia.p
*Atenção! Tabela específica. Retornar apenas se for combinado algo com a GEOvendas*
525 99 victor.klemann
526 99 victor.klemann
|_. Campo          |_. Tipo   |_. Precisão |_. Descrição |
527 99 victor.klemann
| codEmpresa * | String/Integer | 255 | Código da empresa |
528 99 victor.klemann
| codColecao * | String | 255 | Código da coleção no ERP. |
529 99 victor.klemann
| codMarca  | String | 255 | Código da marca no ERP. |
530 99 victor.klemann
| codEscritorio *      | String/Integer   | 255        | Código do escritório de representação no ERP |
531 99 victor.klemann
| metaValor | Double   |            | Meta em valor do escritório |
532 99 victor.klemann
| metaQtde | Double   |            | Meta em quantidade do escritório |
533 99 victor.klemann
| metaPrazoMedio | Double   |            | Meta em prazo médio do escritório |
534 230 erik
| periodoVendaIni | Date   |            | Data inicial de venda |
535 230 erik
| periodoVendaFim | Date   |            | Data final de venda |
536 99 victor.klemann
537 99 victor.klemann
Lista de Parâmetros:
538 99 victor.klemann
539 99 victor.klemann
|_. Parâmetro      |_. Tipo   |_. Precisão |_. Descrição |
540 99 victor.klemann
| :p1     | String/Integer   | 10         | (opcional) Código da empresa no ERP |
541 99 victor.klemann
| :p2     | String   | 10         | Data inicial para filtrar a emissão da nota fiscal |
542 99 victor.klemann
| :p3        | String   | 10         | Data final para filtrar a emissão da nota fiscal |
543 99 victor.klemann
| #COLECOES  | String   | 10         | Coleção da nota fiscal |
544 99 victor.klemann
| #MARCAS       | String   | 10         | Marca da nota fiscal |
545 99 victor.klemann
| #LINHAS   | String   | 10         | Linha da nota fiscal |
546 207 julia.p
| #CORINGA1   | String   | 10         | Campo valores diversos, inicialmente retornar NULL - Ver com GEOvendas |
547 207 julia.p
| #CORINGA2   | String   | 10         | Campo valores diversos, inicialmente retornar NULL - Ver com GEOvendas |
548 207 julia.p
| #CORINGA3   | String   | 10         | Campo valores diversos, inicialmente retornar NULL - Ver com GEOvendas |
549 99 victor.klemann
550 97 gabriel
h2. Valores para Cálculo Desconto Fidelidade Acumulativa
551 97 gabriel
552 97 gabriel
Deve retornar o valor total somado, agrupado por cliente e data a ser considerada para o cálculo de desconto acumulativo por cliente
553 207 julia.p
Parâmetro obrigatório :p1 e :p2, codEmpresa e data limite cujo a qual o sistema irá considerar os registros para cálculo, ultima dia do mês anterior ao calculo. os vide exemplo abaixo.
554 97 gabriel
555 97 gabriel
|_. Campo  |_. Tipo   |_. Precisão |_. Descrição |
556 97 gabriel
|data | Date | | Data vigente da compra, dependendo do cliente pode ser considerada a data de emissão, de faturamento |
557 97 gabriel
|codCliente | Varchar| 255 | Código do cliente  |
558 97 gabriel
|valor| Double | | Valor somado por cliente e data |
559 97 gabriel
560 97 gabriel
Ex:
561 97 gabriel
<pre><code class="sql">
562 98 gabriel
SELECT DataEmissao,
563 98 gabriel
codCliente,
564 98 gabriel
SUM(valorBruto)
565 97 gabriel
FROM (
566 98 gabriel
select date_trunc('month', dataEmissao) DataEmissao,
567 98 gabriel
codCliente, 
568 98 gabriel
valorBruto
569 98 gabriel
FROM ETLPedido pedido
570 98 gabriel
WHERE pedido.codEmpresa = :p1
571 98 gabriel
AND pedido.dataEmissao<=:p2) Pedidos
572 97 gabriel
GROUP BY DataEmissao,codCliente
573 97 gabriel
ORDER BY codCliente, DataEmissao DESC
574 97 gabriel
</code></pre>
575 110 victor.klemann
576 110 victor.klemann
h2. Ranking de referências
577 110 victor.klemann
578 111 victor.klemann
Ranking de referências mais vendidas, homologado somente no ERP Virtual Age.
579 120 luis
O SQL deve retornar a grade da referencia completa sem repetir os campos de grade.
580 120 luis
Apenas um registro por SKU.
581 122 luis
582 110 victor.klemann
|_. Campo  |_. Tipo   |_. Precisão |_. Descrição |
583 110 victor.klemann
| codReferencia * | String | 255 | Código da referência |
584 110 victor.klemann
| descricao | String | 255 | Descrição da referência |
585 110 victor.klemann
| codSortimento * | String | 255 | Código do sortimento |
586 110 victor.klemann
| descSortimento | String | 255 | Descrição do sortimento |
587 110 victor.klemann
| seqTamanho * | String | 255 | Código do tamanho |
588 110 victor.klemann
| codTamaho | String | 255 | Descrição do tamanho |
589 110 victor.klemann
| quantidade | Double | | Quantidade vendida |
590 110 victor.klemann
| valorLiquido | Double | | Valor líquido vendido |
591 110 victor.klemann
| valorBruto | Double | | Valor bruto vendido |
592 110 victor.klemann
| preco | Double | | Valor unitário do produto, baseado na tabela de preço selecionada |
593 110 victor.klemann
| comissaoMedia | Double | | Comissão média do produto |
594 110 victor.klemann
| prazoMedio | Double | | Prazo médio vendido |
595 110 victor.klemann
| codFicha | Double | | Código da ficha |
596 250 giovanni
| seqOrdenacaoTamanho | Integer | Sequencia de ordeação dos tamnahos |
597 112 victor.klemann
598 112 victor.klemann
Lista de parâmetros
599 112 victor.klemann
600 112 victor.klemann
|_. Parâmetro      |_. Tipo   |_. Precisão |_. Descrição |
601 112 victor.klemann
| #COLECOES / #COL_NULL * | String   | 10         | Coleções para filtro de vendas |
602 112 victor.klemann
| #MARCAS / #MARC_NULL       | String   | 10         | Marca para filtro de vendas |
603 112 victor.klemann
| #REPRESENTANTES / #REPRES_NULL | String | 10 | Representantes para filtro de vendas |
604 112 victor.klemann
| #UFS / #UF_NULL | String | 10 | Estados para filtro de vendas |
605 112 victor.klemann
| #TABELASPRECO * / #TABPRECONULL | String | 10 | Tabela de preço para filtro de vendas |
606 112 victor.klemann
| #DATAINICIO / #DATAINI_NULL | String | 10 | Data de emissão inicial para filtro de vendas |
607 112 victor.klemann
| #DATAFINAL / #DATAFIM_NULL | String | 10 | Data de emissão final para filtro de vendas |
608 112 victor.klemann
| #LINHAS / #LINHA_NULL  | String   | 10         | Linha de produto para filtro de vendas |
609 133 gusthawo
| #CORINGA1 / #CPCOR1_NULL  | String   | 10         | Coringa número 1 para filtro de vendas |
610 133 gusthawo
| #CORINGA2 / #CPCOR2_NULL  | String   | 10         | Coringa número 2 para filtro de vendas |
611 133 gusthawo
| #CORINGA3 / #CPCOR3_NULL  | String   | 10         | Coringa número 3 para filtro de vendas |
612 133 gusthawo
| #CORINGA4 / #CPCOR4_NULL  | String   | 10         | Coringa número 4 para filtro de vendas |
613 133 gusthawo
| #CORINGA5 / #CPCOR5_NULL  | String   | 10         | Coringa número 5 para filtro de vendas |
614 133 gusthawo
| #CORINGA6 / #CPCOR6_NULL  | String   | 10         | Coringa número 6 para filtro de vendas |
615 112 victor.klemann
616 112 victor.klemann
Exemplo de sql: 
617 112 victor.klemann
618 112 victor.klemann
<pre><code class="sql">
619 112 victor.klemann
SELECT grupo.cdNivel as codReferencia,
620 112 victor.klemann
       grupo.dsNivel as descReferencia,
621 112 victor.klemann
       grade.cdCor as seqSortimento,
622 112 victor.klemann
       grade.dsCor as descSortimento,
623 112 victor.klemann
       grade.cdTamanho as seqTamanho,
624 112 victor.klemann
       grade.dsTamanho as descTamanho,
625 112 victor.klemann
       cast(sum(vendaItem.qtSolicitada - vendaItem.qtCancelada) as numeric) AS quantidade,
626 112 victor.klemann
       sum(round(cast(((vendaItem.qtSolicitada - vendaItem.qtCancelada) * vendaItem.vlUnitario) * ((100 - venda.prDesconto) / 100) as numeric), 4)) as valorLiquido, 
627 112 victor.klemann
       sum(round(cast((vendaItem.qtSolicitada - vendaItem.qtCancelada) * vendaItem.vlUnitario as numeric), 4)) as valorBruto,
628 112 victor.klemann
       sum(round(cast((vendaItem.qtSolicitada - vendaItem.qtCancelada) * vendaItem.vlUnitario as numeric), 4)) as valorUnitarioBruto,
629 112 victor.klemann
       0 as comissaoMedia,
630 112 victor.klemann
       0 as prazoMedio,
631 112 victor.klemann
       '' as codFicha
632 112 victor.klemann
FROM ProdutoGrupoAdicionalVAEntity grupo
633 112 victor.klemann
JOIN ProdutoGradeVAEntity grade ON grade.cdProduto = grupo.cdProduto
634 112 victor.klemann
JOIN ProdutoClassificacaoVAEntity linha on grupo.cdProduto = linha.cdProduto and linha.cdTipoClass = 75
635 112 victor.klemann
JOIN VendaItemVAEntity vendaItem ON vendaItem.cdProduto = grupo.cdProduto
636 112 victor.klemann
JOIN VendaVAEntity venda ON venda.cdEmpresa = vendaItem.cdEmpresa AND venda.cdPedido = vendaItem.cdPedido
637 112 victor.klemann
JOIN VendaClassificacaoVAEntity colecao ON vendaItem.cdEmpresa = colecao.cdEmpresa AND venda.cdPedido = colecao.cdPedido AND colecao.cdTipoClass = 1
638 112 victor.klemann
JOIN ETLProdutoTabelaPreco tabelaPrecoProduto ON tabelaPrecoProduto.codProduto = CAST(grupo.cdProduto as text)
639 112 victor.klemann
JOIN ETLProdutoTabelaPreco tabelaPrecoProdutoBase ON tabelaPrecoProdutoBase.codProduto = CAST(grupo.cdProduto as text) AND ((tabelaPrecoProdutoBase.codTabelaPreco = #TABELAPRECOBASE) OR (#TABPRECOBASENULL IS NULL))
640 112 victor.klemann
JOIN PessoaVAEntity pessoa ON pessoa.cdPessoa = venda.cdCliente
641 112 victor.klemann
JOIN PessoaEnderecoVAEntity pessoaEndereco ON pessoaEndereco.cdPessoa = pessoa.cdPessoa AND pessoaEndereco.nrSequencia = (SELECT MIN(nrSequencia) FROM PessoaEnderecoVAEntity WHERE pessoa.cdPessoa = cdPessoa)
642 112 victor.klemann
WHERE ((tabelaPrecoProduto.codTabelaPreco IN (#TABELASPRECO)) OR (#TABPRECONULL IS NULL))
643 112 victor.klemann
  AND ((colecao.cdClassificacao IN (#COLECOES)) OR (#COL_NULL IS NULL))
644 1 Anônimo
  AND ((linha.cdClassificacao IN (#LINHAS)) OR (#LINHA_NULL IS NULL))
645 1 Anônimo
  AND ((cast(venda.cdRepresentant as text) IN (#REPRESENTANTES)) OR (#REPRES_NULL IS NULL))
646 1 Anônimo
  AND ((venda.dtPedido >= to_date(#DATAINICIO, 'yyyy-mm-dd')) OR (#DATAINI_NULL IS NULL))
647 1 Anônimo
  AND ((venda.dtPedido <= to_date(#DATAFINAL, 'yyyy-mm-dd')) OR (#DATAFIM_NULL IS NULL))
648 1 Anônimo
  AND ((pessoaEndereco.ufSigla IN (#UFS)) OR (#UF_NULL IS NULL))
649 1 Anônimo
GROUP BY 1, 2, 3, 4, 5, 6
650 1 Anônimo
</code></pre>
651 124 luis
652 124 luis
Como o resultado é esperado:
653 124 luis
Ex:
654 124 luis
655 124 luis
|_. codReferencia |_. codSortimento |_. seqTamanho |_. quantidade |_. valorLiquido |_. valorBruto |_. preco |_. comissaoMedia |_. prazoMedio |
656 124 luis
| 001 | 00009 | 1 | 580 | 14.500 | 29.000 | 50.00 | 0 | 80 |
657 124 luis
| 001 | 00009 | 2 | 580 | 14.500 | 29.000 | 50.00 | 0 | 80 |
658 124 luis
| 001 | 00009 | 3 | 580 | 14.500 | 29.000 | 50.00 | 0 | 80 |
659 136 comin
| 001 | 00009 | 4 | 580 | 14.500 | 29.000 | 50.00 | 0 | 80 |
660 136 comin
661 136 comin
h2. Condição de Vendas
662 136 comin
663 136 comin
Tabela/visão com a relação das condições de vendas. Esta não é uma integração obrigatória.
664 136 comin
665 136 comin
|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |
666 136 comin
| codEmpresa * | String/Integer  | 10         | Código da Empresa origem dos dados |
667 136 comin
| codigo *  | String/Integer   | 255        | Código da condição de venda |
668 136 comin
| nome *      | String   | 7          | Nome da Condição |
669 136 comin
| qtdeParcelas *       | String   | 255        | Quantidade de parcelas |
670 136 comin
| prazoMedio *       | String   | 255        | Prazo médio |
671 136 comin
| ativo       | String   | 255        | Situação da condição de venda |
672 136 comin
| parcelas       | String   | 255        | Parcelas (Para Sispla/TI Empresarial colocar condição separadas por espaço. Ex: 30 60 ou 30 60 90) |
673 156 comin
674 156 comin
675 156 comin
h2. País
676 156 comin
677 156 comin
Tabela/visão com a relação dos países. Esta não é uma integração obrigatória, somente se for exportação do B2B.
678 156 comin
679 156 comin
|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |
680 156 comin
| codigo * | String/Integer  | 255         | Código do país |
681 156 comin
| nome *  | String   | text        | Nome do país |
682 171 paulo
683 171 paulo
h2. Estoque Centralizado
684 185 paulo
685 185 paulo
Tabela/visão com a informações de estoque centralizado.
686 185 paulo
687 185 paulo
*Caso trabalhe com estoque por data*: Neste caso o estoque deve ser acumulativo, sempre.
688 185 paulo
Por exemplo, se o estoque aumenta em 10 peças a cada data, sem considerar nenhuma venda, 
689 185 paulo
na primeira data seu estoque será de 10 peças, na segunda data será de 20 peças e na terceira data será de 30 peças.
690 185 paulo
691 185 paulo
*Atenção!! Esta tabela/visão possui parâmetros!!!*
692 185 paulo
693 185 paulo
694 185 paulo
|_. Campo                       |_. Tipo  |_. Precisão |_. Descrição |
695 185 paulo
| codEmpresa                    | String  | 255        | Código da Empresa origem dos dados |
696 185 paulo
| codigoProduto                 | String  | 255        | Código do Produto |
697 185 paulo
| seqTamanho                    | String  | 255        | Código do tamanho |
698 185 paulo
| seqSortimento                 | String  | 255        | Código da cor/Sortimento |
699 185 paulo
| colecao                       | String  | 255        | Código da coleção |
700 185 paulo
| estoqueLimitado               | Integer | 10         | Flag para estoque limitado ( 1 = limitado, 0 = não limitado) |
701 185 paulo
| quantidade                    | Double  | 10         | Quantidade em estoque |
702 185 paulo
| codTamanho                    | String  | 255        | Código do tamanho |
703 185 paulo
| codGrade                      | String  | 255        | Código da grade |
704 234 alex.a
| deposito                      | String  | 255        | Código do depósito (Se não for usar, deixar 0. O preenchimento com NULL deste campo pode fazer com que as quantidades não apareçam nas referencias.)|
705 185 paulo
| nomeColecao                   | String  | 255        | Nome da coleção |
706 185 paulo
| dataProduto                   | Date    | 10         | Data do estoque (enviar '2000-01-01' caso não trabalhe com estoque por data) |
707 185 paulo
| quantidadeProntaEntrega       | Double  | 10         | Quantidade pronta entrega (retornar 0 se não trabalhar com pronta entrega) |
708 185 paulo
| codCorBase                    | String  | 255        | Código da Cor Base |
709 185 paulo
| nomeReferencia                | String  | 255        | Nome da Referência |
710 185 paulo
| nomeCor                       | String  | 255        | Nome da Cor |
711 185 paulo
| ean13                         | String  | 255        | EAN |
712 185 paulo
| visualQuantidadeProduto       | Double  | 10         | Quantidade visual do produto (enviar null) |
713 185 paulo
| visualQuantidadeProducao      | Double  | 10         | Quantidade visual da produção (enviar null) |
714 185 paulo
| seqOrdenacaoTamanho           | Integer | 10         | Sequencia de ordenação do tamanho do produto |
715 223 paulo
| codReferenciaProvisoria       | String  | 10         | Código de referencia provisória |
716 240 giovanni
| visualDataProduto             | String  | 255         | Data em formate visual "de - até" |
717 244 gusthawo
| coringa1                      | String  | 20         | Código do coringa 1 |
718 244 gusthawo
| coringa2                      | String  | 20         | Código do coringa 2 |
719 244 gusthawo
| coringa3                      | String  | 20         | Código do coringa 3 |
720 244 gusthawo
| coringa4                      | String  | 20         | Código do coringa 4 |
721 244 gusthawo
| coringa5                      | String  | 20         | Código do coringa 5 |
722 244 gusthawo
| unidade                       | String  | 255         | Unidade de medida |
723 244 gusthawo
| conversorUnidade              | String  | 255         | Conversor da unidade de medida |
724 244 gusthawo
| conversorFator                | String  | 255         | Fator do da conversão |
725 244 gusthawo
| conversorOperador             | String  | 255         | Operador da conversão |
726 185 paulo
727 185 paulo
Lista de Parâmetros:
728 185 paulo
729 185 paulo
|_. Campo  |_. Parâmetro  |_. Tipo         |_. Precisão |_. Descrição     |
730 242 alex.a
|  codColecao | in (#COLECOES) or (#COLECOESNULL = '-1')    | String          | 255           | Código da coleção  |
731 185 paulo
|  tabPreco| in (#PRICETABLES) or (#PRICETABLES = '-1')    | String          | 255           | Código da tabela de preço |
732 185 paulo
|  codReferencia | in (#REFERENCES) or (#REFERENCES = '-1')    | String          | 255           | Código da referencia |
733 185 paulo
734 185 paulo
h2. Clientes Inadimplentes
735 171 paulo
736 186 paulo
Tabela/visão com a informações de Clientes Inadimplentes.
737 171 paulo
738 189 paulo
Trazer somente as informações de clientes inadimplentes, 
739 189 paulo
de acordo com as regras desejadas pela empresa
740 189 paulo
741 186 paulo
|_. Campo                    |_. Tipo  |_. Precisão |_. Descrição |
742 186 paulo
| codEmpresa                 | String  | 255        | Código da Empresa origem dos dados |
743 186 paulo
| codcliente                 | String  | 255        | Código do Cliente |
744 186 paulo
| nomeCliente                | String  | 255        | Nome do Cliente |
745 186 paulo
| telefone                   | String  | 255        | Telefone do Cliente |
746 186 paulo
| codRepres1                 | String  | 255        | Código do Representante 1 do Cliente |
747 187 paulo
| codRepres2                 | String  | 255        | Código do Representante 2 do Cliente |
748 187 paulo
| codRepres3                 | String  | 255        | Código do Representante 3 do Cliente |
749 186 paulo
| codIBGE                    | String  | 255        | Código do IBGE |
750 188 paulo
| titulo                     | String  | 255        | Numero do Título |
751 186 paulo
| dataVencimento             | Date    | Data       | Data de Vencimento do Título |
752 186 paulo
| valor                      | String  | 255        | Valor do Título |
753 199 paulo
754 199 paulo
h2. Transportadoras
755 199 paulo
756 199 paulo
Tabela/visão com a informações de Transportadoras.
757 199 paulo
758 199 paulo
Trazer somente as informações de Transportadoras, 
759 199 paulo
de acordo com as regras desejadas pela empresa
760 199 paulo
761 199 paulo
|_. Campo                    |_. Tipo  |_. Precisão |_. Descrição |
762 199 paulo
| codEmpresa                 | String  | 255        | Código da Empresa origem dos dados |
763 199 paulo
| codTransportadora                 | String  | 255        | Código da Transportadora |
764 1 Anônimo
| nomeTransportadora                | String  | 255        | Nome da Transportadora |
765 200 vinidalmagro
| situacao                | Inteiro  |         | 0 - Invativo / 1 - Ativo |