POSTEnviar produtos com vários preços

Envia produtos com preços por quantidade ou por segmento de cliente, em lotes de até 50 por requisição.

Use este endpoint para enviar produtos com mais de um preço: descontos por quantidade (atacado) ou preços por segmento de cliente. Cada produto traz o preço padrão em price e uma lista prices com os preços por quantidade mínima e por segmento. O corpo é um array e o limite é de 50 produtos por requisição.

POST/api/productsSeller

Envia produtos com vários preços

Cabeçalhos

Authorizationstringobrigatório

Basic Auth. Combinação usuário:senha codificada em Base64 (o e-mail e a chave de API do Seller Center).

O corpo deve conter um array de objetos de produto. Você pode enviar até 50 produtos por requisição.

Corpo da requisição

product_codestringobrigatório

Código universal do produto (código de barras).

ncmstring

Código de classificação fiscal NCM.

productstringobrigatório

Nome do produto.

brandstring

Nome da marca.

weightstring

Peso do produto em gramas.

pricestringobrigatório

Preço unitário padrão do produto. Use vírgula como separador decimal, por exemplo "12,49".

pricesarrayobrigatório

Array de objetos de preço, que definem preços diferentes por quantidade ou por segmento de cliente.

lower_limitstringobrigatório

Quantidade mínima para este preço valer. Use "1" se não quiser oferecer preço por quantidade.

usergroup_idstringobrigatório

ID do segmento de clientes a que este preço se aplica. Use "0" se o preço vale para todos os clientes.

pricestringobrigatório

Preço unitário para esta quantidade e este segmento. Use vírgula como separador decimal, por exemplo "10,99".

amountstringobrigatório

Quantidade disponível em estoque.

qty_stepstringpadrão: 1

Incremento mínimo de quantidade.

statusstringobrigatório

ADH

Status do produto: "A" (ativo), "D" (desativado) ou "H" (oculto).

internal_product_codestring

Número interno do produto no sistema de gestão do fornecedor.

quantity_per_packagestring

Número de unidades por embalagem/fardo. Se for maior que um, o cliente poderá comprar a embalagem fechada além de comprar por unidade.

Exemplo de requisição

bash

curl -X POST "$BASE_URL/api/products" \
  -u "$EMAIL:$API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
  {
    "product_code": "7891404130314",
    "ncm": "18069000",
    "product": "Chocolate Sensação 80g",
    "brand": "NESTLE",
    "weight": "80",
    "price": "12,49",
    "prices": [
      {
        "lower_limit": "1",
        "usergroup_id": "0",
        "price": "10,99"
      },
      {
        "lower_limit": "1",
        "usergroup_id": "110",
        "price": "11,99"
      }
    ],
    "amount": "230",
    "qty_step": "1",
    "status": "A"
  }
]'

Exemplo com preço por quantidade

bash

curl -X POST "$BASE_URL/api/products" \
  -u "$EMAIL:$API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
  {
    "product_code": "7891401114233",
    "ncm": "18069000",
    "product": "Nestlé Alpino 100g",
    "brand": "NESTLE",
    "weight": "100",
    "price": "9,99",
    "prices": [
      {
        "lower_limit": "1",
        "usergroup_id": "0",
        "price": "9,99"
      },
      {
        "lower_limit": "5",
        "usergroup_id": "0",
        "price": "9,49"
      },
      {
        "lower_limit": "10",
        "usergroup_id": "0",
        "price": "8,79"
      },
      {
        "lower_limit": "50",
        "usergroup_id": "0",
        "price": "8,49"
      }
    ],
    "amount": "403",
    "qty_step": "1",
    "status": "A"
  }
]'

Resposta

O endpoint devolve o ID dos produtos criados ou atualizados.

201Produtos criados (201 Created)

json

{
  "product_id": 934889,
  "product_ids": [
    934887,
    934889
  ]
}

Erros

Status	Quando	Corpo de exemplo
400	Requisição inválida.	`{"message": "Bad Request", "status": 400}`

Veja também

POSTEnviar produtos com vários preços

Envia produtos com preços por quantidade ou por segmento de cliente, em lotes de até 50 por requisição.

POST/api/productsSeller

Envia produtos com vários preços

Cabeçalhos

Authorizationstringobrigatório

Basic Auth. Combinação usuário:senha codificada em Base64 (o e-mail e a chave de API do Seller Center).

O corpo deve conter um array de objetos de produto. Você pode enviar até 50 produtos por requisição.

Corpo da requisição

product_codestringobrigatório

Código universal do produto (código de barras).

ncmstring

Código de classificação fiscal NCM.

productstringobrigatório

Nome do produto.

brandstring

Nome da marca.

weightstring

Peso do produto em gramas.

pricestringobrigatório

Preço unitário padrão do produto. Use vírgula como separador decimal, por exemplo "12,49".

pricesarrayobrigatório

Array de objetos de preço, que definem preços diferentes por quantidade ou por segmento de cliente.

lower_limitstringobrigatório

Quantidade mínima para este preço valer. Use "1" se não quiser oferecer preço por quantidade.

usergroup_idstringobrigatório

ID do segmento de clientes a que este preço se aplica. Use "0" se o preço vale para todos os clientes.

pricestringobrigatório

Preço unitário para esta quantidade e este segmento. Use vírgula como separador decimal, por exemplo "10,99".

amountstringobrigatório

Quantidade disponível em estoque.

qty_stepstringpadrão: 1

Incremento mínimo de quantidade.

statusstringobrigatório

ADH

Status do produto: "A" (ativo), "D" (desativado) ou "H" (oculto).

internal_product_codestring

Número interno do produto no sistema de gestão do fornecedor.

quantity_per_packagestring

Número de unidades por embalagem/fardo. Se for maior que um, o cliente poderá comprar a embalagem fechada além de comprar por unidade.

Exemplo de requisição

bash

curl -X POST "$BASE_URL/api/products" \
  -u "$EMAIL:$API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
  {
    "product_code": "7891404130314",
    "ncm": "18069000",
    "product": "Chocolate Sensação 80g",
    "brand": "NESTLE",
    "weight": "80",
    "price": "12,49",
    "prices": [
      {
        "lower_limit": "1",
        "usergroup_id": "0",
        "price": "10,99"
      },
      {
        "lower_limit": "1",
        "usergroup_id": "110",
        "price": "11,99"
      }
    ],
    "amount": "230",
    "qty_step": "1",
    "status": "A"
  }
]'

Exemplo com preço por quantidade

bash

curl -X POST "$BASE_URL/api/products" \
  -u "$EMAIL:$API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
  {
    "product_code": "7891401114233",
    "ncm": "18069000",
    "product": "Nestlé Alpino 100g",
    "brand": "NESTLE",
    "weight": "100",
    "price": "9,99",
    "prices": [
      {
        "lower_limit": "1",
        "usergroup_id": "0",
        "price": "9,99"
      },
      {
        "lower_limit": "5",
        "usergroup_id": "0",
        "price": "9,49"
      },
      {
        "lower_limit": "10",
        "usergroup_id": "0",
        "price": "8,79"
      },
      {
        "lower_limit": "50",
        "usergroup_id": "0",
        "price": "8,49"
      }
    ],
    "amount": "403",
    "qty_step": "1",
    "status": "A"
  }
]'

Resposta

O endpoint devolve o ID dos produtos criados ou atualizados.

201Produtos criados (201 Created)

json

{
  "product_id": 934889,
  "product_ids": [
    934887,
    934889
  ]
}

Erros

Status	Quando	Corpo de exemplo
400	Requisição inválida.	`{"message": "Bad Request", "status": 400}`