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.

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 de homologação -> https://openplatform.sandbox.test-stable.shopee.sg

URL de produção -> https://openplatform.shopee.com.br

UrlAutorizacao:

URL de homologação -> https://partner.test-stable.shopeemobile.com

URL de produção -> https://openplatform.shopee.com.br

PartnerId: Partner ID (Identificador do aplicativo da Shopee);

PartnerKey: Partner Key (Chave Secreta do aplicativo da Shopee);

ShopId: ID da Loja Shopee (ShopID);

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

EmpresaReceptora: Empresa em que o pedido será integrado.

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

CodigoStatusPedido: Código de status do pedido (do e-commerce) a ser considerado na busca de dados (Ex.: READY_TO_SHIP);

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;

CondicaoPagto: Código da condicao de pagamento 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;

EnqFiscalPessoaFisica: Código do enquadramento fiscal padrão para Pessoa Fisica ao integrar o cliente;

EnqFiscalPessoaJuridica: Código do enquadramento fiscal padrão para Pessoa Jurídica ao integrar o cliente;

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

CanaisVenda: Define quais serão os canais de venda dos produtos. Separar por vírgulas (Ex.: 91008, 91009);

Classificacao: Classificação utilizada no adiantamento;

Divisao: Divisão utilizada no adiantamento;

CentroCusto: Centro de Custo utilizada no adiantamento;

ContaBancaria: Conta utilizada no adiantamento;

NomeImpressoraEtiquetas: Nome da impressora para impressão de etiquetas;

ImpostoCodigoComissao: Código do imposto para comissão do marketplace.

ImpostoCodigoFreteCusto: Código do imposto para custo de frete que o vendedor paga.

1° Passo - Criar um Aplicativo

Acessar Link: Shopee - Login

Após acessar a conta, basta ir até o "Personal Center"

Depois basta ir em Cadastro -> Cadastro de Aplicativos: Shopee - Aplicativo

Depois basta selecionar o aplicativo ou criar um novo:

Ao criar um novo aplicativo, a URL de Callback (Redirect URL Domain) será essa: <ref>https://google.com</ref>.

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

2° Passo - Criar uma loja

Este procedimento é necessário prioritariamente em ambiente de homologação, visto que, em produção, a loja do cliente já estará previamente configurada e ativa.

3° Passo - Configuração no ERP

No ERP basta informar as credencias ClientId (Partner_id) e ClientSecret (Partner_key) para receber um código de identificação para a coleta do Token de autorização (Access Token) (o code obtido tem duração de 5 minutos) 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:

Após realizar as confirmações necessárias, é preciso coletar a URL que foi retornada no site do Google e informar no campo Identificação Token Temporário

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 é armazenada em um XML na pasta do usuário (C:\Users\USUARIO\AppData\Local) no arquivo ApiConfig no nó <Shopee_Shop_PARTNER_ID>.

Requisitos

Produtos:

 Atributo adicional: J:\Vb.Net\Scripts\Atributos Adicionais\Adiciona campos adicionais no cadastro de Produto - Shopee.sql; 

 Marcar o produto para o aceite de integrações; 

 Informar embalagem com as dimensões; 

 E obrigatóriamente informar imagem(ns) no produto (ao menos uma) marcada como desenho.