API de integração Mercos
API Reference
  1. API de integração Mercos
  2. Depreciados
  3. Produtos V2

Incluir um produto grade (v2)

post
https://sandbox.mercos.com/api/v1/produtos

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

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

📌 Header de resposta

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

Body Params
string

Código de referência do produto.

string
required

Nome do produto.

number | null

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

number
required

Preço deste produto na tabela padrão.

number

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

number

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

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.

string

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

string

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

number

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

string

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

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.

boolean

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

integer

Identificador único da categoria relacionada ao produto.

string

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

double | null

Múltiplo de venda do produto.

double

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

double

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

double

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

double

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

boolean

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

boolean

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

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
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.

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.

string

Depreciado. Lista de cores (String: 50) disponíveis. Caso não trabalhe com variação de cores, informe null.

string

Lista de tamanhos (String: 50) disponíveis. Caso não trabalhe com variação de tamanhos, informe null.

Headers
string
required

Identifica sua aplicação.

string
required

Representa o cliente da sua aplicação.

Responses

Updated 21 days ago

Did this page help you?
Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 21 days ago

Did this page help you?