Projeto

Geral

Perfil

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

comin, 18/06/2019 13:34 h

1 23 Anônimo
h1. Manual de Integração
2 1 Anônimo
3 36 Anônimo
[[Envio de Duplicatas]]
4 87 victor.klemann
[[Portal de Clientes - API]]
5 40 vinidalmagro
[[CRM]]
6 52 Anônimo
[[Digitação de Pedidos]]
7 75 vinidalmagro
[[Digitação de Pedidos - Imagens dos Produtos]]
8 57 ivo
[[Loja Virtual]]
9 79 Anônimo
[[Loja Virtual - Imagens]]
10 89 johny
[[Loja Virtual - Pop ups]]
11 90 johny
[[Loja Virtual - Estilos (Layout Personalizado)]]
12 96 alexandre
[[Loja Virtual - Login Externo]]
13 67 ivo
[[Produção]]
14 76 victor.klemann
[[Gestão de Cobrança]]
15 81 victor.klemann
[[Gestão de Crédito]]
16 23 Anônimo
17 1 Anônimo
*Índice* 
18 23 Anônimo
# [[Manual de Integração#Introdução|Introdução]] 
19 23 Anônimo
# [[Manual de Integração#Acesso-via-JDBC|Acesso via JDBC]] 
20 23 Anônimo
# [[Manual de Integração#Tabelas-de-Integração|Tabelas de Integração]] 
21 23 Anônimo
## [[Manual de Integração#Representantes|Representantes]] 
22 23 Anônimo
## [[Manual de Integração#Municípios-do-Representante|Municípios do Representante]] 
23 23 Anônimo
## [[Manual de Integração#Clientes-e-Prospects|Clientes e Prospects]] 
24 60 victor.klemann
## [[Manual de Integração#Marcas-do-Cliente|Marcas do Cliente]] 
25 23 Anônimo
## [[Manual de Integração#Coleções|Coleções]] 
26 23 Anônimo
## [[Manual de Integração#Linhas-de-Produto|Linhas de Produto]] 
27 47 Anônimo
## [[Manual de Integração#Marcas|Marcas]] 
28 23 Anônimo
## [[Manual de Integração#Vendas|Vendas]] 
29 1 Anônimo
## -[[Manual de Integração#Liquidez|Liquidez]]- (depreciado)
30 103 victor.klemann
## [[Manual de Integração#Faturamento-Contrato|Faturamento - Contrato]]
31 102 victor.klemann
## [[Manual de Integração#Meta-do-Representante|Meta do Representante]]
32 1 Anônimo
## [[Manual de Integração#Meta-do-Escritório|Meta do Escritório]]
33 103 victor.klemann
34 22 Anônimo
35 1 Anônimo
h1. Introdução
36 1 Anônimo
37 23 Anônimo
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 IGS.
38 1 Anônimo
39 94 ivo
*Atenção!! Os campos que estiverem com a descrição "Campo Específico" retornar null, salvo se for combinado algo diferente com a IBTech durante o processo.*
40 92 ivo
41 54 Anônimo
Dúvidas ou maiores esclarecimentos podem ser obtidos pelo e-mail suporte@ibtech.inf.br ou pelo telefone (47) 3370-0504.
42 1 Anônimo
43 23 Anônimo
h1. Acesso via JDBC
44 1 Anônimo
45 23 Anônimo
*Pré-Requisito:* Suporte por parte do Banco de Dados da Empresa fornecedora do ERP a acesso JDBC.
46 1 Anônimo
47 23 Anônimo
Na integração via JDBC a fornecedora de ERP deve disponibilizar para a IBTech 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 IBTech fará acesso via JDBC à base de dados do cliente para extrair as informações.
48 23 Anônimo
49 23 Anônimo
h1. Tabelas de Integração
50 23 Anônimo
51 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.
52 23 Anônimo
53 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.
54 23 Anônimo
55 23 Anônimo
Seguem os layouts das tabelas/visões
56 23 Anônimo
57 23 Anônimo
h2. Representantes
58 23 Anônimo
59 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.
60 23 Anônimo
61 23 Anônimo
|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |
62 23 Anônimo
| codEmpresa * | String/Integer   | 10         | Código da Empresa origem dos dados |
63 23 Anônimo
| codRepres *  | String/Integer   | 255        | Código do Representante no ERP |
64 23 Anônimo
| nome         | String   | 255        | Nome do Representante |
65 23 Anônimo
| telefone     | String   | 255        | Telefone de Contato |
66 23 Anônimo
| email        | String   | 255        | E-Mail |
67 23 Anônimo
| endereco     | String   | 255        | Rua + Número do endereço do Representante |
68 23 Anônimo
| bairro       | String   | 255        | Bairro do Endereço do Representante |
69 23 Anônimo
| CEP          | String   | 8          | CEP do endereço do Representante |
70 23 Anônimo
| Cidade       | String   | 255        | Nome da Cidade do Endereço do Representante |
71 23 Anônimo
| UF           | String   | 2          | Sigla da UF da Cidade |
72 23 Anônimo
| codIBGE      | String   | 7          | Codigo do IBGE da Cidade |
73 1 Anônimo
| situacao     | Integer |          | Situação do cadastro do representante: 0 - Inativo, 1 - Ativo |
74 94 ivo
| Cod Repres Agrupador | String   | 255        | *Campo Específico*. Retornar null , salvo alguma orientação diferente da IBTech |
75 78 matheusk
| telefone 2     | String   | 255        | Telefone de Contato 2 |
76 78 matheusk
| telefone 3     | String   | 255        | Telefone de Contato 3 |
77 101 victor.klemann
| codigoAdministrador    | String   | 255        | Código do administrador do representante no erp |
78 101 victor.klemann
| cnpj     | String   | 255        | CNPJ do representante |
79 101 victor.klemann
| codAgrupadorEscritorio     | String   | 255        | *Campo Específico*. Retornar null , salvo alguma orientação diferente da IBTech |
80 101 victor.klemann
| flagAgrupadorMaster     | Integer   |         | 0 - Não, 1 - Sim (Somente um por grupo) / *Campo Específico*. Retornar null , salvo alguma orientação diferente da IBTech   |
81 23 Anônimo
82 23 Anônimo
h2. Municípios do Representante
83 1 Anônimo
84 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.
85 94 ivo
*Atenção! Tabela não obrigatória. Retornar apenas se existir no ERP*
86 23 Anônimo
87 23 Anônimo
|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |
88 23 Anônimo
| codEmpresa * | String/Integer  | 10         | Código da Empresa origem dos dados |
89 23 Anônimo
| codRepres *  | String/Integer   | 255        | Código do Representante no ERP |
90 23 Anônimo
| codIBGE      | String   | 7          | Codigo do IBGE da Cidade |
91 30 Anônimo
| nomeDistrito       | String   | 255        | Nome da Cidade ou Distrito |
92 23 Anônimo
93 23 Anônimo
h2. Clientes e Prospects
94 23 Anônimo
95 23 Anônimo
Tabela/visão com a relação dos clientes e prospects.
96 23 Anônimo
Podem ser listados clientes ativos ou inativos dependendo da necessidade do cliente.
97 23 Anônimo
98 23 Anônimo
*Situação:* O conceito de situação do cliente para o IGS é:
99 23 Anônimo
* 0-Inativo: Cliente que não está comprando, mas pode voltar a comprar
100 23 Anônimo
* 1-Ativo: Cliente com compra regular
101 23 Anônimo
* 2-Bloqueado: Cliente com restrições (ex: crédito) ou "Clientes que não interessam a empresa"
102 23 Anônimo
Caso seu ERP tenha somente os clientes ativos e inativos, retorne desta forma.
103 23 Anônimo
104 23 Anônimo
*Representante:* Só usar os campos codRepres2 e codRepres3 caso o cliente tenha variação de representante por linha de produto
105 23 Anônimo
106 1 Anônimo
|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |
107 23 Anônimo
| codEmpresa * | String/Integer   | 10         | Código da Empresa origem dos dados |
108 23 Anônimo
| codIBGE     | String   | 7          | Codigo do IBGE da Cidade |
109 94 ivo
| codCliente *    | String/Integer   | 255          | Codigo do Cliente ou Prospect no ERP.  |
110 23 Anônimo
| tipo      | Integer   |           | Tipo de registro: 1 - Cliente, 2 - Prospect |
111 23 Anônimo
| nome         | String   | 255        | Nome do cliente |
112 23 Anônimo
| situacao     | Integer |          | Situação do cadastro do cliente: 0 - Inativo, 1 - Ativo, 2 - Bloqueado |
113 23 Anônimo
| codRepres1   | String   | 255        | Código do Representante Principal no ERP |
114 1 Anônimo
| codRepres2  | String   | 255        | Código do Representante 2 no ERP |
115 23 Anônimo
| codRepres3   | String   | 255        | Código do Representante 3 no ERP |
116 23 Anônimo
| telefone     | String   | 255        | Telefone de Contato |
117 23 Anônimo
| email        | String   | 255        | E-Mail |
118 94 ivo
| endereco     | String   | 255        | Rua |
119 23 Anônimo
| bairro       | String   | 255        | Bairro do Endereço do cliente |
120 23 Anônimo
| CEP          | String   | 8          | CEP do endereço do cliente |
121 23 Anônimo
| dataCadastro | Date    |          | Data de Cadastro do Cliente |
122 29 Anônimo
| cnpjCpf | String | 255 | CNPJ ou CPF do cliente |
123 94 ivo
| emailCobranca | String | 255 | Endereço de e-mail de cobrança. Não Obrigatório |
124 1 Anônimo
| nomeDistrito       | String   | 255        | Nome do Distrito (para o caso de São Paulo, os bairros – para o caso de Brasília, os Distritos)
125 43 ivo
Se o seu sistema não tiver esta informação, retornar o bairro. |
126 38 vinidalmagro
| celular       | String   | 255        | Numero do Celular |
127 38 vinidalmagro
| inscricaoEstadual       | String   | 255        | Inscrição estadual do cliente |
128 39 vinidalmagro
| enderecoNumero       | String   | 255        | Número do endereço do cliente  |
129 38 vinidalmagro
| complemento       | String   | 255        | Complemento do endereço |
130 94 ivo
| IndicePontualidade       | Number   | 5,2       | Indice de Pontualidade. *Campo Específico*. Retornar null , salvo alguma orientação diferente da IBTech|
131 41 ivo
| telefone2       | String   | 255        | Telefone 2. Se não existir o campo, retornar null |
132 1 Anônimo
| telefoneCobranca       | String   | 255        | Telefone de cobrança. Se não existir o campo, retornar null |
133 50 Anônimo
| 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 |
134 50 Anônimo
| codClientePrincipalGrupo | String | 255 | Código do cliente principal do Grupo Economico (conforme regra de negócio de cada empresa). Se o seu ERP não tem isso, retornar null |
135 61 victor.klemann
| situacaoEdt     | String |   255       | Descrição da Situação |
136 1 Anônimo
| 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 |
137 94 ivo
| flagInadimplente| Integer| | 0 - Não / 1 - Sim. Conforme regra da empresa. Não obrigatório para o GeoVendas |
138 82 ivo
| cidade| String| | cidade do cliente |
139 82 ivo
| uf| String| | UF do cliente |
140 1 Anônimo
| nomeFantasia| String| | Nome Fantasia do cliente. Não obrigatório |
141 82 ivo
| ramoAtividade| String| | Descrição do Ramo de atividade do cliente. Não obrigatório. Se não tiver retornar null |
142 83 ivo
| dataPrimeiraCompra| Date| | Não obrigatório. Retornar apenas se for um campo fácil de ser buscado. Se não tiver retornar null |
143 82 ivo
| dataUltimaCompra| Date| | Não obrigatório. Retornar apenas se for um campo fácil de ser buscado. Se não tiver retornar null |
144 94 ivo
| 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 |
145 94 ivo
| 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 |
146 94 ivo
| codClienteERP| String |255| *Campo Específico*. Retornar null , salvo alguma orientação diferente da IBTech. Codigo 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. |
147 1 Anônimo
| codRamoAtividade | String |255| Código do Ramo de atividade do cliente. Não obrigatório. Se não tiver retornar null. |
148 100 Anônimo
| limiteCredito | Double | | *Campo Específico*. Retornar null , salvo alguma orientação diferente da IBTech. Limite de crédito do cliente. |
149 100 Anônimo
| ultimoFaturamento | Date |       |        |
150 100 Anônimo
| dataReativacao | Date |       |        |
151 100 Anônimo
| codSitCreditoERP | Integer | 10 |        |
152 100 Anônimo
| descSitCreditoERP | String | 255 |        |
153 100 Anônimo
| motivoInativo | String | 255 | Motivo cujo o qual o cliente foi inativado no ERP.  Não obrigatório. Se não tiver retornar null|
154 107 comin
| socios | String | | Sócios, separdos por vírgula. |
155 100 Anônimo
156 86 victor.klemann
157 1 Anônimo
h2. Cliente e Prospect - Histórico
158 94 ivo
*Atenção! Tabela específica. Retornar apenas se for combinado algo com a IBTech*
159 62 victor.klemann
160 62 victor.klemann
|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |
161 62 victor.klemann
| dataAlteracao | Date |             | Data da Alteração | 
162 62 victor.klemann
| horaAlteracao | Date  |           | Hora da Alteração |
163 62 victor.klemann
| codUsuario     |  String | 255  | Código do Usuário |
164 62 victor.klemann
| nomeUsuario  | String | 255  | Nome do usuário |
165 62 victor.klemann
| situacao           | String | 255  | Código da Situação |
166 62 victor.klemann
| situacaoEdt     | String | 255  | Descrição da Situação |
167 62 victor.klemann
168 94 ivo
169 62 victor.klemann
Lista de Parâmetros:
170 63 victor.klemann
171 62 victor.klemann
|_. Campo  |_. Parâmetro  |_. Tipo         |_. Precisão |_. Descrição     |
172 63 victor.klemann
|  codEmpresa | :p1    | String          | 255           | Código da Empresa  |
173 63 victor.klemann
| codCliente | :p2 | String | 255 | Código do Cliente |
174 63 victor.klemann
175 63 victor.klemann
176 62 victor.klemann
h2. Marcas do Cliente
177 95 ivo
*Atenção! Tabela específica. Retornar apenas se for combinado algo com a IBTech*
178 59 victor.klemann
179 94 ivo
Tabela com a relação de marcas do cliente, conforme vendas.
180 59 victor.klemann
181 59 victor.klemann
|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |
182 59 victor.klemann
| codEmpresa * | String | 255         | Código da Empresa origem dos dados |
183 59 victor.klemann
| codCliente *    | String   | 255          | Codigo do Cliente |
184 59 victor.klemann
| codMarca * | String   | 255          | Código da Marca |
185 59 victor.klemann
186 23 Anônimo
h2. Coleções
187 23 Anônimo
188 23 Anônimo
Tabela/visão com a relação das coleções.
189 23 Anônimo
190 23 Anônimo
|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |
191 23 Anônimo
| codEmpresa * | String/Integer   | 10         | Código da Empresa origem dos dados |
192 23 Anônimo
| codColecao *     | String   | 255          | Codigo da coleção |
193 23 Anônimo
| nome      | String   | 255          | Nome da coleção |
194 23 Anônimo
195 23 Anônimo
h2. Linhas de Produto
196 23 Anônimo
197 23 Anônimo
Lista das linhas de produtos que tiveram dados gerados.
198 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.)
199 23 Anônimo
200 23 Anônimo
|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |
201 23 Anônimo
| codEmpresa * | String/Integer  | 10   | Código da Empresa origem dos dados |
202 23 Anônimo
| codLinha *     | String  | 255        | Codigo da linha de produto |
203 23 Anônimo
| nome      | String   | 255          | Nome da linha de produto |
204 46 Anônimo
205 46 Anônimo
h2. Marcas
206 46 Anônimo
207 46 Anônimo
_Integração Opcional - Confirme com a IBTech a necessidade de criar esta integração._
208 46 Anônimo
Lista de marcas por empresa.
209 46 Anônimo
210 46 Anônimo
|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |
211 46 Anônimo
| codEmpresa * | String/Integer  | 10   | Código da Empresa origem dos dados |
212 46 Anônimo
| codMarca *     | String  | 255        | Código da marca |
213 46 Anônimo
| nome      | String   | 255          | Nome da marca |
214 23 Anônimo
215 23 Anônimo
h2. Vendas
216 23 Anônimo
217 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.
218 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).
219 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.
220 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).
221 23 Anônimo
222 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.
223 23 Anônimo
224 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).
225 23 Anônimo
226 23 Anônimo
*Observação:* Os campos com asterisco (*) deverão ser agrupados(group by) e os demais somados (sum).
227 23 Anônimo
228 23 Anônimo
|_. Campo          |_. Tipo   |_. Precisão |_. Descrição |
229 23 Anônimo
| codEmpresa *     | String/Integer   | 10         | Código da Empresa origem dos dados |
230 23 Anônimo
| codColecao *     | String | 255        | Código da Coleção sobre a qual estamos gerando os dados. |
231 23 Anônimo
| 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) |
232 23 Anônimo
| codLinha *       | String   | 255        | Código da Linha de Produto. Define-se com o cliente o que ele quer gerar como linha de produto.  |
233 23 Anônimo
| codRepres *      | String/Integer   | 255        | Código do Representante no ERP |
234 23 Anônimo
| codCliente *     | String/Integer   | 255        | Codigo do Cliente |
235 23 Anônimo
| codIBGE *        | String  | 7          | Codigo do IBGE da Cidade do Cliente |
236 23 Anônimo
| UF *             | String  | 2          | Sigla da UF da Cidade do Cliente |
237 23 Anônimo
| valorBruto       | Double   |            | Valor Bruto das Vendas |
238 1 Anônimo
| valorLiquido     | Double   |            | Valor Liquido das Vendas (ex: Valor Bruto - Valor Descontos) |
239 1 Anônimo
| valorDesconto    | Double   |            | Valor de Descontos das Vendas |
240 1 Anônimo
| valorComissao    | Double   |            | Valor de Comissão das Vendas |
241 1 Anônimo
| prazoMedioXValor | Double   |            | Valor Líquido das Vendas multiplicado pelo Prazo Médio de pagamento. |
242 23 Anônimo
| quantidade       | Double   |            | Quantidade de Peças das Vendas |
243 1 Anônimo
| nomeCliente *    | String   | 255        | Nome do Cliente |
244 1 Anônimo
| codPedido *      | String   | 255        | Código do Pedido |
245 1 Anônimo
| codProduto *     | String   | 255        | Código do produto ou referência |
246 23 Anônimo
| campoCoringa1 *  | String   | 255        | Campo valores diversos, inicialmente retornar NULL - Ver com IBTech |
247 1 Anônimo
| campoCoringa2 *  | String   | 255        | Campo valores diversos, inicialmente retornar NULL - Ver com IBTech |
248 1 Anônimo
| campoCoringa3 *  | String   | 255        | Campo valores diversos, inicialmente retornar NULL - Ver com IBTech |
249 43 ivo
| dataPrevFaturamento | Date    |        | Data de Previsão de Faturamento |
250 43 ivo
| nomeDistrito *       | String   | 255        |  Nome do Distrito (para o caso de São Paulo, os bairros – para o caso de Brasília, os Distritos)
251 65 victor.klemann
Se o seu sistema não tiver esta informação, retornar o bairro. |
252 43 ivo
| 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 |
253 94 ivo
| valorRentabilidade | Double   |            | *Campo Específico*. Retornar null , salvo alguma orientação diferente da IBTech. Valor da Rentabilidade do Pedido. Se o seu ERP não tem rentabilidade por pedido, retornar null |
254 94 ivo
| dataUltFaturamento | Date   |            | *Campo Específico*. Retornar null , salvo alguma orientação diferente da IBTech. Data do último faturamento do Pedido. Retornar apenas se for uma informação fácil|
255 94 ivo
| valorFaturado | Double   |            | *Campo Específico*. Retornar null , salvo alguma orientação diferente da IBTech. Valor já Faturado do pedido |
256 94 ivo
| valorSaldo | Double   |            | *Campo Específico*. Retornar null , salvo alguma orientação diferente da IBTech. Valor Saldo |
257 51 victor.klemann
| codMarca *       | String   | 255        | Código da Marca do Produto |
258 1 Anônimo
| nomeGrupoCliente | String | 255 | Descrição do Grupo do Cliente |
259 65 victor.klemann
| dataEmissao | Date | | Data de Emissão do Pedido |
260 94 ivo
| codRepresAgrupador | String | 255 | *Campo Específico*. Retornar null , salvo alguma orientação diferente da IBTech. Código do representante agrupador (atacado) |
261 94 ivo
| flagPolitica | Integer| | *Campo Específico*. Retornar null , salvo alguma orientação diferente da IBTech. Pedido de acordo com a politica comercial (0 - não / 1 - sim) |
262 73 victor.klemann
| codTabPreco | String | 255 | Código da Tabela de Preço |
263 94 ivo
| qtdeItens | Double | | *Campo Específico*. Retornar null , salvo alguma orientação diferente da IBTech. Quantidade de Itens do Pedido |
264 94 ivo
| qtdeEmQuilos | Double | | *Campo Específico*. Retornar null , salvo alguma orientação diferente da IBTech. Quantidade de Peças das Vendas em Quilos |
265 23 Anônimo
266 95 ivo
h2. Liquidez (Deprecated)
267 23 Anônimo
268 95 ivo
269 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.
270 32 ivo
A Liquidez resume-se a:
271 32 ivo
- O Valor a vencer no período e pago dividido pelo a vencer no período.
272 23 Anônimo
- Não entra no cálculo da Liquidez os títulos pagos fora do período de vencimento.
273 1 Anônimo
274 1 Anônimo
*Importante!* Este SQL possui parâmetros.
275 1 Anônimo
276 1 Anônimo
Layout da tabela/visão:
277 23 Anônimo
278 23 Anônimo
|_. Campo          |_. Tipo   |_. Precisão |_. Descrição |
279 23 Anônimo
| codRepres *      | String/Integer   | 255        | Código do Representante no ERP |
280 23 Anônimo
| valorAReceber    | Double   |            | Valor a receber acumulado por representante |
281 1 Anônimo
| valorRecebido    | Double   |            | Valor recebido acumulado por representante |
282 1 Anônimo
283 1 Anônimo
Lista de Parâmetros:
284 23 Anônimo
285 1 Anônimo
_Formato sugerido de data: dd/mm/yyyy (31/12/2013)_
286 23 Anônimo
287 23 Anônimo
|_. Parâmetro      |_. Tipo   |_. Precisão |_. Descrição |
288 23 Anônimo
| :pCodEmpresa     | String/Integer   | 10         | (opcional) Código da empresa no ERP |
289 23 Anônimo
| :pDataInicio     | String   | 10         | Data inicial para filtrar o vencimento e pagamento (formato a combinar) |
290 1 Anônimo
| :pDataFim        | String   | 10         | Data final para filtrar o vencimento e pagamento (formato a combinar) |
291 23 Anônimo
292 1 Anônimo
*Exemplo:*
293 23 Anônimo
294 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:
295 23 Anônimo
296 23 Anônimo
*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 IBTech para configuração.
297 23 Anônimo
298 23 Anônimo
<pre>
299 23 Anônimo
SELECT codRepres, sum(valorAReceber), sum(valorRecebido)
300 23 Anônimo
FROM (
301 23 Anônimo
		SELECT codRepres,
302 23 Anônimo
				valorTitulo as valorAReceber,
303 23 Anônimo
				0.0 as valorRecebido
304 23 Anônimo
		FROM ContasAReceber
305 23 Anônimo
		WHERE codempresa = :pCodEmpresa
306 23 Anônimo
		AND dataVecto >= to_date(:pDataInicio,'dd/mm/yyyy')
307 23 Anônimo
		AND dataVecto <=to_date(:pDataFim,'dd/mm/yyyy')
308 23 Anônimo
		UNION ALL
309 23 Anônimo
		SELECT codrepres,
310 23 Anônimo
				0.0 as valorAReceber,
311 23 Anônimo
				sum(valorTitulo) as valorRecebido
312 23 Anônimo
		FROM ContasRecebidas
313 23 Anônimo
		WHERE codempresa = :pCodEmpresa
314 23 Anônimo
		AND dataPagto >= to_date(:pDataInicio,'dd/mm/yyyy')
315 23 Anônimo
		AND dataPagto <=to_date(:pDataFim,'dd/mm/yyyy')
316 23 Anônimo
		AND dataVecto >= to_date(:pDataInicio,'dd/mm/yyyy')
317 23 Anônimo
		AND dataVecto <=to_date(:pDataFim,'dd/mm/yyyy')
318 23 Anônimo
)
319 23 Anônimo
GROUP BY codRepres
320 69 victor.klemann
</pre>
321 1 Anônimo
322 69 victor.klemann
h2. Faturamento - Contrato
323 104 victor.klemann
324 95 ivo
*Atenção! Tabela específica. Retornar apenas se for combinado algo com a IBTech*
325 69 victor.klemann
326 69 victor.klemann
|_. Campo          |_. Tipo   |_. Precisão |_. Descrição |
327 69 victor.klemann
| codRepres *      | String/Integer   | 255        | Código do Representante no ERP |
328 69 victor.klemann
| qtdeFaturada | Double   |            | Quantidade Faturada |
329 69 victor.klemann
| valorFaturado    | Double   |            | Valor Faturado |
330 69 victor.klemann
331 69 victor.klemann
Lista de Parâmetros:
332 69 victor.klemann
333 74 Anônimo
|_. Parâmetro      |_. Tipo   |_. Precisão |_. Descrição |
334 74 Anônimo
| :p1     | String/Integer   | 10         | (opcional) Código da empresa no ERP |
335 74 Anônimo
| :p2     | String   | 10         | Data inicial para filtrar a emissão da nota fiscal |
336 69 victor.klemann
| :p3        | String   | 10         | Data final para filtrar a emissão da nota fiscal |
337 69 victor.klemann
| #COLECOES  | String   | 10         | Coleção da nota fiscal |
338 88 victor.klemann
| #MARCAS       | String   | 10         | Marca da nota fiscal |
339 70 victor.klemann
| #LINHAS   | String   | 10         | Linha da nota fiscal |
340 70 victor.klemann
| #CORINGA1   | String   | 10         | Campo valores diversos, inicialmente retornar NULL - Ver com IBTech |
341 70 victor.klemann
| #CORINGA2   | String   | 10         | Campo valores diversos, inicialmente retornar NULL - Ver com IBTech |
342 1 Anônimo
| #CORINGA3   | String   | 10         | Campo valores diversos, inicialmente retornar NULL - Ver com IBTech |
343 97 gabriel
344 99 victor.klemann
h2. Meta do Representante
345 105 victor.klemann
346 99 victor.klemann
*Atenção! Tabela específica. Retornar apenas se for combinado algo com a IBTech*
347 99 victor.klemann
348 99 victor.klemann
|_. Campo          |_. Tipo   |_. Precisão |_. Descrição |
349 99 victor.klemann
| codEmpresa * | String/Integer | 255 | Código da empresa |
350 99 victor.klemann
| codColecao * | String | 255 | Código da coleção no ERP. |
351 99 victor.klemann
| codMarca  | String | 255 | Código da marca no ERP. |
352 99 victor.klemann
| codRepres *      | String/Integer   | 255        | Código do Representante no ERP |
353 99 victor.klemann
| metaValor | Double   |            | Meta em valor do representante |
354 99 victor.klemann
| metaQtde | Double   |            | Meta em quantidade do representante |
355 99 victor.klemann
| metaPrazoMedio | Double   |            | Meta em prazo médio do representante |
356 99 victor.klemann
357 99 victor.klemann
h2. Meta do Representante - Linha de Produto
358 99 victor.klemann
*Atenção! Tabela específica. Retornar apenas se for combinado algo com a IBTech*
359 99 victor.klemann
360 99 victor.klemann
|_. Campo          |_. Tipo   |_. Precisão |_. Descrição |
361 99 victor.klemann
| codEmpresa * | String/Integer | 255 | Código da empresa |
362 99 victor.klemann
| codColecao * | String | 255 | Código da coleção no ERP. |
363 99 victor.klemann
| codMarca  | String | 255 | Código da marca no ERP. |
364 99 victor.klemann
| codRepres *      | String/Integer   | 255        | Código do Representante no ERP |
365 99 victor.klemann
| codLinha | Double   |            | Código da linha de produto no ERP. |
366 99 victor.klemann
| percMeta | Double   |            | Percentual de representatividade da linha sobre a meta geral |
367 99 victor.klemann
368 99 victor.klemann
h2. Meta do Escritório
369 106 victor.klemann
370 99 victor.klemann
*Atenção! Tabela específica. Retornar apenas se for combinado algo com a IBTech*
371 99 victor.klemann
372 99 victor.klemann
|_. Campo          |_. Tipo   |_. Precisão |_. Descrição |
373 99 victor.klemann
| codEmpresa * | String/Integer | 255 | Código da empresa |
374 99 victor.klemann
| codColecao * | String | 255 | Código da coleção no ERP. |
375 99 victor.klemann
| codMarca  | String | 255 | Código da marca no ERP. |
376 99 victor.klemann
| codEscritorio *      | String/Integer   | 255        | Código do escritório de representação no ERP |
377 99 victor.klemann
| metaValor | Double   |            | Meta em valor do escritório |
378 99 victor.klemann
| metaQtde | Double   |            | Meta em quantidade do escritório |
379 99 victor.klemann
| metaPrazoMedio | Double   |            | Meta em prazo médio do escritório |
380 99 victor.klemann
381 99 victor.klemann
Lista de Parâmetros:
382 99 victor.klemann
383 99 victor.klemann
|_. Parâmetro      |_. Tipo   |_. Precisão |_. Descrição |
384 99 victor.klemann
| :p1     | String/Integer   | 10         | (opcional) Código da empresa no ERP |
385 99 victor.klemann
| :p2     | String   | 10         | Data inicial para filtrar a emissão da nota fiscal |
386 99 victor.klemann
| :p3        | String   | 10         | Data final para filtrar a emissão da nota fiscal |
387 99 victor.klemann
| #COLECOES  | String   | 10         | Coleção da nota fiscal |
388 99 victor.klemann
| #MARCAS       | String   | 10         | Marca da nota fiscal |
389 99 victor.klemann
| #LINHAS   | String   | 10         | Linha da nota fiscal |
390 99 victor.klemann
| #CORINGA1   | String   | 10         | Campo valores diversos, inicialmente retornar NULL - Ver com IBTech |
391 99 victor.klemann
| #CORINGA2   | String   | 10         | Campo valores diversos, inicialmente retornar NULL - Ver com IBTech |
392 99 victor.klemann
| #CORINGA3   | String   | 10         | Campo valores diversos, inicialmente retornar NULL - Ver com IBTech |
393 99 victor.klemann
394 97 gabriel
h2. Valores para Cálculo Desconto Fidelidade Acumulativa
395 97 gabriel
396 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
397 98 gabriel
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 anteiror ao calculo. os vide exemplo abaixo.
398 97 gabriel
399 97 gabriel
|_. Campo  |_. Tipo   |_. Precisão |_. Descrição |
400 97 gabriel
|data | Date | | Data vigente da compra, dependendo do cliente pode ser considerada a data de emissão, de faturamento |
401 97 gabriel
|codCliente | Varchar| 255 | Código do cliente  |
402 97 gabriel
|valor| Double | | Valor somado por cliente e data |
403 97 gabriel
404 97 gabriel
Ex:
405 97 gabriel
<pre><code class="sql">
406 98 gabriel
SELECT DataEmissao,
407 98 gabriel
codCliente,
408 98 gabriel
SUM(valorBruto)
409 97 gabriel
FROM (
410 98 gabriel
select date_trunc('month', dataEmissao) DataEmissao,
411 98 gabriel
codCliente, 
412 98 gabriel
valorBruto
413 98 gabriel
FROM ETLPedido pedido
414 98 gabriel
WHERE pedido.codEmpresa = :p1
415 98 gabriel
AND pedido.dataEmissao<=:p2) Pedidos
416 97 gabriel
GROUP BY DataEmissao,codCliente
417 97 gabriel
ORDER BY codCliente, DataEmissao DESC
418 97 gabriel
</code></pre>