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 por Representante (opcional - somente se ERP possui esse controle)
   3. Tabela de Preço - Produto
   4. Títulos Em Aberto (opcional)
   5. Condição de Venda
   6. Tipo de Nota(opcional)
   7. Comissões (opcional)
   8. Clientes
   9. Produtos
   10. Produtos - Grades
   11. Produtos - Sortimentos
   12. Produto - Código Reduzido (opcional - somente se ERP precisa do código reduzido)
   13. Pedido - Capa
   14. Pedidos por Referência (opcional)
   15. Listagem de Pedidos - Capa
   16. Listagem de Pedidos - Detalhado
   17. Listagem de Pedidos - Itens
   18. Listagem de Pedidos - Notas

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 por Representante¶

Carrega as tabelas de preço de acordo com a ligação delas com o representante. Retornar somente as ativas.

Campo	Tipo	Precisão	Descrição
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
codRepres	:p2	String/Integer	255	Código do representante

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
situacao	Integer		Situação conforme codificação: 0 - Inativo, 1 - Ativo

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
email	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
fax	String	255	Celular de contato do cliente
flagClienteFiel	Integer		Cliente Fiel/Especial: 0 - Não, 1 - Sim
endComplemento	String	255	Complemento do Endereço
dataUltimaCompra	Date		Data da ultima compra 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

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	#COLECOES			Qualificar no WHERE como IN

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 *	String	255	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	#COLECOES			Qualificar no WHERE como IN

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	#COLECOES			Qualificar no WHERE como IN

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

Pedidos por Referência¶

Retorna a quantidade vendida de uma ou de várias referência, tamanho e cor.

Campo	Tipo	Precisão	Descrição
codEmpresa *	String/Integer	255	Código da empresa no ERP
codReferencia *	String	255	Código da Referência
codTamanho *	String	255	Código do Tamanho
codSortimento *	String	255	Código do Sortimento
quantidade	Integer		Quantidade vendida

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP
codReferencia	#REFERENCIAS			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
qtdePedLiquida	Integer		Quantidade Pedida Liquida

Lista de Parâmetros:

Formato sugerido de data: dd/mm/yyyy (31/12/2013)

Parâmetro	Tipo	Precisão	Descrição
:pDataEmissao	Date		Data de Emissão do Pedido
:pCodRepresentante	String	10	(opcional) Código do Representante
:pCodTabPreco	String	10	(opcional) Código da Tabela de Preço

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

Lista de Parâmetros:

Parâmetro	Tipo	Precisão	Descrição
:pCodPedido	String	255	Código do Pedido

Listagem de Pedidos - Itens¶

Retornar dados dos Itens do pedido.

Campo	Tipo	Precisão	Descrição
codItem	String	255	Código do Item para Ordenação
codProduto	String	255	Código do Produto
nomeProduto	String	255	Nome do Produto
qtdePedida	Double		Quantidade Pedida do Produto
qtdeSaldo	Double		Quantidade Saldo do Produto
qtdeFaturado	Double		Quantidade Faturada do Produto
qtdeCancelada	Double		Quantidade Cancelada do Produto
valorUnitarioBruto	Double		Valor Unitário Bruto do Produto
valorUnitarioLiquido	Double		Valor Unitário Liquido do Produto
valorTotal	Double		Valor Total do Produto

Lista de Parâmetros:

Parâmetro	Tipo	Precisão	Descrição
:pCodPedido	String	255	Código do Pedido

Listagem de Pedidos - Notas¶

Retornar dados das Notas Fiscais do pedido.

Campo	Tipo	Precisão	Descrição
dataEmissao	Date		Data de Emissão da Nota Fiscal
numeroNF	String	255	Número da Nota Fiscal
situacao	String	255	Situação da Nota Fiscal
valorLiquido	Double		Valor Total da Nota Fiscal
codTransp	String	255	Código da Transportadora
nomeTransp	String	255	Nome da Transportadora
codRedespacho	String	255	Código do Redespacho
nomeRedespacho	String	255	Nome do Redespacho
chaveNFE	String	255	Chave da Nota Fiscal

Lista de Parâmetros:

Parâmetro	Tipo	Precisão	Descrição
:pCodPedido	String	255	Código do Pedido