API atual/Referência completa/Autenticação avançada

Aceitar convite de contador

Cria o acesso de um contador a partir do link de convite enviado pela loja.

A loja pode convidar o contador da empresa para baixar os arquivos fiscais e contábeis. O convite chega por e-mail com um link que contém um token de uso único. Esta rota é o passo final: o contador escolhe nome e senha e a plataforma cria o usuário dele.

O token já é a credencial, por isso a rota é pública. Ele vale uma vez, expira e pode ser revogado pela loja; qualquer um desses casos responde invite_invalid. Quem cria e revoga convites é o administrador da loja, no painel.

POST/api/v1/auth/accountant-invites/{token}/acceptPública

Aceitar o convite e criar o usuário contador

Parâmetros de caminho

tokenstringobrigatório

Token do link de convite, como recebido por e-mail.

Corpo da requisição

first_namestring

Nome do contador.

last_namestring

Sobrenome.

passwordstringobrigatório

Senha, mínimo de 8 caracteres.

Exemplo de requisição

bash

curl -X POST "$BASE_URL/api/v1/auth/accountant-invites/$INVITE_TOKEN/accept" \
  -H "Content-Type: application/json" \
  -d '{
  "first_name": "Carlos",
  "last_name": "Almeida",
  "password": "Contab#2026"
}'

Resposta

201Usuário criado

json

{
  "user_id": "3f0c2a54-7c1b-4d4e-9a52-1b6a8d0e7c11"
}

Campos da resposta

user_iduuid

Id do novo usuário (UUID).

Erros

Status	Quando	Exemplo de corpo
400	Corpo que não é JSON.	`{"error":"invalid_body","detail":"..."}`
400	Token desconhecido, já usado, revogado ou expirado.	`{"error":"invite_invalid","detail":"invite invalid or expired"}`
400	Senha curta demais ou outra falha ao criar.	`{"error":"accept_failed","detail":"password too short"}`
429	Limite de requisições da família `/auth/`.	`{"error":"rate limit exceeded","detail":"too many requests, please try again later"}`
503	Recurso de exportação contábil indisponível na loja.	`{"error":"accounting_unavailable","detail":"accounting export service not configured"}`

Veja também