Integração Analytics

h1. Digitação de Pedidos

*Índice* 

# [[Digitação de Pedidos#Introdução|Introdução]] 

# [[Digitação de Pedidos#Acesso-via-JDBC|Acesso via JDBC]] 

# [[Digitação de Pedidos#Tabelas-de-Integração-Parâmetros-e-Exemplo-de-SQL-de-Integração|Tabelas de Integração, Parâmetros e Exemplo de SQL de Integração]]

## [[Digitação de Pedidos#Tabelas-de-Integração|Tabelas de Integração]]

## [[Digitação de Pedidos#Parâmetros|Parâmetros]]

## [[Digitação de Pedidos#Exemplo-de-SQL-de-Integração|Exemplo de SQL de Integração]]

# [[Digitação de Pedidos#Layouts-de-Integração|Layouts de Integração]]

## [[Digitação de Pedidos#Tabela-de-Preço|Tabela de Preço]]

## [[Digitação de Pedidos#Tabela-de-Preço-por-Representante|Tabela de Preço por Representante]] (opcional - somente se ERP possui esse controle)

## [[Digitação de Pedidos#Tabela-de-Preço-Produto|Tabela de Preço - Produto]]

## [[Digitação de Pedidos#Tabela-de-Preço-Política-Desconto-Comercial|Tabela de Preço - Política - Desconto Comercial]] (opcional)

## [[Digitação de Pedidos#Tabela-de-Preço-Política-Desconto-Financeiro|Tabela de Preço - Política - Desconto Financeiro]] (opcional)

## [[Digitação de Pedidos#Tabela-de-Preço-Política-Desconto-Antecipação|Tabela de Preço - Política - Desconto Antecipação]] (opcional)

## [[Digitação de Pedidos#Tabela-de-Preço-Política-Prazo-Adicional|Tabela de Preço - Política - Prazo Adicional]] (opcional)

## [[Digitação de Pedidos#Tabela-de-Preço-Política-Desconto-Volume|Tabela de Preço - Política - Desconto Volume]] (opcional)

## [[Digitação de Pedidos#Tabela-de-Preço-Política-Preços-por-volume|Tabela de Preço - Política - Preços por volume]] (opcional)

## [[Digitação de Pedidos#Títulos-Em-Aberto|Títulos Em Aberto]] (opcional)

## [[Digitação de Pedidos#Condição-de-Venda|Condição de Venda]]

## [[Digitação de Pedidos#Cota-de-estoque-Por-representante|Cota de estoque - Por representante]] (opcional)

## [[Digitação de Pedidos#Tipo-de-Nota|Tipo de Nota]](opcional)

## [[Digitação de Pedidos#Tipo-de-Cobrança|Tipo de Cobrança]](opcional)

## [[Digitação de Pedidos#Comissões|Comissões]] (opcional)

## [[Digitação de Pedidos#Comissões-Extrato-Resumo|Comissões - Extrato Resumo]] (opcional)

## [[Digitação de Pedidos#Comissões-Extrato-Detalhado|Comissões - Extrato Detalhado]] (opcional)

## [[Digitação de Pedidos#Clientes|Clientes]]

## [[Digitação de Pedidos#Clientes-Locais-de-Entrega|Clientes - Locais de Entrega]](opcional)

## [[Digitação de Pedidos#Clientes-Ramos-de-Atividade|Clientes - Ramos de Atividade]](opcional)

## [[Digitação de Pedidos#Clientes-Grupos-de-Cliente|Clientes - Grupos de Cliente]](opcional)

## [[Digitação de Pedidos#Produtos|Produtos]]

## [[Digitação de Pedidos#Produtos-Grades|Produtos - Grades]]

## [[Digitação de Pedidos#Produtos-Sortimentos|Produtos - Sortimentos]]

## [[Digitação de Pedidos#Produto-Código-Reduzido|Produto - Código Reduzido]] (opcional - somente se ERP precisa do código reduzido)

## [[Digitação de Pedidos#Produto-EAN13|Produto - EAN13]] (opcional)

## [[Digitação de Pedidos#Bloqueio-de-Referências|Bloqueio de Referências]](opcional)

## [[Digitação de Pedidos#Pedido-Capa|Pedido - Capa]]

## [[Digitação de Pedidos#Pedidos-por-Referência|Pedidos por Referência]] (opcional)

## [[Digitação de Pedidos#Listagem-de-Pedidos-Capa|Listagem de Pedidos - Capa]]

## [[Digitação de Pedidos#Listagem-de-Pedidos-Detalhado|Listagem de Pedidos - Detalhado]]

## [[Digitação de Pedidos#Listagem-de-Pedidos-Itens|Listagem de Pedidos - Itens]]

## [[Digitação de Pedidos#Listagem-de-Pedidos-Notas|Listagem de Pedidos - Notas]]

## [[Digitação de Pedidos#Listagem-de-Pedidos-Observções|Listagem de Pedidos - Observações]] (opcional)

## [[Digitação de Pedidos#Listagem-de-Pedidos-Histórico|Listagem de Pedidos - Histórico]] (opcional)

## [[Digitação de Pedidos#Estoque|Estoque]]

## [[Digitação de Pedidos#Lotes-de-Entrega|Lote Entrega]]

## [[Digitação de Pedidos#Lotes-de-Faturamento|Lotes de Faturamento]]

## [[Digitação de Pedidos#Cálculo-substituição-tributária|Cálculo substituição tributária]] (opcional)

## [[Digitação de Pedidos#Grupos-substituição-tributária|Grupos substituição tributária]] (opcional)

## [[Digitação de Pedidos#Integração-Valor-de-Frete-por-UF|Integração Valor de Frete por UF]] (opcional)

## [[Digitação de Pedidos#Tabela-de-Preço-SKU|Tabela de Preço SKU]] (opcional)

## [[Digitação de Pedidos#Tabela-de-Preço-Política-Desconto-Adicional-de-Lote|Tabela de Preço - Política - Desconto Adicional de Lote]] (opcional)

## [[Digitação de Pedidos#Listagem-de-Pedidos-Em-Aberto-Capa|Listagem de Pedidos em Aberto - Capa]]

## [[Digitação de Pedidos#Listagem-de-Pedidos-Detalhado|Listagem de Pedidos em Aberto - Detalhado]] (mesma estrutura Listagem de Pedidos - Detalhado)

## [[Digitação de Pedidos#Listagem-de-Pedidos-Itens|Listagem de Pedidos em Aberto - Itens]] (mesma estrutura Listagem de Pedidos - Itens)

h1. Introdução

O presente documento tem por objetivo orientar as empresas de ERP na geração dos arquivos e/ou tabelas necessárias para integração com a Digitação de Pedidos da IBTech.

Dúvidas ou maiores esclarecimentos podem ser obtidos pelo e-mail atendimento@ibtech.inf.br ou pelo telefone (47) 3370-0504.

h1. Acesso via JDBC

*Pré-Requisito:* Suporte por parte do Banco de Dados da Empresa fornecedora do ERP a acesso JDBC.

Na integração via JDBC a fornecedora de ERP deve disponibilizar para a IBTech tabelas (ou visões) conforme os layouts especificados neste documento, também deverá fornecer um usuário e senha que tenha permissão de consulta nas referidas tabelas ou visões. A IBTech fará acesso via JDBC à base de dados do cliente para extrair as informações.

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

h2. Tabelas de Integração

As tabelas/visões tem um campo chamado “codEmpresa” que separa a geração dos dados entre as possíveis várias empresas que o cliente tenha na mesma base de ERP.

*Observação:* Os campos com asterisco (*) compõem a “primaryKey” e podem ser enviados como String ou Integer dependendo da necessidade do cliente.

h2. Parâmetros

Algumas tabelas de integração necessitam de parâmetros. Os parâmetros trabalham em pares: Campo e Parâmetro. 

O Campo refere-se ao campo correspondente na tabela/visão, e o parâmetro é o código que será substituído na hora da execução do SQL.

h2. Exemplo de SQL de Integração

Vamos usar abaixo um exemplo a Tabela de Preços:

*Documentação do IGS:*

> Consulta informações de tabela de preço do ERP.

> 

> |_. Campo      |_. Tipo   |_. Precisão |_. Descrição |

> | codEmpresa * | String/Integer   | 10         | Código da Empresa origem dos dados |

> | codTabela *  | String/Integer   | 255        | Código da tabela de preços no ERP |

> | descricao         | String   | 255        | Descrição da tabela de preços |

> 

> Lista de Parâmetros:

> 

> |_. Campo |_. Parâmetro      |_. Tipo   |_. Precisão |_. Descrição |

> | codEmpresa | :p1     | String/Integer   | 10         | Código da empresa no ERP |

> | codTabela | :p2     | String/Integer   | 255         | Código da tabela de preços no ERP |

*SQL de exemplo com base na documentação*

<pre>SELECT codEmpresa,

codTabela,

descricao

FROM TabelaDePreco

WHERE codEmpresa = :p1

  AND codTabela = :p2</pre>

h1. Layouts de Integração

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

h2. Tabela de Preço

Consulta informações de tabela de preço do ERP.

|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |

| codEmpresa * | String/Integer   | 10         | Código da Empresa origem dos dados |

| codTabela *  | String/Integer   | 255        | Código da tabela de preços no ERP |

| descricao         | String   | 255        | Descrição da tabela de preços |

| 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) |

Lista de Parâmetros:

|_. Campo |_. Parâmetro      |_. Tipo   |_. Precisão |_. Descrição |

| codEmpresa | :p1     | String/Integer   | 10         | Código da empresa no ERP |

| codTabela | :p2     | String/Integer   | 255         | Código da tabela de preços no ERP |

h2. Tabela de Preço 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 |

h2. Tabela de Preço - Produto

Retornar a listagem dos produtos da tabela de preço do ERP.

|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |

| codEmpresa * | String/Integer   | 10         | Código da Empresa origem dos dados |

| codTabela *  | String/Integer   | 255        | Código da tabela de preços no ERP |

| codProduto *  | String/Integer   | 255        | Código do produto no ERP |

| codGrade *  | String/Integer   | 255        | Código da grade de produto no ERP |

| preco    | Double   |            | Preço do produto |

| 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) |

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 |

h2. 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 |

h2. 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 |

h2. 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 |

h2. 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 |

h2. 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 |

h2. 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 |

h2. 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 |

h2. Condição de Venda

Retorna a listagem de Condições de Venda do ERP.

|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |

| codEmpresa * | String/Integer   | 10         | Código da Empresa origem dos dados |

| codPagamento *  | String/Integer   | 255        | Código da condição de Venda no ERP |

| nome         | String   | 255        | Nome da condição de venda |

| qtdeParcelas         | Integer   |        | Número de parcelas da condição de venda |

| prazoMedio         | Double   |         | Prazo médio das parcelas da condição de venda |

| 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 |

h2. 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 |

h2. Tipo de Nota

Retorna a listagem de Tipos de Nota do ERP.

|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |

| codEmpresa * | String/Integer   | 10         | Código da Empresa origem dos dados |

| codTipo *  | String/Integer   | 255        | Código do tipo de nota no ERP |

| nome         | String   | 255        | Nome/descrição do tipo de nota |

| 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 |

h2. 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 |

h2. Comissões

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

|_. Campo      |_. Tipo   |_. Precisão |_. Descrição |

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

h2. 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) |

h2. 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) |

h2. 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 | email | 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 | 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 | instagram | String | 255 | Instagram. |

|_.63 | facebook | 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. |

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 |

h2. 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 |

h2. 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 |

h2. 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 |

h2. 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 |

h2. 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 |

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 |

h2. 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 |

h2. 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 |

h2. 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 |

h2. 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 |

h2. 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 |

h2. 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 |

h2. 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 |

| :pCodRepresentante   | String   | 10         | Código do Representante   |

| :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 |

h2. 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 |

h2. 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 |

h2. 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 |

Lista de Parâmetros:

|_. Parâmetro  |_. Tipo  |_. Precisão |_. Descrição         |

| :p1 | String   |  255          | Código do Pedido |

h2. 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 |

h2. 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 |

h2. Estoque

Retornar a listagem do estoque

|_. 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 |

h2. 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 |

h2. 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 (opcional) |

| 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 |

h2. 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*

<pre>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</pre>

h2. 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 |

h2. 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*

<pre>SELECT custo_frete, 

       uf

FROM v_ibtech_uf_frete

WHERE upper(uf) = upper(:p1)</pre>

h1. 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 |

h1. 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 |

h1. 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 |