Criar Vendedor POST

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

Cria um novo vendedor e o adiciona a todas as lojas informadas. O usuário do token deve ter acesso a todas as lojas de alias_ids.

O vendedor é incluído nas metas em andamento e futuras de cada loja. Se isVezActive for verdadeiro, o vendedor também é inscrito nas filas do AlterVez das lojas que possuem o serviço.

Parâmetros do Body

Parâmetro	Tipo	Descrição
alias_ids	array	Lista com os IDs de alias (strings) das lojas em que o vendedor será adicionado. Deve conter ao menos uma loja.
nameSeller	string	Nome do vendedor.
seller_alias_id	string	ID do alias do vendedor. Deve ser único em cada loja; caso já exista em alguma das lojas, a requisição é rejeitada com status 409 Conflict.
isVezActive [OPCIONAL]	boolean	Indica se o vendedor participa do AlterVez. Aceita true, false, 1 ou 0. Padrão: false.
onboardUtcDatetime [OPCIONAL]	string	Data e hora de entrada do vendedor nas lojas, em UTC. Formato YYYY-MM-DDTHH:mm:ss. Padrão: data e hora atual.

TIP

Informe o seller_alias_id para poder consultar e editar o vendedor posteriormente pelos demais endpoints de vendedores, que o identificam por esse campo.

Exemplo de Body

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

Exemplo de Resposta

Status 201 Created

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