Projeto

Geral

Perfil

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

victor.klemann, 10/06/2019 19:03 h

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