Produtos V2

⚠️
Importante
Anteriormente, para associar grades era necessário informar nos atributos grade_cores e grade_tamanhos (as cores e tamanhos disponíveis) como mostra no exemplo de JSON de POST. Agora, usamos o campo produtos_grade.

Estrutura da Resposta (GET)

Campo	Tipo	Descrição
id	Integer	Identificador único.
codigo	String: 50	Código de referência do produto.
nome	String: 100	Nome do produto.
comissao	Double	Comissão do produto. Ex: `5.0` para 5%. Informe `null` caso não queira calcular comissões pela Mercos.
preco_tabela	Double	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).
ipi	Double	Valor do IPI. Caso não possua, informe `null`.
tipo_ipi	String: 1	Tipo do IPI do produto: `"P"` para percentual, `"V"` para valor fixo em Reais.
st	Double	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`.
grade_cores (depreciado)	Lista	Lista de cores (String: 50) disponíveis. Caso não trabalhe com variação de cores, informe `null`.
grade_tamanhos (depreciado)	Lista	Lista de tamanhos (String: 50) disponíveis. Caso não trabalhe com variação de tamanhos, informe `null`.
moeda	String: 1	Moeda do produto: Real (`"0"`), Dólar (`"1"`) ou Euro (`"2"`).
unidade	String: 10	Unidade de medida do produto. Ex: `"Kg"` ou `"Cx"`. Opcional.
saldo_estoque	Double: 7	Saldo de estoque do produto. Valor máximo suportado: `9999999.99`
observacoes	String: 5000	Utilize para guardar quaisquer informações que não tenham campos específicos.
ultima_alteracao	DateTime	Data e hora da última modificação deste produto na Mercos.
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	Double	Múltiplo de venda do produto.
peso_bruto	Double	Peso bruto do produto em kg (até 3 casas decimais).
largura	Double	Largura da embalagem em centímetros (até 5 casas decimais).
altura	Double	Altura da embalagem em centímetros (até 5 casas decimais).
comprimento	Double	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 `0`. (`1` = unitário, `0` = não unitário)
exibir_no_b2b	Boolean	Indica se o produto é exibido no e-commerce B2B. (`1` = exibido, `0` = não exibido)
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	Lista	Lista de produtos grade que o produto possui.

Parâmetros de Envio — Produto Simples (POST / PUT)

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

Campo	Tipo	Descrição
codigo	String: 50	Código de referência do produto.
nome (obrigatório)	String: 100	Nome do produto.
comissao	Double	Comissão do produto. Ex: `5.0` para 5%. Informe `null` caso não queira calcular comissões pela Mercos.
preco_tabela (obrigatório)	Double	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).
ipi	Double	Valor do IPI. Caso não possua, informe `null`.
tipo_ipi	String: 1	Tipo do IPI do produto: `"P"` para percentual, `"V"` para valor fixo em Reais.
st	Double	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`.
grade_cores (depreciado)	Lista	Lista de cores (String: 50) disponíveis. Caso não trabalhe com variação de cores, informe `null`.
grade_tamanhos (depreciado)	Lista	Lista de tamanhos (String: 50) disponíveis. Caso não trabalhe com variação de tamanhos, informe `null`.
moeda	String: 1	Moeda do produto: Real (`"0"`), Dólar (`"1"`) ou Euro (`"2"`).
unidade	String: 10	Unidade de medida do produto. Ex: `"Kg"` ou `"Cx"`. Opcional.
saldo_estoque	Double: 7	Saldo de estoque do produto. Valor máximo suportado: `9999999.99`
observacoes	String: 5000	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	Double	Múltiplo de venda do produto.
peso_bruto	Double	Peso bruto do produto em kg (até 3 casas decimais).
largura	Double	Largura da embalagem em centímetros (até 5 casas decimais).
altura	Double	Altura da embalagem em centímetros (até 5 casas decimais).
comprimento	Double	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	Lista	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.