Digitação de Pedidos » Histórico » Versão 33
« Anterior -
Versão 33/709
(diff) -
Próximo » -
Versão atual
victor.klemann, 22/09/2015 10:34 h
Digitação de Pedidos¶
Índice- Introdução
- Acesso via JDBC
- Tabelas de Integração, Parâmetros e Exemplo de SQL de Integração
- Layouts de Integração
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 suporte@ibtech.inf.br 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 codEmpresa = :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 Em Aberto¶
Retornar a listagem de títulos (duplicatas) que estão em aberto para os cliente do representante.
| 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 em aberto | |
| 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 |
| codCliente * | String | 255 | Código do cliente no ERP |
| 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 | Situação conforme codificação: 0 - Inativo, 1 - Ativo | |
| telefone | String | 255 | Telefone do cliente |
| String | 255 | Endereço de e-mail padrão do cliente | |
| emailNFE | String | 255 | Endereço de e-mail para Nota Fiscal Eletrônica do do cliente |
| codIBGE | String | 255 | Código IBGE da cidade do cliente |
| endereco | String | 255 | Endereço do cliente sem o número. Caso o número estiver gravado no mesmo cliente, contate a IBTech para discutir uma solução. |
| enderecoNumero | String | 255 | Número do endereço do cliente do cliente |
| bairro | String | 255 | Bairro do cliente |
| cep | String | 255 | CEP do cliente (somente números) |
| dataCadastro | Date | Data de cadastro do cliente | |
| inscricaoEstadual | String | 255 | Inscrição estadual do cliente |
| inscricaoSUFRAMA | String | 255 | Inscrição SUFRAMA do cliente se houver |
| flagConsumidorFinal | Integer | Consumidor final: 0 - Não, 1 - Sim | |
| cobrancaEmail | String | 255 | Endereço de e-mail de cobrança do cliente |
| cobrancaContato | String | 255 | Nome da pessoal de contato de cobrança do cliente |
| cobrancaTelefone | String | 255 | Telefone da pessoal de contato de cobrança do cliente |
| comprasEmail | String | 255 | Endereço de e-mail de compras do cliente |
| comprasContato | String | 255 | Nome da pessoal de contato de compras do cliente |
| comprasTelefone | String | 255 | Telefone da pessoal de contato de compras do cliente |
| avaliacaoRepres | Text | (opcional) Observação de avaliação do representante sobre o cliente (somente informação digitada pelo representante) | |
| celular | String | 255 | Celular de contato do cliente |
| classificacao | String | 255 | (opcional) Classificação do cliente. Exemplo: A, B, C, VIP |
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 |
Produtos¶
Retornar a listagem de produtos ATIVOS filtrando coleção.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codReferencia * | String/Integer | 255 | Código da Referência no ERP |
| descricao | String | 255 | Descrição da referência |
| codEtiqueta | String | 255 | Código da Etiqueta (ou Marca) da referência. Consultar a IBTech sobre o que trazer neste campo. |
| nomeEtiqueta | String | 255 | Nome da Etiqueta (ou Marca) da referência. Consultar a IBTech sobre o que trazer neste campo. |
| codLinha | String | 255 | Código da Linha de Produto da referência. |
| nomeLinha | String | 255 | Nome da Linha de Produto da referência. |
| codTipoPeca | String | 255 | Código do Tipo de Peça da referência. Consultar a IBTech sobre o que trazer neste campo. |
| nomeTpoPeca | String | 255 | Nome do Tipo de Peça da referência. Consultar a IBTech sobre o que trazer neste campo. |
| codTipoModelo | String | 255 | Código do Tipo Modelo da referência. Consultar a IBTech sobre o que trazer neste campo. |
| nomeTipoModelo | String | 255 | Nome do Tipo Modelo da referência. Consultar a IBTech sobre o que trazer neste campo. |
| preco | Double | DEPRECIADO. retornar zero (não há necessidade de incluir na view) |
Lista de Parâmetros:
| Campo | Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| codColecao | :p2 | String/Integer | 255 | Código da coleção da referência no ERP |
Produtos - Grades¶
Retornar a listagem das grades ATIVAS dos produtos filtrando coleção.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codReferencia * | String/Integer | 255 | Código da Referência no ERP |
| codGrade * | String/Integer | 255 | Código da Grade no ERP |
| seqTamanho * | Integer | Código do tamanho na grade no ERP | |
| seqOrdenacao * | Integer | Sequencia de ordenação do tamanho na grade | |
| codTamanho * | String | 255 | Descrição do tamanho no ERP (Ex: "P") |
| qtdPalito | Integer | Quantidade de peças para grade palito |
Lista de Parâmetros:
| Campo | Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| codColecao | :p2 | String/Integer | 255 | Código da coleção da referência no ERP |
Produtos - Sortimentos¶
Retornar a listagem dos sortimentos ATIVOS dos produtos filtrando coleção.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codReferencia * | String/Integer | 255 | Código da Referência no ERP |
| codSortimento * | String/Integer | 255 | Código do Sortimento no ERP |
| descricao | String | 255 | Descrição do sortimento no ERP |
| codCorBase | String | 255 | Código da cor comercial (usada no catalogo) |
Lista de Parâmetros:
| Campo | Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| codColecao | :p2 | String/Integer | 255 | Código da coleção da referência no ERP |
Produto - Código Reduzido¶
Retornar o código reduzido para o produto (referecia, cor e tamanho)
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codReduzido * | String/Integer | 255 | Código reduzido do produto no ERP |
| seqTamanho * | String/Integer | 255 | Código do tamanho no ERP |
| seqTamOrdenacao | Integer | Sequencia de ordenação do tamanho no ERP | |
| seqSortimento * | String/Integer | 255 | Código da sortimento no ERP |
| seqSortOrdenacao | Integer | Sequencia de ordenação do sortimento no ERP | |
| codColecao | String/Integer | 255 | Código da coleção da referencia no ERP |
Lista de Parâmetros:
| Campo | Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| codReferencia | :p2 | String/Integer | 255 | Código da referência no ERP |
Pedido - Capa¶
Retornar a situação do pedido no ERP.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codPedido * | String/Integer | 255 | Código do pedido no ERP |
| situacao | Integer | Situação do pedido no ERP. Pedido FATURADO: 99 Pedido CANCELADO: 98 Demais situações: retornar código do ERP |
|
| descSituacao | String | 255 | Descrição da situação |
Lista de Parâmetros:
| Campo | Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
| codPedido | #PEDIDOS | Qualificar no WHERE como IN |
Listagem de Pedidos - Capa¶
Retornar dados referentes a capa do pedido.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codEmpresa | String/Integer | 10 | Código da empresa no ERP |
| codCliente | String | 255 | Código do Cliente |
| nomeCliente | String | 255 | Nome do Cliente |
| codRepres | String | 255 | Código do Representante |
| pedAutomacao | String | 255 | Número do Lote de Gravação |
| codPedido | String | 255 | Código do Pedido no ERP |
| dataEmissao | Date | Data de Emissão do Pedido | |
| dataPrevFat | Date | Data de Previsão de Faturamento do Pedido | |
| situacao | Integer | 10 | Código da Situação no ERP |
| situacaoEdt | String | 255 | Descrição da Situação do Pedido |
| valorBruto | Double | Valor Bruto do Pedido | |
| valorLiquido | Double | Valor Liquido do Pedido | |
| valorSaldo | Double | Valor Saldo do Pedido |
Listagem de Pedidos - Detalhado¶
Retornar dados detalhados do pedido.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| dataEmissao | Date | Data de Emissão do Pedido | |
| dataPrevFatur | Date | Data de Previsão do Faturamento | |
| situacaoEdt | String | 255 | Descrição da Situação do Pedido |
| codCliente | String | 255 | Código do Cliente |
| nomeCliente | String | 255 | Nome do Cliente |
| cidadeCliente | String | 255 | Nome da Cidade do Cliente (cidade da venda) |
| ufCliente | String | 255 | Sigla do Estado do Cliente (estado da venda). |
| inscEstadual | String | 255 | Inscrição Estadual do Cliente |
| cnpjCliente | String | 255 | Cnpj do Cliente |
| codRepres | String | 255 | Código do Representante |
| percComissao | Double | Percentual de Comissão do Pedido | |
| codTabPreco | String | 255 | Código da Tabela de Preço |
| nomeTabPreco | String | 255 | Nome da Tabela de Preço |
| codCondVenda | String | 255 | Código da Condição de Venda |
| nomeCondVenda | String | 255 | Nome da Condição de Venda |
| codTranspDespacho | String | 255 | Código da Transportadora de Despacho |
| nomeTranspDespacho | String | 255 | Nome da Transportadora de Despacho |
| tipoFreteTranspDespacho | String | 255 | Tipo de Frete do Transporte de Despacho |
| codTranspRedespacho | String | 255 | Código da Transportadora de Redespacho |
| nomeTranspRedespacho | String | 255 | Nome da Transportadora de Redespacho |
| tipoFreteTranspRedespacho | String | 255 | Tipo de Frete do Transporte de Redespacho |
| codTipoNota | String | 255 | Código do Tipo de Nota |
| nomeTipoNota | String | 255 | Nome do Tipo de Nota |
| observacao | String | 255 | Observação do Pedido |
| valorBruto | Double | Valor Bruto do Pedido | |
| valorLiquido | Double | Valor Liquido do Pedido | |
| valorSaldo | Double | Valor Saldo do Pedido |