Projeto

Geral

Perfil

Histórico

Manual de Integração » Digitação de Pedidos - Padrão »

Digitação de Pedidos » Histórico » Versão 5

« Anterior - Versão 5/709 (diff) - Próximo » - Versão atual
Anônimo, 23/03/2015 12:17 h

Digitação de Pedidos

Índice
  1. Introdução
  2. Acesso via JDBC
  3. Tabelas de Integração, Parâmetros e Exemplo de SQL de Integração
    1. Tabelas de Integração
    2. Parâmetros
    3. Exemplo de SQL de Integração
  4. Layouts de Integração
    1. Tabela de Preço
    2. Tabela de Preço - Produto
    3. Títulos
    4. Condição de Venda
    5. Tipo de Nota
    6. Comissões
    7. Clientes
    8. Produtos
    9. Produtos - Grades
    10. Produtos - Sortimentos
    11. Pedido - Capa

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 ou pelo telefone (47) 3370-0504.

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.

Tabelas de Integração, Parâmetros e Exemplo de SQL de Integração

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.

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.

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

SELECT codEmpresa,
codTabela,
descricao
FROM TabelaDePreco
WHERE codEmresa = :p1
  AND codTabela = :p2

Layouts de Integração

Segue os layouts que devem servir de base para construção dos SQLs de integração.

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

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

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

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

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

Comissões

Retorna informações de comissão para o representante filtrado.

Campo Tipo Precisão Descrição
tipo * Integer Tipo de comissão: 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
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

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