Etapa 1: Registro Inicial da Empresa / Step 1: Initial Company Registration

📌 Visão Geral / Overview

O primeiro passo é criar o registro básico da empresa no sistema com os dados essenciais para identificação.

The first step is to create the basic company registration in the system with the essential data for identification.

---

🔐 Autenticação / Authentication

Todos os endpoints desta API requerem os seguintes headers obrigatórios:

All endpoints in this API require the following mandatory headers:

Authorization: Bearer {seu_jwt_token}
Role: ADMIN_PARTNER
x-api-key: {guid_individualizado_do_parceiro}
Accept-Language: {pt-br | en-us | es-es}

[!WARNING] IMPORTANTE / IMPORTANT

Todos os headers acima são obrigatórios em todas as requisições. A falta de qualquer um deles resultará em erro de autenticação.

All the above headers are mandatory in all requests. Missing any of them will result in an authentication error.

---

Endpoint: POST /v1/partner/public/clients/create-pj

Dados Obrigatórios / Mandatory Data

Campo / Field	Tipo / Type	Obrigatório / Required	Validação / Validation	Descrição / Description
document	string	✅	14 dígitos 14 digits	CNPJ da empresa (apenas números) Company CNPJ (numbers only)
name	string	✅	Max 255 chars	Nome do contato principal na empresa Main contact name at the company
phoneNumber	string	✅	Formato brasileiro Brazilian format	Telefone de contato com DDD Contact phone with area code
email	string	✅	Formato email Email format	Email principal de contato Main contact email
additionalEmails	array	✅	Min 1 item	Lista de emails adicionais (pelo menos 1 obrigatório) List of additional emails (at least 1 required)

[!WARNING] ATENÇÃO / ATTENTION

É obrigatório fornecer pelo menos um email adicional na lista additionalEmails durante o registro inicial.

It is mandatory to provide at least one additional email in the additionalEmails list during the initial registration.

---

Exemplo de Requisição / Request Example

JSON

{
  "document": "12345678000123",
  "name": "Maria Silva Santos",
  "phoneNumber": "(11) 99999-8888",
  "email": "maria.silva@empresaexemplo.com.br",
  "additionalEmails": [
    {
      "email": "financeiro@empresaexemplo.com.br"
    },
    {
      "email": "contabilidade@empresaexemplo.com.br"
    }
  ]
}

Resposta de Sucesso / Success Response

JSON

{
  "success": true,
  "data": {
    "clientId": "PJ_def456ghi789",
    "document": "12345678000123",
    "name": "Maria Silva Santos",
    "phoneNumber": "(11) 99999-8888",
    "email": "maria.silva@empresaexemplo.com.br",
    "additionalEmails": [
      {
        "id": 1,
        "email": "financeiro@empresaexemplo.com.br"
      },
      {
        "id": 2,
        "email": "contabilidade@empresaexemplo.com.br"
      }
    ]
  }
}

[!WARNING] IMPORTANTE / IMPORTANT

Guarde o clientId retornado! Ele será usado em todas as próximas etapas.

Save the returned clientId! It will be used in all subsequent steps.

---

Possíveis Erros / Possible Errors

CNPJ Inválido / Invalid CNPJ

JSON

{
  "success": false,
  "errors": ["CNPJ inválido ou já cadastrado no sistema"]
}

Email Adicional Obrigatório / Required Additional Email

JSON

{
  "success": false,
  "errors": ["Pelo menos um email adicional é obrigatório"]
}

Email Duplicado / Duplicate Email

JSON

{
  "success": false,
  "errors": ["Email já está sendo utilizado por outro cliente"]
}

Próximos Passos / Next Steps

Após completar o registro inicial, prossiga para a Etapa 2: Atualização de Dados Completos para fornecer informações detalhadas da empresa e sócios.

After completing the initial registration, proceed to Step 2: Complete Data Update to provide detailed information about the company and partners.

[!WARNING] LEMBRE-SE / REMEMBER

Este é um processo regulamentado. Todos os dados fornecidos devem ser verdadeiros e atualizados. Informações falsas podem resultar em bloqueio permanente da conta e notificação aos órgãos competentes.

This is a regulated process. All data provided must be accurate and up-to-date. False information may result in permanent account suspension and notification to the competent authorities.

[!NOTE] SUPORTE / SUPPORT

Em caso de dúvidas sobre regulamentações ou requisitos específicos, entre em contato com nossa equipe de compliance através do canal de suporte dedicado.

If you have any questions regarding regulations or specific requirements, please contact our compliance team through the dedicated support channel.