Produto
POST
/erp-produto
atualiza: true, atualiza um produto existente.Inclusão ou atualização
tipo + codigo_produto.atualiza não é true: nada é alterado (204).atualiza: true: atualiza somente os campos enviados no produto base (204).Campos omitidos ou vazios não são alterados. Campos atualizáveis:
nome_produto,unidade_referencia, movimenta_estoque, indicativo_estoque, garantia_cl, garantia_fn,seguro, status, origem (ou cfpsr), cest e GTIN.As variantes existentes não são alteradas (peso, dimensões, referências, nome e situação
ficam como estão), com exceção do
GTIN, que é replicado para todas elas. A grade do produtonão é alterada pela atualização. Variantes novas enviadas em
variantes são incluídas.Código do produto
codigo_produto (ou envie %) para o ERP gerar o código automaticamente, conforme aparametrização de código do tipo do produto. Se o tipo não tiver geração automática configurada,
a requisição é recusada e o código deve ser enviado. Um código já usado por outro tipo de item é
recusado.
GTIN (código de barras)
de
variantes é ignorado (com aviso). Um GTIN já cadastrado em outro produto base é recusado.Grade (cor, tamanho etc.)
tipo_grade_1 / tipo_grade_2 (códigoscadastrados em Variantes do ERP) e liste em
variantes exatamente as combinações a criar,usando os códigos das variantes (ex.:
AZU, não AZUL). O ERP não gera a matriz completa.Produto com grade sem a lista
variantes é recusado. Sem grade, o produto recebe uma únicavariante padrão; duas variantes sem grade são a mesma variante (a segunda é ignorada, com aviso).
Avisos
GTIN informado na variante, variante repetida, CST ICMS não cadastrado) são devolvidos em
content.avisos no 201. Na atualização (204) não há corpo de resposta.O que o endpoint não faz
POST /erp-preco) e não dispara webhooks de produto.Requisição
Parâmetros Bodyapplication/jsonObrigatório
Respostas
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location '/erp-produto' \
--header 'WGX-API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"nome_produto": "Placa Sensor de Giro DS-18911-SF",
"id_classificacao_contabil": 1,
"tipo": "P",
"categoria": "00100",
"unidade_referencia": "UN",
"ncm": "85437099",
"cest": "0100100",
"marca": "HIKVISION",
"modelo": "DS-18911-SF",
"origem": "2",
"cst_icms": "00",
"cst_ibs_cbs": "000",
"cclastrib": "000001",
"GTIN": "7891234567918",
"referencia_fabricante": "DS-18911-SF",
"peso_bruto": 0.15,
"peso_liquido": 0.12,
"status": "PD"
}'Response Response Example
201 - Sucesso
{
"success": true,
"status": "CREATED",
"date": "2026-11-04T12:06:47.787189",
"contentType": "application/json",
"content": {
"status": "INSERTED",
"ipsr": "0011398",
"zk_bpsr": 27079,
"bpsi": {
"status": "INSERTED",
"ipsr": "0011398",
"ccst": "00",
"ufs": 6
},
"avisos": [],
"variantes": [
{
"status": "INSERTED",
"ipsv": "0011398000001",
"zk": 17005,
"ivar1": "AZU",
"ivar2": "P",
"npsv": "CAMISETA BASICA AZUL TAMANHO P"
},
{
"status": "INSERTED",
"ipsv": "0011398000002",
"zk": 17006,
"ivar1": "AZU",
"ivar2": "M",
"npsv": "CAMISETA BASICA AZUL TAMANHO M"
},
{
"status": "INSERTED",
"ipsv": "0011398000003",
"zk": 17007,
"ivar1": "VER",
"ivar2": "G",
"npsv": "CAMISETA BASICA VERMELHO TAMANHO G"
}
]
}
}Modificado em 2026-11-04 19:33:55