Linx Commerce

objetivo/resumo o conector linx commerce facilita a comunicação eficaz entre a plataforma fluid e o sistema linx commerce este conector tem como objetivo principal integrar o linx commerce com outros sistemas que você utiliza para gerenciar seu negócio online ele permite uma troca de informações suave e automatizada, possibilitando o gerenciamento eficiente de produtos, pedidos, categorias e fulfillments com a integração entre a plataforma fluid e o linx commerce, você pode aproveitar ao máximo todas as funcionalidades oferecidas pelo linx commerce, garantindo que seu negócio funcione de maneira eficiente e organizada este conector é uma ferramenta essencial para micro e pequenas empresas que desejam simplificar seus processos de negócios e alcançar um alto nível de eficiência operacional gerando api key para configuração do seu conector linx commerce para a integração com o conector linx commerce, é fundamental possuir uma chave api (api key) válida esta chave permite que nossa plataforma se comunique de maneira segura e eficiente com o sistema linx commerce passos para obter sua api key docid\ vojxrxx nflvlcqizn7hk do linx commerce acesse a plataforma linx commerce faça login em sua conta no sistema linx commerce se você ainda não possui uma conta, crie uma seguindo as instruções fornecidas no site oficial consulte a documentação oficial recomendamos fortemente que consulte a documentação oficial do linx commerce https //share linx com br/pages/viewpage action?pageid=412268985 para obter informações detalhadas sobre a criação e gestão de chaves api navegue até a seção de chave de api uma vez logado, localize o menu de configurações e procure pela seção dedicada à api ou integrações esta seção geralmente contém as opções para gerar, visualizar e gerenciar suas chaves api crie uma nova chave api siga as instruções fornecidas para criar uma nova chave api certifique se de salvar essa chave em um local seguro, pois ela será necessária para a configuração do conector em nossa plataforma criando um fluxo utilizando o conector linx commerce para criar um fluxo docid\ wtzwyezqpk5bx oj0t938 utilizando o conector linx commerce é preciso adicionar uma ou mais conexões docid\ fdr1y5srgt0dnlvqkuekj e em seguida configurar o fluxo criando conexão linx commerce oma to seller acessar o painel principal faça login na plataforma fluid no painel à esquerda, navegue até a opção "conexões" e clique nela iniciar nova conexão no canto superior direito, clique em "nova conexão" seleção do tipo de conexão na tela de configuração, localize "configure uma nova conexão" e selecione "linx commerce" da lista suspensa nome da conexão forneça um nome descritivo para a conexão no campo "nome " descrição da conexão no campo "descrição ", forneça uma breve descrição da conexão token chave de autenticação/integração do seu aplicativo linx commerce, que será utilizada pela api testar a conexão clique no botão "testar" para verificar a conexão salvar conexão após a verificação, clique em "salvar conexão" para finalizar criando conexão linx commerce commerce acessar o painel principal faça login na plataforma fluid no painel à esquerda, navegue até a opção "conexões" e clique nela iniciar nova conexão no canto superior direito, clique em "nova conexão" seleção do tipo de conexão na tela de configuração, localize "configure uma nova conexão" e selecione "linx commerce" da lista suspensa nome da conexão forneça um nome descritivo para a conexão no campo "nome " descrição da conexão no campo "descrição ", forneça uma breve descrição da conexão user usuario de login da plataforma password senha de login da plataforma loja identificação na url https // layer core dcg com br (campo obrigatório); testar a conexão clique no botão "testar" para verificar a conexão salvar conexão após a verificação, clique em "salvar conexão" para finalizar configurando fluxo linx commerce para configurar o conector linx commerce na plataforma fluid, siga os passos abaixo crie um fluxo e arraste o conector linx commerce para o canvas selecione o conector linx commerce na aba de parametrizações docid\ vpilzuenypycbjpp4yand , você encontrará os campos de configuração escolha o módulo/serviço desejado os módulos disponíveis são ◦ oma to seller ◦ commerce defina o recurso para o módulo/serviço escolhido ◦ oma to seller ▪ categorias ▪ produtos ▪ preços ▪ estoque ▪ pedidos ▪ fulfillments ◦ commerce ▪ categorias defina a operação para o recurso desejado ◦ categorias ▪ lista todas as categorias ▪ retorna uma categoria e seus filhos ▪ lista todas os atributos de uma categoria ▪ lista todos os valores possíveis para um atributo com valor tipo single ou multiple ▪ lista todas as especificaçoes de uma categoria que sejam do tipo single ou text ▪ lista todos os valores possíveis especificações de uma categoria ◦ produtos ▪ listar todos os produtos ▪ listar um produto específico ▪ remover um produto do marketplace ▪ adicionar uma variação ao produto ▪ retorna uma variação específica de um produto ▪ remover uma variação do marketplace ▪ listar todos os produtos com filtro de pesquisa ▪ adicionar/atualizar um lote de produtos no marketplace ▪ retorna atualizações de status de produtos adicionados na fila uma variação de produto da fila ▪ realizar auditoria dos logs de integração ◦ preço ▪ retorna o preço de um sku (variação) ▪ atualiza o preço de um sku (variação) ▪ atualiza um lote de preços por sku ◦ estoque ▪ retorna a posição de estoque de um sku (variação) ▪ atualiza a posição de estoque de um sku (variação) ▪ atualiza um lote de estoques por sku (variação) ◦ pedidos ▪ lista todos os pedidos ▪ retorna um pedido ▪ cancela um pedido ainda não faturado ▪ lista todos os pedidos da fila do oma ▪ remove um item da fila de status de pedido ◦ f ulfillment ▪ retorna todos os fulfillments de um pedido ▪ adiciona fulfillment ao pedido informado ▪ retorna um fulfillment de um pedido ▪ envia nf para um fulfillment ▪ expede uma entrega (com tracking number) ▪ define uma entrega como recebida pelo produto ▪ cancela uma entrega antes de estar faturada ◦ categorias ▪ consulta categoria ▪ consulta propriedades de um categoria ▪ deleta categoria ▪ cadastra categoria ▪ atualiza categoria ▪ cadastra categorias em lote ▪ busca categoria por pesquisa corpo da requisição todas as operações possuem um corpo a ser inserido certifique se de preenchê lo de acordo com a operação escolhida finalize acessando a aba "propriedades" selecione a conexão desejada, nomeie o passo e, se necessário, inclua uma descrição detalhada na prática neste tópico criaremos um exemplo de um fluxo utilizando o conector da linx commerce o fluxo terá apenas um passo que será responsável pela criação de um produto no sistema da linx commerce enviaremos um payload de entrada que passará por uma transformação em nosso template docid\ treajh8tvdyh6ukyeaqzp , para assim enviarmos o objeto esperado pela api com os dados do produto a ser criado passo 'cadastra produto' assim ficará a parametrização do nosso primeiro e único passo para tratar os dados recebidos do payload de entrada usamos o template https //www notion so/depara e assim ficou nosso template para mais informações sobre como tratamos template docid\ treajh8tvdyh6ukyeaqzp na aba propriedades informamos o nome do passo e a conexão criada para a linx commerce conclusão com o passo configurado basta disparar o fluxo informando o payload de entrada { "id" "16413217230", "name" "bota teste 1", "sellercategory" \[ "" ], "marketplacecategoryid" "1", "brand" "bota", "description" "descrição texto", "warranty" "texto", "variations" \[ { "sku" "16413217230 1", "name" "bota teste 1", "identifiers" \[ { "type" "ean", "value" "" } ], "weight" 1, "height" 1, "width" 1, "length" 1, "listprice" 170 00, "available" 10, "handlingtime" 5, "backorderlimit" 0, "backordertime" 0, "attributes" \[ ], "mainimage" "https //a4 vnda com br/1000x/vincishoes/2022/02/23/16 2 7 756 anturpiablacksite4 jpg", "images" \[ "https //a4 vnda com br/1000x/vincishoes/2022/02/23/16 2 7 762 anturpiablack1 jpg", "https //a2 vnda com br/1000x/vincishoes/2022/04/05/0 4 3 323 antuerpiablack2 jpg" ], "active" true } ] } este é um payload teste disponibilizado pela propria api da linx commerce https //api linxcommerce io/marketplace/v1/swagger/index html para mais informações sobre a api linx commerce oma to seller https //demo layer core dcg com br para mais informações sobre a api linx commerce commerce username layer demo password demo123 após o disparo, o resultado do fluxo aparecerá em realtime no canvas ao clicar em detalhes, temos a requisição e a resposta retornada pela linx commerce