Digitação de Pedidos » Histórico » Versão 312
« Anterior -
Versão 312/711
(diff) -
Próximo » -
Versão atual
andreg, 23/11/2022 16:23 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
- Tabela de Preço
- Tabela de Preço por Representante (opcional - somente se ERP possui esse controle)
- Tabela de Preço - Produto
- Tabela de Preço - Política - Desconto Comercial (opcional)
- Tabela de Preço - Política - Desconto Financeiro (opcional)
- Tabela de Preço - Política - Desconto Antecipação (opcional)
- Tabela de Preço - Política - Prazo Adicional (opcional)
- Tabela de Preço - Política - Desconto Volume (opcional)
- Tabela de Preço - Política - Preços por volume (opcional)
- Títulos Em Aberto (opcional)
- Condição de Venda
- Cota de estoque - Por representante (opcional)
- Tipo de Nota(opcional)
- Tipo de Cobrança(opcional)
- Comissões (opcional)
- Comissões - Extrato Resumo (opcional)
- Comissões - Extrato Detalhado (opcional)
- Clientes
- Clientes - Campos Customizados
- Clientes - Locais de Entrega(opcional)
- Clientes - Ramos de Atividade(opcional)
- Clientes - Grupos de Cliente(opcional)
- Clientes - Condições de venda(opcional)
- Produtos - Gold Be
- Produtos
- Produtos - Grades
- Produtos - Sortimentos
- Produtos Skus
- Produto - Código Reduzido (opcional - somente se ERP precisa do código reduzido)
- Produto - EAN13 (opcional)
- Bloqueio de Referências(opcional)
- Pedido - Capa
- Pedidos por Referência (opcional)
- Listagem de Pedidos - Capa
- Listagem de Pedidos - Detalhado
- Listagem de Pedidos - Itens
- Listagem de Pedidos - Notas
- Listagem de Pedidos - Observações (opcional)
- Listagem de Pedidos - Histórico (opcional)
- Estoque
- Lote Entrega
- Lotes de Faturamento
- Cálculo substituição tributária (opcional)
- Grupos substituição tributária (opcional)
- Integração Valor de Frete por UF (opcional)
- Tabela de Preço SKU (opcional)
- Tabela de Preço - Política - Desconto Adicional de Lote (opcional)
- Listagem de Pedidos em Aberto - Capa
- Listagem de Pedidos em Aberto - Detalhado (mesma estrutura Listagem de Pedidos - Detalhado)
- Listagem de Pedidos em Aberto - Itens (mesma estrutura Listagem de Pedidos - Itens)
- SKUs Pronta Entrega e Programado
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 atendimento@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 |
| dataMinimaFaturamento | Date | Data mínima de faturamento | |
| dataMaximaFaturamento | Date | Data máxima de faturamento | |
| percDescontoShowRoom | Double | Percentual de desconto para show room | |
| dataVigenciaInicial | Date | Data de vigência inicial | |
| dataVigenciaFinal | Date | Data de vigência final | |
| codColecao | String | Código da coleção (opicional) | |
| codSegmento | String | Código do segmento (opicional) | |
| codTabelaPrecoPrincipal | String | Código da tabela de preços (opicional) | |
| desconsiderarDescAcr | Integer | Desconsiderar Desconto Acrescimo (opicional) | |
| codEmpresaDestino | String | Código de empresa destino (opicional) | |
| currency | String | Tipo de moeda (opicional) | |
| codTipoPedido | String | Código do tipo de pedido (opicional) | |
| codTabPrecoIntegracao | String | Código da tabela de preços para integração (opicional) |
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 | |
| seqSortimento | String/Integer | 255 | Código da sortimento no ERP (opicional, somente para quem utiliza venda agrupada/look) |
| itemAtivo | Integer | 1 | Situação do item no ERP (0 - Inativo, 1 - Ativo) |
| seqTamanho | String | ||
| descricaoProd | String | ||
| vlrUnitarioAnterior | String | ||
| seqTamanho | String | ||
| permiteBonificacao | String | ||
| flagOferta | String | ||
| codigoCaixaGoldBe | String | Código agrupador de caixas Gold Be |
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 |
| produtoAtivo | :p4 | Integer | - | Filtro para buscar produto ativo/inativo |
| codReferencia | :p5 | String/Integer | 255 | Utilizada para filtrar um produto para digitação online |
| codColecao | #COLECOES | Qualificar no WHERE como IN |
Tabela de Preço - Política - Desconto Comercial¶
Retornar a política de desconto comercial da tabela de preço do ERP.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| valorInicio | Double | ||
| valorFim | Double | ||
| qtdePecasIni | Integer | ||
| qtdePecasFim | Integer | ||
| percDesconto | Double | ||
| perccomissao | Double |
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 - Política - Desconto Financeiro¶
Retornar a política de desconto financeiro da tabela de preço do ERP.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| prazoMedioMinimo | Double | ||
| prazoMedioMaximo | Double | ||
| percDesconto | Double | ||
| perccomissaoAdicional | Double |
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 - Política - Desconto Antecipação¶
Retornar a política de desconto antecipação da tabela de preço do ERP.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| dataInicio | Date | ||
| dataFim | Date | ||
| percDesconto | Double |
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 - Política - Prazo Adicional¶
Retornar a política de prazo adicional da tabela de preço do ERP.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| descricao | String | 255 | |
| qtdeDias | Integer | ||
| ufs | String | 255 | |
| dataFaturamentoInicio | Date | ||
| dataFaturamentoFim | Date | ||
| dataEmissaoInicio | Date | ||
| dataEmissaoFim | Date |
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 - Política - Desconto Volume¶
Desconto de Volume
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codSegmento | String | 255 | Fixo null quando por Cliente e Tabela de Preços |
| codColecao | String | Fixo null quando por Cliente e Tabela de Preços | |
| clienteUf | String | 255 | Fixo null quando por Cliente e Tabela de Preços |
| valorInicial | Double | Valor Inicial | |
| valorFinal | Double | Valor Final | |
| tipoValor | Integer | Fixo null quando por Cliente e Tabela de Preços | |
| desconto | Double | Valor do desconto | |
| codTabelaPreco | String | Obrigatório quando por Cliente e Tabela de Preços | |
| codCliente | String | Obrigatório quando por Cliente e Tabela de Preços | |
| descontoComercialMinimo | Double | ||
| codReferencia | String | Obrigatório quando por "40 - Desc. Hist Compra por referência." |
Lista de Parâmetros:
| Campo | Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| codRepresentante | :p1 | String | 10 | Apenas usado quando por cliente e tabela de preço |
| codCliente | :p2 | String | 255 | Apenas usado quando por cliente e tabela de preço |
| codTabelaPreco | :p3 | String | 255 | Apenas usado quando por cliente e tabela de preço |
Tabela de Preço - Política - Preços por volume¶
Retornar a listagem dos produtos da tabela de preço do ERP.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codTabela * | String/Integer | 10 | Código da tabela de preços |
| codProduto * | String/Integer | 255 | Código do produto |
| codGrade * | String/Integer | 255 | Código da grade do produto |
| qtdMaxima * | String/Integer | 255 | Quantidade limite para aquela faixa de preço |
| preco * | Double | Preço | |
| seqSortimento | String/Integer | 255 | SeqSortimento do produto, apenas usado quando utiliza configuração por sortimento |
| agrupador | String | 255 | Agrupador para quando for usar preços por volume com grupo |
Lista de Parâmetros:
| Campo | Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| codTabela | #TABATIVAS | Filtro de código da Tabela de Preços |
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 |
| codgrupocliente | String/Integer | 255 | Código do grupo do cliente |
| moeda | String/Integer | 255 | Moeda (O padrão é R$, deixar null) |
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 |
| codCliente (opcional) | :p3 | String/Integer | 255 | Código do cliente no ERP |
| dataReferencia (opcional) | :p4 | Date | Data de referência para títulos |
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 | |
| Parcelamento | Integer | Condicao de Parcelamento EX:30/60/90 | |
| Acrescimo | Double | Percentual de acréscimo da condição (Apenas alimentício | |
| Desconto | Double | Percentual de desconto concedido pela condição ao pedido |
Lista de Parâmetros:
| Campo | Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| codEmpresa | :p1 | String/Integer | 10 | Código da empresa no ERP |
Cota de estoque - Por representante¶
Retorna a listagem da Cota de Estoque por Representante
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codigoEmpresa | String | 255 | Código da empresa no ERP |
| codigoRepresentante | String | 255 | Código do Representante |
| codReferencia | String | 255 | Código da Referência no ERP |
| codTamanho | String | 255 | Descrição do tamanho no ERP (Ex: "P") |
| seqTamanho | String | 255 | Código do tamanho na grade no ERP |
| codGrade | String | 255 | Código da grade de produto no ERP |
| seqSortimento | String | 255 | Sequência de Sortimento |
| nomeSortimento | String | 255 | Descrição do Sortimento |
| quantidade | Double | Quantidade |
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 |
| classificacao | Integer | Classificação: 1 - Venda, 2 - Bonificação, 3 - Consumo Próprio, 4 - Devolução |
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 Cobrança¶
Retorna a listagem de Tipos de Cobrança do ERP.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codTipo * | String/Integer | 255 | Código do tipo de cobrança no ERP |
| nome | String | 255 | Nome/descrição do tipo de cobrança |
| situacaoPagamento | String | 255 | Situação de pagamento a ser enviada na integração do pedido |
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 | |
| codNota | String | 255 | Código da Nota relacionado a comissão |
| pedidos | String | 255 | Lista de pedidos separado por virgula relarcionados a comissão |
| percBaseComissao | Double | Percentual base |
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 |
Comissões - Extrato Resumo¶
Retornar de forma resumida os resultados dos meses de comissões
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| anoMes | Integer | 6 | Ano/mês de referencia ex: 201708 |
| flagMesFechado | Integer | 1 | Identificador para a situação do mês (0 - Em Aberto(Box Amarelo) / 1 - Fechado (Box Verde) |
| valorIRF | Double | Valor de IR Total | |
| valorComissao | Double | Valor da Comissão | |
| valorNotaFiscal | Double | Valor da Nota Fiscal | |
| valorLiquido | Double | Valor Liquido Total de 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 |
| anoMesReferencia | :p3 | Integer | 255 | Ano Mes Referencia para retornar apenas os ultimos 6 meses (ex: 201801) |
| anoMes | :p4 | Integer | 255 | Ano Mes Referencia necessário para que o total dos lançamentos seja baseado no resumo. (Incluir or is null) |
Comissões - Extrato Detalhado¶
Retornar de extrato detalhado das comissões
Os 5 primeiros campos, são os mesmos retornados na Integração Anterior, os valores deles são referentes ao total do periodo
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| anoMes | Integer | 6 | Ano/mês de referencia ex: 201708 |
| flagMesFechado | Integer | 1 | Identificador para a situação do mês (0 - Em Aberto(Box Amarelo) / 1 - Fechado (Box Verde) |
| valorIRF | Double | Valor de IR Total | |
| valorComissao | Double | Valor da Comissão | |
| valorNotaFiscal | Double | Valor da Nota Fiscal | |
| dataLcto | Date | Data do registro | |
| lancamento | Integer | Indentificador do registro (usado para ordenação) | |
| notaFiscal | String | 255 | Número da Nota Fiscal |
| cliente | String | 255 | Nome do Cliente |
| baseComissao | Double | Valor base para calculo da comissão | |
| percBaseComissao | Double | Percentual Base Cálculo comissão | |
| percComiss | Double | Percentual de comissão | |
| valorCredito | Double | Valor para credito | |
| valorDebito | Double | Valor para debito | |
| titulo | String | 255 | Titulo que originou o lançamento |
| pedido | String | 255 | Pedido que originou o lançamento |
| observacao | String | 255 | Historico ou Descrição do lançamento |
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 |
| anoMes | :p3 | Integer | 255 | Ano Mes Referencia (ex: 201801) |
Clientes¶
Retornar a listagem de clientes de um representante.
| Campo | Tipo | Precisão | Descrição | |
|---|---|---|---|---|
| 1 | codEmpresa * | String/Integer | 10 | Código da Empresa origem dos dados |
| 2 | codCliente * | String | 255 | Código do cliente no ERP |
| 3 | cnpj * | String | 255 | CNPJ ou CPF do cliente (somente números) |
| 4 | nomeFantasia | String | 255 | Nome fantasia do cliente |
| 5 | razaoSocial | String | 255 | Razão social do cliente |
| 6 | situacao | Integer | Situação conforme codificação: 2- Inativo, 1 - Ativo, 999 - Limbo(Bloqueado) | |
| 7 | telefone | String | 255 | Telefone do cliente |
| 8 | String | 255 | Endereço de e-mail padrão do cliente | |
| 9 | emailNFE | String | 255 | Endereço de e-mail para Nota Fiscal Eletrônica do do cliente |
| 10 | codIBGE | String | 255 | Código IBGE da cidade do cliente |
| 11 | 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. |
| 12 | enderecoNumero | String | 255 | Número do endereço do cliente do cliente |
| 13 | bairro | String | 255 | Bairro do cliente |
| 14 | cep | String | 255 | CEP do cliente (somente números) |
| 15 | dataCadastro | Date | Data de cadastro do cliente | |
| 16 | inscricaoEstadual | String | 255 | Inscrição estadual do cliente |
| 17 | inscricaoSUFRAMA | String | 255 | Inscrição SUFRAMA do cliente se houver |
| 18 | flagConsumidorFinal | Integer | Consumidor final: 0 - Não, 1 - Sim | |
| 19 | cobrancaEmail | String | 255 | Endereço de e-mail de cobrança do cliente |
| 20 | cobrancaContato | String | 255 | Nome da pessoal de contato de cobrança do cliente |
| 21 | cobrancaTelefone | String | 255 | Telefone da pessoal de contato de cobrança do cliente |
| 22 | comprasEmail | String | 255 | Endereço de e-mail de compras do cliente |
| 23 | comprasContato | String | 255 | Nome da pessoal de contato de compras do cliente |
| 24 | comprasTelefone | String | 255 | Telefone da pessoal de contato de compras do cliente |
| 25 | avaliacaoRepres | Text | (opcional) Observação de avaliação do representante sobre o cliente (somente informação digitada pelo representante) | |
| 26 | celular | String | 255 | Celular de contato do cliente |
| 27 | fax | String | 255 | Celular de contato do cliente |
| 28 | flagClienteFiel | Integer | Cliente Fiel/Especial: 0 - Não, 1 - Sim | |
| 29 | endComplemento | String | 255 | Complemento do Endereço |
| 30 | dataUltimaCompra | Date | Data da ultima compra do cliente | |
| 31 | codTransportadora | String | 255 | Código da transportadora do cliente |
| 32 | codCondPagto | String | 255 | Código da condição de pagamento do cliente |
| 33 | flagSimplesNacional | Integer | Cliente faz parte do Simples Nacional: 0 - Não, 1 - Sim | |
| 34 | codTabPreco | String | 255 | Código da tabela de preço do cliente |
| 35 | percDesconto | Double | % Desconto curva ABC (Obrigatoriamente colocar o filtro de codCliente no WHERE) | |
| 36 | codGerente | String | 255 | Código do Gerente/Supervisor do representante do cliente. |
| 37 | inscricaoMunicipal | String | 255 | Inscrição municipal do cliente |
| 38 | codRamoAtividade | String | 255 | Código do ramo de atividade do cliente. |
| 39 | codGrupoCliente | String | 255 | Código do grupo de cliente. |
| 40 | dataFundacao | String | 255 | Data de fundação do cliente. |
| 41 | limiteCredito | Double | Limite de crédito do cliente. | |
| 42 | limiteCreditoDisponivel | Double | Limite de crédito disponível. | |
| 43 | percDescontoGrupo | Double | Percentual de desconto do grupo comercial. | |
| 44 | classificacaoCurva | String | Classificação da Curva. | |
| 45 | obs | String | Observação do Cliente (Para recuperar facebook,instagram TI Empresarial). | |
| 46 | listCodRepres (Passar sempre null) | String | Lista de representantes do cliente. (Opcional) | |
| 47 | midiasSociais | String | Midias sociais (facebook, instagram) da Sisplan separadas por ||. | |
| 48 | msgDashboard | String | Mensagem dashboard. | |
| 49 | latitude | Double | latitude. | |
| 50 | longitude | Double | longitude. | |
| 51 | latitudeISF | Double | latitudeISF. | |
| 52 | longitudeISF | Double | longitudeISF. | |
| 53 | atualizadoCoordPor | String | atualizadoCoordPor. | |
| 54 | cfop | Double | CFOP Cliente. | |
| 55 | codTranspRedespacho | String | Código de transportadora de redespacho. | |
| 56 | codPortador | String | 255 | Código do portador. |
| 57 | codTipoCob | String | 255 | Código do tipo de cobrança. |
| 58 | valorPedidosEmAberto | Double | Valor do pedido em aberto. | |
| 59 | valorTitulosEmAberto | Double | Valor dos títulos em aberto. | |
| 60 | codGrupoCliente | String | 255 | Código do grupo do cliente. |
| 61 | codTipoFatur | String | 255 | Código do tipo de faturamento. |
| 62 | String | 255 | Instagram. | |
| 63 | String | 255 | Facebook. | |
| 64 | validarCamposCustomizados | Integer | Flag para validar campos customizados. | |
| 65 | lembreteAprovacaoPedido | String | 255 | Lembrete de aprovação do pedido. |
| 66 | grupoClienteCalculoST | String | 255 | Código do grupo de substituição tributária do cliente. |
| 67 | somenteTriangulacao | String | 255 | Cliente somente triangulação |
| 68 | possuiGrupoFiscal | String | 255 | Cliente possui grupo fiscal |
| 69 | origemCliente | String | 255 | Origem 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 |
| codCliente | :p3 | String/Integer | 255 | Código do cliente no ERP |
Clientes - Campos Customizados¶
Retornar as informações dos Campos Cutomizados por Cliente
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codCliente * | String | 255 | Cod do Cliente |
| cnpj | String | 255 | CNPJ ou CPF do cliente (formatado) |
| idCampoCustomizado | String | 255 | Id do campo Customizado Criado no FV |
| valorCampoCustomizado | String | 255 | Valor que vai retornar no Campo. |
ista de Parâmetros:
| Campo | Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| codRepres | :p2 | String/Integer | 10 | Código do Representante |
Clientes - Locais de Entrega¶
Retornar a listagem de locais de entrega de um cliente.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| cnpj * | String | 255 | CNPJ ou CPF do cliente (formatado) |
| seqEntrega | String | 255 | Identificador único para o local de entrega |
| descricao | String | 255 | Descrição sobre o local de entrega |
| cep | String | 255 | CEP do local de entrega (somente números) |
| endereco | String | 255 | Endereço do local de entrega |
| numero | String | 255 | Número do endereço do local de entrega |
| complemento | String | 255 | Complemento do local de entrega |
| bairro | String | 255 | Bairro do local de entrega |
| codIBGE | String | 255 | Código IBGE do local de entrega |
| telefone | String | 255 | Telefone do local de entrega |
| celular | String | 255 | Celular do local de entrega |
| inscEstadual | String | 255 | Inscrição estadual do local de entrega |
Lista de Parâmetros:
| Campo | Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| codEmpresa * | :p1 | String/Integer | 10 | Código da empresa no ERP |
| cnpj * | :p2 | String | 255 | CNPJ do cliente no ERP |
Clientes - Ramos de Atividade¶
Retornar a listagem de ramos de atividade.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codigo * | String | 255 | Código do ramo de atividade |
| descricao | String | 255 | Descrição do ramo de atividade |
| flagSituacao | Integer | Situação do ramo de atividade no ERP (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 |
Clientes - Grupos de Cliente¶
Retornar a listagem de grupos de cliente.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codigo * | String | 255 | Código do grupo |
| descricao | String | 255 | Descrição do grupo |
Lista de Parâmetros:
| Campo | Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| codEmpresa * | :p1 | String/Integer | 10 | Código da empresa no ERP |
Clientes - Condições de venda¶
Retornar a listagem de grupos de cliente.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codCondPagto * | String | 255 | Código da condição de pagamento |
| codCliente | String | 255 | Código do cliente |
| libEmpresa | Integer | 10 | Situação da condição de pagamento (0 - inativo / 1 - ativo) |
Lista de Parâmetros:
| Campo | Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| codCliente | #CLIENTES | Filtro de código de cliente |
Produtos - Gold Be¶
Retornar a listagem de produtos Gold Be
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codProduto | String | ||
| descReferencia | String | ||
| codCaixaMatriz | String | ||
| codCaixa | String | ||
| codGrade | String | ||
| codTamanho | String | ||
| seqTamanho | String | ||
| ordemTamanho | String | ||
| gradePalito | String | ||
| seqSortimento | String | ||
| codSortimento | String |
Lista de Parâmetros:
| Campo | Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| codTabela | #TABATIVAS | Filtro de código da Tabela de Preços |
Produtos¶
Retornar a listagem de produtos ATIVOS filtrando coleção.
| col | Campo | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| 1 | codReferencia * | String/Integer | 255 | Código da Referência no ERP |
| 2 | descricao | String | 255 | Descrição da referência |
| 3 | codEtiqueta | String | 255 | Código da Etiqueta (ou Marca) da referência. Consultar a IBTech sobre o que trazer neste campo. |
| 4 | nomeEtiqueta | String | 255 | Nome da Etiqueta (ou Marca) da referência. Consultar a IBTech sobre o que trazer neste campo. |
| 5 | codLinha | String | 255 | Código da Linha de Produto da referência. |
| 6 | nomeLinha | String | 255 | Nome da Linha de Produto da referência. |
| 7 | codTipoPeca | String | 255 | Código do Tipo de Peça da referência. Consultar a IBTech sobre o que trazer neste campo. |
| 8 | nomeTpoPeca | String | 255 | Nome do Tipo de Peça da referência. Consultar a IBTech sobre o que trazer neste campo. |
| 9 | codTipoModelo | String | 255 | Código do Tipo Modelo da referência. Consultar a IBTech sobre o que trazer neste campo. |
| 10 | nomeTipoModelo | String | 255 | Nome do Tipo Modelo da referência. Consultar a IBTech sobre o que trazer neste campo. |
| 11 | opcoesVenda | String | 255 | (opcional) Opções de venda separadas por virgula, depende de como a empresa trabalha. ex: '6,12' |
| 12 | codReferProvisoria | String | 255 | Codigo da referencia provisoria, caso não exista, retornar a própria codReferencia |
| 13 | flagSortimentoCor | Integer | Referencia permite sortimento por cor. 0 - Não, 1 - Sim | |
| 14 | flagEstoqueLimitado | Integer | Referencia é vendida apenas sob disponibilidade, é sobreescrito pela integração de estoque. 0 - Não, 1 - Sim | |
| 15 | flagSortimentoCorTamanho | Integer | Referencia permite sortimento por cor/tamanho (grade aberta). 0 - Não, 1 - Sim | |
| 16 | flagSortimentoAutomatico | Integer | Referencia permite sortimento automatico. 0 - Não, 1 - Sim | |
| 17 | aliquotaIpi | Double | Percentual de IPI que deve ser aplicado a referencia. ex: 10 | |
| 18 | flagNaoAplicaDesconto | Integer | Indicar se o desconto NÃO deve ser aplicado a referencia. 0 - Não, 1 - Sim | |
| 19 | codColecao | String | 255 | Codigo da coleção do produto |
| 20 | qtdeQuilosPadrao | Double | Utilizado quando Malharia, qtde. de kilos por quantidade, determina quandos quilos tem uma unidade da peça | |
| 21 | cubagem | Double | ||
| 22 | nomeColecao | String | 255 | Nome da coleção do produto, utilizado inicialmente no filtro por coleção para clientes com seleção agrupada (La Playa) |
| 23 | estacaoColecao | String | 255 | Estação do ano do produto |
| 24 | codFamilia | String | 255 | Codigo da familia do produto |
| 25 | nomeFamilia | String | 255 | Nome da familia do produto |
| 26 | divisorLote | String | 255 | (Opcional) Consultar a IBTech sobre o que trazer neste campo. |
| 27 | divisorBrinde | String | 255 | (Opcional) Consultar a IBTech sobre o que trazer neste campo. |
| 28 | codReferImagem | String | 255 | Codigo do produto para chave das imagens |
| 29 | agrupadorEstoqueData | String | 255 | (Opcional) Consultar a IBTech sobre o que trazer neste campo. |
| 30 | codMarca | String | 255 | Codigo da marca do produto |
| 31 | nomeMarca | String | 255 | Nome da marca do produto |
| 32 | peso | Double | 255 | Peso do produto |
| 33 | codArtigoPai | String | 255 | Código do Artigo Pai |
| 34 | flagGradeFechada | Integer | 1 | Flag para dizer se a grade é fechada ou não |
| 35 | codReferenciaCorTamanho | String | 255 | (Opcional) Consultar a IBTech sobre o que trazer neste campo. |
| 36 | dataLimiteFatur | Date | (Opcional) Consultar a IBTech sobre o que trazer neste campo. | |
| 37 | qtdDiasMinFaturamento | Integer | (Opcional) Consultar a IBTech sobre o que trazer neste campo. | |
| 38 | dataVencimentoProduto | Date | (Opcional) Data de vencimento do produto (apenas para mostrar na listagem). | |
| 39 | especificacoesTecnicas | String | 255 | (Opcional) Dados/Especificações/Descrição do produto |
| 40 | codGenero | String | 255 | (Opcional) Informação de gênero do produto p/ ser utilizado como filtro |
| 41 | nomeGenero | String | 255 | (Opcional) Informação de gênero do produto p/ ser utilizado como filtro |
| 42 | composicaoProduto | String | 255 | (Opcional) Consultar a IBTech sobre o que trazer neste campo. |
| 43 | descricaoPesquisa | String | 255 | (Opcional) Consultar a IBTech sobre o que trazer neste campo. |
| 44 | flagReferenciaCalcadista | Integer | (Opcional) Campo específico para empresas que trabalham no modelo confecção e calçadista. 0 - Não, 1 - Sim | |
| 45 | dataEntrega | Date | (Opcional) Data de entrega do produto, usado com funcionalidade especifica | |
| 46 | grupoProdutoCalculoST | String | Código do grupo de substituição tributária do produto | |
| 47 | flagMultiplicadorUnico | Integer | Define se o produto deve utilizar a mesma quantidade de multiplicação na grade fechada |
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 | 255 | Código da referência 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 | |
| itemAtivoLido | Integer | Indicador se item ativo, caso não informado, por padrão 1 (ativo) | |
| descricao | String | 255 | Descrição da grade no ERP |
| percPalito | Double | Percentual de distribuição por tamanho | |
| flagLiberadoDivisorGradeFechada | String | 255 | Indica se produto pode ou não ser editado quando distribuição por percentual de tamanho |
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 | 255 | Código da referência 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) |
| rgb | String | 255 | Valor hexadecial ou RGB da cor para amostra ao representante |
| loteEntrega | String | 255 | Lote de Entrega padrão do sortimento |
| itemAtivo | Integer | 1 | Situação do Item (0 - Inativo, 1 - Ativo) |
| percentualSortimento | Double | Percentual de sortimento | |
| flagEstoqueLimitado | Integer | 1 | Estoque limitado (0 - Não, 1 - Sim) |
| codFamilia | String | 255 | Código da família do sortimento |
| nomeFamilia | String | 255 | Descrição da família do sortimento |
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 | 255 | Código da referência no ERP |
| codColecao | #COLECOES | Qualificar no WHERE como IN |
Produtos Skus¶
Consulta de produtos SKUs utilizada internamente pela IBTech
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codReferencia * | String/Integer | 255 | Código da Referência |
| seqTamanho* | String/Integer | 255 | Sequencia do tamanho |
| seqSortimento | String | 255 | Sequência de Sortimento |
| codigoReduzido | String | 255 | Código reduzido |
| percPalito | Double | 255 | Percentual da grade palito |
Produto - EAN13¶
Um novo código EAN por referencia para cada sortimento/tamanho!
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codReferencia * | String/Integer | 255 | Código da Referência no ERP |
| EAN * | String/Integer | 255 | Código de Barras (EAN) |
| seqSortimento | String | 255 | Sequência de Sortimento |
| seqTamanho | String | 255 | Sequência de Tamanho |
| nomeRef | String | 255 | Nome da Referência |
| nomeSort | String | 255 | Nome do Sortimento |
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 | ||
| codTabPreco | #TABPRECOS | Qualificar no WHERE como IN | ||
| codReferencia | #REFERENCIAS OR #REFERSNULL IS NULL | Qualificar no WHERE como IN | ||
| codLinha | #LINHAS | Qualificar no WHERE como IN | ||
| codEtiqueta | #ETIQUETAS | Qualificar no WHERE como IN | ||
| codModelo | #MODELOS | Qualificar no WHERE como IN | ||
| codTipo | #TIPOS | Qualificar no WHERE como IN | ||
| codEan | #EANS | 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 |
Bloqueio de Referências¶
Retornar as referências bloqueadas no ERP.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codEmpresa * | String/Integer | 255 | Código da empresa no ERP |
| codReferencia * | String/Integer | 255 | Código da referência no ERP |
| descricao | String | 255 | Descrição da referência |
| seqTamanho * | String/Integer | 255 | Código do tamanho na grade no ERP |
| seqSortimento * | String/Integer | 255 | Código da sortimento no ERP |
| flagBloqueado | Integer | Indicador do bloqueio da referência (1 - Sim, 0 - Não) | |
| codTabPreco (opcional) | String | 255 | Código da tabela de preço |
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 |
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 | ||
| DataVenda | :p2 | Date | Data da venda |
Listagem de Pedidos - Capa¶
Retornar dados referentes a capa do pedido.
| Num | Campo | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| 1 | codEmpresa | String/Integer | 10 | Código da empresa no ERP |
| 2 | codCliente | String | 255 | Código do Cliente |
| 3 | nomeCliente | String | 255 | Nome do Cliente |
| 4 | codRepres | String | 255 | Código do Representante |
| 5 | pedAutomacao | String | 255 | Número do Lote de Gravação |
| 6 | codPedido | String | 255 | Código do Pedido no ERP |
| 7 | dataEmissao | Date | Data de Emissão do Pedido | |
| 8 | dataPrevFat | Date | Data de Previsão de Faturamento do Pedido | |
| 9 | situacao | Integer | 10 | Código da Situação no ERP |
| 10 | situacaoEdt | String | 255 | Descrição da Situação do Pedido |
| 11 | valorBruto | Double | Valor Bruto do Pedido | |
| 12 | valorLiquido | Double | Valor Liquido do Pedido | |
| 13 | valorSaldo | Double | Valor Saldo do Pedido | |
| 14 | qtdePedLiquida | Integer | Quantidade Pedida Liquida | |
| 15 | motivo | String | 255 | Motivo do pedido |
| 16 | pedidoCliente | String | 255 | Codigo do Pedido de controle do cliente |
| 17 | pedidoRepresentante | String | 255 | Codigo do Pedido de controle do representante |
| 18 | percComissao | Double | Percentual de comissão do pedido | |
| 19 | usuarioDigitacao | String | 255 | Usuário digitação do pedido |
| 20 | valorComissao | Double | Valor da comissão do pedido | |
| 21 | percDescGeral | Double | Percentual de desconto geral do pedido | |
| 22 | valorDesconto | Double | Valor total de desconto do pedido | |
| 23 | nomeColecao | String | 255 | Coleção do Pedido p/ Histórico de Pedidos |
| 24 | codTipoNota | String | 255 | Código do Tipo de nota p/ Histórico de Pedidos |
| 25 | currency | String | 255 | Config de moeda para o ISF, fixo 'R$' |
| 26 | tipoNota | String | 255 | Tipo da Nota |
| 27 | motivoQuarentenaPedidos | String | 255 | Motivo Da Quarentena dos pedidos |
| 28 | atendente | String | 255 | Atendente do pedido |
| 29 | tabPrecoPedido | String | 255 | Tabela de Preço do Pedido |
| 30 | situacaoWorkFlow | String | 255 | Situação do Ppedido no WorkFlow |
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 | |
| :p3 | String | 10 | Código do Representante (Alterado de :pCodRepresentante para :p3 por Ivo em 26/10/2022 |
| :p4 | String | 10 | (opcional) Código do Cliente |
| #COLECOES | string | (opcional) para ser utilizado na consulta de pedidos Online | |
| #CODPEDIDOCLIENTE | String | 255 | Código de pedido do cliente |
| #CODPEDIDOREPRESENTANTE | String | 255 | Código de pedido do representante |
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 | |
| percDesconto1 | Double | Percentual de Desconto 1 | |
| percDesconto2 | Double | Percentual de Desconto 2 | |
| percDesconto3 | Double | Percentual de Desconto 3 | |
| percDesconto4 | Double | Percentual de Desconto 4 | |
| percDesconto5 | Double | Percentual de Desconto 5 | |
| fantasia | String | 255 | Nome Fantasia |
| emailCliente | String | 255 | E-mail do Cliente |
| pedidoCliente | String | 255 | Codigo do Pedido de controle do cliente |
| pedidoRepresentante | String | 255 | Codigo do Pedido de controle do representante |
Lista de Parâmetros:
| Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|
| :p1 | 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 | |
| codReferencia | String | 255 | Código da Referência do Item. |
| seqTamanho | String | 255 | Tamanho do Item. |
| seqSortimento | String | 255 | Cor do Item. |
Lista de Parâmetros:
| Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|
| :p1 | 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 |
| qtdeFaturado | Double | Quantidade de peças faturadas | |
| dataEntrega | Date | Data de entrega da Nota Fiscal |
Lista de Parâmetros:
| Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|
| :p1 | String | 255 | Código do Pedido |
Listagem de Pedidos - Observações¶
Retornar dados das observações do pedido por setor.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codSetor | String | 255 | Código do setor da observação |
| nomeSetor | String | 255 | Nome do setor da observação |
| dataObservacao | Date | Data da observação | |
| descricao | String | 255 | Texto da observação |
Lista de Parâmetros:
| Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|
| :pCodPedido | String | 255 | Código do Pedido |
Listagem de Pedidos - Histórico¶
Retornar dados do histórico de movimentação do pedido no ERP.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codHistorico | String | 255 | Código do histórico |
| situacao | String | 255 | Número da situação do pedido no ERP |
| descSituacao | String | 255 | Descrição da situação do pedido no ERP |
| data | Date | Data da movimentação |
Lista de Parâmetros:
| Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|
| :pCodPedido | String | 255 | Código do Pedido |
Estoque¶
Retornar a listagem do estoque
Só é necessário caso não esteja utilizando a view de Estoque Centralizado abaixo
https://redmine.ibtech.inf.br/projects/integracao_igs/wiki/Manual_de_Integra%C3%A7%C3%A3o#Estoque-Centralizado
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codEmpresa | String | 255 | Código da Empresa origem dos dados |
| codReferencia* | String | 255 | Código da Referência no ERP |
| seqTamanho* | String | 255 | Código do tamanho na grade no ERP |
| seqSortimento* | String | 255 | Código do Sortimento no ERP |
| codColecao* | String | 255 | Código da coleção da referencia no ERP |
| estoqueLimitado | Integer | Referencia com estoque limitado/vendida por disponibilidade, geralmente produtos importados: 0 - Não, 1 - Sim | |
| quantidade* | Double | Quantidade disponivel para venda (estoque - pedidos em aberto + OPs em aberto) | |
| qtdProducao | Double | Quantidade em OPs em aberto, utilizar apenas se o ERP não tratar o % de quebra e o valor não estiver compondo o campo de quantidade acima | |
| nomeReferencia* | String | 255 | (opcional) Nome da referencia |
| nomeSortimento* | String | 255 | (opcional) Descricao do Sortimento |
| codTamanho* | String | 255 | (opcional) Codigo do Tamanho. ex: P ou M ou G |
| codGrade* | String | 255 | (opcional) Codigo da grade dos tamanhos |
| codDeposito | String | 255 | Codigo do Deposito, utilizar apenas em casos espcificos, falar com a IBTech antes |
| nomeDeposito | String | 255 | Nome do Deposito, utilizar apenas em casos espcificos, falar com a IBTech antes |
| qtdProntaEntrega | Double | Quantidade em pronta entrega, não considera as OPs em aberto, somente os produtos no estoque fisico | |
| nomeColecao* | String | 255 | (opcional) Nome da coleção do produto |
| seqOrdenacaoTamanho* | integer | (opcional) Sequencia de ordenação do tamanho na grade | |
| peso | Double | (opcional) Peso da peça acabada | |
| dataReferencia | Date | (opcional) Data da disponibilidade do estoque do SKU. O valor de estoque deve ser o acumulado na data, não apenas o que sera produzido no dia em questão. | |
| codMarca | String | 255 | (opcional) Codigo da marca no qual o produto pertence |
| CodCorBase | String | 255 | (opcional) Código da Cor Base do Produto |
| codReferProvisoria | String | 255 | (opcional) Código provisório |
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 | 10 | (opcional) Código da empresa no ERP |
| seqTamanho | :p3 | String/Integer | 10 | (opcional) Código do tamanho na grade no ERP |
| seqSortimento | :p4 | String/Integer | 10 | (opcional) Código do Sortimento no ERP |
| codColecao | #COLECOES | Qualificar no WHERE como IN |
Lotes de Entrega¶
Retornar o cadastro de lotes de entrega
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| prazo | String | 255 | Código do lote de entrega (consequente prazo) |
| descricao | String | 255 | Descrição do lote de entrega |
| dataInicio | Date | 255 | Data de Início da vigência de entrega |
| dataFim | Date | 255 | Data Final da vigência de entrega |
Lotes de Faturamento¶
Retornar o cadastro de lotes de faturamento
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| dataReferencia | Date | Data de referência | |
| dataFaturamento | Date | Data de faturamento | |
| descricao | String | Descrição do lote de faturamento | |
| codErp | String | Código do lote no ERP (Necessário APENAS se for essencial para a gravação do Pedido) | |
| codRepres | String | Código do representante (opcional) | |
| janelaEntregaDe | Date | Data de Início da vigência de entrega (opcional) | |
| janelaEntregaAte | Date | Data Final da vigência de entrega (opcional) | |
| codTabPreco | String | Código de tabela de preços (opcional) | |
| codTipoNota | String | Código de tipo de nota (opcional) | |
| situacao | Integer | Situação do lote de faturamento (opcional) | |
| dataMinimaEntrega | Date | Data minima para entrega (opcional) |
| Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|
| :p1 | Date | Data de referência |
Cálculo substituição tributária¶
A integração de ST possuiu dois modelos de leitura.
O modelo PADRAO que filtra a ST apenas pelo código da referência e o MODELO_GRUPO_PRODUTO_CLIENTE que filtra a ST de acordo com o grupo do produto e a do cliente.
O formato do SQL muda de acordo com as configurações gerais do Força de Vendas.
Abaixo SQL modelo padrão:
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codReferencia | String | 255 | Código da referência |
| UF | String | 2 | Sigla do estado |
| aliquotaInterna | double | aliquotaInterna | |
| aliquotaICMS | double | aliquotaICMS | |
| aliquotaICMS2 | double | aliquotaICMS2 | |
| reducaoICMS | double | reducaoICMS | |
| percentualMVA | double | percentualMVA | |
| reducaoICMSBase | double | reducaoICMSBase | |
| pauta | double | pauta | |
| peso | double | peso |
Abaixo SQL modelo por grupo de produto e de cliente:
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codGrupoProduto | String | 255 | Grupo de ST do produto |
| codGrupoCliente | String | 255 | Grupo de ST do cliente |
| UF | String | 2 | Sigla do estado |
| aliquotaInterna | double | aliquotaInterna | |
| aliquotaICMS | double | aliquotaICMS | |
| aliquotaICMS2 | double | aliquotaICMS2 | |
| reducaoICMS | double | reducaoICMS | |
| percentualMVA | double | percentualMVA | |
| reducaoICMSBase | double | reducaoICMSBase | |
| pauta | double | pauta | |
| peso | double | peso |
SQL de exemplo com base na documentação
select codEmpresa, cgiima->cgisai->coditem, uf, aliquotaICMSInterna, IBTech.CGISAI_getPercICMS(codEmpresa,cgiima->cgisai->coditem,uf) aliqOrigemICMS, percReducaoBase percReducaoBASE, percIVA percMVA, percReducaoMVASimplesNac percReducaoICMS, IBTech.FTBTAB97fx1nv6_pegarValorPautaVigencia(codEmpresa,uf,cgiima->cgisai->coditem,null) pauta, 0 peso from IBTech.FTBTAB60fx1nv6 where codEmpresa = 20
Grupos substituição tributária¶
Quando usar o modelo substituição tributária por grupo então é necessário utilizar esse SQL.
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codigo | String | 255 | Código do grupo ST |
| descricao | String | 255 | Descrição do grupo ST |
Integração Valor de Frete por UF¶
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| Valor | Double | Valor do frete | |
| UF | String | 2 | Sigla do estado |
Lista de Parâmetros:
| Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|
| :p1 | String | 2 | UF do Cliente |
SQL de exemplo com base na documentação
SELECT custo_frete,
uf
FROM v_ibtech_uf_frete
WHERE upper(uf) = upper(:p1)
Tabela de Preço SKU¶
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| codEmpresa * | String | 10 | Código da Empresa de origem dos dados |
| codTabPreco * | String | 255 | Código da tabela de preço |
| codReferencia * | String | 225 | Código de referência |
| codGrade * | String | 225 | Código da grade |
| vlrUnitario * | Double | Valor Unitário da SKU | |
| seqSortimento * | String/Integer | 255 | Código do sortimento |
| itemAtivo | Integer | 1 | Flag de item ativo |
| seqTamanho * | String | 225 | Sequência do tamanho |
| descrProduto | String | 255 | Descrição de produto |
| vlrUnitarioAnterior | Double | Valor Unitário Anterior na tabela | |
| seqTamanho * | String | 225 | Sequência do tamanho |
| permiteBonificacao | Integer | 1 | Definição para Bonificação na tabela |
| flagOferta | Integer | 1 | Flag de Oferta na Tabela |
Tabela de Preço - Política - Desconto Adicional de Lote¶
| Campo | Tipo | Precisão | Descrição |
|---|---|---|---|
| prazoMedioMinimo * | Double | Prazo Médio Mínimo | |
| prazoMedioMaximo * | Double | Prazo Médio Máximo | |
| percDesconto * | Double | Prazo Inicial |
Lista de Parâmetros:
| Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|
| :p2 | String | Tabela de Preço |
Listagem de Pedidos Em Aberto - Capa¶
Retornar dados referentes a capa do pedido.
| Num | Campo | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| 1 | codEmpresa | String/Integer | 10 | Código da empresa no ERP |
| 2 | codPedido | String | 255 | Código do Pedido no ERP |
| 3 | dataEmissao | Date | Data de Emissão do Pedido | |
| 4 | dataPrevFat | Date | Data de Previsão de Faturamento do Pedido | |
| 5 | codCliente | String | 255 | Código do Cliente |
| 6 | nomeCliente | String | 255 | Nome do Cliente |
| 7 | situacaoDescritiva | String | 255 | Situação no ERP |
| 8 | valorLiquido | Double | Valor Liquido do Pedido |
Lista de Parâmetros:
| Campo | Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| dataEmissaoDe | :p1 | Date | Data Emissão Inicial | |
| dataEmissaoAte | :p2 | Date | Data Emissão Final | |
| codRepres | :p3 | String | 255 | Código Representante |
| codCliente | :p4 | String | 255 | Código Cliente |
SKUs Pronta Entrega e Programado¶
| Campo | Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| 1 | codReferencia | String/Integer | 10 | Código da referência |
| 2 | codTabPreco | String | 255 | Código da tabela de preço |
| 3 | seqSortimento | String | Sequência do Sortimento | |
| 4 | seqTamanhos | String | Sequência do Tamanho | |
| 5 | tipoPedido | Int | 255 | Tipo de pedido (10 = Pronta Entrega, 20 = Programado) |
Lista de Parâmetros:
| Campo | Parâmetro | Tipo | Precisão | Descrição |
|---|---|---|---|---|
| codTabPreco | #TABPRECOS | Qualificar no WHERE como IN |