RN Integracao Shopee v2

Regra de negócio do tipo habilitadora, acoplável ao DataPlus ERP, com o objetivo de configurar e manipular a integração entre a API da Shopee (versão 2) e o DataPlusERP. Ela pode ser acessada por meio da tela de integração do sistema.

Para a versão 2 da API da Shopee, foi incluído um novo processo de autenticação de usuário/aplicativo.

1° Passo - Acessar Aplicativos

Acessar Link: Shopee - Login

Após acessar a conta, basta ir no Ícone de configurações -> Todas as configurações:

Depois basta ir em Cadastro -> Cadastro de Aplicativos: https://www.bling.com.br/login?r=https%3A%2F%2Fwww.bling.com.br%2Fcadastro.aplicativos.php

Depois basta selecionar o aplicativo ou criar um novo:

Para criar um novo basta seguir as seguintes instruções: <ref>https://developer.bling.com.br/homologacao#inscri%C3%A7%C3%A3o</ref>

Ao criar um novo aplicativo, a URL de Callback será essa: <ref>https://ws32.dataplussistemas.com.br/DataPlusERP.svc/AuthorizationEcommerce</ref>. Será uma URL definida no servidor da DataPlus.

Após a criação do aplicativo, você poderá obter as credenciais de acesso a API, como o ClientId e o ClientSecret:

2° Passo - Configuração no ERP

No ERP basta informar as credencias ClientId e ClientSecret e uma identificação para recebimento do Token de autorização temporário (O token tem o tempo de expiração de 1 minuto) para a configuração do E-commerce:

Após informar o as credenciais e a identificação para recebimento do token, basta clicar no botão Gerar Token Autorização, após o click uma tela na Web será aberta, para a autorização do aplicativo com o ERP:

Basta selecionar autorizar logo abaixo:

Após a autorização, você será redirecionado para o webservice da DataPlus, com a mensagem de ok você pode fechar a página e prosseguir com o segundo passo:

Lembrando que o token gerado após a aparição da mensagem expira em 1 minuto, caso o token expire será necessário repetir o processo.

Após gerar o token de acesso temporário, basta clicar em Gerar Token Acesso:

Com a mensagem o ecommerce está configurado corretamente. As credenciais de acesso é guardado em um XML na pasta do usuário (C:\Users\Vinicius\AppData\Local) no arquivo ApiConfig no nó <ApiBlingV3>.

Acoplamento

Essa regra de negócio só poder acoplada à entidade Comum.IntegracaoDadosExternos. Ela está preparada para funcionar com o elemento ExecutaOperacao, sendo seu designador por Execução e tempo de execução Depois.

Parâmetros

UrlEcommerce: Url do e-commerce https://api.bling.com.br/Api/v3;

ClientId: Credencial ClientId do aplicativo;

ClientSecret: Credencial ClientSecret do aplicativo;

CodigoStatusPedido: Código de status do pedido (do e-commerce) a ser considerado na busca de dados. Mais de um separados por vírgula;
Códigos verificados e possíveis para utilização:
6: em aberto
9: atendido
12: cancelado
15: em andamento
18: venda agenciada
21: em digitação
24: verificado

SituacaoCodigo: Código da situação padrão para a gravação dos pedidos;

PortadorCodigo: Código do portador padrão para a gravação dos pedidos;

TransportadoraCodigo: Código da transportadora padrão para a gravação dos pedidos;

OpSaidaCodigo: Código da operação de saída padrão para a gravação dos pedidos;

RepresentanteCodigo: Código do representante padrão para a gravação dos pedidos;

TelevendasCodigo: Código do televendas padrão para a gravação dos pedidos;

CaracteristicaCodigo: Código da característica de venda padrão para a gravação dos pedidos;

DiasPrazoEntrega: Prazo de entrega padrão, a partir da emissão, para pedidos (quantidade de dias);

TipoFrete: Tipo de frete;

StatusCliente: Código do status de pessoa para clientes trazidos do e-commerce;

RamoAtividadeCodigo: Código do ramo de atividade padrão para a gravação dos clientes;

DefinirEnqFiscal: Define o enquadramento fiscal do cliente ao integrá-lo;

FamiliasKit: Define quais famílias serão consideradas para kits na integração;

NumeroListaPrecoProdutos: Lista de Preços para realizar o envio dos produtos para o web service;

IdsLojas: ID das lojas (separadas por ;), que são utilizadas em questão de preço de produto;

PercentualLojas: Percentuais (separados por ;) a serem aplicados nos preços da lista de preços para cada loja (relacionado com IdsLojas);

QtdeEstoque: Quantidade de estoque fixa a ser enviada. Se for zero ou vazio, enviará o estoque atual individual de cada produto.

EmpresaReceptora: Empresa em que o pedido será integrado.

DepositoId: Id do deposito para lançamento de estoque. Se 0 coleta o deposito padrão.