---
title: Linx Commerce
slug: linx-commerce
docTags: 
createdAt: 2025-03-12T02:14:46.400Z
---

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

1. **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.
2. **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.
3. **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.
4. **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:

1. **Crie um fluxo e arraste o conector Linx Commerce para o canvas.**
2. **Selecione o conector Linx Commerce**. Na aba de [Parametrizações](docId\:VpiLZuEnyPyCbjPp4YAND), você encontrará os campos de configuração.
3. **Escolha o Módulo/Serviço desejado**. Os módulos disponíveis são:
   ◦ OMA TO SELLER
   ◦ Commerce
4. **Defina o Recurso para o módulo/serviço escolhido**:
   ◦ OMA TO SELLER**:**
   ▪ Categorias
   ▪ Produtos
   ▪ Preços
   ▪ Estoque
   ▪ Pedidos
   ▪ Fulfillments
   ◦ Commerce:
   ▪ Categorias
5. **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
6. ◦ **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
   ◦ **Fulfillment
**
▪ 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
7. **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.
8. 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.

::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/CQWDlypqcutds863MJGPc_image-2.png" size="50" width="647" height="373" position="center" darkWidth="647" darkHeight="373" showCaption="false"}

**Passo 'cadastra-produto'**

Assim ficará a Parametrização do nosso primeiro e único passo:

::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/GgU7DrRtPt78k38-xweHe_image-3.png" size="40" width="434" height="750" position="center" darkWidth="434" darkHeight="750" showCaption="false"}

Para tratar os dados recebidos do payload de entrada usamos o [Template](https://www.notion.so/depara). E assim ficou nosso Template:

::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/em8o8svl7sRIjoi9xk3dF_image-4.png" size="60" width="1472" height="903" position="center" darkWidth="1472" darkHeight="903" showCaption="false"}

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

::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/qtxyHN9cz7yLBgx7byRg5_image-5.png" size="50" width="435" height="753" position="center" darkWidth="435" darkHeight="753" showCaption="false"}

## Conclusão

Com o passo configurado basta disparar o fluxo informando o payload de entrada:

```json
{
  "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. *[Clique aqui](https://api.linxcommerce.io/marketplace/v1/swagger/index.html)* para mais informações sobre a API Linx Commerce -* **OMA TO SELLER**\*.\*

[Clique aqui](https://demo.layer.core.dcg.com.br)* para mais informações sobre a API Linx Commerce - Commerce.
*
*UserName: layer.demo
*
*Password: demo123*

::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/I0W7Q71-NxhrjKqzi7C2V_image-6.png" size="70" width="832" height="330" position="center" showCaption="false"}

Após o disparo, o resultado do fluxo aparecerá em realtime no canvas:

::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/l2FtqnrLYChhvVU6IUgiw_image-7.png" size="70" width="731" height="379" position="center" showCaption="false"}

Ao clicar em detalhes, temos a requisição e a resposta retornada pela Linx Commerce:

::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/qh-E5LNLGM-3zwOX-GmWj_image-8.png" size="70" width="1148" height="794" position="center" showCaption="false"}

::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/kGjheQRHlYrObMbnO49g__image-9.png" size="70" width="1154" height="799" position="center" showCaption="false"}