Criar uma Meta com Níveis POST

URL: https://api.painelalter.com/api/meta/tiered/create

Cria uma meta para uma loja com suporte a múltiplos níveis de faturamento, como meta e super meta.

Parâmetros do body

Parâmetro	Tipo	Descrição
alias_id	string	ID do alias da loja.
revenueTiers	array	Lista de níveis de meta de faturamento. Consulte a seção revenueTiers.
averageTicket	integer	Opcional (O sistema definirá uma meta de ticket médio automaticamente se não for informado). Ticket médio, representado como um inteiro com duas casas decimais virtuais.
conversionRatio	integer	Opcional (O sistema definirá uma meta de conversão automaticamente se não for informado). Taxa de conversão, representada como um inteiro com duas casas decimais virtuais.
upt	integer	Opcional. Unidades por transação (UPT/PA).
yearMonth	string	Opcional (usar isso ou período customizado com dateBegin e dateEnd). Mês e ano da meta no formato YYYY-MM.
dateBegin	string	Opcional (somente usado quando yearMonth não é fornecido). Data de início da meta no formato YYYY-MM-DD.
dateEnd	string	Opcional. (somente usado quando yearMonth não é fornecido). Data de fim da meta no formato YYYY-MM-DD.
title	string	Opcional quando há yearMonth e obrigatório com dateBegin e dateEnd. Título da meta. Exemplo: "Meta de Julho".

Os valores descritos como inteiros com duas casas decimais virtuais devem ser enviados sem o separador decimal. Por exemplo, 20000000 representa 200000,00.

revenueTiers

É um array em que cada item representa um nível de meta:

Propriedade	Tipo	Descrição
tierName	string	Nome do nível da meta.
integerValue	integer	Valor da meta, representado como um inteiro com duas casas decimais virtuais.
isMain	integer	Indica o nível principal. Aceita 1 para principal ou 0 para não principal. Ao menos um nível deve ser marcado com 1; a propriedade pode ser omitida nos demais níveis.

Inclua pelo menos um nível em revenueTiers e marque um deles como principal com isMain: 1.

Exemplo de Body

{
  "alias_id": "24581235",
  "revenueTiers": [
    {
      "tierName": "Meta",
      "integerValue": 20000000,
      "isMain": 1
    },
    {
      "tierName": "Super Meta",
      "integerValue": 25000000
    }
  ],
  "averageTicket": 14055,
  "conversionRatio": 2212,
  "upt": 124,
  "yearMonth": "2026-09"
}

Exemplo de Resposta

{
  "meta_id": 8886
}