Planos e pré-cadastro — API WebSystem Provider

Listar planos ativos

GET/planosplanos:leitura

curl "$API/planos" -H "Authorization: Bearer $CHAVE"

{
  "sucesso": true,
  "dados": [
    { "id": 3, "nome": "300 Mega", "download_mbps": 300, "upload_mbps": 150, "valor": 99.9, "tecnologia": "FIBRA", "descricao": null }
  ]
}

Gerar link de pré-cadastro

POST/pre-cadastros/convitespre_cadastro:escrita

Gera o link do formulário de pré-cadastro do provedor. Envie o link ao interessado (por exemplo, no fim de uma conversa de vendas no chatbot): ele mesmo preenche os dados, e o cadastro entra no sistema como pré-cadastro, com as validações e os avisos de sempre para a equipe.

Corpo (opcional)

Campo	Descrição
`plano_id`	Plano já escolhido. Precisa estar ativo.
`dia_vencimento`	Dia de vencimento já escolhido (1 a 30).
`validade_dias`	Por quantos dias o link vale. Padrão 7, máximo 365.

curl -X POST "$API/pre-cadastros/convites" \
  -H "Authorization: Bearer $CHAVE" -H "Content-Type: application/json" \
  -d '{"plano_id": 3, "dia_vencimento": 10}'

{
  "sucesso": true,
  "dados": {
    "link": "https://painel.seuprovedor.com.br/pre-cadastro/9f2c...",
    "expira_em": "2026-10-20T15:00:00.000Z",
    "plano_id": 3,
    "dia_vencimento": 10
  }
}

A API não cria o cliente diretamente: o assinante confirma os próprios dados no formulário. Assim valem as mesmas regras do cadastro do provedor (documento único, maioridade, vencimentos permitidos, condições comerciais). Para acompanhar os cadastros que chegaram, consulte /clientes?situacao=pre_cadastro.

Recusa possível

HTTP	Código	Significado
422	`plano_invalido`	O plano não existe ou está inativo.