Loja Integrada

• Pré-requisitos de hardware
• Pré-requisitos de implantação
• Instalando o servidor
• Configurando a integração pela primeira vez
• O que integra
• Vinculando cadastros para lojas que já possuem informações cadastradas
• Colocando todos os cadastro na Fila de Envio
• Configurando o envio no agendador de tarefas do Windows

Pré-requisitos de hardware

Os pré-requisitos necessários para execução do integrador podem ser visualizados no link abaixo:

https://docs.microsoft.com/pt-br/dotnet/framework/get-started/system-requirements

Pré-requisitos de implantação

Os pré-requisitos necessários para implantação são: 

• Ativar o parâmetro que disponibiliza os campos para internet deve estar ativado
• O número do campo do pedido de vendas deve estar configurado para gerar numerações maiores que 5 caracteres
• A empresa deverá ter uma faixa de preço que será usada para cadastrar o preço de venda dos produtos da loja virtual 
• A empresa deverá trabalhar com locais de estoque e precisará informar de quais locais de estoque deve buscar o estoque do produto 
• A empresa deverá trabalhar com regras fiscais
• A empresa deverá trabalhar com endereço de entrega nos pedidos de vendas 

Instalando o servidor

Instale o .NET 5, você pode baixá-lo no link abaixo 

https://dotnet.microsoft.com/en-us/download/dotnet/5.0 

Criei uma nova pasta para armazenar o integrador e seus arquivos 

Copie para essa nova pasta os arquivos do integrador 

Copie para a nova pasta o arquivo arqcam.ini da pasta da cybersul 

Verifique e crie caso não esteja criado, o usuário SYSTEMUSER com senha sol3ug70

 

 

Configurando a integração pela primeira vez

Instale o .NET 5, você pode baixá-lo no link abaixo 

https://dotnet.microsoft.com/en-us/download/dotnet/5.0 

Configure as seguintes informações no integrador

O que integra

• Envio para o site: 

  • Produto  

Envia apenas produtos marcados com o campo PRINTEGRAVEL igual a Sim

 

//largura = PRLARGURA;
//profundidade = PRCOMPRIMENTO;
//altura = PRALTURA;
//sku = CODIGO;
//tipo = "normal";
//usado = PRCONDICAO == "U";
//peso = PESO_BRUTO;
//nome = PRSITEDESCRICAO (se PRSITEDESCRICAO não informado, então envia PRDESCRICAOCOMERCIAL)
//marca  = FOFABRICANTE

//ativo = PRINTERNET == "S";

//categorias  = GRCODIGOSUBGRUPO

• • Atualização de estoque

Envia a soma dos locais de estoques informados nas configurações

• • Atualização de preço 

Envia o preço informado na faixa de preço da configuração

• • Grupos 

Envia apenas os grupos marcados com GRINTERNET igual a Sim 

//descricao = DESCRICAO

• • Envio de fotos do produto não é realizado e deve ser cadastrado diretamente na plataforma da loja integrada  https://app.lojaintegrada.com.br/painel/login 

• Recebe do site:
  • Cadastro do cliente

//TELEFONE1 = cliente.telefone_principal;
//TELEFONE2 = cliente.telefone_celular;
//PESSOA_FISICAOUJURIDICA = cliente.cpf != null ? "F" : "J";
//EMAIL = cliente.email;
//CLPAIS = "BRASIL";
//CLSEXO = cliente.sexo;
se  (PESSOA_FISICAOUJURIDICA = ("F"))
{

NOME = cliente.nome;
CGC_CNPJ = cliente.cpf ;
CLIE = "NÃO CONTRIBUINTE";
CLCONSUMIDORFINAL = "S";
ORCTCODIGO =currencyConfiguracao.clienteCodCondTributariaPF;

}
senão
{

NOME = cliente.razao;
CGC_CNPJ = cliente.cnpj;
ORCTCODIGO = currencyConfiguracao.clienteCodCondTributariaPJ;
CLCONSUMIDORFINAL = "N";

}

• • Endereço de entrega 

//ANNOME = nome;
//ANVINCULOCODIGO = CODIGO_CLIENTE;
//ANVINCULOCATEGORIA = "C";
//ANTIPO = "L";
//ANEMAIL = EMAIL;

//ANCIDADE = cidade;
//ANUF = estado;
//ANCEP = cep;
//ANBAIRRO = bairro;
//ANENDERECO = endereco;
//UGINSERIDO = DateTime.Now;
//ANCOMPLEMENTO = complemento;
//ANNUMERO = numero;
UGINSERIDOREG = DateTime.Now;

//ANSEQUENCIA = 0;

• • Pedido de vendas

//AUX2 = "0";
//DATA_EMISSAO = ordem.data_criacao;
//VENDEDOR_EMPRESA = "I";
//CODIGO_VENDEDOR = currencyConfiguracao.pedidoCodigoVendedor;
//OPERACAO = currencyConfiguracao.pedidoCodigoOperacao;
//TABELA_VENCIMENTO = currencyConfiguracao.pedidoCodigoTabelaVencimento;

//VELOCAL = currencyConfiguracao.pedidoCodigoEmpresa;
//IMPRESSO_NF = "";
//ENTREGUE = ordem.numero.ToString();

//FRETE = "1";
//AUX1 = ordem.valor_envio;
//VALOR_TOTAL = ordem.valor_total;
//VEPEDIDOIMPRESSO = "N";

//VECREDITO = "N";
//VEPESOLIQUIDO = 0;
//VEPESOBRUTO = 0;
//VERECIBO = "N";
//VEVALORRENTABILIDADE = pedidoNovo.VALOR_TOTAL;
//VEVALORTOTALBRUTOITEM = pedidoNovo.VALOR_TOTAL;
//VEUSUARIO = "LOJAINTEGRADA";
//UGINSERIDO = DateTime.Now;
//VECODIGOINTEGRACAO = ordem.numero.ToString();
//ANCODIGOENTREGA = ANCODIGOENTREGA;
//CODIGO_CLIENTE = cliente.CODIGO_CLIENTE;

• • itens comprados

COD = codigo;
NUMERO_PEDIDO = pedido.NUMERO_PEDIDO;
CODIGO = prcodigo;
LECODIGO = currencyConfiguracao.pedidoCodigoLocalEstoque;
OBS = item.id.ToString();
VALOR = item.preco_venda;
QUANTIDADE = item.quantidade;
TOTAL_UNIT = itemP.VALOR * itemP.QUANTIDADE;
UGINSERIDO = DateTime.Now;
VEITCFOP = PedidoItemService.GetOperacaoRegraClassificacaoFiscal()

Vinculando cadastros para lojas que já possuem informações cadastradas

Antes de começar a enviar os dados para Loja Virtual, você deverá verificar se ela já possuí alguma informação cadastrada no painel da Loja Integrada. Caso ela já possua você precisará rodar o programa que faz o mapeamento das informações cadastradas no loja virtual com as informações cadastradas no banco de dados do sistema. 

 

Para isso é preciso executar o programa MapeadorLojaIntegrada

 

Para Executá-lo basta informar nas configurações a Chave da API

Após informar a chave você só precisa clicar nos botões Mapear Produtos, Mapear Fabricantes e Mapear Grupos

Antes de realizar o mapeamento, o programa faz uma analise e verifica se irá conseguir mapear todos os produtos, grupos e fabricantes cadastrados na Loja Integrada.

Caso o programa não consiga mapear alguma  produto, grupos ou fabricante ele irá criar os seguintes arquivos respectivamente ProdutosNaoMapeados.txt, GruposNaoMapeados.txt e FabricantesNaoMapeados.txt

 

Como é feito o mapeamento? 

O mapeamento de Grupos (Categorias)  e Fabricantes (Marcas) é feito pela descrição. Então antes confirmar a execução após a analise é preciso cadastrar no Solution 3 os registros com o nome exatamente igual ao cadastrado na Loja Integrada

O mapeamento dos produtos é feito pelo campo sku informado na loja integrada que busca no sistema pelo campo CODIGO da tabela de produtos

 

 

Colocando todos os cadastro na Fila de Envio

Para colocar todos os cadastros na fila de envios do integrador, basta você abrir o integrador com interface gráfica e clicar no botão "Colocar todos na fila"

 

Configurando o envio no agendador de tarefas do Windows

1. Pressione “Win+R” para abrir o Executar, digite taskschd.msc e clique em “OK” para abrir o Agendador de Tarefas. Outra opção é procurar por “Agendador de Tarefas” na pesquisa ou no menu Iniciar do Windows.

2. Uma vez aberto o Agendador de Tarefas, clique no menu e selecione a opção Criar Tarefa...

3. Digite um nome e marque a opção que permite executar a tarefa mesmo sem ter um usuário logado.

 

3. Abra a guia “Disparadores“, clique em “Novo” e selecione quando o programa deve ser executado. Você pode executá-lo em um agendamento, quando ocioso, ao fazer logon, ao iniciar, ao bloquear o usuário, etc.

4. Para uma execução de Segunda a Sábado a cada 5 minutos, configure assim: 

 

 

 

 5. Em seguida, na guia “Ações“, clique em “Novo” e adicione o caminho do programa que deseja executar.

 

6.  Você deverá informar o caminho do integrador e a opção -ENVIAR ou -BAIXAR (somente uma das duas). 

No caminho do integrador é recomendado que seja informado o integrador no modo CONSOLE  (sem interface gráfica)

 

7. Na aba condições você deve informar para o a tarefa ser executada apenas se houver conexão de rede 

 

8. Se você realizou o cadastramento da tarefe que ENVIA os dados, você deverá repetir o cadastramento para a tarefa que BAIXA os pedidos

 

9. Para finalizar, após criar as tarefas você deverá habilitar os históricos de disparo no Agendador de Tarefas do Windows