Crear Vendedor POST

URL: https://api.painelalter.com/api/seller/create

Crea un nuevo vendedor y lo agrega a todas las tiendas informadas. El usuario del token debe tener acceso a todas las tiendas de alias_ids.

El vendedor se incluye en las metas en curso y futuras de cada tienda. Si isVezActive es verdadero, el vendedor también se inscribe en las filas de AlterVez de las tiendas que tienen el servicio.

Parámetros del Body

Parámetro	Tipo	Descripción
alias_ids	array	Lista con los IDs de alias (strings) de las tiendas a las que se agregará el vendedor. Debe contener al menos una tienda.
nameSeller	string	Nombre del vendedor.
seller_alias_id	string	ID de alias del vendedor. Debe ser único en cada tienda; si ya existe en alguna de las tiendas, la solicitud se rechaza con el estado 409 Conflict.
isVezActive [OPCIONAL]	boolean	Indica si el vendedor participa en AlterVez. Acepta true, false, 1 o 0. Por defecto: false.
onboardUtcDatetime [OPCIONAL]	string	Fecha y hora de ingreso del vendedor en las tiendas, en UTC. Formato YYYY-MM-DDTHH:mm:ss. Por defecto: fecha y hora actual.

TIP

Informe el seller_alias_id para poder consultar y editar el vendedor posteriormente con los demás endpoints de vendedores, que lo identifican por este campo.

Ejemplo de Body

{
  "alias_ids": ["TIENDA-10", "TIENDA-11"],
  "nameSeller": "Ana",
  "seller_alias_id": "VEND-001",
  "isVezActive": true,
  "onboardUtcDatetime": "2026-10-01T12:00:00"
}

Ejemplo de Respuesta

Status 201 Created

{
  "seller": {
    "alias_id": "VEND-001",
    "nameSeller": "Ana",
    "isVezActive": 1,
    "stores_alias_id": ["TIENDA-10", "TIENDA-11"]
  }
}