Projeto

Geral

Perfil

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

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