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

Incluir um produto grade v3

post
https://sandbox.mercos.com/api/new-endpoint
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⚠️

Importante

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


📌 Header de resposta

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

Body Params
string
required
Defaults to Produto Grade V3

Nome do produto.

number

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

string

Código de referência do produto.

string

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

string

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

string

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

double
required
Defaults to 200

Preço deste produto na tabela padrão.

double

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

string

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

double

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

double

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

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.

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.

boolean

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

integer

Identificador único da categoria relacionada ao produto.

double

Múltiplo de venda do produto.

double

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

double

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

double

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

double

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

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.

boolean

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

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.

produtos_grade*
Headers
string
required

Identifica sua aplicação.

string
required

Representa o cliente da sua aplicação.

Responses

Updated about 2 months 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 about 2 months ago

Did this page help you?