Atualizado em 17 de outubro de 2026

Considerações

  • Exige o escopo service-orders:write e a permissão Gestão de OS (editar) e Gestão de Pedidos (editar) do usuário responsável.
  • Altere com PATCH e remova com DELETE em /items/{item}.
  • OS com pedido vinculado não muda os itens (409).
  • Exige Idempotency-Key: repetir a chave com o mesmo corpo devolve o resultado original, sem repetir a operação.

Referência

POST /service-orders/{serviceOrder}/items na Referência da API

Como fazer

cURL
curl -X POST "$MICORE_BASE_URL/service-orders/1024/items" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: request-2026-0001" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": 77,
    "quantity": 1
}'

Resposta

Resposta · 201
{
    "data": {
        "id": 9012,
        "product": {
            "id": 482,
            "name": "Cabeça de impressão DX7",
            "type": "produto-fisico",
            "unit": "UN"
        },
        "quantity": 2,
        "currency": "BRL",
        "price": 350,
        "price_original": 420,
        "discount": 20,
        "unit_discount": 10,
        "total": 680,
        "is_kit_component": false,
        "kit_product": {
            "id": 77,
            "name": "Kit manutenção preventiva"
        },
        "order_id": 1,
        "created_at": "2026-10-20T10:00:00-03:00",
        "updated_at": "2026-10-20T10:00:00-03:00"
    }
}
Precisa de ajuda?Use o request ID e abra um chamado no miCore se encontrar uma divergência.