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

# Alterar conta bancária da loja

> Cadastra ou atualiza a conta bancária da loja. Todos os campos da conta são enviados juntos.

Cadastra ou atualiza a conta bancária da loja.

A conta é substituída por inteiro a cada chamada — envie todos os campos, não apenas os alterados.

<Note>
  Quando o modelo de desembolso da loja é externo (`3`), `nomeTitular` e `documentoTitular` são obrigatórios.
</Note>

<Warning>
  Uma loja inativa não aceita alteração da conta bancária. Reative a loja antes, em [Ativar ou inativar loja](/pages/establishments/status).
</Warning>


## OpenAPI

````yaml PUT /v1/establishment/{estabelecimentoId}/bank-account
openapi: 3.0.1
info:
  title: WebIntegration
  description: Este documento descreve os endpoints disponíveis da API.
  version: '1.0'
servers:
  - url: https://api.parcelemais.com.br/integration
    description: Servidor para o ambiente de produção
  - url: https://api.staging.parcelemais.com.br/integration
    description: Servidor para o ambiente de staging
security:
  - bearerAuth: []
paths:
  /v1/establishment/{estabelecimentoId}/bank-account:
    put:
      tags:
        - Loja
      summary: Alterar conta bancária da loja.
      description: >-
        Cadastra ou atualiza a conta bancária da loja. Todos os campos da conta
        são enviados juntos.
      operationId: upsertEstablishmentBankAccount
      parameters:
        - $ref: '#/components/parameters/EstablishmentId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EstablishmentBankAccountRequest'
            example:
              banco: '341'
              agencia: '1234'
              digitoAgencia: ''
              conta: '56789'
              digitoConta: '0'
              tipoConta: 1
      responses:
        '200':
          description: Conta bancária atualizada com sucesso.
        '400':
          description: Dados inválidos.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails'
        '404':
          description: Loja não encontrada ou não pertence ao parceiro.
        '409':
          description: Loja ou rede inativa.
        '500':
          description: Internal Server Error
components:
  parameters:
    EstablishmentId:
      name: estabelecimentoId
      in: path
      required: true
      description: Identificador da loja, retornado no cadastro.
      schema:
        type: string
        format: uuid
      example: 9c0969d7-561e-4fae-88e7-790968fd1ddf
  schemas:
    EstablishmentBankAccountRequest:
      required:
        - banco
        - agencia
        - conta
        - digitoConta
        - tipoConta
      type: object
      description: Conta bancária da loja.
      properties:
        banco:
          type: string
          description: Código do banco.
          example: '341'
        agencia:
          type: string
          description: Número da agência, sem dígito.
        digitoAgencia:
          type: string
          description: Dígito da agência. Envie vazio quando a agência não tiver dígito.
        conta:
          type: string
          description: Número da conta, sem dígito.
        digitoConta:
          type: string
          description: Dígito da conta.
        tipoConta:
          type: integer
          format: int32
          enum:
            - 1
            - 2
            - 3
          description: '1: Corrente; 2: Poupança; 3: Pagamento.'
        nomeTitular:
          type: string
          nullable: true
          description: >-
            Nome do titular da conta. Obrigatório quando o modelo de desembolso
            é externo (`3`).
        documentoTitular:
          type: string
          nullable: true
          description: >-
            CPF ou CNPJ do titular da conta. Obrigatório quando o modelo de
            desembolso é externo (`3`).
      additionalProperties: false
    Microsoft.AspNetCore.Mvc.ProblemDetails:
      type: object
      properties:
        tipo:
          type: string
          nullable: true
        titulo:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
          nullable: true
        detalhe:
          type: string
          nullable: true
        instancia:
          type: string
          nullable: true
        erros:
          type: object
          nullable: true
          description: >-
            Detalhamento por campo, presente quando o erro é de validação de
            payload. Ausente (`null`) para erros de regra de negócio, que trazem
            a explicação apenas em `detalhe`.
          additionalProperties:
            type: array
            items:
              type: string
        correlationId:
          type: string
          nullable: true
          description: >-
            Identificador de correlação da requisição (ver cabeçalho
            `CorrelationId`), útil para localizar logs ao abrir um chamado de
            suporte.
      example:
        tipo: https://tools.ietf.org/html/rfc7231#section-6.5.1
        titulo: Requisição inválida.
        status: 400
        detalhe: O campo 'cpf' é obrigatório.
        instancia: /v1/order
        erros:
          cpf:
            - O campo 'cpf' é obrigatório.
        correlationId: 0HN7E4B8Q9K3D:00000001
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Cabeçalho de autenticação Bearer no formato `Bearer <token>` onde
        `<token>` é seu TOKEN de autenticação

````