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

Incluir um produto simples

post
https://sandbox.mercos.com/api/v1/produtos
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
required
Defaults to PRODUTO TESTE

Nome do produto.

double
Defaults to 5

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

string
Defaults to S002

Código de referência do produto.

string
Defaults to UN

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

string
Defaults to Cadastro de teste

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

string
Defaults to 2828.90.11

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

double
required
Defaults to 100.50

Preço deste produto na tabela padrão.

double
Defaults to 1

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

string
Defaults to 0

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

double
Defaults to 100

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

double
Defaults to 11

Caso não possua IPI, informe null.

string
Defaults to P

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

double
Defaults to 0.0

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 "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
Defaults to 233006

Identificador único da categoria relacionada ao produto.

double
Defaults to 1

Múltiplo de venda do produto.

double
Defaults to 5

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

double
Defaults to 10

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

double
Defaults to 10

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

double
Defaults to 10

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

boolean
Defaults to true

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

boolean
Defaults to true

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, esse campo deve ser enviado como falso.

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.

Headers
string
required

Identifica sua aplicação.

string
required

Representa o cliente da sua aplicação.

Responses

Updated 4 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 4 months ago

Did this page help you?