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ámetro | Tipo | Descripción |
|---|---|---|
alias_id | string | ID del alias de la tienda. |
revenueTiers | array | Lista de niveles de meta de facturación. Consulta la sección revenueTiers. |
averageTicket | integer | Opcional (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. |
conversionRatio | integer | Opcional (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. |
upt | integer | Opcional. Unidades por transacción (UPT). |
yearMonth | string | Opcional (usar esto o un período personalizado con dateBegin y dateEnd). Mes y año de la meta en formato YYYY-MM. |
dateBegin | string | Opcional (solo se usa cuando no se proporciona yearMonth). Fecha de inicio de la meta en formato YYYY-MM-DD. |
dateEnd | string | Opcional (solo se usa cuando no se proporciona yearMonth). Fecha de fin de la meta en formato YYYY-MM-DD. |
title | string | Opcional 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:
| Propiedad | Tipo | Descripción |
|---|---|---|
tierName | string | Nombre del nivel de meta. |
integerValue | integer | Valor de la meta, representado como un entero con dos decimales implícitos. |
isMain | integer | Indica 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
}
