US01 - Criar endpoint de cadastro de usuário empresa

[Iewandowski]

Contrato REST API - Cadastro de Empresa

Visão Geral

API RESTful para cadastro e gerenciamento de usuários surdos no sistema PointTils - plataforma de agendamento de intérpretes de Libras.

Base URL: https://api.pointtils.com/v1

---

POST /enterprise-users/register

Registrar empresa que atende usuários surdos.

Request Body:

{
  "corporate_reason": "Empresa Inclusiva LTDA",
  "cnpj": "12345678000123",
  "email": "contato@empresainclusiva.com",
  "password": "senhaEmpresa123",
  "phone": "1133333333",
  "picture": "base64_encoded_logo",
  "status": "pending_verification",
  "type": "enterprise",
  "location": {
    "uf": "SP",
    "city": "São Paulo"
  },
  "accessibility_features": [
    "interprete_libras",
    "legenda_automatica",
    "videoconferencia_acessivel"
  ],
  "contact_person": {
    "name": "Ana Silva",
    "role": "Coordenadora de Acessibilidade",
    "phone": "11944444444",
    "email": "ana.silva@empresainclusiva.com"
  }
}

Responses:

• 201 Created - Empresa registrada com sucesso

  {
    "success": true,
    "message": "Empresa cadastrada com sucesso",
    "data": {
      "enterprise": {
        "id": 456,
        "corporate_reason": "Empresa Inclusiva LTDA",
        "cnpj": "12.345.678/0001-23",
        "email": "contato@empresainclusiva.com",
        "type": "enterprise",
        "status": "pending_verification",
        "phone": "1133333333",
        "picture": "https://storage.pointtils.com/logos/456.jpg",
        "location": {
          "id": 789,
          "uf": "SP",
          "city": "São Paulo"
        },
        "accessibility_features": [
          "interprete_libras",
          "legenda_automatica",
          "videoconferencia_acessivel"
        ],
        "contact_person": {
          "name": "Ana Silva",
          "role": "Coordenadora de Acessibilidade",
          "phone": "11944444444",
          "email": "ana.silva@empresainclusiva.com"
        },
        "created_at": "2025-08-26T10:00:00Z"
      }
    }
  }

• 400 Bad Request - Dados inválidos
• 409 Conflict - CNPJ ou email já existem
• 422 Unprocessable Entity - Validação falhou