📗 2️⃣ Integração com Lexos E-commerce.O “Integrador e-commerce”, agora possui a plataforma “Lexos” disponível para integração dos pedidos feitos através do e-commerce para o Guarani ERP (Imagem 1). Image Added Informações |
---|
Para configurar a integração com a “Lexos” no “Integrador ECommerce”, 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.
| Image Added Painel |
---|
| Ao criar este acesso, o primeiro code (um token JWT), será gerado na própria URL. Devido ao “Integrador ECommerce” não conseguir inserir estes dados via código, este primeiro passo deverá ser feito manualmente através do navegador (Imagem 3). | Image Added 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 4). | Image Added Aviso |
---|
Ao testar pela primeira vez, o “Integrador ECommerce” preencherá o campo “Refresh Token”, que será atualizado automaticamente em toda chamada na integração (Imagem 5). | Image Added Informações |
---|
Catálogo O “Integrador ECommerce” possui cinco chamadas para cadastramento de catálogo da “Lexos”, sendo elas: |
Painel |
---|
| Da mesma forma que as 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 6). | Image Added Aviso |
---|
Como já dito, nenhum POST foi realizado em lojas reais da Lexos, por não haver ambiente de testes. De qualquer maneira, é possível capturar o JSON gerado em cada carga. Os arquivos (payload) ficarão na pasta Response, da instalação do integrador, nas pastas do nome do endpoint da API. | Image Added Painel |
---|
| Para exemplificar, será enviada uma carga individual de produto (da mesma maneira que as demais integrações) (Imagem 8). | Image Added Painel |
---|
| O arquivo é gerado em “…\Response\PRODUTO” com a data e hora atual. Informações comuns como descrição, valor unitário, estoque AFV. As informações sobre medidas e especificações serão como apontado (Imagem 9). | Image Added Painel |
---|
| O arquivo da carga de estoque será gerado em “…\Response\ESTOQUE” com a data e hora atual. O arquivo da carga de preço será gerado em “…\Response\PRECO” com a data e hora atual. |
Aviso |
---|
Na carga manual buscando todos ou no serviço, o integrador utilizará o método “ObterLista”. Este método responde com resumos dos pedidos a partir de uma data atribuída (o LastUpdate). Os arquivos de payload desta requisição ficarão na pasta “…\Response\OBTERLISTA”. Assim, o integrador percorrerá estes resumos para capturar a informação completa do pedido, disponibilizada no método “ObterPorId”.
Os arquivos de “payload” desta 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. Ao realizar uma carga por todos os pedidos, o integrador percorrerá a lista citada e irá gravar os pedidos disponíveis nela. | Image Added 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 11). | Image Added Painel |
---|
| O processo comum será inserir normalmente, assim como nos outros E-Commerces (Imagens 12, 13 e 14). | Image AddedImage Added Image Added Painel |
---|
| Quando os “De → Para” estiverem informados corretamente, os pedidos subirão para o Guarani ERP (Imagem 15). | Image Added Painel |
---|
| Já 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 16, 17, 18 e 19). | Image AddedImage Added Image Added Image Added |