Skip to content

Crear una Meta con Niveles POST ​

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

Crea una meta para una tienda con soporte para múltiples niveles de facturación, como meta y super meta.

Parámetros del cuerpo ​

ParámetroTipoDescripción
alias_idstringID del alias de la tienda.
revenueTiersarrayLista de niveles de meta de facturación. Consulta la sección revenueTiers.
averageTicketintegerOpcional (el sistema definirá una meta de ticket promedio automáticamente si no se proporciona). Ticket promedio, representado como un entero con dos decimales implícitos.
conversionRatiointegerOpcional (el sistema definirá una meta de conversión automáticamente si no se proporciona). Tasa de conversión, representada como un entero con dos decimales implícitos.
uptintegerOpcional. Unidades por transacción (UPT).
yearMonthstringOpcional (usar esto o un período personalizado con dateBegin y dateEnd). Mes y año de la meta en formato YYYY-MM.
dateBeginstringOpcional (solo se usa cuando no se proporciona yearMonth). Fecha de inicio de la meta en formato YYYY-MM-DD.
dateEndstringOpcional (solo se usa cuando no se proporciona yearMonth). Fecha de fin de la meta en formato YYYY-MM-DD.
titlestringOpcional cuando se proporciona yearMonth y obligatorio con dateBegin y dateEnd. Título de la meta. Ejemplo: "Meta de julio".

Los valores descritos como enteros con dos decimales implícitos deben enviarse sin el separador decimal. Por ejemplo, 20000000 representa 200000,00.

revenueTiers ​

Es un array en el que cada elemento representa un nivel de meta:

PropiedadTipoDescripción
tierNamestringNombre del nivel de meta.
integerValueintegerValor de la meta, representado como un entero con dos decimales implícitos.
isMainintegerIndica el nivel principal. Acepta 1 para principal o 0 para no principal. Al menos un nivel debe marcarse con 1; la propiedad puede omitirse en los demás niveles.

Incluye al menos un nivel en revenueTiers y marca uno de ellos como principal con isMain: 1.

Ejemplo de cuerpo ​

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

Ejemplo de respuesta ​

json
{
  "meta_id": 8886
}