Criação de Lojas

Esta documentação apresenta o novo fluxo automatizado de criação de lojas no Plug4Market, permitindo que a SH tenha mais autonomia e independência no processo.

Atualmente, apenas usuários com perfil ADMIN têm permissão para realizar a criação de lojas, tanto via painel quanto via API.

Pré-requisitos

Antes de iniciar, verifique os seguintes pontos:

• O CNPJ da loja deve ser único no sistema.

• O e-mail do responsável deve ser único no sistema.

• Caso trabalhe com WhiteLabel, certifique-se que sua Software House já está devidamente configurada conosco.

A tentativa de cadastro com dados duplicados resultará em erro.

Criação de loja via painel:

A criação de lojas pelo painel da aplicação segue um formulário dividido em seções:

Acessando o painel no menu lateral esquerda Lojas> Novo:

• CNPJ
• Nome Fantasia
• Razão Social
• Inscrição Estadual
• Status (Ativo/Inativo)

Dados de Endereço

• CEP -  (Deve ser um CEP válido)
• Logradouro
• Número
• Complemento
• Bairro
• Cidade
• Estado

Dados do Responsável e Usuários Existentes do HUB

• Nome
• Email -  (Deve ser único) 
• Telefone

Usuários Existentes do HUB

• Emails: Vincule usuários que já estão cadastrados no HUB para terem acesso a esta loja

Loja criada com sucesso, serão enviados os dados de acesso por e-mail.

Criação de loja via API:

Autenticação

Geração do Token de Usuário

Nessa etapa, você utilizará o login e senha para gerar um token de autenticação.
Esse processo equivale a realizar o login no Painel de Monitoramento do Plug4Market, garantindo o acesso autorizado às demais rotas da API.

Endpoint de Login
 

Método

POST

Exemplo de Requisição

{
 "login": "tecnospeed@email.com",
 "password": "senha123"
}

Exemplo de Response:
 

{
 "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
 "user": {
   "id": "d10fd030-ef4a-4808-be6d-c621075fb7bf",
   "name": "Alisson",
   "role": "admin",
   "login": "alissondelporto@tecnospeed.com.br"
 }

Use o valor de accessToken no header Authorization das próximas requisições.

Criando a loja:

Após obter o token, utilize o endpoint abaixo para criar uma nova loja.

Endpoint
 

Exemplo de Requisição (cURL)

curl --location 'https://api.plug4market.com.br/stores' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ***' \
--data-raw '{
 "cnpj": "52936448000115",
 "tradingName": "Loja Exemplo Teste 13",
 "companyName": "Exemplo Comércio de Produtos LTDA",
 "stateRegistration": "123456789",
 "active": true,
 "address": {
   "cep": "01310-100",
   "street": "Avenida Paulista",
   "number": "1578",
   "complement": "Sala 101",
   "neighborhood": "Bela Vista",
   "city": "São Paulo",
   "state": "SP"
 },
 "responsible": {
   "name": "Teste",
   "email": "marcos.santos+20@tecnospeed.com.br",
   "phone": "(11) 98765-4321"
 },
 "hubUserEmails": [
   "usuario1@hub.com",
   "usuario2@hub.com"
   ]
}'

Estrutura do Payload