Alterar um produto grade v3

put

https://sandbox.mercos.com/api/new-endpoint/{id}

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

⚠️
Importante
Para realizar o PUT do produto grade v3 utilize a URL padrão:https://sandbox.mercos.com/api/v1/produtos

Path Params

string

required

ID do produto no sistema Mercos.

Body Params

Para requisições do tipo PUT, envie apenas os campos que deseja alterar. Não é possível alterar os itens de variação de um produto por este endpoint.

nome

string

required

Defaults to Produto Grade V3 Alterado

Nome do produto.

comissao

number

Comissão do produto. Exemplo: 5.0 para 5%. Informe null caso não queira calcular comissões pela Mercos.

codigo

string

Código de referência do produto.

unidade

string

Unidade de medida do produto, por exemplo "Kg" ou "Cx". Opcional.

observacoes

string

Utilize para guardar quaisquer informações que não tenham campos específicos.

codigo_ncm

string

Código do NCM - Nomenclatura Comum do Mercosul, utilizado para cálculo automático do ST.

preco_tabela

double

required

Defaults to 250

Preço deste produto na tabela padrão.

preco_minimo

string

Preço mínimo do produto para o recurso da Rentabilidade (apenas Plano Ouro).

moeda

string

Moeda do produto: Real ("0"), Dólar ("1") ou Euro ("2").

saldo_estoque

double

Saldo de estoque do produto. Valor máximo suportado: 9999999.99.

ipi

double

Valor do IPI do produto. Caso não possua IPI, informe null.

tipo_ipi

string

Tipo do IPI do produto: "P" para percentual, "V" para valor fixo em Reais.

double

Percentual de Substituição Tributária do produto. Caso não possua ST ou se esse imposto deve ser calculado com base na regra vinculada ao NCM, informe null.

excluido

boolean

Indica se o produto está excluído. Os produtos excluídos não poderão mais ser atualizados. Após excluir um produto com "excluido": true, este processo não tem retorno; será necessário criar outro produto.

ativo

boolean

Indica se o produto está ativo. Os produtos inativos podem ser atualizados, inclusive podendo voltar a ser ativos.

categoria_id

integer

Identificador único da categoria relacionada ao produto.

multiplo

double

Múltiplo de venda do produto.

peso_bruto

double

Peso bruto do produto em kg, com até 3 casas decimais.

largura

double

Largura da embalagem do produto em centímetros, com até 5 casas decimais.

altura

double

Altura da embalagem do produto em centímetros, com até 5 casas decimais.

comprimento

double

Comprimento da embalagem do produto em centímetros, com até 5 casas decimais.

peso_dimensoes_unitario

boolean

Indica se o peso bruto e as dimensões (largura, altura e comprimento) informadas são unitárias. Em caso de caixa master, esse campo deve ser enviado como false.

exibir_b2b

boolean

Indica se o produto é exibido no e-commerce B2B. Por padrão esse campo é verdadeiro; caso deseje que o produto não seja exibido no B2B, envie false.

precos_especificos

boolean

Indica se os produtos grade vão herdar do agregador as tabelas de preço ou se terão preços específicos.

produtos_grade

array of objects

required

Lista de produtos grade que o produto possui. Caso o produto possua produtos grade e nada seja informado neste campo, os produtos grade serão atualizados apenas com os dados herdados do produto agregador.

produtos_grade*

Headers

ApplicationToken

string

required

Identifica sua aplicação.

CompanyToken

string

required

Representa o cliente da sua aplicação.

Responses

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Importante

200OK

401Unauthorized

429Too Many Requests