Digitação de Pedidos » Histórico » Versão 5
Versão 4 (Anônimo, 23/03/2015 11:43 h) → Versão 5/711 (Anônimo, 23/03/2015 12:17 h)
h1. Digitação de Pedidos
*Índice*
# [[Digitação de Pedidos#Introdução|Introdução]]
# [[Digitação de Pedidos#Acesso-via-JDBC|Acesso via JDBC]]
# [[Digitação de Pedidos#Tabelas-de-Integração-Parâmetros-e-Exemplo-de-SQL-de-Integração|Tabelas de Integração, Parâmetros e Exemplo de SQL de Integração]]
## [[Digitação de Pedidos#Tabelas-de-Integração|Tabelas de Integração]]
## [[Digitação de Pedidos#Parâmetros|Parâmetros]]
## [[Digitação de Pedidos#Exemplo-de-SQL-de-Integração|Exemplo de SQL de Integração]]
# [[Digitação de Pedidos#Layouts-de-Integração|Layouts de Integração]]
## [[Digitação de Pedidos#Tabela-de-Preço|Tabela de Preço]]
## [[Digitação de Pedidos#Tabela-de-Preço-Produto|Tabela de Preço - Produto]]
## [[Digitação de Pedidos#Títulos|Títulos]]
## [[Digitação de Pedidos#Condição-de-Venda|Condição de Venda]]
## [[Digitação de Pedidos#Tipo-de-Nota|Tipo de Nota]]
## [[Digitação de Pedidos#Comissões|Comissões]]
## [[Digitação de Pedidos#Clientes|Clientes]]
## [[Digitação de Pedidos#Produtos|Produtos]]
## [[Digitação de Pedidos#Produtos-Grades|Produtos - Grades]]
## [[Digitação de Pedidos#Produtos-Sortimentos|Produtos - Sortimentos]]
## [[Digitação de Pedidos#Pedido-Capa|Pedido - Capa]]
h1. Introdução
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 a Digitação de Pedidos da IBTech.
Dúvidas ou maiores esclarecimentos podem ser obtidos pelo e-mail contato@ibtech.inf.br ou pelo telefone (47) 3370-0504.
h1. Acesso via JDBC
*Pré-Requisito:* Suporte por parte do Banco de Dados da Empresa fornecedora do ERP a acesso JDBC.
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.
h1. Tabelas de Integração, Parâmetros e Exemplo de SQL de Integração
h2. Tabelas de Integração
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.
*Observação:* Os campos com asterisco (*) compõem a “primaryKey” e podem ser enviados como String ou Integer dependendo da necessidade do cliente.
h2. Parâmetros
Algumas tabelas de integração necessitam de parâmetros. Os parâmetros trabalham em pares: Campo e Parâmetro.
O Campo refere-se ao campo correspondente na tabela/visão, e o parâmetro é o código que será substituído na hora da execução do SQL.
h2. Exemplo de SQL de Integração
Vamos usar abaixo um exemplo a Tabela de Preços:
*Documentação do IGS:*
> Consulta informações de tabela de preço do ERP.
>
> |_. Campo |_. Tipo |_. Precisão |_. Descrição |
> | codEmpresa * | String/Integer | 10 | Código da Empresa origem dos dados |
> | codTabela * | String/Integer | 255 | Código da tabela de preços no ERP |
> | descricao | String | 255 | Descrição da tabela de preços |
>
> Lista de Parâmetros:
>
> |_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
> | codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
> | codTabela | :p2 | String/Integer | 255 | Código da tabela de preços no ERP |
*SQL de exemplo com base na documentação*
<pre>SELECT codEmpresa,
codTabela,
descricao
FROM TabelaDePreco
WHERE codEmresa = :p1
AND codTabela = :p2</pre>
h1. Layouts de Integração
Segue os layouts que devem servir de base para construção dos SQLs de integração.
h2. Tabela de Preço
Consulta informações de tabela de preço do ERP.
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa * | String/Integer | 10 | Código da Empresa origem dos dados |
| codTabela * | String/Integer | 255 | Código da tabela de preços no ERP |
| descricao | String | 255 | Descrição da tabela de preços |
Lista de Parâmetros:
|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| codTabela | :p2 | String/Integer | 255 | Código da tabela de preços no ERP |
h2. Tabela de Preço - Produto
Retornar a listagem dos produtos da tabela de preço do ERP.
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa * | String/Integer | 10 | Código da Empresa origem dos dados |
| codTabela * | String/Integer | 255 | Código da tabela de preços no ERP |
| codProduto * | String/Integer | 255 | Código do produto no ERP |
| codGrade * | String/Integer | 255 | Código da grade de produto no ERP |
| preco | Double | | Preço do produto |
Lista de Parâmetros:
|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| codTabela | :p2 | String/Integer | 255 | Código da tabela de preços no ERP |
h2. Títulos
Retornar a listagem de títulos (duplicatas) do cliente.
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| titulo * | String/Integer | 255 | Chave única do título no ERP |
| notaFiscal | String/Integer | 255 | Número da nota fiscal ou documento |
| dataEmissao | Date | | Data de Emissão do título |
| dataVecto | Date | | Data de Vencimento do título |
| valor | Double | | Valor do título |
| nomePortador | String/Integer | 255 | Nome/Descrição do portador |
| codCliente | String/Integer | 255 | Código do cliente |
| nomeCliente | String/Integer | 255 | Nome do cliente |
Lista de Parâmetros:
|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| codRepresentante | :p2 | String/Integer | 255 | Código do representante no ERP |
h2. Condição de Venda
Retorna a listagem de Condições de Venda do ERP.
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa * | String/Integer | 10 | Código da Empresa origem dos dados |
| codPagamento * | String/Integer | 255 | Código da condição de Venda no ERP |
| nome | String | 255 | Nome da condição de venda |
| qtdeParcelas | Integer | | Número de parcelas da condição de venda |
| prazoMedio | Double | | Prazo médio das parcelas da condição de venda |
Lista de Parâmetros:
|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
h2. Tipo de Nota
Retorna a listagem de Tipos de Nota do ERP.
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa * | String/Integer | 10 | Código da Empresa origem dos dados |
| codTipo * | String/Integer | 255 | Código do tipo de nota no ERP |
| nome | String | 255 | Nome/descrição do tipo de nota |
Lista de Parâmetros:
|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
h2. Comissões
Retorna informações de comissão para o representante filtrado.
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| tipo * | Integer | | Tipo de comissão:
SELECT 1 - No Faturamento, 2 - Na Liquidação |
| dataReferencia * | Date | | Data de referência da comissão |
| codTitulo * | String | 255 | Título de referência da comissão. Sugestão: no caso do tipo 1 trazer o número da nota fiscal, no caso do tipo 2 trazer o número do título |
| codCliente | String | 255 | Código do cliente relacionado a comissão |
| nomeCliente | String | 255 | Código do cliente relacionado a comissão |
| baseComissaoLiq | Double | | Valor base líquido usado no cálculo da comissão |
| tipo, dataMovto, titulo, codCliente, nomeCliente, baseComissaoLiq, valorComissaoLiq | Double | | Valor líquido da comissão |
Lista de Parâmetros:
|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| codRepresentante | :p2 | String/Integer | 255 | Código do representante no ERP |
| dataReferencia | :p3 | Date | | Data de Referência - utilizar sinal de (>=) maior igual |
h2.
Clientes
Retornar a listagem de clientes de um representante.
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa * | String/Integer | 10 | Código da Empresa origem dos dados |
| cnpj * | String | 255 | CNPJ ou CPF do cliente - somente números |
| nomeFantasia | String | 255 | Nome fantasia do cliente |
| razaoSocial | String | 255 | Razão social do cliente |
| situacao | Integer | |
| codCliente * | String | 255 | Código do cliente no ERP |
| nomeCliente | String | 255 | Código do cliente relacionado a comissão |
| baseComissaoLiq | Double | | Valor base líquido usado no cálculo da comissão |
| valorComissaoLiq | Double | | Valor líquido da comissão |
Lista de Parâmetros:
|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| codRepresentante | :p2 | String/Integer | 255 | Código do representante no ERP |
select m.codEmpresa,
m.codCliente,
m.cnpjcpf,
nvl(rtrim(ltrim(m.nomeFantasia)),rtrim(ltrim(m.nome))),
rtrim(ltrim(m.nome)),
m.situacao,
m.telefone,
m.email,
m.emailNFE,
m.cidadeCodIBGE,
m.endrua,
nvl(m.endnumero,' '),
m.endbairro,
m.cep,
m.dataCadastro,
m.inscricaoEstadual,
m.inscricaoSUFRAMA,
m.flagConsumidorFinal,
m.cobrancaEmail,
m.cobrancaContato,
m.cobrancaTelefone,
m.comprasEmail,
m.comprasContato,
comprasTelefone,
null avaliacaoRepres
from IBTech.FTCL m
where codEmpresa = :p1
and ((codRepres = :p2) or (codrepres2 = :p2))
and situacao not in (3,4)
ORDER BY m.codCliente
Produtos
Produtos - Grades
Produtos - Sortimentos
Pedido - Capa
*Índice*
# [[Digitação de Pedidos#Introdução|Introdução]]
# [[Digitação de Pedidos#Acesso-via-JDBC|Acesso via JDBC]]
# [[Digitação de Pedidos#Tabelas-de-Integração-Parâmetros-e-Exemplo-de-SQL-de-Integração|Tabelas de Integração, Parâmetros e Exemplo de SQL de Integração]]
## [[Digitação de Pedidos#Tabelas-de-Integração|Tabelas de Integração]]
## [[Digitação de Pedidos#Parâmetros|Parâmetros]]
## [[Digitação de Pedidos#Exemplo-de-SQL-de-Integração|Exemplo de SQL de Integração]]
# [[Digitação de Pedidos#Layouts-de-Integração|Layouts de Integração]]
## [[Digitação de Pedidos#Tabela-de-Preço|Tabela de Preço]]
## [[Digitação de Pedidos#Tabela-de-Preço-Produto|Tabela de Preço - Produto]]
## [[Digitação de Pedidos#Títulos|Títulos]]
## [[Digitação de Pedidos#Condição-de-Venda|Condição de Venda]]
## [[Digitação de Pedidos#Tipo-de-Nota|Tipo de Nota]]
## [[Digitação de Pedidos#Comissões|Comissões]]
## [[Digitação de Pedidos#Clientes|Clientes]]
## [[Digitação de Pedidos#Produtos|Produtos]]
## [[Digitação de Pedidos#Produtos-Grades|Produtos - Grades]]
## [[Digitação de Pedidos#Produtos-Sortimentos|Produtos - Sortimentos]]
## [[Digitação de Pedidos#Pedido-Capa|Pedido - Capa]]
h1. Introdução
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 a Digitação de Pedidos da IBTech.
Dúvidas ou maiores esclarecimentos podem ser obtidos pelo e-mail contato@ibtech.inf.br ou pelo telefone (47) 3370-0504.
h1. Acesso via JDBC
*Pré-Requisito:* Suporte por parte do Banco de Dados da Empresa fornecedora do ERP a acesso JDBC.
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.
h1. Tabelas de Integração, Parâmetros e Exemplo de SQL de Integração
h2. Tabelas de Integração
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.
*Observação:* Os campos com asterisco (*) compõem a “primaryKey” e podem ser enviados como String ou Integer dependendo da necessidade do cliente.
h2. Parâmetros
Algumas tabelas de integração necessitam de parâmetros. Os parâmetros trabalham em pares: Campo e Parâmetro.
O Campo refere-se ao campo correspondente na tabela/visão, e o parâmetro é o código que será substituído na hora da execução do SQL.
h2. Exemplo de SQL de Integração
Vamos usar abaixo um exemplo a Tabela de Preços:
*Documentação do IGS:*
> Consulta informações de tabela de preço do ERP.
>
> |_. Campo |_. Tipo |_. Precisão |_. Descrição |
> | codEmpresa * | String/Integer | 10 | Código da Empresa origem dos dados |
> | codTabela * | String/Integer | 255 | Código da tabela de preços no ERP |
> | descricao | String | 255 | Descrição da tabela de preços |
>
> Lista de Parâmetros:
>
> |_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
> | codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
> | codTabela | :p2 | String/Integer | 255 | Código da tabela de preços no ERP |
*SQL de exemplo com base na documentação*
<pre>SELECT codEmpresa,
codTabela,
descricao
FROM TabelaDePreco
WHERE codEmresa = :p1
AND codTabela = :p2</pre>
h1. Layouts de Integração
Segue os layouts que devem servir de base para construção dos SQLs de integração.
h2. Tabela de Preço
Consulta informações de tabela de preço do ERP.
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa * | String/Integer | 10 | Código da Empresa origem dos dados |
| codTabela * | String/Integer | 255 | Código da tabela de preços no ERP |
| descricao | String | 255 | Descrição da tabela de preços |
Lista de Parâmetros:
|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| codTabela | :p2 | String/Integer | 255 | Código da tabela de preços no ERP |
h2. Tabela de Preço - Produto
Retornar a listagem dos produtos da tabela de preço do ERP.
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa * | String/Integer | 10 | Código da Empresa origem dos dados |
| codTabela * | String/Integer | 255 | Código da tabela de preços no ERP |
| codProduto * | String/Integer | 255 | Código do produto no ERP |
| codGrade * | String/Integer | 255 | Código da grade de produto no ERP |
| preco | Double | | Preço do produto |
Lista de Parâmetros:
|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| codTabela | :p2 | String/Integer | 255 | Código da tabela de preços no ERP |
h2. Títulos
Retornar a listagem de títulos (duplicatas) do cliente.
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| titulo * | String/Integer | 255 | Chave única do título no ERP |
| notaFiscal | String/Integer | 255 | Número da nota fiscal ou documento |
| dataEmissao | Date | | Data de Emissão do título |
| dataVecto | Date | | Data de Vencimento do título |
| valor | Double | | Valor do título |
| nomePortador | String/Integer | 255 | Nome/Descrição do portador |
| codCliente | String/Integer | 255 | Código do cliente |
| nomeCliente | String/Integer | 255 | Nome do cliente |
Lista de Parâmetros:
|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| codRepresentante | :p2 | String/Integer | 255 | Código do representante no ERP |
h2. Condição de Venda
Retorna a listagem de Condições de Venda do ERP.
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa * | String/Integer | 10 | Código da Empresa origem dos dados |
| codPagamento * | String/Integer | 255 | Código da condição de Venda no ERP |
| nome | String | 255 | Nome da condição de venda |
| qtdeParcelas | Integer | | Número de parcelas da condição de venda |
| prazoMedio | Double | | Prazo médio das parcelas da condição de venda |
Lista de Parâmetros:
|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
h2. Tipo de Nota
Retorna a listagem de Tipos de Nota do ERP.
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa * | String/Integer | 10 | Código da Empresa origem dos dados |
| codTipo * | String/Integer | 255 | Código do tipo de nota no ERP |
| nome | String | 255 | Nome/descrição do tipo de nota |
Lista de Parâmetros:
|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
h2. Comissões
Retorna informações de comissão para o representante filtrado.
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| tipo * | Integer | | Tipo de comissão:
SELECT 1 - No Faturamento, 2 - Na Liquidação |
| dataReferencia * | Date | | Data de referência da comissão |
| codTitulo * | String | 255 | Título de referência da comissão. Sugestão: no caso do tipo 1 trazer o número da nota fiscal, no caso do tipo 2 trazer o número do título |
| codCliente | String | 255 | Código do cliente relacionado a comissão |
| nomeCliente | String | 255 | Código do cliente relacionado a comissão |
| baseComissaoLiq | Double | | Valor base líquido usado no cálculo da comissão |
| tipo, dataMovto, titulo, codCliente, nomeCliente, baseComissaoLiq, valorComissaoLiq | Double | | Valor líquido da comissão |
Lista de Parâmetros:
|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| codRepresentante | :p2 | String/Integer | 255 | Código do representante no ERP |
| dataReferencia | :p3 | Date | | Data de Referência - utilizar sinal de (>=) maior igual |
h2.
Clientes
Retornar a listagem de clientes de um representante.
|_. Campo |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa * | String/Integer | 10 | Código da Empresa origem dos dados |
| cnpj * | String | 255 | CNPJ ou CPF do cliente - somente números |
| nomeFantasia | String | 255 | Nome fantasia do cliente |
| razaoSocial | String | 255 | Razão social do cliente |
| situacao | Integer | |
| codCliente * | String | 255 | Código do cliente no ERP |
| nomeCliente | String | 255 | Código do cliente relacionado a comissão |
| baseComissaoLiq | Double | | Valor base líquido usado no cálculo da comissão |
| valorComissaoLiq | Double | | Valor líquido da comissão |
Lista de Parâmetros:
|_. Campo |_. Parâmetro |_. Tipo |_. Precisão |_. Descrição |
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| codRepresentante | :p2 | String/Integer | 255 | Código do representante no ERP |
select m.codEmpresa,
m.codCliente,
m.cnpjcpf,
nvl(rtrim(ltrim(m.nomeFantasia)),rtrim(ltrim(m.nome))),
rtrim(ltrim(m.nome)),
m.situacao,
m.telefone,
m.email,
m.emailNFE,
m.cidadeCodIBGE,
m.endrua,
nvl(m.endnumero,' '),
m.endbairro,
m.cep,
m.dataCadastro,
m.inscricaoEstadual,
m.inscricaoSUFRAMA,
m.flagConsumidorFinal,
m.cobrancaEmail,
m.cobrancaContato,
m.cobrancaTelefone,
m.comprasEmail,
m.comprasContato,
comprasTelefone,
null avaliacaoRepres
from IBTech.FTCL m
where codEmpresa = :p1
and ((codRepres = :p2) or (codrepres2 = :p2))
and situacao not in (3,4)
ORDER BY m.codCliente
Produtos
Produtos - Grades
Produtos - Sortimentos
Pedido - Capa