Exibir código-fonte para 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:'''
<br>

URL de homologação -> https://openplatform.sandbox.test-stable.shopee.sg
<br>

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

'''UrlAutorizacao:'''
<br>

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

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;

== 1° Passo - Criar um Aplicativo ==

Acessar Link:
[https://open.business.accounts.shopee.com/authenticate/login?client_id=11&should_hide_back=true&next=https%3A%2F%2Fopen.shopee.com%2Fopservice%2Fapi%2Fv1%2Faccount%2Finit_session%3Fredirect_url%3Dhttps%253A%252F%252Fopen.shopee.com%252F Shopee - Login]

Após acessar a conta, basta ir até o "Personal Center"
[[Arquivo:Personal Center - Shopee Developer.png|Personal Center - Shopee Developer]]

<br>
<br>

Depois basta ir em Cadastro -> Cadastro de Aplicativos: [https://open.shopee.com/console/app Shopee - Aplicativo]

<br>
<br>

[[Arquivo:App - Shopee Developer.png|App - Shopee Developer]]

Depois basta selecionar o aplicativo ou criar um novo:

<br>
<br>

[[Arquivo:New App - Shopee Developer.png|New App - Shopee Developer]]

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

<br>
<br>

[[Arquivo:Credenciais - Shopee Developer.png|Credenciais - Shopee Developer]]

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

<br>
<br>

[[Arquivo:Loja - Shopee Developer.png|Loja - Shopee Developer]]


== 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:
[[Arquivo:Credenciais (Code) Part.1 - Shopee Developer.png|Credenciais (Code) Part.1 - Shopee Developer]]

[[Arquivo:Credenciais (Code) Part.2 - Shopee Developer.png|Credenciais (Code) Part.2 - Shopee Developer]]

[[Arquivo:Credenciais (Code) Part.3 - Shopee Developer.png|Credenciais (Code) Part.3 - Shopee Developer]]

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'''
[[Arquivo:Credenciais (Code) Part.4 - Shopee Developer.png|Credenciais (Code) Part.4 - Shopee Developer]]

Após gerar o token de acesso temporário, basta clicar em '''Gerar Token Acesso''':
[[Arquivo:Credenciais (Code) Part.5 - Shopee Developer.png|Credenciais (Code) Part.5 - Shopee Developer]]

<br>

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; <br>
  Marcar o produto para o aceite de integrações; <br>
  Informar embalagem com as dimensões; <br>
  E obrigatóriamente informar imagem(ns) no produto (ao menos uma) marcada como desenho.