> ## Documentation Index
> Fetch the complete documentation index at: https://bmpdocs.moneyp.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# 80 - Envio de Documentos

> <p>Scopes:</p>
<b>api.ext api.onboarding.conta.inserirdocumento</b>

Utilize essa requisição para enviar os documentos dos responsáveis informados na abertura de contas.

Em caso de PJ, títular e sócios.

<Expandable title="Mensagens de requisições com erro">
  O retorno de uma requisição com status HTTP 400 (Bad Request) pode incluir as seguintes mensagens de erro:

  | Endpoint                                      | Mensagem de erro                                                  |
  | --------------------------------------------- | ----------------------------------------------------------------- |
  | /api/OnboardingContas/PessoasDocumentoArquivo | Operador não configurado para esta integração                     |
  | /api/OnboardingContas/PessoasDocumentoArquivo | O código da solicitação é obrigatório                             |
  | /api/OnboardingContas/PessoasDocumentoArquivo | O tipo do documento é obrigatório                                 |
  | /api/OnboardingContas/PessoasDocumentoArquivo | O tipo da entidade é obrigatório                                  |
  | /api/OnboardingContas/PessoasDocumentoArquivo | O documento federal informado está inválido                       |
  | /api/OnboardingContas/PessoasDocumentoArquivo | Nome do arquivo é obrigatório                                     |
  | /api/OnboardingContas/PessoasDocumentoArquivo | O limite para nome de arquivos é de 60 caracteres                 |
  | /api/OnboardingContas/PessoasDocumentoArquivo | O nome do arquivo não deve conter caracteres especiais            |
  | /api/OnboardingContas/PessoasDocumentoArquivo | O envio do arquivo é obrigatório                                  |
  | /api/OnboardingContas/PessoasDocumentoArquivo | O arquivo é inválido                                              |
  | /api/OnboardingContas/PessoasDocumentoArquivo | A extensão do arquivo deve ser apenas .png, .jpg,  .pdf,  .jpeg   |
  | /api/OnboardingContas/PessoasDocumentoArquivo | O tamanho do arquivo excede o limite de...                        |
  | /api/OnboardingContas/PessoasDocumentoArquivo | Não existe uma solicitação ativa para o código informado          |
  | /api/OnboardingContas/PessoasDocumentoArquivo | Não foi possível obter o parceiro para o código informado         |
  | /api/OnboardingContas/PessoasDocumentoArquivo | Não é possível inserir documento na situação atual da solicitação |
  | /api/OnboardingContas/PessoasDocumentoArquivo |                                                                   |
  | /api/OnboardingContas/PessoasDocumentoArquivo | Não é possível finalizar a análise na situação atual              |
  | /api/OnboardingContas/PessoasDocumentoArquivo | Ainda faltam arquivos para serem inseridos                        |
  | /api/OnboardingContas/PessoasDocumentoArquivo | Solicitação do correntista não encontrada                         |
  | /api/OnboardingContas/PessoasDocumentoArquivo | Não foi possível inserir o arquivo                                |
</Expandable>


## OpenAPI

````yaml post /v1/api/OnboardingContas/PessoasDocumentoArquivo
openapi: 3.0.1
info:
  title: BMPSPBExt
  description: '<p><strong>Build Number: </strong>#0.0</p>'
  version: v1
servers:
  - url: https://api.ext.dbs.moneyp.dev.br/
    description: Localhost
security:
  - Bearer: []
paths:
  /v1/api/OnboardingContas/PessoasDocumentoArquivo:
    post:
      tags:
        - PessoasDocumentoArquivo
      summary: >-
        Responsável pela inserção de documentos na abertura de contas via
        Onboarding (Titular e sócios em caso de PJ).
      description: "<p>Scopes:</p>\r\n<b>api.ext api.onboarding.conta.inserirdocumento</b>"
      parameters:
        - name: IdempotencyKey
          in: header
          required: true
          schema:
            type: string
        - name: IgnoraHandshake
          in: header
          description: (somente em homologação)
          required: true
          schema:
            type: boolean
            default: true
      requestBody:
        content:
          application/json:
            schema:
              allOf:
                - $ref: >-
                    #/components/schemas/BMPSPB.Domain.Messaging.API.Externa.OnboardingContas.DocumentoExternaRequest
          text/json:
            schema:
              allOf:
                - $ref: >-
                    #/components/schemas/BMPSPB.Domain.Messaging.API.Externa.OnboardingContas.DocumentoExternaRequest
          application/*+json:
            schema:
              allOf:
                - $ref: >-
                    #/components/schemas/BMPSPB.Domain.Messaging.API.Externa.OnboardingContas.DocumentoExternaRequest
      responses:
        '200':
          description: Success
        '400':
          description: Erro de negócio
          content:
            application/json:
              schema:
                type: object
                properties:
                  sucesso:
                    type: boolean
                  mensagem:
                    type: string
        '500':
          description: Erro interno do servidor
          content:
            application/json:
              schema:
                type: object
                properties:
                  sucesso:
                    type: boolean
                  mensagem:
                    type: string
components:
  schemas:
    BMPSPB.Domain.Messaging.API.Externa.OnboardingContas.DocumentoExternaRequest:
      required:
        - arquivo
        - codigoContaSolicitacaoCriacao
        - documentoFederal
        - nomeArquivo
        - tipoDocumento
        - tipoEntidade
      type: object
      properties:
        codigoContaSolicitacaoCriacao:
          type: string
          description: Código da solicitação de abertura da conta.
          format: uuid
        tipoDocumento:
          allOf:
            - $ref: '#/components/schemas/BMPSPB.Infra.Enums.TipoDocumento'
          description: " Qual é o tipo do documento:\n\t\t\t1 - Identificação,\n\t\t\t2 - Termo aceite,\n\t\t\t3 - Contrato social,\n\t\t\t4 - Procuração,\n\t\t\t5 - Mei,\n\t\t\t6 - Empresário individual,\n\t\t\t7 - Sociedade limitada unipessoal,\n\t\t\t8 - Sociedade empresária limitada,\n\t\t\t9 - Sociedade simples,\n\t\t\t10 - Sociedade anônima,\n\t\t\t11 - Sociedade cooperativa,\n\t\t\t12 - Sociedade de associação privada,\n\t\t\t13 - Condomínio edifício\n\t\t\t"
        tipoEntidade:
          allOf:
            - $ref: '#/components/schemas/BMPSPB.Infra.Enums.TipoEntidade'
          description: " Qual persona o arquivo enviado pertence:\n\t\t\t1 - Correntista,\n\t\t\t2 - Sócio,\n\t\t\t3 - Controlador,\n\t\t\t4 - Operador front-end,\n\t\t\t5 - Credor"
        documentoFederal:
          minLength: 1
          type: string
          description: Documento federal vinculado ao arquivo enviado.
        nomeArquivo:
          minLength: 1
          type: string
          description: Nome do arquivo que está sendo enviado.
        arquivo:
          minLength: 1
          type: string
          description: Arquivo criptografado em base64.
        finalizarSolicitacao:
          type: boolean
          description: >-
            Caso seja enviado true, a solicitação será enviada para análise e
            não poderá mais ser efetuado alterações.
          nullable: true
      additionalProperties: false
    BMPSPB.Infra.Enums.TipoDocumento:
      enum:
        - 1
        - 2
        - 3
        - 4
        - 5
        - 6
        - 7
        - 8
        - 9
        - 10
        - 11
        - 12
        - 13
      type: integer
      description: ''
      format: int32
    BMPSPB.Infra.Enums.TipoEntidade:
      enum:
        - 1
        - 2
        - 3
        - 4
        - 5
      type: integer
      description: ''
      format: int32
  securitySchemes:
    Bearer:
      type: apiKey
      description: Copie 'Bearer ' + token
      name: Authorization
      in: header

````