Criação de Múltiplos Produtos

Cria ou atualiza mútiplos produtos.

Para atualizações, todos os dados de produto previamente existentes serão substituídos pelos desta requisição.

São permitidos apenas 10 produtos por request.
Esse endpoint tem um limite de 5000 requests por minuto, mais do que isso ele irá retornar status 503

Body Params

apiKey
stringrequired

ID interno de identificação da sua loja.

Não sabe qual a apiKey da sua loja? Solicite ao responsável técnico de integração enviando um email para suporteimpulse@linx.com.br

secretKey
stringrequired

Chave de acesso para autenticar a requisição. Pode ser substituída pelo parâmetro origin quando a requisição é feita via frontend para não expor a chave.

Não sabe qual a secretKey da sua loja? Solicite ao responsável técnico de integração enviando um email para suporteimpulse@linx.com.br

name
stringrequired

Título do produto.

description
string

Breve descrição do produto em texto plano, sem tags HTML e quebras de linhas.

url
stringrequired

URL da página de detalhes do produto.

Exemplo: //www.mystore.com/product/P123.html

status
stringrequired

Disponibilidade do produto em estoque.

Valores possíveis: available, unavailable ou removed

images
Objectrequired
Objeto chave valor contendo as resoluções do produto como chave e as URLs de imagens do produto como valor. A imagem selecionada por padrão será provida pela chave default.
{
  "default": "https://mystore.com/products/1234/images/200x200.png",
  "200": "https://mystore.com/products/1234/images/200x200.png",
  "400": "https://mystore.com/products/1234/images/400x400.png"
}
categories
string[] | Category[]required
Conjunto de categorias relacionadas ao produto.

price
numberrequired

Preço de comercialização do produto.

oldPrice
number

Preço anterior do produto.

brand
string

Marca do produto.

salesChannel
string

O identificador de sales channel do produto

skus
Sku[]required
Cada variante possível do produto vira um objeto dentro de skus.
Cada produto pode ter no máximo 200 skus.
installment
Installment
Objeto contento as opções de parcelamento do produto

details
Object

Objeto para atribuição de detalhes específicos do produto. Pode conter qualquer chave/valor válido para um JSO (Javascript Object).
{
  "hasSpecificRule": true,
  "myCompanyCode": "1234"
}

tags
string[]

Conjunto de tags relacionadas ao produto.

published
string

Data de adição do produto ao catálogo no formato YYYY-MM-DD.

Exemplo: 2015-02-04

unit
string

Unidade de medida utilizada na comercialização do produto. Informe somente para produtos que possuem quantidades fracionárias.

Exemplo: "M", "M(2)", "KG"

stock
number

Quantidade de itens disponíveis em estoque.

eanCode
string

Código EAN do produto

Edit this page on GitHub
New Product
import axios from 'axios';

const products = [
  {
    apiKey: 'api-sample',
    id: '124',
    secretKey: 'v8s+tGw2kuCKX33TYeFUOA==',
    name: 'Refrigerator Y',
    description: 'Energy-efficient double-door refrigerator.',
    url: '/products/124.html',
    brand: 'Marca do Produto',
    images: {
      default: '/products/124_default.png'
    },
    status: 'AVAILABLE',
    categories: ['kitchen', 'refrigerators'],
    specs: {
      voltage: ['110V', '220V']
    },
    eanCode: 'F124',
    skus: [
      {
        sku: '2.1',
        specs: { voltage: '110V' },
        status: 'available',
        price: 1150.5,
        oldPrice: 1300,
        installment: { count: 10, price: 117 }
      },
      {
        sku: '2.2',
        specs: { voltage: '220V' },
        status: 'available',
        price: 1170.99,
        oldPrice: 1300,
        installment: { count: 10, price: 117 }
      }
    ],
    price: 1150,
    details: { rating: '4.5' },
    installment: { count: 10, price: 115 },
    oldPrice: 1300,
    published: '2016-07-10'
  },
  {
    apiKey: 'api-sample',
    id: '125',
    secretKey: 'v8s+tGw2kuCKX33TYeFUOA==',
    name: 'Refrigerator Z',
    description: 'Compact fridge perfect for small kitchens.',
    url: '/products/125.html',
    brand: 'Marca do Produto',
    images: {
      default: '/products/125_default.png'
    },
    status: 'AVAILABLE',
    categories: ['kitchen', 'refrigerators'],
    specs: {
      voltage: ['110V']
    },
    eanCode: 'F125',
    skus: [
      {
        sku: '3.1',
        specs: { voltage: '110V' },
        status: 'available',
        price: 899.99,
        oldPrice: 999.99,
        installment: { count: 12, price: 75 }
      }
    ],
    price: 899.99,
    details: { rating: '3.8' },
    installment: { count: 12, price: 75 },
    oldPrice: 999.99,
    published: '2017-09-12'
  }
  // Add more products here...
];

try {
  const response = await axios.put(
    'https://collect.chaordicsystems.com/v7/multiProducts',
    products,
    {
      headers: {
        'Content-Type': 'application/json'
      }
    }
  );
  console.log('Response:', response.data);
} catch (error) {
  console.error('Error:', error.response?.data || error.message);
}
curl
curl --location --request PUT 'https://collect.chaordicsystems.com/v7/multiProducts' \
--header 'Content-Type: application/json' \
--data '[
  {
    "apiKey": "api-sample",
    "id": "124",
    "secretKey": "v8s+tGw2kuCKX33TYeFUOA==",
    "name": "Refrigerator Y",
    "description": "Energy-efficient double-door refrigerator.",
    "url": "/products/124.html",
    "brand": "Marca do Produto",
    "images": {
      "default": "/products/124_default.png"
    },
    "status": "AVAILABLE",
    "categories": [
      "kitchen",
      "refrigerators"
    ],
    "specs": {
      "voltage": [
        "110V",
        "220V"
      ]
    },
    "eanCode": "F124",
    "skus": [
      {
        "sku": "2.1",
        "specs": {
          "voltage": "110V"
        },
        "status": "available",
        "price": 1150.50,
        "oldPrice": 1300,
        "installment": {
          "count": 10,
          "price": 117
        }
      },
      {
        "sku": "2.2",
        "specs": {
          "voltage": "220V"
        },
        "status": "available",
        "price": 1170.99,
        "oldPrice": 1300,
        "installment": {
          "count": 10,
          "price": 117
        }
      }
    ],
    "price": 1150,
    "details": {
      "rating": "4.5"
    },
    "installment": {
      "count": 10,
      "price": 115
    },
    "oldPrice": 1300,
    "published": "2016-07-10"
  },
  {
    "apiKey": "api-sample",
    "id": "125",
    "secretKey": "v8s+tGw2kuCKX33TYeFUOA==",
    "name": "Refrigerator Z",
    "description": "Compact fridge perfect for small kitchens.",
    "url": "/products/125.html",
    "brand": "Marca do Produto",
    "images": {
      "default": "/products/125_default.png"
    },
    "status": "AVAILABLE",
    "categories": [
      "kitchen",
      "refrigerators"
    ],
    "specs": {
      "voltage": [
        "110V"
      ]
    },
    "eanCode": "F125",
    "skus": [
      {
        "sku": "3.1",
        "specs": {
          "voltage": "110V"
        },
        "status": "available",
        "price": 899.99,
        "oldPrice": 999.99,
        "installment": {
          "count": 12,
          "price": 75 
        }
      }
    ],
    "price": 899.99,
    "details": {
      "rating": "3.8"
    },
    "installment": {
      "count": 12,
      "price": 75
    },
    "oldPrice": 999.99,
    "published": "2017-09-12"
  },
  {
    "apiKey": "api-sample",
    "id": "126",
    "secretKey": "v8s+tGw2kuCKX33TYeFUOA==",
    "name": "Refrigerator MaxCool",
    "description": "Spacious and smart refrigerator with freezer.",
    "url": "/products/126.html",
    "brand": "Marca do Produto",
    "images": {
      "default": "/products/126_default.png"
    },
    "status": "AVAILABLE",
    "categories": [
      "kitchen",
      "refrigerators"
    ],
    "specs": {
      "voltage": [
        "220V"
      ]
    },
    "eanCode": "F126",
    "skus": [
      {
        "sku": "4.1",
        "specs": {
          "voltage": "220V"
        },
        "status": "available",
        "price": 1349.50,
        "oldPrice": 1450,
        "installment": {
          "count": 10,
          "price": 135 
        }
      }
    ],
    "price": 1349.50,
    "details": {
      "rating": "4.2"
    },
    "installment": {
      "count": 10,
      "price": 135
    },
    "oldPrice": 1450,
    "published": "2019-02-20"
  },
  {
    "apiKey": "api-sample",
    "id": "126",
    "secretKey": "v8s+tGw2kuCKX33TYeFUOA==",
    "name": "Refrigerator MaxCool",
    "description": "Spacious and smart refrigerator with freezer.",
    "url": "/products/126.html",
    "brand": "Marca do Produto",
    "images": {
      "default": "/products/126_default.png"
    },
    "status": "AVAILABLE",
    "categories": [
      "kitchen",
      "refrigerators"
    ],
    "specs": {
      "voltage": [
        "220V"
      ]
    },
    "eanCode": "F126",
    "skus": [
      {
        "sku": "4.1",
        "specs": {
          "voltage": "220V"
        },
        "status": "available",
        "price": 1349.50,
        "oldPrice": 1450,
        "installment": {
          "count": 10,
          "price": 135 
        }
      }
    ],
    "price": 1349.50,
    "details": {
      "rating": "4.2"
    },
    "installment": {
      "count": 10,
      "price": 135
    },
    "oldPrice": 1450,
    "published": "2019-02-20"
  },
  {
    "apiKey": "api-sample",
    "id": "126",
    "secretKey": "v8s+tGw2kuCKX33TYeFUOA==",
    "name": "Refrigerator MaxCool",
    "description": "Spacious and smart refrigerator with freezer.",
    "url": "/products/126.html",
    "brand": "Marca do Produto",
    "images": {
      "default": "/products/126_default.png"
    },
    "status": "AVAILABLE",
    "categories": [
      "kitchen",
      "refrigerators"
    ],
    "specs": {
      "voltage": [
        "220V"
      ]
    },
    "eanCode": "F126",
    "skus": [
      {
        "sku": "4.1",
        "specs": {
          "voltage": "220V"
        },
        "status": "available",
        "price": 1349.50,
        "oldPrice": 1450,
        "installment": {
          "count": 10,
          "price": 135 
        }
      }
    ],
    "price": 1349.50,
    "details": {
      "rating": "4.2"
    },
    "installment": {
      "count": 10,
      "price": 135
    },
    "oldPrice": 1450,
    "published": "2019-02-20"
  },
  {
    "apiKey": "api-sample",
    "id": "126",
    "secretKey": "v8s+tGw2kuCKX33TYeFUOA==",
    "name": "Refrigerator MaxCool",
    "description": "Spacious and smart refrigerator with freezer.",
    "url": "/products/126.html",
    "brand": "Marca do Produto",
    "images": {
      "default": "/products/126_default.png"
    },
    "status": "AVAILABLE",
    "categories": [
      "kitchen",
      "refrigerators"
    ],
    "specs": {
      "voltage": [
        "220V"
      ]
    },
    "eanCode": "F126",
    "skus": [
      {
        "sku": "4.1",
        "specs": {
          "voltage": "220V"
        },
        "status": "available",
        "price": 1349.50,
        "oldPrice": 1450,
        "installment": {
          "count": 10,
          "price": 135 
        }
      }
    ],
    "price": 1349.50,
    "details": {
      "rating": "4.2"
    },
    "installment": {
      "count": 10,
      "price": 135
    },
    "oldPrice": 1450,
    "published": "2019-02-20"
  },
  {
    "apiKey": "api-sample",
    "id": "126",
    "secretKey": "v8s+tGw2kuCKX33TYeFUOA==",
    "name": "Refrigerator MaxCool",
    "description": "Spacious and smart refrigerator with freezer.",
    "url": "/products/126.html",
    "brand": "Marca do Produto",
    "images": {
      "default": "/products/126_default.png"
    },
    "status": "AVAILABLE",
    "categories": [
      "kitchen",
      "refrigerators"
    ],
    "specs": {
      "voltage": [
        "220V"
      ]
    },
    "eanCode": "F126",
    "skus": [
      {
        "sku": "4.1",
        "specs": {
          "voltage": "220V"
        },
        "status": "available",
        "price": 1349.50,
        "oldPrice": 1450,
        "installment": {
          "count": 10,
          "price": 135 
        }
      }
    ],
    "price": 1349.50,
    "details": {
      "rating": "4.2"
    },
    "installment": {
      "count": 10,
      "price": 135
    },
    "oldPrice": 1450,
    "published": "2019-02-20"
  },
  {
    "apiKey": "api-sample",
    "id": "126",
    "secretKey": "v8s+tGw2kuCKX33TYeFUOA==",
    "name": "Refrigerator MaxCool",
    "description": "Spacious and smart refrigerator with freezer.",
    "url": "/products/126.html",
    "brand": "Marca do Produto",
    "images": {
      "default": "/products/126_default.png"
    },
    "status": "AVAILABLE",
    "categories": [
      "kitchen",
      "refrigerators"
    ],
    "specs": {
      "voltage": [
        "220V"
      ]
    },
    "eanCode": "F126",
    "skus": [
      {
        "sku": "4.1",
        "specs": {
          "voltage": "220V"
        },
        "status": "available",
        "price": 1349.50,
        "oldPrice": 1450,
        "installment": {
          "count": 10,
          "price": 135 
        }
      }
    ],
    "price": 1349.50,
    "details": {
      "rating": "4.2"
    },
    "installment": {
      "count": 10,
      "price": 135
    },
    "oldPrice": 1450,
    "published": "2019-02-20"
  },
  {
    "apiKey": "api-sample",
    "id": "126",
    "secretKey": "v8s+tGw2kuCKX33TYeFUOA==",
    "name": "Refrigerator MaxCool",
    "description": "Spacious and smart refrigerator with freezer.",
    "url": "/products/126.html",
    "brand": "Marca do Produto",
    "images": {
      "default": "/products/126_default.png"
    },
    "status": "AVAILABLE",
    "categories": [
      "kitchen",
      "refrigerators"
    ],
    "specs": {
      "voltage": [
        "220V"
      ]
    },
    "eanCode": "F126",
    "skus": [
      {
        "sku": "4.1",
        "specs": {
          "voltage": "220V"
        },
        "status": "available",
        "price": 1349.50,
        "oldPrice": 1450,
        "installment": {
          "count": 10,
          "price": 135 
        }
      }
    ],
    "price": 1349.50,
    "details": {
      "rating": "4.2"
    },
    "installment": {
      "count": 10,
      "price": 135
    },
    "oldPrice": 1450,
    "published": "2019-02-20"
  },
  {
    "apiKey": "api-sample",
    "id": "126",
    "secretKey": "v8s+tGw2kuCKX33TYeFUOA==",
    "name": "Refrigerator MaxCool",
    "description": "Spacious and smart refrigerator with freezer.",
    "url": "/products/126.html",
    "brand": "Marca do Produto",
    "images": {
      "default": "/products/126_default.png"
    },
    "status": "AVAILABLE",
    "categories": [
      "kitchen",
      "refrigerators"
    ],
    "specs": {
      "voltage": [
        "220V"
      ]
    },
    "eanCode": "F126",
    "skus": [
      {
        "sku": "4.1",
        "specs": {
          "voltage": "220V"
        },
        "status": "available",
        "price": 1349.50,
        "oldPrice": 1450,
        "installment": {
          "count": 10,
          "price": 135 
        }
      }
    ],
    "price": 1349.50,
    "details": {
      "rating": "4.2"
    },
    "installment": {
      "count": 10,
      "price": 135
    },
    "oldPrice": 1450,
    "published": "2019-02-20"
  }
]'