Manual de Integração » Histórico » Versão 104
victor.klemann, 10/06/2019 19: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 | 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 | 104 | victor.klemann | |
323 | 95 | ivo | *Atenção! Tabela específica. Retornar apenas se for combinado algo com a IBTech* |
324 | 69 | victor.klemann | |
325 | 69 | victor.klemann | |_. Campo |_. Tipo |_. Precisão |_. Descrição | |
326 | 69 | victor.klemann | | codRepres * | String/Integer | 255 | Código do Representante no ERP | |
327 | 69 | victor.klemann | | qtdeFaturada | Double | | Quantidade Faturada | |
328 | 69 | victor.klemann | | valorFaturado | Double | | Valor Faturado | |
329 | 69 | victor.klemann | |
330 | 69 | victor.klemann | Lista de Parâmetros: |
331 | 69 | victor.klemann | |
332 | 74 | Anônimo | |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição | |
333 | 74 | Anônimo | | :p1 | String/Integer | 10 | (opcional) Código da empresa no ERP | |
334 | 74 | Anônimo | | :p2 | String | 10 | Data inicial para filtrar a emissão da nota fiscal | |
335 | 69 | victor.klemann | | :p3 | String | 10 | Data final para filtrar a emissão da nota fiscal | |
336 | 69 | victor.klemann | | #COLECOES | String | 10 | Coleção da nota fiscal | |
337 | 88 | victor.klemann | | #MARCAS | String | 10 | Marca da nota fiscal | |
338 | 70 | victor.klemann | | #LINHAS | String | 10 | Linha da nota fiscal | |
339 | 70 | victor.klemann | | #CORINGA1 | String | 10 | Campo valores diversos, inicialmente retornar NULL - Ver com IBTech | |
340 | 70 | victor.klemann | | #CORINGA2 | String | 10 | Campo valores diversos, inicialmente retornar NULL - Ver com IBTech | |
341 | 1 | Anônimo | | #CORINGA3 | String | 10 | Campo valores diversos, inicialmente retornar NULL - Ver com IBTech | |
342 | 97 | gabriel | |
343 | 99 | victor.klemann | h2. Meta do Representante |
344 | 99 | victor.klemann | *Atenção! Tabela específica. Retornar apenas se for combinado algo com a IBTech* |
345 | 99 | victor.klemann | |
346 | 99 | victor.klemann | |_. Campo |_. Tipo |_. Precisão |_. Descrição | |
347 | 99 | victor.klemann | | codEmpresa * | String/Integer | 255 | Código da empresa | |
348 | 99 | victor.klemann | | codColecao * | String | 255 | Código da coleção no ERP. | |
349 | 99 | victor.klemann | | codMarca | String | 255 | Código da marca no ERP. | |
350 | 99 | victor.klemann | | codRepres * | String/Integer | 255 | Código do Representante no ERP | |
351 | 99 | victor.klemann | | metaValor | Double | | Meta em valor do representante | |
352 | 99 | victor.klemann | | metaQtde | Double | | Meta em quantidade do representante | |
353 | 99 | victor.klemann | | metaPrazoMedio | Double | | Meta em prazo médio do representante | |
354 | 99 | victor.klemann | |
355 | 99 | victor.klemann | h2. Meta do Representante - Linha de Produto |
356 | 99 | victor.klemann | *Atenção! Tabela específica. Retornar apenas se for combinado algo com a IBTech* |
357 | 99 | victor.klemann | |
358 | 99 | victor.klemann | |_. Campo |_. Tipo |_. Precisão |_. Descrição | |
359 | 99 | victor.klemann | | codEmpresa * | String/Integer | 255 | Código da empresa | |
360 | 99 | victor.klemann | | codColecao * | String | 255 | Código da coleção no ERP. | |
361 | 99 | victor.klemann | | codMarca | String | 255 | Código da marca no ERP. | |
362 | 99 | victor.klemann | | codRepres * | String/Integer | 255 | Código do Representante no ERP | |
363 | 99 | victor.klemann | | codLinha | Double | | Código da linha de produto no ERP. | |
364 | 99 | victor.klemann | | percMeta | Double | | Percentual de representatividade da linha sobre a meta geral | |
365 | 99 | victor.klemann | |
366 | 99 | victor.klemann | h2. Meta do Escritório |
367 | 99 | victor.klemann | *Atenção! Tabela específica. Retornar apenas se for combinado algo com a IBTech* |
368 | 99 | victor.klemann | |
369 | 99 | victor.klemann | |_. Campo |_. Tipo |_. Precisão |_. Descrição | |
370 | 99 | victor.klemann | | codEmpresa * | String/Integer | 255 | Código da empresa | |
371 | 99 | victor.klemann | | codColecao * | String | 255 | Código da coleção no ERP. | |
372 | 99 | victor.klemann | | codMarca | String | 255 | Código da marca no ERP. | |
373 | 99 | victor.klemann | | codEscritorio * | String/Integer | 255 | Código do escritório de representação no ERP | |
374 | 99 | victor.klemann | | metaValor | Double | | Meta em valor do escritório | |
375 | 99 | victor.klemann | | metaQtde | Double | | Meta em quantidade do escritório | |
376 | 99 | victor.klemann | | metaPrazoMedio | Double | | Meta em prazo médio do escritório | |
377 | 99 | victor.klemann | |
378 | 99 | victor.klemann | Lista de Parâmetros: |
379 | 99 | victor.klemann | |
380 | 99 | victor.klemann | |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição | |
381 | 99 | victor.klemann | | :p1 | String/Integer | 10 | (opcional) Código da empresa no ERP | |
382 | 99 | victor.klemann | | :p2 | String | 10 | Data inicial para filtrar a emissão da nota fiscal | |
383 | 99 | victor.klemann | | :p3 | String | 10 | Data final para filtrar a emissão da nota fiscal | |
384 | 99 | victor.klemann | | #COLECOES | String | 10 | Coleção da nota fiscal | |
385 | 99 | victor.klemann | | #MARCAS | String | 10 | Marca da nota fiscal | |
386 | 99 | victor.klemann | | #LINHAS | String | 10 | Linha da nota fiscal | |
387 | 99 | victor.klemann | | #CORINGA1 | String | 10 | Campo valores diversos, inicialmente retornar NULL - Ver com IBTech | |
388 | 99 | victor.klemann | | #CORINGA2 | String | 10 | Campo valores diversos, inicialmente retornar NULL - Ver com IBTech | |
389 | 99 | victor.klemann | | #CORINGA3 | String | 10 | Campo valores diversos, inicialmente retornar NULL - Ver com IBTech | |
390 | 99 | victor.klemann | |
391 | 97 | gabriel | h2. Valores para Cálculo Desconto Fidelidade Acumulativa |
392 | 97 | gabriel | |
393 | 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 |
394 | 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. |
395 | 97 | gabriel | |
396 | 97 | gabriel | |_. Campo |_. Tipo |_. Precisão |_. Descrição | |
397 | 97 | gabriel | |data | Date | | Data vigente da compra, dependendo do cliente pode ser considerada a data de emissão, de faturamento | |
398 | 97 | gabriel | |codCliente | Varchar| 255 | Código do cliente | |
399 | 97 | gabriel | |valor| Double | | Valor somado por cliente e data | |
400 | 97 | gabriel | |
401 | 97 | gabriel | Ex: |
402 | 97 | gabriel | <pre><code class="sql"> |
403 | 98 | gabriel | SELECT DataEmissao, |
404 | 98 | gabriel | codCliente, |
405 | 98 | gabriel | SUM(valorBruto) |
406 | 97 | gabriel | FROM ( |
407 | 98 | gabriel | select date_trunc('month', dataEmissao) DataEmissao, |
408 | 98 | gabriel | codCliente, |
409 | 98 | gabriel | valorBruto |
410 | 98 | gabriel | FROM ETLPedido pedido |
411 | 98 | gabriel | WHERE pedido.codEmpresa = :p1 |
412 | 98 | gabriel | AND pedido.dataEmissao<=:p2) Pedidos |
413 | 97 | gabriel | GROUP BY DataEmissao,codCliente |
414 | 97 | gabriel | ORDER BY codCliente, DataEmissao DESC |
415 | 97 | gabriel | </code></pre> |