Alterar um produto simples

put

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

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

⚠️
Importante
Para requisições do tipo PUT envie apenas os campos que deseja alterar.

Path Params

integer

required

ID do produto no sistema Mercos.

Body Params

nome

string

required

Defaults to Produto Simples Alterado

Nome do produto.

comissao

double

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 150

Preço deste produto na tabela padrão.

preco_minimo

double

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.

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

Importante

200OK

401Unauthorized

429Too Many Requests