Alterar um produto grade (v2)

put

https://sandbox.mercos.com/api/v1/produtos/{id}

Diferença: Em um produto grade v2 SÃO enviados os campos grade_cores ou grade_tamanhos.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

📌 Header de resposta

Em caso de sucesso (201 - Created), o ID Mercos do recurso criado será retornado no header *meuspedidosid

Path Params

string

required

Body Params

codigo

string

Código de referência do produto.

nome

string

required

Nome do produto.

comissao

number | null

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

preco_tabela

number

required

Preço deste produto na tabela padrão.

preco_minimo

number

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

ipi

number

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

tipo_ipi

string

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

number | null

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

moeda

string

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

unidade

string

Unidade de medida do produto. Ex: "Kg" ou "Cx". Opcional.

saldo_estoque

number

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

observacoes

string

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

excluido

boolean

Indica se o produto está excluído. Produtos excluídos não poderão mais ser atualizados. Após excluir ("excluido": true), o processo não tem retorno — será necessário criar outro produto.

ativo

boolean

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

categoria_id

integer

Identificador único da categoria relacionada ao produto.

codigo_ncm

string

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

multiplo

number | null

Múltiplo de venda do produto.

peso_bruto

number

Peso bruto do produto em kg (até 3 casas decimais).

largura

number

Largura da embalagem em centímetros (até 5 casas decimais).

altura

number

Altura da embalagem em centímetros (até 5 casas decimais).

comprimento

number

Comprimento da embalagem em centímetros (até 5 casas decimais).

peso_dimensoes_unitario

boolean

Indica se o peso bruto e as dimensões são unitárias. Em caixa master, envie false.

exibir_no_b2b

boolean

Indica se o produto é exibido no e-commerce B2B. Por padrão é true. Para ocultar, envie false.

precos_especificos

boolean

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

produtos_grade

array

Lista de produtos grade. Caso o produto possua grades e nada for informado, os produtos grade serão atualizados apenas com os dados herdados do produto agregador.

produtos_grade

representada_id

integer | null

Identificador da representada. Opcional: quando não informado, o Mercos usa a representada associada à integração. Utilize este campo se a sua conta não é uma indústria com divisões. Se for, utilize divisao_id no lugar dele.

divisao_id

integer | null

Identificador da divisão. Opcional: quando não informado, o Mercos usa a divisão associada à integração. Utilize este campo se a sua conta é uma indústria com divisões. Nas demais contas, utilize representada_id.

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

200OK

401Unauthorized

429Too Many Requests