📗 2️⃣ Integração com “Lexos” no E-commerce.O “Integrador E-commerce”, agora possui a plataforma “Lexos” disponível para integração dos pedidos feitos através do E-commerce, com isso, será ampliado o tipo de integração de venda do E-commerce com o ERP Guarani (Imagem 1). Informações |
---|
Para configurar a integração com a “Lexos” no “Integrador E-commerce”, serão necessários os dados: URL Integração: api.lexos.com.br; Usuário: E-mail para a autenticação (api.lexos.com.br/Autenticacao); Senha: Senha para a autenticação (api.lexos.com.br/Autenticacao); Code: Primeiro token disponibilizado com o usuário e senha da autenticação; Chave de Integração: Token disponibilizado pela Lexos, disponível no painel do usuário; Refresh Token: Campo de preenchimento automático que controla os tokens de atualização, para realizar novas requisições.
|
Autenticação Painel |
---|
| Com o code da URL copiado, será necessário colar no campo “Code”, nas configurações do integrador. A “Chave de Integração” também deverá ser inserida (a própria “Lexos” localiza esta informação, caso o usuário não encontre no painel). O campo “Refresh Token” será o único a não ser preenchido inicialmente (Imagem 2).
|
Painel |
---|
| Ao testar pela primeira vez, o “Integrador E-commerce” preencherá o campo “Refresh Token”, que será atualizado automaticamente em toda chamada na integração (Imagem 3). |
Catálogo | O “Integrador E-commerce”, possui cinco chamadas para cadastramento de catálogo da “Lexos”, sendo elas: |
Painel |
---|
| Da mesma forma que das demais integrações, as informações “De > Para” deverão ser inseridas. Apenas uma tabela de preço foi disponibilizada neste momento, pois isso dependerá de uma condição específica do usuário que utilizará a integração. O status para importação no integrador, neste momento deverá ser “Todos” e para o ERP vazio. Além disso, deverão ser inseridos os estoques e usuários de cancelamento. As demais informações serão necessárias, com o início da chegada dos pedidos (Imagem 4). |
Painel |
---|
| Os arquivos “payload” ficarão na pasta “Response” da instalação do integrador, nas pastas do nome do “endpoint da API” (Imagem 5). |
Painel |
---|
| Como exemplo, será enviada uma carga individual de produtos (da mesma maneira que as demais integrações) (Imagem 6). |
O arquivo será gerado em “…\Response\PRODUTO” com a data e hora atual, onde constará: ProdutoTipoId, Sku, Ean, Nome, LocalArm, Peso, Comprimento, Largura, Altura, DescricaoResumida, Descricao, DescricaoMarketplace, Marca, Modelo, VideoURL, ProdutoImposto, NCM, Cest, Origem, Estoques, Sku, LojaIdGlobal, LocalArm, Quantidade, QuantidadeReservado, Custo e Precos.
|
Painel |
---|
| Informações comuns, como: “descrição, valor unitário, estoque AFV”. As informações sobre medidas e especificações (Imagem 7). |
O arquivo da carga de estoque será gerado em “…\Response\ESTOQUE” com a data e hora atual, constando: sku, quantidade, quantidadeReservado, custo, lojaIdGlobal e localArm. O arquivo da carga de preço será gerado em “…\Response\PRECO” com a data e hora atual. Constando o sku, preco e codigo.
|
Pedidos Na carga manual buscando “todos” ou “serviço”, o integrador utilizará o método “ObterLista”. Esse método responde com resumos dos pedidos, à partir de uma data atribuída (o LastUpdate). Nesse arquivo deverá constar: PaginaAtual, TotalPaginas, TotalRegistros, Pedidos, Data, AtualizadoEm e PedidoStatus.
|
Os arquivos de “payload”da requisição ficarão na pasta “…\Response\OBTERLISTA”. Assim, o integrador percorrerá os resumos, para capturar a informação completa do pedido, disponibilizada no método “ObterPorId”. PedidoId, PedidoERPId, Codigo, Data, Status, Desconto, Acrescimo, Frete, FreteCusto, SubTotal, Total, TipoFrete, EntregasStatus, ClienteCpfcnpj, ClienteNome, ClienteNomeFantasia, ClienteDataNascimento, ClienteSexo, ClienteRg, Observacao, CodigoRastreio, CodigoPlataforma, Plataforma, Canal, LojaId, PedidoStatusERPId, UpdatedOn, CodigoLojaErpExterno, PedidoCampanhaView, Contatos, Nome, Telefone, Email, Enderecos, TipoEndereco, Endereco, Bairro, Cidade, Uf, Pais, Cep, Numero e Complemento.
|
Os arquivos de “payload”da requisição, ficarão na pasta “…\Response\OBTERPORID”. Este será o pedido que será gravado na tabela “Pedidos” do integrador, assim como posteriormente no Guarani ERP. Todas as associações possíveis foram realizadas; ao homologar, mais informações podem ser encontradas e/ou alteradas, em relação aos campos da Lexos com os da Guarani.
|
Painel |
---|
| Ao realizar uma carga com todos os pedidos, o integrador percorrerá a lista citada e gravará os pedidos disponíveis nela (Imagem 8). |
Painel |
---|
| Neste ponto, os logs de “De>Para” serão exibidos (por se tratar de uma integração nova), como cidades, cobranças, etc (Imagem 9). |
Painel |
---|
| O processo comum será de inserção normal, assim como nos outros E-commerces (Imagens 10, 11 e 12). |
Painel |
---|
| Quando os “De>Para” estiverem informados devidamente, os pedidos subirão para o Guarani ERP (Imagem 13). |
Painel |
---|
| Na importação de pedidos específicos, o “endpoint” utilizado será o “ObterPorCodigo”, (número do pedido na plataforma da “Lexos”). Para estes pedidos, o “payload” ficará na pasta “…\Response\OBTERPORCODIGO” (apenas manuais). Ao pesquisar, o pedido será exibido normalmente (Imagens 14, 15, 16 e 17). |
|