Cadastrar um fornecedor

Atualizado em 17 de outubro de 2026

Considerações

Exige o escopo suppliers:write e a permissão de criar em Fornecedores.
Só o name é obrigatório e ele é único: nome repetido responde 422.
A inscrição estadual (ie) é guardada só com números.
O cadastro é idempotente: envie um Idempotency-Key.

Referência

Como fazer

cURL

curl -X POST "$MICORE_BASE_URL/suppliers" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: request-2026-0001" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "TinTec",
    "name_pj": "TinTec Co., Ltd.",
    "email": "vendas@fornecedor.example",
    "observations": "Preços ExWorks Coreia"
}'

Resposta

Resposta · 201

{
  "data": {
    "id": 12,
    "name": "TinTec",
    "name_pj": "TinTec Co., Ltd.",
    "email": "vendas@fornecedor.example",
    "observations": "Preços ExWorks Coreia",
    "status": true
  }
}

Precisa de ajuda?Use o request ID e abra um chamado no miCore se encontrar uma divergência.