Criar uma meta da empresa ou de time

Atualizado em 17 de outubro de 2026

Considerações

Exige o escopo objectives:write, a permissão Metas e Idempotency-Key.
owner_scope: empresa dispensa quadro e time. owner_scope: time exige team_id (veja os times em /teams); o board_id é opcional e serve para as tarefas da meta.
O responsável precisa ser do time, na meta de time.
Metas de time ou de quadro podem somar numa meta da empresa: informe parent_id (a meta maior) e parent_weight (quanto esta pesa nela, em %). A meta maior soma as filhas pelo peso; o resto até 100 é da medida própria dela.
Métricas por indicador (source: indicator) contam os números do sistema sem lançamento: ex.: crm.won_deals (negócios ganhos) e finance.received (valor recebido). Indicador de um módulo que a empresa não tem não aparece.

Referência

Como fazer

Meta da empresa medida por um indicador do Financeiro:

cURL

curl -X POST "$MICORE_BASE_URL/objectives" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: request-2026-0001" \
  -H "Content-Type: application/json" \
  -d '{
    "owner_scope": "empresa",
    "name": "Faturamento recebido em 2026",
    "type": "resultado",
    "priority": "critica",
    "visibility": "empresa",
    "date_start": "2026-01-01",
    "date_end": "2026-12-31",
    "metrics": [
        {
            "name": "Valor recebido",
            "source": "indicator",
            "indicator_key": "finance.received",
            "target_value": 1200000,
            "unit": "R$"
        }
    ]
}'

Meta do time comercial que soma na meta da empresa:

cURL

curl -X POST "$MICORE_BASE_URL/objectives" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: request-2026-0001" \
  -H "Content-Type: application/json" \
  -d '{
    "owner_scope": "time",
    "team_id": 3,
    "name": "Negócios ganhos no trimestre",
    "type": "resultado",
    "date_start": "2026-10-01",
    "date_end": "2026-12-31",
    "responsible_id": 7,
    "parent_id": 90,
    "parent_weight": 40,
    "participant_ids": [
        7,
        12
    ],
    "metrics": [
        {
            "name": "Negócios ganhos",
            "source": "indicator",
            "indicator_key": "crm.won_deals",
            "target_value": 30,
            "count_scope": "participantes"
        }
    ]
}'

Resposta

Resposta · 201

{
    "data": {
        "id": 90,
        "name": "Faturamento recebido em 2026",
        "type": "resultado",
        "priority": "critica",
        "owner_scope": "empresa",
        "team": null,
        "visibility": "empresa",
        "parent": null,
        "progress_mode": "metricas",
        "routine": null,
        "bands": {
            "partial_from": 80,
            "exceeded_from": 120
        },
        "checkin": {
            "cadence": null,
            "weekday": null
        },
        "alerts": null,
        "on_complete": null,
        "participants": [],
        "milestones": [],
        "confirmation": null,
        "recurrence": null,
        "recurrence_name": null,
        "recurrence_source_id": null,
        "description": null,
        "achievement_criteria": null,
        "board": null,
        "responsible": null,
        "date_start": "2026-01-01",
        "date_end": "2026-12-31",
        "status": "em_andamento",
        "situation": "at_risk",
        "progress": {
            "percent": 78,
            "achievement": 78,
            "suggested_result": "nao_atingida",
            "source": "metrics"
        },
        "pace": {
            "elapsed_percent": 86,
            "ideal_percent": 86,
            "days_left": 49,
            "days_total": 365,
            "days_elapsed": 316,
            "projection_percent": 90,
            "achievement": 78
        },
        "closure": null,
        "metrics": [
            {
                "id": 150,
                "name": "Valor recebido",
                "source": "indicator",
                "integration_key": null,
                "indicator_key": "finance.received",
                "indicator_filters": null,
                "direction": "aumentar",
                "baseline_value": null,
                "tolerance_min": null,
                "tolerance_max": null,
                "weight": null,
                "count_scope": null,
                "target_value": 1200000,
                "current_value": 936000,
                "unit": "R$",
                "percent": 78,
                "task_template_id": null,
                "user_id": null,
                "frequency": null,
                "frequency_target": null,
                "updated_at": "2026-11-12T09:00:00-03:00"
            }
        ],
        "created_at": "2026-11-13T09:00:00-03:00",
        "updated_at": "2026-11-13T09:00:00-03:00"
    }
}

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