Atualizado em 17 de outubro de 2026
Criar um produto
Cria um produto no catálogo. Reusa o mesmo serviço do painel e vale para todos os tipos.
Considerações
- Exige o escopo
products:writee a permissão de criar em Gestão de Produtos. - Obrigatórios:
typeename(os demais obrigatórios dependem do tipo e da configuração do tenant). - Campos por tipo —
compositions(kit, com preço por item),related_key_product_id(chave-codigo),subscription_id(assinatura). - Aceita também os textos da aba de informações, as fotos (
images) e o preço em dólar — veja a solução Textos, fotos e preço em dólar. - A compatibilidade com impressoras vai em
printer_model_id(lista de ids de modelos). - A criação é idempotente: envie um
Idempotency-Key; a mesma chave devolve o produto original por 24h. - Qualquer gravação desliga a sincronização com o Mercado Livre, como no painel.
Referência
POST /products na Referência da APIComo fazer
cURL
curl -X POST "$MICORE_BASE_URL/products" \
-H "Authorization: Bearer $MICORE_TOKEN" \
-H "Accept: application/json" \
-H "Idempotency-Key: request-2026-0001" \
-H "Content-Type: application/json" \
-d '{
"type": "produto-fisico",
"name": "Camiseta Básica",
"reference": "CAM-001",
"price": "79,90",
"warranty_days": 90,
"validity_days": 0,
"category_id": 4,
"unit_id": 1
}'
Resposta
Resposta · 201
{
"data": {
"id": 1203,
"name": "Camiseta Básica",
"reference": "CAM-001",
"type": "produto-fisico",
"status": true,
"price": 79.9
}
}
Precisa de ajuda?Use o request ID e abra um chamado no miCore se encontrar uma divergência.