Cenários práticos - Abertura de Conta PJ

Abertura de Conta Pessoa Jurídica (PJ)

Estrutura do array `owner`

Os campos do array owner devem ser utilizados para informar todos os sócios e/ou representantes da empresa que está realizando a abertura da conta.

⚠️
É obrigatório informar todos os sócios com mais de 25% de participação na sociedade, caso contrário a aprovação da conta será recusada.

Regras Gerais

O primeiro registro do array owner deve ser sempre uma Pessoa Física, pois será o responsável pelo processo de abertura da conta.

Essa Pessoa Física poderá ser:

um sócio da empresa (ownerType = "SOCIO"); ou
um representante legal (ownerType = "REPRESENTANTE"), quando não houver um sócio Pessoa Física.
Todos os demais sócios (Pessoa Física ou Pessoa Jurídica) devem ser enviados com:
- ownerType = "DEMAIS_SOCIOS".

Envio de documentos sem WebView

Quando o processo não utiliza WebView, todos os documentos deverão ser enviados diretamente no payload de abertura da conta, por meio do atributo files.

Exemplo:

"files": [ {
  "type": "RG_FRONT",
  "data": "https://exemplo.com/documento.png"
}
]

Campo type

Os seguintes tipos de documentos são aceitos:

Tipo	Descrição
CNH_FRONT CNH_BACK	Carteira Nacional de Habilitação (CNH)
RG_FRONT RG_BACK	Registro Nacional (RG)
RNE_FRONT RNE_BACK	Registro Nacional de Estrangeiro (RNE)
CONTRATO_SOCIAL	Contrato Social da empresa
DOCUMENTO_FINANCEIRO	Documentos financeiros
PROCURACAO_PODERES	Procuração que confere poderes a um Representante Legal
SELFIE	Fotografia do próprio rosto
COMPROVANTE_RENDA	Comprovante de renda
COMPROVANTE_RESIDENCIA	Comprovante de endereço
OUTROS	Outro documento relevante

Campo data

O campo data deve conter uma URL pública para download do documento correspondente ao tipo informado.

Requisitos:

A URL deve estar acessível no momento do processamento.
Recomendamos que a URL permaneça válida por, no mínimo, 1 hora.
Os formatos aceitos são PDF, PNG e JPEG.

📌
Observação:
O arquivo informado no campo data deve ser um único PDF, PGN ou JPEG contendo todos os documentos necessários para aquele envio. Caso existam múltiplos documentos, eles deverão ser previamente unidos (merge) pela aplicação cliente.

Cenários de preenchimento do payload e envio de documentação:

Cenário 1 – Empresa com 3 sócios Pessoa Física

Ordem	Tipo	ownerType	Observação
Owner 1	Pessoa Física	`SOCIO`	Sócio responsável pela abertura da conta e envio da documentação. Tanto da documentação pessoal dele, quanto da documentação da empresa. RG_FRONT ou CNH_FRONT RG_BACK ou CNH_BACK (se RG) SELFIE CONTRATO_SOCIAL (da empresa) COMPROVANTE_RESIDENCIA
Owner 2	Pessoa Física	`DEMAIS_SOCIOS`	Apenas dados cadastrais no payload. Nenhum documento adicional no campo files.
Owner 3	Pessoa Física	`DEMAIS_SOCIOS`	Apenas dados cadastrais no payload. Nenhum documento adicional no campo files.

// Cenário 1 — 3 sócios PF sem Webview
{
  "clientCode": "<CLIENT_CODE>",
  "contactNumber": "+5511985028123",
  "documentNumber": "<CNPJ_DA_EMPRESA>",
  "businessEmail": "[email protected]",
  "businessName": "Razão Social da Empresa",
  "tradingName": "Nome Fantasia",
  "companyType": "PJ",
  "onboardingType": "BAAS",
  "owner": [
    {
      "ownerType": "SOCIO",
      "documentNumber": "<CPF_SOCIO_1>",
      "fullName": "Nome Sócio 1",
      "phoneNumber": "+5511912345678",
      "email": "[email protected]",
      "motherName": "Nome da Mãe",
      "socialName": "Nome Social",
      "birthDate": "22-06-1972",
      "address": {
        "postalCode": "06455030",
        "street": "Rua do Teste",
        "number": "123",
        "addressComplement": "",
        "neighborhood": "Alphaville Industrial",
        "city": "Barueri",
        "state": "SP"
       },
       "isPoliticallyExposedPerson": false,    
       "financialOwnerDetails": {
        "ownerDeclaredIncome": "ODIB02" // Renda declarada em caso de sócio PF
      }
    },
    {
      "ownerType": "DEMAIS_SOCIOS", /* dados do sócio 2 */
      "documentNumber": "<CPF_SOCIO_21>",
      "fullName": "Nome Sócio 2",
      "phoneNumber": "+5511912345678",
      "email": "[email protected]",
      "motherName": "Nome da Mãe",
      "socialName": "Nome Social",
      "birthDate": "22-06-1972",
      "address": {
        "postalCode": "06455030",
        "street": "Rua do Teste",
        "number": "123",
        "addressComplement": "",
        "neighborhood": "Alphaville Industrial",
        "city": "Barueri",
        "state": "SP"
       },
       "isPoliticallyExposedPerson": false,    
       "financialOwnerDetails": {
        "ownerDeclaredIncome": "ODIB02" // Renda declarada em caso de sócio PF
      }
  },    {
      "ownerType": "DEMAIS_SOCIOS",
      "documentNumber": "<CPF_SOCIO_3>",
      "fullName": "Nome Sócio 3",
      "phoneNumber": "+5511912345678",
      "email": "[email protected]",
      "motherName": "Nome da Mãe",
      "socialName": "Nome Social",
      "birthDate": "22-06-1972",
      "address": {
        "postalCode": "06455030",
        "street": "Rua do Teste",
        "number": "123",
        "addressComplement": "",
        "neighborhood": "Alphaville Industrial",
        "city": "Barueri",
        "state": "SP"
       },
       "isPoliticallyExposedPerson": false,    
       "financialOwnerDetails": {
        "ownerDeclaredIncome": "ODIB02"// Renda declarada em caso de sócio PF
      }
    }
  ],
  "businessAddress": {
    "postalCode": "06454000",
    "street": "Alameda Rio Negro",
    "number": "503",
    "addressComplement": "sala 2020",
    "neighborhood": "Alphaville Centro Industrial",
    "city": "Barueri",
    "state": "SP" 
    },
 "onboardingType": "BAAS",
 "financialCompanyDetails": {
    "declaredCompanyRevenue": "DCRB03" //Faturamento anual declarado da empresa
    },
  "files": [
    {
      "type": "RG_FRONT",
      "data": "https://<URL_ACESSIVEL_DO_DOCUMENTO>" // URL com expiração mínima de 1 hora
    },
    {
      "type": "RG_BACK",
      "data": "https://<URL_ACESSIVEL_DO_DOCUMENTO>"
    },
    {
      "type": "SELFIE",
      "data": "https://<URL_ACESSIVEL_DO_DOCUMENTO>"
    },
    {
      "type": "CONTRATO_SOCIAL",
      "data": "https://<URL_ACESSIVEL_DO_DOCUMENTO>"
    },
    {
      "type": "COMPROVANTE_RESIDENCIA",
      "data": "https://<URL_ACESSIVEL_DO_DOCUMENTO>"
    }
  ]
}

Cenário 2 – Empresa com 1 sócio Pessoa Física e 1 sócio Pessoa Jurídica

Ordem	Tipo	ownerType	Observação
Owner 1	Pessoa Física	`SOCIO`	Sócio responsável pela abertura da conta e envio da documentação. RG_FRONT ou CNH_FRONT RG_BACK ou CNH_BACK (se RG) SELFIE CONTRATO_SOCIAL (empresa que abre a conta + empresa sócia em um único PDF/PNG/JPEG) COMPROVANTE_RESIDENCIA
Owner 2	Pessoa Jurídica	`DEMAIS_SOCIOS`	Inserir os dados da empresa sócia. O contrato social já foi incluído no campo files do Owner 1. Não é necessário informar os sócios internos da empresa PJ sócia.

Exemplo de payload

// Cenário 2 — 1 PF + 1 PJ sem Webview
{
  "clientCode": "<CLIENT_CODE>",
  "contactNumber": "+5511985028123",
  "documentNumber": "<CNPJ_DA_EMPRESA>",
  "businessEmail": "[email protected]",
  "businessName": "Razão Social da Empresa",
  "tradingName": "Nome Fantasia",
  "companyType": "PJ",
  "onboardingType": "BAAS",
  "owner": [
    {
      "ownerType": "SOCIO",
      "documentNumber": "<CPF_SOCIO_1>",
      "fullName": "Nome Sócio 1",
      "phoneNumber": "+5511912345678",
      "email": "[email protected]",
      "motherName": "Nome da Mãe",
      "socialName": "Nome Social",
      "birthDate": "22-06-1972",
      "address": {
        "postalCode": "06455030",
        "street": "Rua do Teste",
        "number": "123",
        "addressComplement": "",
        "neighborhood": "Alphaville Industrial",
        "city": "Barueri",
        "state": "SP"
       },
       "isPoliticallyExposedPerson": false,    
       "financialOwnerDetails": {
        "ownerDeclaredIncome": "ODIB02" // Renda declarada em caso de sócio PF
      }
    },
    {
      "ownerType": "DEMAIS_SOCIOS",
      "documentNumber": "<CNPJ_SOCIO_PJ>",
      "fullName": "Razão Social da Empresa Sócia",
      "phoneNumber": "+5511912345678",
      "email": "[email protected]",
      "motherName": "nao se aplica",
      "socialName": "nao se aplica",
      "birthDate": "22-06-1972",//Data de abertura da empresa
      "address": {
        "postalCode": "06455030",
        "street": "Rua do Teste",
        "number": "123",
        "addressComplement": "",
        "neighborhood": "Alphaville Industrial",
        "city": "Barueri",
        "state": "SP"
       },
       "isPoliticallyExposedPerson": false,    
       "financialOwnerDetails": {
        "ownerDeclaredRevenue": "ODRB02"// Faturamento declarado em caso de sócio PJ
      }
    }
  ],
  "businessAddress": {
    "postalCode": "06454000",
    "street": "Alameda Rio Negro",
    "number": "503",
    "addressComplement": "sala 2020",
    "neighborhood": "Alphaville Centro Industrial",
    "city": "Barueri",
    "state": "SP" 
    },
 "onboardingType": "BAAS",
 "financialCompanyDetails": {
    "declaredCompanyRevenue": "DCRB03" //Faturamento anual declarado da empresa
    },
  "files": [
    {
      "type": "RG_FRONT",
      "data": "https://<URL_ACESSIVEL_DO_DOCUMENTO>" // URL com expiração mínima de 1 hora
    },
    {
      "type": "RG_BACK",
      "data": "https://<URL_ACESSIVEL_DO_DOCUMENTO>"
    },
    {
      "type": "SELFIE",
      "data": "https://<URL_ACESSIVEL_DO_DOCUMENTO>"
    },
    {
      "type": "CONTRATO_SOCIAL",  // Todos os contratos sociais consolidados em 1 documento
      "data": "https://<URL_ACESSIVEL_DO_DOCUMENTO>"
    },
    {
      "type": "COMPROVANTE_RESIDENCIA",
      "data": "https://<URL_ACESSIVEL_DO_DOCUMENTO>"
    }
  ]
}

📘
Contratos sociais de sócios PJ
Quando há sócios PJ, envie todos os contratos sociais:

Da empresa que está abrindo a conta e

Da empresa sócia.

Use "type": "CONTRATO_SOCIAL" com um PDF, PNG ou JPEG consolidado.

Cenário 3 – Empresa com 2 sócios Pessoa Jurídica (que serve para casos com 3 ou mais sócios também)

📌
Observação:
Como todos os sócios são Pessoas Jurídicas, é obrigatório informar uma pessoa física como representante legal da empresa, no primeiro registro do array.

Ordem	Tipo	ownerType	Observação
Owner 1	Pessoa Física	`REPRESENTANTE`	Representante legal responsável pela abertura da conta e envio da documentação. RG_FRONT ou CNH_FRONT RG_BACK ou CNH_BACK (se RG) SELFIE PROCURACAO_PODERES (necessário em caso de REPRESENTANTE) CONTRATO_SOCIAL (empresa principal + PJ 1 + PJ 2 em único documento) COMPROVANTE_RESIDENCIA
Owner 2	Pessoa Jurídica	`DEMAIS_SOCIOS`	Apenas dados cadastrais da empresa sócia no payload. Não é necessário informar os sócios (PF ou PJ) das empresas sócias — apenas as próprias empresas sócias.
Owner 3	Pessoa Jurídica	`DEMAIS_SOCIOS`	Apenas dados cadastrais da empresa sócia no payload. Não é necessário informar os sócios (PF ou PJ) das empresas sócias — apenas as próprias empresas sócias.

Exemplo de payload

// Cenário 3 — 2 sócios PJ sem Webview
{
  "clientCode": "<CLIENT_CODE>",
  "contactNumber": "+5511985028123",
  "documentNumber": "<CNPJ_DA_EMPRESA>",
  "businessEmail": "[email protected]",
  "businessName": "Razão Social da Empresa",
  "tradingName": "Nome Fantasia",
  "companyType": "PJ",
  "onboardingType": "BAAS",
  "owner": [
    {
      "ownerType": "REPRESENTANTE",
      "documentNumber": "<CPF_REPRESENTANTE>",
      "fullName": "Nome do Representante Legal",
      "phoneNumber": "+5511912345678",
      "email": "[email protected]",
      "motherName": "Nome da Mãe",
      "socialName": "Nome Social",
      "birthDate": "22-06-1972",
      "address": {
        "postalCode": "06455030",
        "street": "Rua do Teste",
        "number": "123",
        "addressComplement": "",
        "neighborhood": "Alphaville Industrial",
        "city": "Barueri",
        "state": "SP"
       },
       "isPoliticallyExposedPerson": false,    
       "financialOwnerDetails": {
        "ownerDeclaredIncome": "ODIB02" // Renda declarada em caso de sócio PF
      }
    },
    {
      "ownerType": "DEMAIS_SOCIOS",
      "documentNumber": "<CNPJ_SOCIO_PJ1>",
      "fullName": "Razão Social da Empresa Sócia1",
      "phoneNumber": "+5511912345678",
      "email": "[email protected]",
      "motherName": "nao se aplica",
      "socialName": "nao se aplica",
      "birthDate": "22-06-1972",//Data de abertura da empresa
      "address": {
        "postalCode": "06455030",
        "street": "Rua do Teste",
        "number": "123",
        "addressComplement": "",
        "neighborhood": "Alphaville Industrial",
        "city": "Barueri",
        "state": "SP"
       },
       "isPoliticallyExposedPerson": false,    
       "financialOwnerDetails": {
        "ownerDeclaredRevenue": "ODRB02"// Faturamento declarado em caso de sócio PJ
      }
    },
    {
      "ownerType": "DEMAIS_SOCIOS",
      "documentNumber": "<CNPJ_SOCIO_PJ2>",
      "fullName": "Razão Social da Empresa Sócia 2",
      "phoneNumber": "+5511912345678",
      "email": "[email protected]",
      "motherName": "nao se aplica",
      "socialName": "nao se aplica",
      "birthDate": "22-06-1972",//Data de abertura da empresa
      "address": {
        "postalCode": "06455030",
        "street": "Rua do Teste",
        "number": "123",
        "addressComplement": "",
        "neighborhood": "Alphaville Industrial",
        "city": "Barueri",
        "state": "SP"
       },
       "isPoliticallyExposedPerson": false,    
       "financialOwnerDetails": {
        "ownerDeclaredRevenue": "ODRB02"// Faturamento declarado em caso de sócio PJ
      }
    }
  ],
  "businessAddress": {
    "postalCode": "06454000",
    "street": "Alameda Rio Negro",
    "number": "503",
    "addressComplement": "sala 2020",
    "neighborhood": "Alphaville Centro Industrial",
    "city": "Barueri",
    "state": "SP" 
    },
 "onboardingType": "BAAS",
 "financialCompanyDetails": {
    "declaredCompanyRevenue": "DCRB03" //Faturamento anual declarado da empresa
    },
  "files": [
    {
      "type": "RG_FRONT",
      "data": "https://<URL_ACESSIVEL_DO_DOCUMENTO>" // URL com expiração mínima de 1 hora
    },
    {
      "type": "RG_BACK",
      "data": "https://<URL_ACESSIVEL_DO_DOCUMENTO>"
    },
    {
      "type": "SELFIE",
      "data": "https://<URL_ACESSIVEL_DO_DOCUMENTO>"
    },
    {
      "type": "PROCURACAO_PODERES",
      "data": "https://<URL_ACESSIVEL_DO_DOCUMENTO>"
    },    
    {
      "type": "CONTRATO_SOCIAL",  // Contratos das 3 empresas consolidados em 1 documento
      "data": "https://<URL_ACESSIVEL_DO_DOCUMENTO>"
    },
    {
      "type": "COMPROVANTE_RESIDENCIA",
      "data": "https://<URL_ACESSIVEL_DO_DOCUMENTO>"
    }
  ]
}

📘
Contratos sociais de sócios PJ
Quando há sócios PJ, envie todos os contratos sociais:

Da empresa que está abrindo a conta;

Da primeira empresa sócia;

Da segunda empresa sócia.

Use "type": "CONTRATO_SOCIAL" com um PDF, PNG ou JPEG consolidado.

E caso aquele sócio PJ por sua vez tenha outros sócios PJ, vai ser necessário enviar também o contrato deste outro sócio PJ, até que seja possível identificar a Pessoa Física que seja o beneficiário final.
Não é necessário enviar nenhum documento dos beneficiários finais, somente as documentações necessárias que permitam a Celcoin conhecer os beneficiários finais das empresas, sempre respeitando a regra dos 25% ou mais de participação na sociedade.

⚠️
Regra de profundidade de sócios:
Não é necessário informar os sócios dos sócios PJ. Mesmo que a empresa sócia tenha uma cadeia de beneficiários, basta informar a empresa sócia direta no payload.
A informação a respeito do sócio dos sócios deverá ser apenas enviada a documentação societária.

Abertura de Conta Pessoa Jurídica (PJ)

Estrutura do array owner

É obrigatório informar todos os sócios com mais de 25% de participação na sociedade, caso contrário a aprovação da conta será recusada.

Envio de documentos sem WebView

Observação:

Cenários de preenchimento do payload e envio de documentação:

Contratos sociais de sócios PJ

Observação:

Contratos sociais de sócios PJ

Regra de profundidade de sócios:

Estrutura do array `owner`