Loja Virtual - B2B¶

Índice

1. Introdução
2. Acesso via JDBC
3. Tabelas de Integração, Parâmetros e Exemplo de SQL de Integração
   1. Tabelas de Integração
   2. Parâmetros
   3. Exemplo de SQL de Integração
4. Layouts de Integração
   1. Produtos
   2. Produtos - Grades
   3. Produtos - Grade Fechada
   4. Produtos - Sortimentos
   5. Produtos - Tabela de Preço
   6. Produtos - Tabela de Preço por SKU
   7. Produtos - Estoque
   8. Produtos - Pocket
   9. Pedido - Capa
   10. Pedido - Histórico
   11. Pedido - Detalhe
   12. Pedido - Itens
   13. Pedido - Itens Detalhado
   14. Pedidos - Histórico - Dinâmico
   15. Licenciados - Fornecedores
   16. Licenciados - Pedido - Histórico
   17. Licenciados - Pedido - Itens
   18. Licenciados - DANFE - Listagem
   19. Licenciados - DANFE - XML
   20. Cliente
   21. Clientes - Crédito troca em garantia
   22. Representantes - Clientes
   23. Clientes - Representantes
   24. Comissão por Repres/Cliente/Marca
   25. Condição de Venda
   26. Bloqueio Referências
   27. Boletos - Consulta Cliente
   28. Boletos - Listagem
   29. Boletos - Detalhado
   30. Boletos Pagos - Listagem (somente via API com ELT)
   31. DANFE- Listagem
   32. DANFE- Itens da Nota
   33. DANFE- XML
   34. Lote de Faturamento
   35. Produto SKU - Cód. Barras
   36. Frete
   37. Espelho Nota de Devolução
   38. Nota de Devolução Integral
   39. Produto Volume Valor por Referência
   40. Substituição Tributária
   41. Pedido - Recompra
   42. Compra Acumulada - Valores Base Cálculo
   43. Partidas de Pedidos
   44. Tabela de Preço

Introdução¶

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

Atenção!! Os campos que estiverem com a descrição "Campo Específico" retornar null, salvo se for combinado algo diferente com a GEOvendas durante o processo.

Atenção!! Cabe ao desenvolvedor das Views retornar nas views os campos obrigatórios e os campos não obrigatórios que forem pertinentes ao processo do Cliente, ou a informação que o cliente deseja enxergar.

Dúvidas ou maiores esclarecimentos podem ser obtidos pelo e-mail atendimento@geovendas.com 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 GEOvendas 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 GEOvendas 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.

Produtos¶

Retornar a listagem de produtos ATIVOS filtrando coleção.

Pos	Campo	Tipo	Precisão	Descrição
1	codReferencia *	String/Integer	255	Código da Referência no ERP. É o código usado para gravar o produto no ERP
2	NomeReferencia	String	255	Descrição da referência
3	codEtiqueta	String	255	Código da Etiqueta (ou Marca) da referência. Consultar a GEOvendas sobre o que trazer neste campo.(Não pode ter caracteres especiais, exceto hifen. Qualquer caracter especial deve ser trocado por hifen, inclusive espaços)
4	nomeEtiqueta	String	255	Nome da Etiqueta (ou Marca) da referência. Consultar a GEOvendas sobre o que trazer neste campo. Ex: FASHION, CASUAL, etc.(Não pode ter caracteres especiais, exceto hifen. Qualquer caracter especial deve ser trocado por hifen, inclusive espaços)
5	codLinha	String	255	Código da Linha de Produto da referência.(Não pode ter caracteres especiais, exceto hifen. Qualquer caracter especial deve ser trocado por hifen, inclusive espaços)
6	nomeLinha	String	255	Nome da Linha de Produto da referência. Ex: ADULTO, INFANTIL, etc.(Não pode ter caracteres especiais, exceto hifen. Qualquer caracter especial deve ser trocado por hifen, inclusive espaços)
7	codTipoPeca	String	255	Código do Tipo de Peça da referência. Consultar a GEOvendas sobre o que trazer neste campo.(Não pode ter caracteres especiais, exceto hifen. Qualquer caracter especial deve ser trocado por hifen, inclusive espaços)
8	nomeTpoPeca	String	255	Nome do Tipo de Peça da referência. Consultar a GEOvendas sobre o que trazer neste campo. Ex: CALCA, BLUSA, CAMISA, SHORTS, etc.(Não pode ter caracteres especiais, exceto hifen. Qualquer caracter especial deve ser trocado por hifen, inclusive espaços)
9	codTipoModelo	String	255	Código do Tipo Modelo da referência. Consultar a GEOvendas sobre o que trazer neste campo.(Não pode ter caracteres especiais, exceto hifen. Qualquer caracter especial deve ser trocado por hifen, inclusive espaços)
10	nomeTipoModelo	String	255	Nome do Tipo Modelo da referência. Consultar a GEOvendas sobre o que trazer neste campo. Ex: Masculino / Feminino.(Não pode ter caracteres especiais, exceto hifen. Qualquer caracter especial deve ser trocado por hifen, inclusive espaços)
11	precoUnitario	Double		Preço Unitário, geralmente deixado valor 0
12	GradesAtivas	String		Campo Específico. Retornar null , salvo alguma orientação diferente da GEOvendas. Somente se trabalha com Grade Estendida. Senão retornar null
13	codReferenciaProvisoria	String		Código de Referencia "Provisória", ou aquela que o cliente "conhece". Caso seja a mesma do campo codReferencia, retornar o mesmo valor
14	descricao	String	255	Descrição
15	descricaoHTML	String	255	Descrição HTML (Se existir no ERP). Se não retornar null
16	qtdeEmbarquePadrao	Integer		Campo Específico. Retornar null , salvo alguma orientação diferente da GEOvendas. Quantidade Embarque Padrão. Para o caso de compras múltiplas.
17	genero	String	255	(Não pode ter caracteres especiais, exceto hifen. Qualquer caracter especial deve ser trocado por hifen, inclusive espaços)
18	keywords	String	255	Keywords do produto.
19	composicao	String	255	Composição do produto.
20	precoSugerido	Double		Preço sugerido de venda.
21	flagGradeFechada	Integer		0 ou 1 se utiliza grade fechada
22	unidMedida	String	20	Unidade de Medida
23	codGrupo	String	250	Campo Específico. (Retornar null , salvo alguma orientação diferente da GEOvendas) - Código do Agrupador da Ref.
24	percentualIPI	Double		Percentual de incidência de IPI.
25	grupo_st	String	255	Responsável por gravar o grupo do produto pertencente ao ST
26	data_referencia	String	255	Data de referência do produto - usado para quebra de pedido - Formato: "yyyy-mm-dd hh:mm:ss" (ano, mês, dia, hora 24h, min, seg)
27	codCoringa1	String	255	Código do campo coringa 1. Consultar a GEOvendas sobre o que trazer neste campo.
28	nomeCoringa1	String	255	Nome do coringa 1. Consultar a GEOvendas sobre o que trazer neste campo. Ex: FASHION, CASUAL, etc
29	codCoringa2	String	255	Código do campo coringa 2. Consultar a GEOvendas sobre o que trazer neste campo.
30	nomeCoringa2	String	255	Nome do coringa 2. Consultar a GEOvendas sobre o que trazer neste campo. Ex: FASHION, CASUAL, etc
31	codCoringa3	String	255	Código do campo coringa 3. Consultar a GEOvendas sobre o que trazer neste campo.
32	nomeCoringa3	String	255	Nome do coringa 3. Consultar a GEOvendas sobre o que trazer neste campo. Ex: FASHION, CASUAL, etc
33	codCoringa4	String	255	Código do campo coringa 4. Consultar a GEOvendas sobre o que trazer neste campo.
34	nomeCoringa4	String	255	Nome do coringa 4. Consultar a GEOvendas sobre o que trazer neste campo. Ex: FASHION, CASUAL, etc
35	codCoringa5	String	255	Código do campo coringa 5. Consultar a GEOvendas sobre o que trazer neste campo.
36	nomeCoringa5	String	255	Nome do coringa 5. Consultar a GEOvendas sobre o que trazer neste campo. Ex: FASHION, CASUAL, etc
37	sequencia	Integer		Sequência do produto para exibição na loja
38	agrupador_kit	String	255	Código do agrupador de kits
39	nome_agrupador_kit	String	255	Nome do agrupador de kits
40	embarque_referencia	Integer		Quantidade mínimo da referência em um pedido
41	embarque_sortimento	Integer		Quantidade mínima de um sortimento de uma referência em um pedido
42	embarque_sku	Integer		Quantidade mínima de uma SKU em um pedido
43	referencia_kit	Integer		0 ou 1 para definir se é uma referência kit

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP
codColecao	:p2	String/Integer	255	Código da coleção da referência no ERP
codReferencia	#REFERENCIAS	String	text	Lista de Referências Ex: and (codReferencia in (#REFERENCIAS) or #REFERENCIAS_TODAS = '') Para ORACLE and (codReferencia in (#REFERENCIAS) or nvl(#REFERENCIAS_TODAS,'0') = nvl('','0') )
CodTabela	#TABPRECO			Código da tabela de preços no ERP usando a clausula IN ('#TABPRECO')

Produtos - Grades¶

Retornar a listagem das grades ATIVAS dos produtos filtrando coleção.

Campo	Tipo	Precisão	Descrição
codReferencia *	String/Integer	255	Código da Referência no ERP
codGrade *	String/Integer	255	Código da Grade no ERP
seqTamanho *	Integer		Código do tamanho na grade no ERP
seqOrdenacao *	Integer		Sequencia de ordenação do tamanho na grade
codTamanho *	String	255	Descrição do tamanho no ERP (Ex: "P")
pesoPeca	Double		Peso da Peça. (Separado por ponto e não por virgula)
nomeGrade	Double		Nom da Grade. Exemplo: P/M/G/GG ou 01/02/03 ou Unica

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP
codColecao	:p2	String/Integer	255	Código da coleção da referência no ERP
CodTabela	#TABPRECO			Código da tabela de preços no ERP usando a clausula IN ('#TABPRECO')

Produtos - Grade Fechada¶

Retornar a listagem das grades fechadas

Campo	Tipo	Precisão	Descrição
codReferencia *	String/Integer	255	Código da Referência no ERP
seqTamanho *	String		Código do tamanho na grade no ERP
multiplo *	Integer		Múltiplo do tamanho a ser considerado na grade fechada
nome	String		Nome do grupo de grade

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP
codColecao	:p2	String/Integer	255	Código da coleção da referência no ERP

Produtos - Sortimentos¶

Retornar a listagem dos sortimentos ATIVOS dos produtos filtrando coleção.

Campo	Tipo	Precisão	Descrição
codReferencia *	String/Integer	255	Código da Referência no ERP
codSortimento *	String/Integer	255	Código do Sortimento no ERP
descricao	String	255	Descrição do sortimento no ERP
codCorBase	String	255	Código da cor comercial (usada no catalogo)
codRGBCorBase	String	255	Código em RGB da cor
ordem	Integer		Ordenação das cores
pocket	Integer		Indicativo que o sortimento é Pocket valores 0 ou 1 (Morena Rosa)
estampa	string		Código da estampa para envio de samples

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP
codColecao	:p2	String/Integer	255	Código da coleção da referência no ERP
CodTabela	#TABPRECO			Código da tabela de preços no ERP usando a clausula IN ('#TABPRECO')

Produtos - Tabela de Preço¶

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 (Campo deve vir com ponto em vez de virgula nos preços)
preco_sugerido	Double		Preço sugerido para venda (Campo deve vir com ponto em vez de virgula nos preços)
precoPromocao	Double		Preço de promoção (Campo deve vir com ponto em vez de virgula nos preços)
ignorarDescontoB2B	Integer		Se deve ignorar o desconto sobre o item. (Default é 0, não deve ignorar)
markup	Double		Markup do Produto
precoMeta	Double		Preco para ser usado na funcionalidade de Meta por cliente

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP
codColecao	:p2	String/Integer	10	Código da colecao no ERP
codTabela	#REFERENCIAS		AND (codProduto in (#REFERENCIAS) or COALESCE = COALESCE )
codTabela	#TABPRECO			Código da tabela de preços no ERP usando a clausula IN

Produtos - Tabela de Preço por SKU¶

Retornar a listagem dos produtos da tabela de preço por SKU 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
seqSortimento *	String/Integer	255	Código do sortimento do produto no ERP
seqTamanho*	String/Integer	255	Código do tamanho do produto no ERP
preco	Double		Preço do produto (Campo deve vir com ponto em vez de virgula nos preços)
preco_sugerido	Double		Preço sugerido para venda (Campo deve vir com ponto em vez de virgula nos preços)
flagBloqueio	Integer		Flag bloqueado
precoPromocional	Double		Preço promocional do produto
dataInicioPromo	Date		Data inicial da vigência do preço promocional (Formato yyyy-MM-dd)
dataFimPromo	Date		Data final da vigência do preço promocional (Formato yyyy-MM-dd)
codGrade	String		Código da Grade (USADO PELA MALWEE)

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP
codColecao	:p2			Código da tabela de preços no ERP usando a clausula IN
codTabela	#TABPRECO			Código da coleção do produto no ERP usando a clausula IN

Produtos - Estoque¶

Retornar a listagem dos estoques dos produtos. Para bom funcionamento o ideal é ter um "Almoxarifado" (ou o que for similar no seu ERP) exclusivo para loja.

Campo	Tipo	Precisão	Descrição
codProduto *	String/Integer	255	Código do produto no ERP
seqTamanho *	Integer		Código do tamanho na referencia
seqSortimento *	Integer		Código do sortimento na referencia
qtdeEstoque	Integer		Estoque do Produto
estoqueLimitado *	Integer		Se vende somente estoque ou trabalha com programação (1,0)
ncm	String		NCM
ean13	String		Ean 13
qtdeEstoqueProducao	Integer		Estoque a Produzir (Só popular caso seja solicitado Pela GEOvendas, por padrão trazer 0)
data	String		Data do depósito "yyyy-mm-dd hh:mm:ss" (ano, mês, dia, hora 24h, min, seg)
codDeposito	String		Código do depósito

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			Lista de coleções para filtro com a cláusula IN
codTabPreco	#TABPRECO			Lista de tabelas de preços para filtro com a cláusula IN
codNatureza/codDeposito	#NATUREZA			Lista de natureza/deposito para filtro com a cláusula IN

Produtos - Pocket¶

Retornar as SKUS que compõem o pocket, por cliente e referência..

Campo	Tipo	Precisão	Descrição
codCliente *	String/Integer	255	Código do cliente
codReferencia *	String/Integer	255	Código da referencia
seqSortimento *	String/Integer	255	Código do sortimento na referencia
seqTamanho *	String/Integer	255	Código do tamanho na referência
quantidade *	Integer		Quantidade que será enviada no pocket

Pedido - Capa¶

Consulta situação do pedido no ERP.

Campo	Tipo	Precisão	Descrição
codPedidoLoja *	String/Integer	255	Código do pedido no B2B
codPedido *	String/Integer	255	Código do pedido no ERP
situacao	Integer		Retornar o código da situação do pedido no ERP (ver códigos disponíveis logo abaixo)

Campos Referentes ao B2C¶

descSituacao	String	255	Descrição da situação no ERP
numeroNotaFiscal	Integer	_.	Número da primeira nota fiscal do pedido no ERP
serieNotaFiscal	String	255	Série da primeira nota fiscal do pedido no ERP
numeroDanfNfe	String	255	Número da DANF da NFE
valorNotaFiscal	Double		Valor da Nota Fiscal

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

h3.Listagem dos Status disponíveis para o B2B e seus respectivos codigos

10	Em aberto
20	Aguardando pagamento
30	Processando pagamento
35	Em análise comercial
37	Em análise financeira
40	Programado
43	Faturamento Parcial
45	Faturado
50	Em transporte
97	Erro
98	Cancelado
99	Faturado Total
100	Infinito
110	Pedido Pai

Pedido - Histórico¶

Histórico pedido ERP.

Campo	Tipo	Precisão	Descrição
NumeroErp *	String/Integer		Código pedido ERP
Data *	String		Data de Emissão do Pedido
Situacao *	String		Descrição da Situação do Pedido
FormaPagamento *	String		Forma de pagamento do pedido
Total *	String/Integer		Total líquido pedido
codcliente *	String/Integer		Código cliente pedido
cliCnpj *	String		cnpj cliente pedido
nomecliente *	String		nome cliente pedido
pedidoCliente	String		numero do pedido do cliente
DataPrevFatur *	String		Data de Previsão de Faturamento do Pedido
coringa1	String		Situação da coleta

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP
cnpjCliente	:p2	String		CNPJ do Cliente
dataEmissaoInicio	:p3	Date		Data de Inicio do Período
dataEmissaoFim	:p4	Date		Data Final do Período
dataPrevFaturInicio	:p5	Date		Data de Inicio do Período da Previsão
dataPrevFaturFim	:p6	Date		Data Final do Período da Previsão

Pedido - Detalhe¶

Detalhe pedido ERP.

Campo	Tipo	Precisão	Descrição
NumeroErp *	String/Integer		Código pedido ERP
Data *	String		Data emissão pedido
Situacao *	String		Descrição da Situação do Pedido
FormaPagamento *	String		Forma de pagamento pedido
Total *	double		total líquido pedido
TotalBruto *	double		Total bruto pedido
Observacoes *	String		Obs pedido

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP
cnpjCliente	:p2	String		CNPJ Cliente
codPedido	:p3	String		Código pedido erp

Pedido - Itens¶

Itens detalhe pedido ERP.

Campo	Tipo	Precisão	Descrição
CodItem *	String		Código do item
CodProduto *	String		Código do produto
NomeProduto *	Double		Nome do item
QtdePedida *	Double		Quantidade pedida
QtdeSaldo *	Double		Quantidade saldo
QtdeFaturado *	Double		Quantidade faturada
QtdeCancelado *	Double		Quantidade cancelada
ValorUnitarioBruto *	Double		Valor unitário bruto
ValorUnitarioLiquido *	Double		Valor líquido
ValorTotal *	Double		Valor total
CodReferenciaReduzida *	Double		Código referencia Reduzido
SeqTamanho *	String		Seq tamanho
SeqSortimento *	String		Seq sortimento
QtdeReservado *	Double		Quantidade reservada

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codPedido	:p1	String		Código pedido erp

Pedido - Itens Detalhado¶

Itens detalhe pedido ERP, com informações mais completas.

Campo	Tipo	Precisão	Descrição
CodItem *	String		Código do item
CodProduto *	String		Código do produto
NomeProduto *	Double		Nome do item, sem concatenação do soritmento ou código de cor
QtdePedida *	Double		Quantidade pedida
QtdeSaldo *	Double		Quantidade saldo
QtdeFaturado *	Double		Quantidade faturada
QtdeCancelado *	Double		Quantidade cancelada
ValorUnitarioBruto *	Double		Valor unitário bruto
ValorUnitarioLiquido *	Double		Valor líquido
ValorTotal *	Double		Valor total
CodReferencia *	Double		Código referencia
SeqTamanho *	String		Código do tamanho
SeqSortimento *	String		Descrição do sortimento, pode ser concatenado com o código
QtdeReservado *	Double		Quantidade reservada

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codPedido	:p1	String		Código pedido erp

Pedidos - Histórico - Dinâmico¶

Este SQL impacta a tela Meus Pedidos -> ERP, presente no menu minha conta do E-commerce B2B. O SQL está estruturado com base na feature de relatório de pedidos dinâmicos do B2B, por conta disso, certifique-se de, antes de realizar a configuração, setar como 1 o parâmetro “Carrega pedidos ERP dinamicamente” presente no menu Parâmetros (Novo) do Portal B2B.

Campo	Tipo	Precisão	Descrição
Numero_Pedido *	String/Integer		Código pedido ERP
Data_Emissão *	String		Data de Emissão do Pedido
Código_Cliente *	String/Integer		Código cliente pedido
CNPJ *	String		CNPJ cliente pedido
Razão_Social *	String		Nome cliente pedido
Situação *	String		Descrição da Situação do Pedido
Forma_De_Pagamento *	String		Forma de pagamento do pedido
Valor_Líquido *	String/Double		Total líquido pedido
Valor_Faturado *	String/Double		Valor que já foi faturado
Qtde_Itens *	String/integer		Quantidade total de itens
Qtde_Itens_Faturados *	String/integer		Quantidade de itens que já foi faturado

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP
cnpjCliente	:p2	String		CNPJ do Cliente
dataInicio	:p3	Date		Data de Inicio do Período
dataFim	:p4	Date		Data Final do Período

Licenciados - Pedido - Histórico¶

Histórico pedido ERP.

Campo	Tipo	Precisão	Descrição
NumeroErp *	String/Integer		Código pedido ERP
Data *	Date		Data de Emissão do Pedido
Situacao *	String		Descrição da Situação do Pedido
codColecao *	String		Código da Coleção
nomeColecao *	String		Nome da Coleção
dataPrevisaoEntrega *	Date		Data de Previsão de Entrega
qtdePecas *	Integer		Quantidade de Peças
Total *	String/Integer		Total líquido pedido
codcliente *	String/Integer		Código cliente pedido
cliCnpj *	String		CNPJ cliente pedido
nomecliente *	String		Nome cliente pedido
cnpjFornecedor *	String		Código do fornecedor
codFornecedor *	String		Código do fornecedor
codEmpresa *	String		Código da empresa
cidadeCliente *	String		Nome da cidade do cliente
estadoCliente *	String		Nome do estado do cliente
logradouroCliente *	String		logradouro do cliente
bairroCliente *	String		bairro do cliente
cepCliente *	String		CEP do cliente
numeroCliente*	String		Número do endereço do cliente
complementoCliente*	String		Complemento do endereço do cliente
paisCliente*	String		Pais do cliente
telefoneCliente *	String		Telefone do cliente
emailCliente *	String		E-mail do cliente
inscricaoEstadualCliente *	String		Inscrição Estadual do cliente
descMarca*	String		Descrição Marca
codRepresentante*	String		Código do representante
dataInclusao *	Date		Data de Inclusao
condPagamento*	String		Condição de pagamento

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP
cnpjFornecedor	:p2	String		CNPJ do Fornecedor
dataInicio	:p3	Date		Data de Inicio do Período
dataFim	:p4	Date		Data Final do Período

Licenciados - Pedido - Itens¶

Itens detalhe pedido ERP.

Campo	Tipo	Precisão	Descrição
CodProduto *	String		Código do produto
NomeProduto *	String		Nome do item
QtdePedida *	Double		Quantidade pedida
ValorUnitarioLiquido *	Double		Valor líquido
ValorTotal *	Double		Valor total
SeqTamanho *	String		Seq tamanho
SeqSortimento *	String		Seq sortimento
CodReferenciaReduzida *	String		Código referencia Reduzido
DescTamanho *	String		Descrição do tamanho
DescSortimento *	String		descrição do Sortimento
DataPrevBaixa*	Date		Data previsão de baixa

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codPedido	:p1	String		Código pedido erp

Licenciados - DANFE - Listagem¶

Estes dados serão utilizados na listagem das notas fiscais no portal B2B.

Campo	Tipo	Precisão	Descrição
cnpj *	String	255	CNPJ do cliente
codCliente *	String	255	Código do cliente
nomeCliente *	String	255	Nome do cliente
cidade *	String	255	Cidade do cliente
notaFiscal *	String	255	Número da nota fiscal
chaveNFE *	String	255	Chave da Nota fiscal
dataEmissao *	Date ODBC	255	Data de emissão da nota fiscal
valor *	Double	2	Valor total da nota fiscal
ocorrencias	String		JSON das ocorrências da nota fiscal. Campo especifico, mandar null salvo orientação
codEmpresa	String	255	Código da empresa

Listagem de parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP
codPedido	:p2	String		Código do pedido

Licenciados - DANFE - XML¶

Estes dados serão utilizados para gerar a visualização em PDF das notas fiscais.

Campo	Tipo	Precisão	Descrição
codCliente *	String	255	Código do cliente
notaFiscal *	String	255	Código da Nota Fiscal
xml *	String		XML da nota fiscal completo (NÃO PODE SER O CAMINHO DO FILESERVER NEM TIPO CLOB)

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP
notaFiscal	:p2	String	255	Código da nota fiscal

Cliente¶

Consulta dados do cliente

0	Campo	Tipo	Precisão	Descrição
1	cnpj *	String	255	CNPJ ou CPF do cliente (somente números)
2	nomeFantasia	String	255	Nome fantasia do cliente
3	email	String	255	Endereço de e-mail padrão do cliente
4	cep	String	255	CEP do cliente (somente números)
5	endereco	String	255	Endereço do cliente sem o número. Caso o número estiver gravado no mesmo cliente, contate a GEOvendas para discutir uma solução.
6	enderecoNumero	String	255	Número do endereço do cliente do cliente
7	complemento	String	255	Complemento do endereço do cliente do cliente
8	bairro	String	255	Bairro do cliente
9	codIBGE	String	255	Código IBGE da cidade do cliente
10	telefone	String	255	Telefone do cliente
11	codRepres1	String	255	Código do Representante Principal no ERP
12	codRepres2	String	255	Código do Representante 2 no ERP
13	codRepres3	String	255	Código do Representante 3 no ERP
14	codCliente	String	255	Código do cliente no ERP
15	flagAtivoParaLoja	Integer		Falg para Ativo na Loja
16	flagIsRepresentanteB2B	Integer		Flag para saber se é um representante 1-Cliente 2-Representante
17	razaoSocial	String	200	Razão Social do Cliente
18	emailRepres	String	255	Email do representante para disparo de e-mail, ao cliente logar na loja
19	inscricaoEstadual	String	255	Inscrição Estadual
20	siglaUF	String	255	Sigla do Estado da Cidade do Cliente
21	nomeUF	String	255	Nome do Estado da Cidade do Cliente
22	populacao	Integer		População da Cidade do Cliente
23	ipc	Double		IPC da Cidade do Cliente
24	codGrupoCli	String		Código do Grupo do Cliente
25	nomeGrupoCli	String		Nome do Grupo do Cliente
26	salarioBase	Double		Salário base do funcionário (quando cliente for um funcionário - Haskell)
27	limiteCredito	Double		Limite de crédito do cliente, já descontado os pedidos que estão em aberto
28	codCondPagto	String		Código da condição de pagamento do cliente
29	codTransportadora	String		Código da Transportadora do cliente
30	descontoPadrao	Double		Desconto Padrão do Cliente
31	pais	String		Código do País
32	inadimplente	Integer		0 = Não Inadimplente, 1 = Inadimplente
33	cliente_novo_crm	Integer		0 = Cliente da Base, 1 = Cliente Novo
34	fax	String		Fax do Cliente
35	celular	String		Celular do Cliente
36	emailNfe	String		Email referente as notas fiscais
37	telefoneCompras	String		Telefone do setor de compras
38	telefoneCobranca	String		Telefone do setor de cobranças
39	facebook	String		Facebook do cliente
40	instagram	String		Instagram do Cliente
41	dataFundacao	Date		Data de Fundação
42	marcasLiberadas	Date		Código das Marcas liberadas para compra do cliente (separado por virgula)
43	tipoFaturamento	String		Código do tipo de faturamento (Normal ou SKU)
44	regime_st	String		Responsável por gravar o regime tributário do cliente (Simples, SST…)
45	depositos_cliente	String		Definição dos depósitos do cliente (para quebra de pedido e exibição/validação de estoque)
46	percAcrescimo	Double		Percentual de acréscimo do Cliente (Royaltie) (EM DESENVOLVIMENTO)
47	dataFaturamento	Date		Data de faturamento do cliente
48	dataLimiteCompra	Date		Data de limite para o cliente poder digitar pedidos
49	codigosAgrupadosRep	String		Codigos dos reps agrupados, usado em caso de multiplos códigos de REP pra um CNPJ

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/Integer	255	CNPJ ou CPF do Cliente

Clientes - Crédito troca em garantia¶

Retornar saldos e notas disponíveis para que o cliente use na troca e garantia.

Campo	Tipo	Precisão	Descrição
filial *	String	100	Código/nome da filial
notaFiscal *	String	100	Número da nota fiscal
codCliente *	String	100	Código do cliente
cnpjCliente *	String	20	CNPJ do cliente
codGrupoCliente *	String	20	Código do Grupo do cliente
nomeCliente *	String	300	Nome do cliente
valor *	Double	10,2	Valor do credito disponível

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP
notaFiscal	:p2	String	100	Número da nota fiscal

Clientes - Representantes¶

Consulta dados para trazer os clientes dos representantes que vendem pelo B2B

0	Campo	Tipo	Precisão	Descrição
1	cnpj *	String	255	CNPJ ou CPF do cliente (somente números)
2	nomeFantasia	String	255	Nome fantasia do cliente
3	email	String	255	Endereço de e-mail padrão do cliente
4	cep	String	255	CEP do cliente (somente números)
5	endereco	String	255	Endereço do cliente sem o número. Caso o número estiver gravado no mesmo cliente, contate a GEOvendas para discutir uma solução.
6	enderecoNumero	String	255	Número do endereço do cliente do cliente
7	complemento	String	255	Complemento do endereço do cliente do cliente
8	bairro	String	255	Bairro do cliente
9	codIBGE	String	255	Código IBGE da cidade do cliente
10	telefone	String	255	Telefone do cliente
11	codRepres1	String	255	Código do Representante Principal no ERP
12	codRepres2	String	255	Código do Representante 2 no ERP
13	codRepres3	String	255	Código do Representante 3 no ERP
14	codCliente	String	255	Código do cliente no ERP
15	flagAtivoParaLoja	Integer		Falg para Ativo na Loja
16	flagIsRepresentanteB2B	Integer		Flag para saber se é um representante 1-Cliente 2-Representante
17	razaoSocial	String	200	Razão Social do Cliente
18	emailRepres	String	255	Email do representante para disparo de e-mail, ao cliente logar na loja
19	inscricaoEstadual	String	255	Inscrição Estadual
20	siglaUF	String	255	Sigla do Estado da Cidade do Cliente
21	nomeUF	String	255	Nome do Estado da Cidade do Cliente
22	populacao	Integer		População da Cidade do Cliente
23	ipc	Double		IPC da Cidade do Cliente
24	codGrupoCli	String		Código do Grupo do Cliente
25	nomeGrupoCli	String		Nome do Grupo do Cliente
26	salarioBase	Double		Salário base do funcionário (quando cliente for um funcionário - Haskell)
27	limiteCredito	Double		Limite de crédito do cliente, já descontado os pedidos que estão em aberto
28	codCondPagto	String		Código da condição de pagamento do cliente
29	codTransportadora	String		Código da Transportadora do cliente
30	descontoPadrao	Double		Desconto Padrão do Cliente
31	pais	String		Código do País
32	inadimplente	Integer		0 = Não Inadimplente, 1 = Inadimplente
33	cliente_novo_crm	Integer		0 = Cliente da Base, 1 = Cliente Novo
34	fax	String		Fax do Cliente
35	celular	String		Celular do Cliente
36	emailNfe	String		Email referente as notas fiscais
37	telefoneCompras	String		Telefone do setor de compras
38	telefoneCobranca	String		Telefone do setor de cobranças
39	facebook	String		Facebook do cliente
40	instagram	String		Instagram do Cliente
41	dataFundacao	Date		Data de Fundação
42	marcasLiberadas	Date		Código das Marcas liberadas para compra do cliente (separado por virgula)
43	tipoFaturamento	String		Código do tipo de faturamento (Normal ou SKU)
44	regime_st	String		Responsável por gravar o regime tributário do cliente (Simples, SST…)
45	depositos_cliente	String		Definição dos depósitos do cliente (para quebra de pedido e exibição/validação de estoque)
46	percAcrescimo	Double		Percentual de acréscimo do Cliente (Royaltie) (EM DESENVOLVIMENTO)
47	dataFaturamento	Date		Data de faturamento do cliente
48	dataLimiteCompra	Date		Data de limite para o cliente poder digitar pedidos
49	codigosAgrupadosRep	String		Codigos dos reps agrupados, usado em caso de multiplos códigos de REP pra um CNPJ

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

Licenciados - Fornecedor¶

Consulta dados dos fornecedor para disponibilizar no b2b

0	Campo	Tipo	Precisão	Descrição
1	cnpj *	String	255	CNPJ ou CPF do fornecedor (somente números)
2	nomeFantasia	String	255	Nome fantasia do fornecedor
3	email	String	255	Endereço de e-mail padrão do fornecedor
4	cep	String	255	CEP do fornecedor (somente números)
5	endereco	String	255	Endereço do fornecedor sem o número. Caso o número estiver gravado no mesmo fornecedor, contate a GEOvendas para discutir uma solução.
6	enderecoNumero	String	255	Número do endereço do fornecedor
7	complemento	String	255	Complemento do endereço do fornecedor
8	bairro	String	255	Bairro do fornecedor
9	codIBGE	String	255	Código IBGE da cidade do fornecedor
10	telefone	String	255	Telefone do fornecedor
11	codRepres1	String	255	Código do Representante Principal no ERP
12	codRepres2	String	255	Código do Representante 2 no ERP
13	codRepres3	String	255	Código do Representante 3 no ERP
14	codFornecedor	String	255	Código do fornecedor no ERP
15	flagAtivoParaLoja	Integer		Falg para Ativo na Loja
16	flagIsRepresentanteB2B	Integer		Flag para saber se é um representante, vira como 4 para fornecedor
17	razaoSocial	String	200	Razão Social do fornecedor
18	emailRepres	String	255	Email do representante para disparo de e-mail, ao fornecedor logar na loja
19	inscricaoEstadual	String	255	Inscrição Estadual
20	siglaUF	String	255	Sigla do Estado da Cidade do fornecedor
21	nomeUF	String	255	Nome do Estado da Cidade do fornecedor
22	populacao	Integer		População da Cidade do fornecedor
23	ipc	Double		IPC da Cidade do fornecedor
24	codGrupoCli	String		Código do Grupo do fornecedor
25	nomeGrupoCli	String		Nome do Grupo do fornecedor
26	salarioBase	Double		Salário base do funcionário (quando fornecedor for um funcionário - Haskell)
27	limiteCredito	Double		Limite de crédito do fornecedor, já descontado os pedidos que estão em aberto
28	codCondPagto	String		Código da condição de pagamento do fornecedor
29	codTransportadora	String		Código da Transportadora do fornecedor
30	descontoPadrao	Double		Desconto Padrão do fornecedor
31	pais	String		Código do País
32	inadimplente	Integer		0 = Não Inadimplente, 1 = Inadimplente
33	fornecedor_novo_crm	Integer		0 = fornecedor da Base, 1 = fornecedor Novo
34	fax	String		Fax do fornecedor
35	celular	String		Celular do fornecedor
36	emailNfe	String		Email referente as notas fiscais
37	telefoneCompras	String		Telefone do setor de compras
38	telefoneCobranca	String		Telefone do setor de cobranças
39	facebook	String		Facebook do fornecedor
40	instagram	String		Instagram do fornecedor
41	dataFundacao	Date		Data de Fundação
42	marcasLiberadas	Date		Código das Marcas liberadas para compra do fornecedor (separado por virgula)
43	tipoFaturamento	String		Código do tipo de faturamento (Normal ou SKU)
44	regime_st	String		Responsável por gravar o regime tributário do fornecedor (Simples, SST…)
45	depositos_fornecedor	String		Definição dos depósitos do fornecedor (para quebra de pedido e exibição/validação de estoque)
46	percAcrescimo	Double		Percentual de acréscimo do fornecedor (Royaltie)

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/Integer	255	CNPJ ou CPF do fornecedor

Representantes - Clientes¶

Consulta dados para login de venda como representante no B2B

0	Campo	Tipo	Precisão	Descrição
1	cnpj *	String	255	CNPJ ou CPF do cliente (somente números)
2	nomeFantasia	String	255	Nome fantasia do cliente
3	email	String	255	Endereço de e-mail padrão do cliente
4	cep	String	255	CEP do cliente (somente números)
5	endereco	String	255	Endereço do cliente sem o número. Caso o número estiver gravado no mesmo cliente, contate a GEOvendas para discutir uma solução.
6	enderecoNumero	String	255	Número do endereço do cliente do cliente
7	complemento	String	255	Complemento do endereço do cliente do cliente
8	bairro	String	255	Bairro do cliente
9	codIBGE	String	255	Código IBGE da cidade do cliente
10	telefone	String	255	Telefone do cliente
11	codRepres1	String	255	Código do Representante Principal no ERP
12	codRepres2	String	255	Código do Representante 2 no ERP
13	codRepres3	String	255	Código do Representante 3 no ERP
14	codRepresentanteCliente	String	255	Código do Representante no ERP (Vai aparecer no campo do codigo de cliente na manutenção de clientes)
15	flagAtivoParaLoja	Integer		Falg para Ativo na Loja
16	flagIsRepresentanteB2B	Integer		Flag para saber se é um representante 1-Cliente 2-Representante
17	razaoSocial	String	200	Razão Social do Cliente
18	emailRepres	String	255	Email do representante para disparo de e-mail, ao cliente logar na loja
19	inscricaoEstadual	String	255	Inscrição Estadual
20	siglaUF	String	255	Sigla do Estado da Cidade do Cliente
21	nomeUF	String	255	Nome do Estado da Cidade do Cliente
22	populacao	Integer		População da Cidade do Cliente
23	ipc	Double		IPC da Cidade do Cliente
24	codGrupoCli	String		Código do Grupo do Cliente
25	nomeGrupoCli	String		Nome do Grupo do Cliente
26	salarioBase	Double		Salário base do funcionário (quando cliente for um funcionário - Haskell)
27	limiteCredito	Double		Limite de crédito do cliente, já descontado os pedidos que estão em aberto
28	codCondPagto	String		Código da condição de pagamento do cliente
29	codTransportadora	String		Código da Transportadora do cliente
30	descontoPadrao	Double		Desconto Padrão do Cliente
31	pais	String		Código do País
32	inadimplente	Integer		0 = Não Inadimplente, 1 = Inadimplente
33	cliente_novo_crm	Integer		0 = Cliente da Base, 1 = Cliente Novo
34	fax	String		Fax do Cliente
35	celular	String		Celular do Cliente
36	emailNfe	String		Email referente as notas fiscais
37	telefoneCompras	String		Telefone do setor de compras
38	telefoneCobranca	String		Telefone do setor de cobranças
39	facebook	String		Facebook do cliente
40	instagram	String		Instagram do Cliente
41	dataFundacao	Date		Data de Fundação
42	marcasLiberadas	Date		Código das Marcas liberadas para compra do cliente (separado por virgula)
43	tipoFaturamento	String		Código do tipo de faturamento (Normal ou SKU)
44	regime_st	String		Responsável por gravar o regime tributário do cliente (Simples, SST…)
45	depositos_cliente	String		Definição dos depósitos do cliente (para quebra de pedido e exibição/validação de estoque)
46	percAcrescimo	Double		Percentual de acréscimo do Cliente (Royaltie) (EM DESENVOLVIMENTO)
47	dataFaturamento	Date		Data de faturamento do cliente
48	dataLimiteCompra	Date		Data de limite para o cliente poder digitar pedidos
49	RepresAprovaPedido	String		separado por , os codigos dos representantes que aprovam pedidos relacionados ao rep do login

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
cnpjrepres	:p2	String/Integer	255	cnpj do Representante

Comissão por Repres/Cliente/Marca¶

integracao para permitir a quebra do pedido por marca e representante

Campo	Tipo	Precisão	Descrição
CodRepresentante	String	255	Código do Representante no ERP
codigoCliente	String	255	Código do Cliente no ERP
codMarca	String	255	Código Marca
PercComissao	String	255	Percentual de Comissão

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	String	255	Condição de Parcelamento EX:30/60/90
clientes	String		CNPJ dos clientes separados por vírgula

Representantes¶

Esta tabela/visão será utilizada para carregar no IGS a lista de representantes. (GEOREPRESENTANTE - NÃO É O SQL DE LOGIN DE REPRESENTANTE DO B2B)

Campo	Tipo	Precisão	Descrição
codEmpresa *	String/Integer	10	Código da Empresa origem dos dados
codRepres *	String/Integer	255	Código do Representante no ERP
nome	String	255	Nome do Representante
telefone	String	255	Telefone de Contato
email	String	255	E-Mail
endereco	String	255	Rua + Número do endereço do Representante
bairro	String	255	Bairro do Endereço do Representante
CEP	String	8	CEP do endereço do Representante
Cidade	String	255	Nome da Cidade do Endereço do Representante
UF	String	2	Sigla da UF da Cidade
codIBGE	String	7	Código do IBGE da Cidade
situacao	Integer		Situação do cadastro do representante: 0 - Inativo, 1 - Ativo
Cod Repres Agrupador	String	255	Campo Específico. Retornar null , salvo alguma orientação diferente da GEOvendas
telefone 2	String	255	Telefone de Contato 2
telefone 3	String	255	Telefone de Contato 3
codigoAdministrador	String	255	Código do administrador do representante no erp
cnpj	String	255	CNPJ do representante
codAgrupadorEscritorio	String	255	Campo Específico. Retornar null , salvo alguma orientação diferente da GEOvendas
flagAgrupadorMaster	Integer		0 - Não, 1 - Sim (Somente um por grupo) / Campo Específico. Retornar null , salvo alguma orientação diferente da GEOvendas
percComissa	Double		Percentual de comissão
codigoPessoaFisica	String	255	Código que representa o cadastro da pessoa física do representante
nomePessoaFisica	String	255	Nome da pessoa física

Bloqueio de Referências¶

Estes dados serão utilizada para bloquear as referências no B2B a nível de SKU. Esta integração não alterará bloqueios feitos manualmente.

Campo	Tipo	Precisão	Descrição
codigo *	String	50	Código da Referência
tamanho *	String	50	Código do Tamanho
cor *	String	50	Código da Cor
flagBloqueio	Integer	1	Flag de Bloqueio 0 - Bloqueado, 1 - Liberado
flagBloqueioProntaEntrega	Integer	1	Flag de Bloqueio 0 - Bloqueado, 1 - Liberado
flagBloqueioProgramado	Integer	1	Flag de Bloqueio 0 - Bloqueado, 1 - Liberado

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codColecoes	#COLECOES	String		Coleções separadas por virgula. Usar com in (#COLECOES). Não existe no momento os IS NULL dessa condição.
codTabPrecos	#TABPRECOS or #TABPRECOSNULL	String		Tabelas de preços separadas por virgula

Boletos - Consulta Cliente¶

Estes dados serão utilizados realizar o vínculo entre os usuários B2B, para visualização de boletos para grupos comerciais.

Campo	Tipo	Precisão	Descrição
codCliente *	String	255	Código do cliente
nome *	String	255	Nome do cliente
cnpj *	String	11	CNPJ do cliente SEM FORMATACAO
email *	String	255	E-Mail 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
cnpj	:p2	String	11	CNPJ do cliente a buscar

Boletos - Listagem¶

Estes dados serão utilizados na listagem dos títulos, que poderão ser emitidos uma segunda via.

Campo	Tipo	Precisão	Descrição
titulo *	String	255	Código do Titulo
codCliente *	String	255	Código do cliente
cnpj *	String	255	CNPJ do Pagador
nome *	String	255	Nome do Pagador
cidade *	String	255	Cidade do pagador
codPortador *	String	255	Código do portador
nomePortador *	String	255	Nome do portador
notaFiscal *	String	255	Numero da nota fiscal
dataEmissao *	String	255	Data de emissão
dataVecto *	String	255	Data de vencimento
valor *	String	255	Valor do documento
tituloDisplay	String	255	Código do Titulo para Exibição (Na tabela e no boleto)
chaveNFE	String	255	Chave da NFE para emissão via API
codEmpresa	String	255	Código empresa
exercicio	String	255	Excercício
parcela	String	255	Parcela
valorAbatimento	Double	2	Valor abatimento
observacaoAbatimento	String	255	Observação do abatimento
bloqueado	int	1	Flag para sinalizar se o título está bloqueado para emissão

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP
emissaoDe	:p2	Date		Data de emissão Inicial
emissaoAte	:p3	Date		Data de emissão Final
vectoDe	:p4	Date		Data de vencimento Inicial
vectoAte	:p5	Date		Data de vencimento Final
cnpjs	#CNPJS or #CNPJSNULL	String		CNPJ's para consulta (separados por virgula)
codClientes	#CLIENTES or #CLIENTESNULL	String		Código dos clientes para consulta (separados por virgula)
codRepres	#REPRES or #REPRESNULL	String		Código dos representantes para consulta (separados por virgula)

Boletos Pagos - Listagem (somente via API com ELT)¶

Estes dados serão utilizados somente se a integração for via API para remover os títulos já pagos do lado da GEOVENDAS, eles não serão listados mais para pagamento.
Esse endpoint deve conter um filtro para passar de "pagametoDe" e de "pagamentoAté" para filtrar no endpoint.

Campo	Tipo	Precisão	Descrição
codEmpresa	String	10	Código da empresa no ERP
titulo *	String	255	Código do Titulo
codCliente *	String	255	Código do cliente
cnpj *	String	255	CNPJ do Pagador
dataPagamento *	Date	-	Data de pagamento

Boletos - Detalhado¶

Estes dados serão utilizados na geração do boleto de cobrança

-	Campo	Tipo	Precisão	Descrição
1	banco *	String	255	Código do banco
2	codCliente *	String	255	Código do cliente
3	cnpjBenef *	String	255	CNPJ do Beneficiário
4	nomeBenef *	String	255	Nome do Beneficiário
5	agenciaBenef *	String	255	Agencia do Beneficiário
6	agDigitoBenef *	String	255	Digito da agencia do Beneficiário
7	carteiraBenef *	String	255	Carteira do Beneficiário
8	contaBenef *	String	255	Conta do Beneficiário
9	digitoContaBenef *	String	255	Digito da conta do Beneficiário
10	nossoNumero *	String	255	Nosso número boleto
11	digNossoNumero *	String	255	Digito nosso número boleto
12	cepBenef *	String	255	CEP do Beneficiário
13	logradouroBenef *	String	255	Logradouro Beneficiário
14	bairroBenef *	String	255	Bairro Beneficiário
15	cidadeBenef *	String	255	Cidade Beneficiário
16	ufBenef *	String	255	UF Beneficiário
17	cnpjPagador *	String	255	CNPJ Pagador
18	nomePagador *	String	255	Nome Pagador
19	cepPagador *	String	255	CEP do Pagador
20	logradouroPagador *	String	255	Logradouro Pagador
21	bairroPagador *	String	255	Bairro Pagador
22	cidadePagador *	String	255	Cidade Pagador
23	ufPagador *	String	255	UF Pagador
24	valorBoleto *	Double	2	Valor do Boleto
25	valorMulta *	Double	2	Valor da Multa
26	valorAcrescimos *	Double	2	Valor de acréscimos
27	descontos *	Double	2	Valor de descontos
28	deducoes *	Double	2	Valor de deduções
29	especieDoc *	String	255	Espécie do Documento
30	numDoc *	String	255	Número do Documento
31	dataEmissao *	String	255	Data de emissão
32	dataProcessamento *	String	255	Data de processamento do Documento
33	dataVencimento *	String	255	Data de vencimento
34	dataVencimentoOrig *	String	255	Data vencimento original
35	Instrucao1*	String	255	descrição da Instrução titulo
36	Instrucao2*	String	255	descrição da Instrução titulo
37	Instrucao3*	String	255	descrição da Instrução titulo
38	Instrucao4*	String	255	descrição da Instrução titulo
39	Instrucao5*	String	255	descrição da Instrução titulo
40	flag_escritural*	String	255	se o titulo é ou não de cobrança escritural
41	MenssagemErro	String	255	Mensagem Retorno caso titulo esteja faltando campos
42	Convenio	String	255	Numero do convenio
43	NumeroPosto	String	255	Numero do Posto Bancário
44	numParcela	String	255	Numero da parcela do boleto (tratado Sicoob)
45	linhaDigitavel	String	255	Linha digitável pronta, para ser utilizada quando não podemos gerar com os dados fornecidos
46	emailCliente	String	255	Email 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
numDoc	:p2	String	255	Número do Documento

DANFE - Listagem¶

Estes dados serão utilizados na listagem das notas fiscais no portal B2B.

Campo	Tipo	Precisão	Descrição
cnpj *	String	255	CNPJ do cliente
codCliente *	String	255	Código do cliente
nomeCliente *	String	255	Nome do cliente
cidade *	String	255	Cidade do cliente
notaFiscal *	String	255	Número da nota fiscal
chaveNFE *	String	255	Chave da Nota fiscal
dataEmissao *	Date ODBC	255	Data de emissão da nota fiscal
valor *	Double	2	Valor total da nota fiscal
ocorrencias	String		JSON das ocorrências da nota fiscal. Campo especifico, mandar null salvo orientação
codEmpresa	String	255	Código da empresa

Listagem de parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP
emissaoDe	:p2	Date		Data de emissão da nota Inicial
emissaoAte	:p3	Date		Data de emissão da nota Final
cnpjs	#CNPJS or #CNPJSNULL	String		CNPJ's para consulta (separados por virgula)
codClientes	#CLIENTES or #CLIENTESNULL	String		Código dos clientes para consulta (separados por virgula)
codRepres	#REPRES or #REPRESNULL	String		Código dos representantes para consulta (separados por virgula)

DANFE - Itens da Nota¶

Estes dados serão utilizados para baixar as imagens dos itens da nota fiscal.

Campo	Tipo	Precisão	Descrição
codRef *	String	255	Código da referência

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP
notaFiscal	:p2	String	255	Código da nota fiscal

DANFE - XML¶

Estes dados serão utilizados para gerar a visualização em PDF das notas fiscais.

Campo	Tipo	Precisão	Descrição
codCliente *	String	255	Código do cliente
notaFiscal *	String	255	Código da Nota Fiscal
xml *	String		XML da nota fiscal completo (NÃO PODE SER O CAMINHO DO FILESERVER)

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP
notaFiscal	:p2	String	255	Código da nota fiscal

Lote de Faturamento¶

Retorna a integração do ERP de Lotes de Faturamento.

• Lembrando que fará somente a carga de novos registros, pois os antigos não serão mexidos.

Campo	Tipo	Precisão	Descrição
dataReferencia *	Date		Data de referência (limite)
dataFaturamento *	Date		Data do faturamento
descricao *	String	255	Descrição
codTabPreco *	String	30	Código da tabela de preço, se for geral enviar uma string '-1'
codLoteErp	String	50	Código do lote de faturamento no ERP

Produto SKU - Cód. Barras¶

Retorna a integração do ERP dos códigos de barras de todos os SKUs.

Campo	Tipo	Precisão	Descrição
codReferencia *	String		Código da referência
codSortimento *	String		Código do sortimento
codTamanho *	String		Código do tamanho
colecao *	String		Código da coleção
codEan *	String		Código de barras

Frete¶

Retorna a integração do ERP das faixas de frete.

Campo	Tipo	Precisão	Descrição
código *	Long		Código da faixa de frete (ID Registro)
codTabelasPreco	String		Códigos das tabelas de preço, separados por vírgula, ou null para todas
codPaises	String		Códigos dos países, separados por vírgula, ou null para todos. Aqui vale lembrar que quando informado o país o estado e cidade devem ser null
estados	String		Sigla dos estados, separados por vírgula, ou null para todos.
cidades	String		Códigos dos IBGE das cidades, separados por vírgula, ou null para todas
vlrInicialCompra *	Double		Valor inicial para a faixa de compra
vlrFinalCompra *	Double		Valor Final para a faixa de compra
vlrFreteCompra *	Double		Valor do frete para a faixa de compra
prazoEntregaCompra *	Integer		Prazo, em dias, para a entrega para esta faixa de compra
vlrInicialRecompra *	Double		Valor inicial para a faixa de recompra
vlrFinalRecompra *	Double		Valor Final para a faixa de recompra
vlrFreteRecompra *	Double		Valor do frete para a faixa de recompra
prazoEntregaRecompra *	Integer		Prazo, em dias, para a entrega para esta faixa de recompra

Espelho Nota de Devolução¶

Retorna os itens referente a entrada data para a nota de devolução

Campo	Tipo	Precisão	Descrição
referencia *	String		Código da referência (deve ser a mesma referência da combo ao selecionar o item para devolução)
nome *	String		Nome/descrição da referência
tamanho *	String		Código do tamanho
quantidade *	String		Quantidade de itens da nota original da referência em questão
tipoUnidade *	String		Tipo de unidade. Ex: cx, pç
valorLiquidoUnidade *	String		Valor líquida da unidade
baseCalcIcmsUnidade *	String		Base de calc icms da unidade
aliqIcms *	String		Alíquota icms
aliqIpi *	String		Alíquota IPI
icmsValorUnidade *	String		Valor referente ao ICMS da unidade
ipiValorUnidade *	String		Valor referente ao IPI da unidade
CST ou O/CST *	String		CST ou O/CST
NCM *	String		NCM
nota *	String		Número nota fiscal
dataEmissao *	Date		Data referente a nota fiscal de origem
chaveNfe *	String		Chave da NFE
transportadoraCnpj *	String		CNPJ da transportadora
transportadoraRazaoSocial *	String		Razão social da transportadora
transportadoraUf *	String		UF da transportadora
transportadoraEndereco *	String		Endereço da transportadora
transportadoraNumeroEndereco *	String		Número endereço da transportadora
transportadoraCidade *	String		Cidade da transportadora
transportadoraIE *	String		Inscrição Estadual da transportadora
cor	String		Código da cor
nomeCor	String		Nome da Cor
nomeTamanho	String		Nome do Tamanho

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:codEmpresa	String/Integer	10	Código da empresa no ERP
itensDevolucao	#itensDevolucao	String	Array<String>	Array com o Código do produto
numerosNotas	#numerosNotas	String	Array<String>	Array com o número das notas

Nota de Devolução Integral¶

Retorna os itens referente a nota para a inclusão integral.

Campo	Tipo	Precisão	Descrição
nota *	String		Número da Nota (deve ser montado igualmente a KEY do EditDisplay para selecionar a nota para devolução)
descricaoNota *	String		Descrição da Nota (deve ser montado igualmente ao LABEL do EditDisplay para selecionar a nota para devolução)
referencia *	String		Código da referência (deve ser a mesma KEY da combo ao selecionar o item para devolução)
descricaoReferencia *	String		Nome/descrição da referência (deve ser a mesma KEY da combo ao selecionar o item para devolução)
tamanho *	String		Código do tamanho (deve ser a mesma KEY da combo ao selecionar o Tamanho para devolução)
descricaoTamanho *	String		Descrição do Tamanho (deve ser a mesma KEY da combo ao selecionar o Tamanho para devolução)
quantidade *	String		Quantidade de itens da nota original da referência em questão
descricaoQuantidade *	String		Descrição da quantidade de itens da nota original da referência em questão
cor	String		Código da cor
nomeCor	String		Nome da Cor

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codEmpresa	:p1	String/Integer	10	Código da empresa no ERP
nota *	:p2	String		Número da nota para a inclusao integral

Produto Volume Valor por Referência¶

Retorna a integração do ERP dos códigos de referências, faixa de quantidade versos o valor de cada faixa.

Campo	Tipo	Precisão	Descrição
codReferencia *	String		Código da referência
qtdeMaxima *	Integer		Quantidade da faixa
valor *	Double	2	Valor da faixa
cor**	String		Código da cor
codTabPreco	String		Código da tabela de preço
agrupador	String		Agrupador para referências que compartilham as quantidades informadas
tamanho	String		Código do tamanho

Lista de Parâmetros:

Parâmetro	Tipo	Descrição
#REFERS	IN	Recebe uma lista dos códigos dos produtos para integração (Pode ser null para todos)
#REFERSNULL	-	Parâmetro para trazer todos registros ((campo in (#REFERS)) OR (#REFERSNULL IS NULL))
#TABPRECOS	IN	Recebe uma lista dos códigos das tabelas de preços ativas para o B2B (Pode ser null para todos)
#TABPRECOSNULL	-	Parâmetro para trazer todos registros ((campo in (#TABPRECOS)) OR (#TABPRECOSNULL IS NULL))

.* Campos obrigatórios
.** Campo obrigatório, quando não informado o campo Agrupador

Substituição Tributária¶

Retorna a integração dos dados referente ao cadastro de substituição tributária.

Campo	Tipo	Precisão	Descrição
grupo_produto *	String		Responsável por gravar o grupo ST pertencente ao produto
regime *	String		Responsável por gravar o regime tributário (Simples, SST…)
uf *	Double	2	Grava a sigla do estado pertencente
percentual_st *	Double	2	Grava o percentual de acréscimo no calculo

Pedido - Recompra¶

Recompra de pedidos do cliente.
OBS. Este SQL deve retornar sempre só uma linha.

Campo	Tipo	Precisão	Descrição
codEmpresa *	String/Integer		Código da empresa
codCliente *	String		Código do cliente
codPedido *	String		Código do pedido
dataEmissao *	Date		Data de emissão do pedido
codSituacao *	Integer		Código da situação do pedido
valorBruto *	Double		Valor bruto do pedido
valorLiquido *	Double		Valor liquido do pedido
valorSaldo *	Double		Valor do saldo do pedido
quantidade *	Double		Quantidade do pedido
valorMinimo	Double		Valor Minimo do pedido
qtdMinima	Integer		Quantidade Minima do pedido

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
Data Inicial	:p1	Date	10	Data inicial do parâmetro na tabela de preço
Data Final	:p2	Date		Data final do parâmetro na tabela de preço
CNPJ do Cliente	:p3	String		CNPJ do Cliente
Tabela de preço	:p4	String		Tabela de Preço
Valor Bruto	:p5	String		Valor Bruto Mínimo do Pedido
Quantidade Minima	:p6	String		Quantidade Mínima do Pedido
Tabelas de preço	#TABPRECOS	String		Tabelas de Preço observadas, caso cliente trabalhe com mais de uma

Compra Acumulada - Valores Base Cálculo¶

Estes dados serão utilizados para calcular um desconto extra no pedido caso o cliente alcance o valor de compra da coleção.

Campo	Tipo	Precisão	Descrição
codColecao *	String	255	Código da coleção
valor *	Double		Soma dos itens comprados da coleção

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codColecoes	#colecoes	String		Código das coleções que se deseja obter os valores
codClienteErp	:p2	String		Código do cliente no ERP ()

Partidas de Pedidos¶

Nessa consulta será possível consultar as partidas dos pedidos efetuados.

Campo	Tipo	Precisão	Descrição
anoPartida	String		Retorna a informação de mês e ano da partida no formato AAAAMM
codPartida	String		Código da partida no ERP
situacao	Integer		código da situação atual da partida
codPedido	String		Código do pedido no ERP ao qual a partida pertence
sequenciaItem	Integer		Sequência da partida na produção de acordo com o pedido
dataEmissao	Date		Data de início da produção da partida no formato AAAA-MM-DD
dataPrevisaoFaturamento	Date		Data de previsão de faturamento da partida no formato AAAA-MM-DD
variacaoProduto	String		Código de variação do produto
codReferencia	String		Código da referência no ERP
codVariante	String
corTingimento	String		Código da cor da tonalidade do tingimento
nome	String		Nome da malha? (Verificar junto ao cliente)
codigoEngenharia	String		Código do produto na engenharia
qtdeQuilos	Double	(10, 2)	Quantidade em kg da partida
qtdePecas	Integer		Quantidade de rolos da partida
rendimento	Double	(10, 2)	Rendimento do tecido
nomeProcessoAtual	String		Nome do processo atual que a partida se encontra
nomeProcessoSeguinte	String		Nome da próxima etapa do fluxo de partidas
peso	Double	(10, 2)	Peso da partida
pesoPadrao	Double	(10, 2)	Peso padrão da partida
gramatura	Double	(10, 2)	Gramatura do tecido da partida
largura	Double	(10, 2)	Largura do tecido da partida
qtdeRolos	Double	(10, 2)	Quantidade de rolos da partida
qtdeMetros	Double	(10, 2)	Quantidade de metros da partida
dataFechamento	Date		Data do fechamento da produção da partida no formato AAAA-MM-DD
horaFechamento	String		Hora do fechamento da produção da partida no formato HH:mm:ss
valor	Double	(10, 2)	Valor total da partida
dataBaixa	Date		Data da baixa final da partida no formato AAAA-MM-DD
loteCliente	String		Lote do cliente
descProduto	String		Descrição do produto

Parâmetros da Consulta

Campo	_. Tipo	_. Parâmetro	_.Precisão / Tamanho / Formato	_. Descrição	_. Obrigatório
codEmpresa	String	:p1		Código da empresa dentro do ERP	Sim
codCliente	String	:p2		Código do cadastro do cliente no ERP	Sim
dataEmissaoInicial	Date	:p3	AAAA-MM-DD	Data inicial para consulta com base na data de emissão	Sim
dataEmissaoFinal	Date	:p4	AAAA-MM-DD	Data final para consulta com base na data de emissão	Sim
codPedido	String	:p5		Código do pedido no ERP (pode ser parcial)	Não
codPartida	String	:p6		Código da partida no ERP (pode ser parcial)	Não
codReferPai	String	:p7		Código da referência no ERP	Não
cor	String	:p8		Código da cor no ERP	Não
qtde	Double	:p9	(10, 2)	Peso da partida no ERP	Não
qtdePecas	Integer	:p10		Quantidade de peças da partida	Não
larguraAcab	Double	:p11	(10, 2)	Largura da partida	Não
gramaturaAcab	Double	:p12	(10, 2)	Gramatura da partida	Não
valorTotalLiquido	Double	:p13	(10, 2)	Valor total líquido da partida	Não
dataPrevFat	Date	:p14	AAAA-MM-DD	Data de previsão de faturamento da partida	Não

Tabela de Preço¶

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

Campo	Tipo	Precisão	Descrição
codEmpresa *	String		Código da empresa (OBRIGATÓRIO)
codTabPreco *	String		Código da tabela de preço (OBRIGATÓRIO)
nomeTabela *	String		Descrição/Nome da tabela de preço (OBRIGATÓRIO)
codOperacaoERP	String		(dados para integração)
codTabPrecoERP	String		(dados para integração)
codContaERP	String		(dados para integração)
codTipoPedidoERP	String		(dados para integração)
codEmpresaERP *	String		(dados para integração)
codTipoNotaERP	String		(dados para integração)
codDepositoERP	String		(dados para integração)
codColecaoERP	String		(dados para integração)
codMoedaERP	String		(dados para integração)
codLoteERP	String		(dados para integração)
codMarcaERP	String		(dados para integração)
situacaoPedidoVA	String		(dados para integração)
qtdeEmbarque	Integer		(dados para integração)
cnpjPacote	String		(dados para integração)
nrPrioridade	String		(dados para integração)
inFatura	String		(dados para integração)
periodoProdERP	String		(dados para integração)
codStatusERP	String		(dados para integração)
codFilialERP	String		(dados para integração)
dataEntregaInicialERP	Date		(dados para integração)
dataEntregaFinalERP	Date		(dados para integração)
codMoeda	String		(dados para integração)
codCampanhaERP	String		(dados para integração)
codColecaoClassificacaoERP	String		(dados para integração)
codTipoVendaERP	Integer		(dados para integração)
codBloqueioERP	String		(dados para integração)
codFinanceiroERP	String		(dados para integração)

Lista de Parâmetros:

Campo	Parâmetro	Tipo	Precisão	Descrição
codTabelaERP	:p2	String/Integer	255	Código da tabela de preços no ERP