Projeto

Geral

Perfil

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

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