Projeto

Geral

Perfil

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

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