Etapa 3: Envio de Documentos PJ / Step 3: Legal Entity (PJ) Documents Upload¶

📌 Visão Geral / Overview¶

Agora você deve enviar os documentos da empresa e dos sócios responsáveis com validação automática.

Now you must submit the company and the responsible partners' documents with automatic validation.

Endpoint: `POST /v1/partner/public/clients/update-documents-pj`¶

📄 Estrutura de Documentos Obrigatórios / Mandatory Documents Structure¶

[!WARNING] IMPORTANTE / IMPORTANT

O endpoint aceita uma estrutura complexa de documentos incluindo contrato social e documentos dos sócios responsáveis.

The endpoint accepts a complex document structure including the articles of incorporation (social contract) and the responsible partners' documents.

Contrato Social (Obrigatório) / Articles of Incorporation (Mandatory)

Campo / Field	Tipo / Type	Formato / Format	Tamanho Máximo / Max Size	Obrigatório / Required
`socialContract.clientId`	string	-	Max 450 chars	✅
`socialContract.file`	file	PDF, JPEG, JPG, PNG	5MB	✅

Documentos dos Sócios (Obrigatório) / Partners' Documents (Mandatory)

Campo / Field	Tipo / Type	Formato / Format	Tamanho Máximo / Max Size	Obrigatório / Required
`companyResponsibles`	array	-	-	✅ (Min 1 item)
`companyResponsibles[].clientId`	string	-	Max 450 chars	✅
`companyResponsibles[].file`	file	PDF, JPEG, JPG, PNG	5MB	✅

⚙️ Validações de Arquivo / File Validations¶

Validação / Validation	Regra / Rule	Descrição / Description
Tamanho / Size	< 5MB (5.242.880 bytes)	Arquivo não pode exceder 5MB File cannot exceed 5MB
Formato / Format	PDF, JPEG, JPG, PNG	Apenas formatos específicos aceitos Only specific formats accepted
Presença / Presence	Obrigatório / Mandatory	Arquivo deve estar presente File must be present

💻 Exemplo de Requisição / Request Example¶

cURL

POST /v1/partner/public/clients/update-documents-pj
Content-Type: multipart/form-data

{
  "socialContract": {
    "clientId": "PJ_def456ghi789",
    "file": [arquivo_contrato_social.pdf]
  },
  "companyResponsibles": [
    {
      "clientId": "PJ_def456ghi789",
      "file": [arquivo_rg_frente_joao.jpg]
    },
    {
      "clientId": "PJ_def456ghi789",
      "file": [arquivo_rg_verso_joao.jpg]
    },
    {
      "clientId": "PJ_def456ghi789",
      "file": [arquivo_comprovante_joao.pdf]
    }
  ]
}

Resposta de Sucesso / Success Response¶

JSON

{
  "success": true,
  "data": {
    "socialContract": {
      "clientId": "PJ_def456ghi789",
      "documentId": "DOC_123456",
      "status": "uploaded",
      "uploadDate": "2024-01-15T10:30:00Z"
    },
    "companyResponsibles": [
      {
        "documentId": "DOC_789012",
        "status": "uploaded",
        "uploadDate": "2024-01-15T10:31:00Z"
      },
      {
        "documentId": "DOC_345678",
        "status": "uploaded",
        "uploadDate": "2024-01-15T10:32:00Z"
      }
    ],
    "seeAwayProposalId": "PROP_789012345",
    "overallStatus": "documents_received"
  }
}

📑 Documentos Recomendados / Recommended Documents¶

Para completar o processo KYB, recomenda-se enviar os seguintes documentos:

To complete the KYB process, we recommend sending the following documents:

Contrato Social: / Articles of Incorporation:

Contrato Social Atualizado (PDF preferível) 1. Updated Articles of Incorporation (PDF preferred)

Para cada Sócio Responsável: / For each Responsible Partner:

RG ou CNH (frente e verso no mesmo documento) 1. ID or Driver's License (front and back in the same document)**

➡️ Próximos Passos / Next Steps¶

Após o envio dos documentos, o processo segue automaticamente para a Etapa 4: Aprovação KYB onde será realizada a validação completa.

After submitting the documents, the process automatically proceeds to Step 4: KYB Approval, where full validation will be performed.

[!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 true 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.