Projeto

Geral

Perfil

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

victor.klemann, 05/06/2019 14:08 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 94 ivo
| limiteCredito | Double | | *Campo Específico*. Retornar null , salvo alguma orientação diferente da IBTech. Limite de crédito do cliente. |
141 86 victor.klemann
| codRamoAtividade | String |255| Código do Ramo de atividade do cliente. Não obrigatório. Se não tiver retornar null. |
142 86 victor.klemann
143 1 Anônimo
h2. Cliente e Prospect - Histórico
144 94 ivo
*Atenção! Tabela específica. Retornar apenas se for combinado algo com a IBTech*
145 62 victor.klemann
146 62 victor.klemann
|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |
147 62 victor.klemann
| dataAlteracao | Date |             | Data da Alteração | 
148 62 victor.klemann
| horaAlteracao | Date  |           | Hora da Alteração |
149 62 victor.klemann
| codUsuario     |  String | 255  | Código do Usuário |
150 62 victor.klemann
| nomeUsuario  | String | 255  | Nome do usuário |
151 62 victor.klemann
| situacao           | String | 255  | Código da Situação |
152 62 victor.klemann
| situacaoEdt     | String | 255  | Descrição da Situação |
153 62 victor.klemann
154 94 ivo
155 62 victor.klemann
Lista de Parâmetros:
156 63 victor.klemann
157 62 victor.klemann
|_. Campo  |_. Parâmetro  |_. Tipo         |_. Precisão |_. Descrição     |
158 63 victor.klemann
|  codEmpresa | :p1    | String          | 255           | Código da Empresa  |
159 63 victor.klemann
| codCliente | :p2 | String | 255 | Código do Cliente |
160 63 victor.klemann
161 63 victor.klemann
162 62 victor.klemann
h2. Marcas do Cliente
163 95 ivo
*Atenção! Tabela específica. Retornar apenas se for combinado algo com a IBTech*
164 59 victor.klemann
165 94 ivo
Tabela com a relação de marcas do cliente, conforme vendas.
166 59 victor.klemann
167 59 victor.klemann
|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |
168 59 victor.klemann
| codEmpresa * | String | 255         | Código da Empresa origem dos dados |
169 59 victor.klemann
| codCliente *    | String   | 255          | Codigo do Cliente |
170 59 victor.klemann
| codMarca * | String   | 255          | Código da Marca |
171 59 victor.klemann
172 23 Anônimo
h2. Coleções
173 23 Anônimo
174 23 Anônimo
Tabela/visão com a relação das coleções.
175 23 Anônimo
176 23 Anônimo
|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |
177 23 Anônimo
| codEmpresa * | String/Integer   | 10         | Código da Empresa origem dos dados |
178 23 Anônimo
| codColecao *     | String   | 255          | Codigo da coleção |
179 23 Anônimo
| nome      | String   | 255          | Nome da coleção |
180 23 Anônimo
181 23 Anônimo
h2. Linhas de Produto
182 23 Anônimo
183 23 Anônimo
Lista das linhas de produtos que tiveram dados gerados.
184 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.)
185 23 Anônimo
186 23 Anônimo
|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |
187 23 Anônimo
| codEmpresa * | String/Integer  | 10   | Código da Empresa origem dos dados |
188 23 Anônimo
| codLinha *     | String  | 255        | Codigo da linha de produto |
189 23 Anônimo
| nome      | String   | 255          | Nome da linha de produto |
190 46 Anônimo
191 46 Anônimo
h2. Marcas
192 46 Anônimo
193 46 Anônimo
_Integração Opcional - Confirme com a IBTech a necessidade de criar esta integração._
194 46 Anônimo
Lista de marcas por empresa.
195 46 Anônimo
196 46 Anônimo
|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |
197 46 Anônimo
| codEmpresa * | String/Integer  | 10   | Código da Empresa origem dos dados |
198 46 Anônimo
| codMarca *     | String  | 255        | Código da marca |
199 46 Anônimo
| nome      | String   | 255          | Nome da marca |
200 23 Anônimo
201 23 Anônimo
h2. Vendas
202 23 Anônimo
203 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.
204 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).
205 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.
206 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).
207 23 Anônimo
208 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.
209 23 Anônimo
210 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).
211 23 Anônimo
212 23 Anônimo
*Observação:* Os campos com asterisco (*) deverão ser agrupados(group by) e os demais somados (sum).
213 23 Anônimo
214 23 Anônimo
|_. Campo          |_. Tipo   |_. Precisão |_. Descrição |
215 23 Anônimo
| codEmpresa *     | String/Integer   | 10         | Código da Empresa origem dos dados |
216 23 Anônimo
| codColecao *     | String | 255        | Código da Coleção sobre a qual estamos gerando os dados. |
217 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) |
218 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.  |
219 23 Anônimo
| codRepres *      | String/Integer   | 255        | Código do Representante no ERP |
220 23 Anônimo
| codCliente *     | String/Integer   | 255        | Codigo do Cliente |
221 23 Anônimo
| codIBGE *        | String  | 7          | Codigo do IBGE da Cidade do Cliente |
222 23 Anônimo
| UF *             | String  | 2          | Sigla da UF da Cidade do Cliente |
223 23 Anônimo
| valorBruto       | Double   |            | Valor Bruto das Vendas |
224 1 Anônimo
| valorLiquido     | Double   |            | Valor Liquido das Vendas (ex: Valor Bruto - Valor Descontos) |
225 1 Anônimo
| valorDesconto    | Double   |            | Valor de Descontos das Vendas |
226 1 Anônimo
| valorComissao    | Double   |            | Valor de Comissão das Vendas |
227 1 Anônimo
| prazoMedioXValor | Double   |            | Valor Líquido das Vendas multiplicado pelo Prazo Médio de pagamento. |
228 23 Anônimo
| quantidade       | Double   |            | Quantidade de Peças das Vendas |
229 1 Anônimo
| nomeCliente *    | String   | 255        | Nome do Cliente |
230 1 Anônimo
| codPedido *      | String   | 255        | Código do Pedido |
231 1 Anônimo
| codProduto *     | String   | 255        | Código do produto ou referência |
232 23 Anônimo
| campoCoringa1 *  | String   | 255        | Campo valores diversos, inicialmente retornar NULL - Ver com IBTech |
233 1 Anônimo
| campoCoringa2 *  | String   | 255        | Campo valores diversos, inicialmente retornar NULL - Ver com IBTech |
234 1 Anônimo
| campoCoringa3 *  | String   | 255        | Campo valores diversos, inicialmente retornar NULL - Ver com IBTech |
235 43 ivo
| dataPrevFaturamento | Date    |        | Data de Previsão de Faturamento |
236 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)
237 65 victor.klemann
Se o seu sistema não tiver esta informação, retornar o bairro. |
238 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 |
239 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 |
240 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|
241 94 ivo
| valorFaturado | Double   |            | *Campo Específico*. Retornar null , salvo alguma orientação diferente da IBTech. Valor já Faturado do pedido |
242 94 ivo
| valorSaldo | Double   |            | *Campo Específico*. Retornar null , salvo alguma orientação diferente da IBTech. Valor Saldo |
243 51 victor.klemann
| codMarca *       | String   | 255        | Código da Marca do Produto |
244 1 Anônimo
| nomeGrupoCliente | String | 255 | Descrição do Grupo do Cliente |
245 65 victor.klemann
| dataEmissao | Date | | Data de Emissão do Pedido |
246 94 ivo
| codRepresAgrupador | String | 255 | *Campo Específico*. Retornar null , salvo alguma orientação diferente da IBTech. Código do representante agrupador (atacado) |
247 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) |
248 73 victor.klemann
| codTabPreco | String | 255 | Código da Tabela de Preço |
249 94 ivo
| qtdeItens | Double | | *Campo Específico*. Retornar null , salvo alguma orientação diferente da IBTech. Quantidade de Itens do Pedido |
250 94 ivo
| qtdeEmQuilos | Double | | *Campo Específico*. Retornar null , salvo alguma orientação diferente da IBTech. Quantidade de Peças das Vendas em Quilos |
251 23 Anônimo
252 95 ivo
h2. Liquidez (Deprecated)
253 23 Anônimo
254 95 ivo
255 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.
256 32 ivo
A Liquidez resume-se a:
257 32 ivo
- O Valor a vencer no período e pago dividido pelo a vencer no período.
258 23 Anônimo
- Não entra no cálculo da Liquidez os títulos pagos fora do período de vencimento.
259 1 Anônimo
260 1 Anônimo
*Importante!* Este SQL possui parâmetros.
261 1 Anônimo
262 1 Anônimo
Layout da tabela/visão:
263 23 Anônimo
264 23 Anônimo
|_. Campo          |_. Tipo   |_. Precisão |_. Descrição |
265 23 Anônimo
| codRepres *      | String/Integer   | 255        | Código do Representante no ERP |
266 23 Anônimo
| valorAReceber    | Double   |            | Valor a receber acumulado por representante |
267 1 Anônimo
| valorRecebido    | Double   |            | Valor recebido acumulado por representante |
268 1 Anônimo
269 1 Anônimo
Lista de Parâmetros:
270 23 Anônimo
271 1 Anônimo
_Formato sugerido de data: dd/mm/yyyy (31/12/2013)_
272 23 Anônimo
273 23 Anônimo
|_. Parâmetro      |_. Tipo   |_. Precisão |_. Descrição |
274 23 Anônimo
| :pCodEmpresa     | String/Integer   | 10         | (opcional) Código da empresa no ERP |
275 23 Anônimo
| :pDataInicio     | String   | 10         | Data inicial para filtrar o vencimento e pagamento (formato a combinar) |
276 1 Anônimo
| :pDataFim        | String   | 10         | Data final para filtrar o vencimento e pagamento (formato a combinar) |
277 23 Anônimo
278 1 Anônimo
*Exemplo:*
279 23 Anônimo
280 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:
281 23 Anônimo
282 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.
283 23 Anônimo
284 23 Anônimo
<pre>
285 23 Anônimo
SELECT codRepres, sum(valorAReceber), sum(valorRecebido)
286 23 Anônimo
FROM (
287 23 Anônimo
		SELECT codRepres,
288 23 Anônimo
				valorTitulo as valorAReceber,
289 23 Anônimo
				0.0 as valorRecebido
290 23 Anônimo
		FROM ContasAReceber
291 23 Anônimo
		WHERE codempresa = :pCodEmpresa
292 23 Anônimo
		AND dataVecto >= to_date(:pDataInicio,'dd/mm/yyyy')
293 23 Anônimo
		AND dataVecto <=to_date(:pDataFim,'dd/mm/yyyy')
294 23 Anônimo
		UNION ALL
295 23 Anônimo
		SELECT codrepres,
296 23 Anônimo
				0.0 as valorAReceber,
297 23 Anônimo
				sum(valorTitulo) as valorRecebido
298 23 Anônimo
		FROM ContasRecebidas
299 23 Anônimo
		WHERE codempresa = :pCodEmpresa
300 23 Anônimo
		AND dataPagto >= to_date(:pDataInicio,'dd/mm/yyyy')
301 23 Anônimo
		AND dataPagto <=to_date(:pDataFim,'dd/mm/yyyy')
302 23 Anônimo
		AND dataVecto >= to_date(:pDataInicio,'dd/mm/yyyy')
303 23 Anônimo
		AND dataVecto <=to_date(:pDataFim,'dd/mm/yyyy')
304 23 Anônimo
)
305 23 Anônimo
GROUP BY codRepres
306 69 victor.klemann
</pre>
307 1 Anônimo
308 69 victor.klemann
h2. Faturamento - Contrato
309 95 ivo
*Atenção! Tabela específica. Retornar apenas se for combinado algo com a IBTech*
310 69 victor.klemann
311 69 victor.klemann
|_. Campo          |_. Tipo   |_. Precisão |_. Descrição |
312 69 victor.klemann
| codRepres *      | String/Integer   | 255        | Código do Representante no ERP |
313 69 victor.klemann
| qtdeFaturada | Double   |            | Quantidade Faturada |
314 69 victor.klemann
| valorFaturado    | Double   |            | Valor Faturado |
315 69 victor.klemann
316 69 victor.klemann
Lista de Parâmetros:
317 69 victor.klemann
318 74 Anônimo
|_. Parâmetro      |_. Tipo   |_. Precisão |_. Descrição |
319 74 Anônimo
| :p1     | String/Integer   | 10         | (opcional) Código da empresa no ERP |
320 74 Anônimo
| :p2     | String   | 10         | Data inicial para filtrar a emissão da nota fiscal |
321 69 victor.klemann
| :p3        | String   | 10         | Data final para filtrar a emissão da nota fiscal |
322 69 victor.klemann
| #COLECOES  | String   | 10         | Coleção da nota fiscal |
323 88 victor.klemann
| #MARCAS       | String   | 10         | Marca da nota fiscal |
324 70 victor.klemann
| #LINHAS   | String   | 10         | Linha da nota fiscal |
325 70 victor.klemann
| #CORINGA1   | String   | 10         | Campo valores diversos, inicialmente retornar NULL - Ver com IBTech |
326 70 victor.klemann
| #CORINGA2   | String   | 10         | Campo valores diversos, inicialmente retornar NULL - Ver com IBTech |
327 1 Anônimo
| #CORINGA3   | String   | 10         | Campo valores diversos, inicialmente retornar NULL - Ver com IBTech |
328 97 gabriel
329 99 victor.klemann
h2. Meta do Representante
330 99 victor.klemann
*Atenção! Tabela específica. Retornar apenas se for combinado algo com a IBTech*
331 99 victor.klemann
332 99 victor.klemann
|_. Campo          |_. Tipo   |_. Precisão |_. Descrição |
333 99 victor.klemann
| codEmpresa * | String/Integer | 255 | Código da empresa |
334 99 victor.klemann
| codColecao * | String | 255 | Código da coleção no ERP. |
335 99 victor.klemann
| codMarca  | String | 255 | Código da marca no ERP. |
336 99 victor.klemann
| codRepres *      | String/Integer   | 255        | Código do Representante no ERP |
337 99 victor.klemann
| metaValor | Double   |            | Meta em valor do representante |
338 99 victor.klemann
| metaQtde | Double   |            | Meta em quantidade do representante |
339 99 victor.klemann
| metaPrazoMedio | Double   |            | Meta em prazo médio do representante |
340 99 victor.klemann
341 99 victor.klemann
h2. Meta do Representante - Linha de Produto
342 99 victor.klemann
*Atenção! Tabela específica. Retornar apenas se for combinado algo com a IBTech*
343 99 victor.klemann
344 99 victor.klemann
|_. Campo          |_. Tipo   |_. Precisão |_. Descrição |
345 99 victor.klemann
| codEmpresa * | String/Integer | 255 | Código da empresa |
346 99 victor.klemann
| codColecao * | String | 255 | Código da coleção no ERP. |
347 99 victor.klemann
| codMarca  | String | 255 | Código da marca no ERP. |
348 99 victor.klemann
| codRepres *      | String/Integer   | 255        | Código do Representante no ERP |
349 99 victor.klemann
| codLinha | Double   |            | Código da linha de produto no ERP. |
350 99 victor.klemann
| percMeta | Double   |            | Percentual de representatividade da linha sobre a meta geral |
351 99 victor.klemann
352 99 victor.klemann
h2. Meta do Escritório
353 99 victor.klemann
*Atenção! Tabela específica. Retornar apenas se for combinado algo com a IBTech*
354 99 victor.klemann
355 99 victor.klemann
|_. Campo          |_. Tipo   |_. Precisão |_. Descrição |
356 99 victor.klemann
| codEmpresa * | String/Integer | 255 | Código da empresa |
357 99 victor.klemann
| codColecao * | String | 255 | Código da coleção no ERP. |
358 99 victor.klemann
| codMarca  | String | 255 | Código da marca no ERP. |
359 99 victor.klemann
| codEscritorio *      | String/Integer   | 255        | Código do escritório de representação no ERP |
360 99 victor.klemann
| metaValor | Double   |            | Meta em valor do escritório |
361 99 victor.klemann
| metaQtde | Double   |            | Meta em quantidade do escritório |
362 99 victor.klemann
| metaPrazoMedio | Double   |            | Meta em prazo médio do escritório |
363 99 victor.klemann
364 99 victor.klemann
Lista de Parâmetros:
365 99 victor.klemann
366 99 victor.klemann
|_. Parâmetro      |_. Tipo   |_. Precisão |_. Descrição |
367 99 victor.klemann
| :p1     | String/Integer   | 10         | (opcional) Código da empresa no ERP |
368 99 victor.klemann
| :p2     | String   | 10         | Data inicial para filtrar a emissão da nota fiscal |
369 99 victor.klemann
| :p3        | String   | 10         | Data final para filtrar a emissão da nota fiscal |
370 99 victor.klemann
| #COLECOES  | String   | 10         | Coleção da nota fiscal |
371 99 victor.klemann
| #MARCAS       | String   | 10         | Marca da nota fiscal |
372 99 victor.klemann
| #LINHAS   | String   | 10         | Linha da nota fiscal |
373 99 victor.klemann
| #CORINGA1   | String   | 10         | Campo valores diversos, inicialmente retornar NULL - Ver com IBTech |
374 99 victor.klemann
| #CORINGA2   | String   | 10         | Campo valores diversos, inicialmente retornar NULL - Ver com IBTech |
375 99 victor.klemann
| #CORINGA3   | String   | 10         | Campo valores diversos, inicialmente retornar NULL - Ver com IBTech |
376 99 victor.klemann
377 97 gabriel
h2. Valores para Cálculo Desconto Fidelidade Acumulativa
378 97 gabriel
379 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
380 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.
381 97 gabriel
382 97 gabriel
|_. Campo  |_. Tipo   |_. Precisão |_. Descrição |
383 97 gabriel
|data | Date | | Data vigente da compra, dependendo do cliente pode ser considerada a data de emissão, de faturamento |
384 97 gabriel
|codCliente | Varchar| 255 | Código do cliente  |
385 97 gabriel
|valor| Double | | Valor somado por cliente e data |
386 97 gabriel
387 97 gabriel
Ex:
388 97 gabriel
<pre><code class="sql">
389 98 gabriel
SELECT DataEmissao,
390 98 gabriel
codCliente,
391 98 gabriel
SUM(valorBruto)
392 97 gabriel
FROM (
393 98 gabriel
select date_trunc('month', dataEmissao) DataEmissao,
394 98 gabriel
codCliente, 
395 98 gabriel
valorBruto
396 98 gabriel
FROM ETLPedido pedido
397 98 gabriel
WHERE pedido.codEmpresa = :p1
398 98 gabriel
AND pedido.dataEmissao<=:p2) Pedidos
399 97 gabriel
GROUP BY DataEmissao,codCliente
400 97 gabriel
ORDER BY codCliente, DataEmissao DESC
401 97 gabriel
</code></pre>