---
title: "Atualizar a Carteira"
method: PUT
path: "/v1/bank_billet_accounts/{id}"
tags: ["Carteiras de Cobrança"]
---

# Atualizar a Carteira

`PUT /v1/bank_billet_accounts/{id}`

## Request

- Base URL: `https://api-sandbox.kobana.com.br`
- URL: `https://api-sandbox.kobana.com.br/v1/bank_billet_accounts/{id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/kobana/apis/cobran-as/docs/v1/bank_billet_accounts/:id/put.ts> (a function with typed inputs; its response is checked against the schema)

Atualiza informações específicas de uma Carteira.

## Path parameters

- `id` string, required

## Headers

- `User-Agent` string
- `X-Idempotency-Key` string

## Request body

- BankBilletAccountUpdateObject
  - `kind` 'cnab400' | 'cnab240': Tipo de CNAB: * `cnab400` CNAB 400 * `cnab240` CNAB 240
  - `bank_contract_slug` string: [Slug da Carteira](/reference/bancos-suportados). Carteiras ativas não poderão ter o campo bank_contract_slug alterados.
  - `financial_account` object, nullable: Conta Financeira associada à carteira
    - `uid` string, uuid: UID da Conta Financeira
  - `payment_place` string, nullable: Local de Pagamento
  - `custom_name` string: Nome da Carteira para identificação dentro da Kobana.
  - `allow_expiration_on_weekends` boolean, nullable: Permitir vencimento em fim de semana e feriados
  - `beneficiary_name` string: Nome do Beneficiário
  - `beneficiary_cnpj_cpf` string: CNPJ/CPF do Beneficiário
  - `agency_number` string: Agência. Preenchido automaticamente quando financial_account_uid é fornecido.
  - `agency_digit` string, nullable: Dígito da Agência. Opcional: será calculado automaticamente usando Módulo 11 quando o banco exigir e não for fornecido. Preenchido automaticamente quando financial_account_uid é fornecido.
  - `account_number` string: Conta. Preenchida automaticamente quando financial_account_uid é fornecido.
  - `account_digit` string: Dígito da Conta. Preenchido automaticamente quando financial_account_uid é fornecido.
  - `extra1` string, nullable: Campo extra 1.
  - `extra1_digit` string, nullable: Digito do Campo extra 1.
  - `extra2` string, nullable: Campo extra 2.
  - `extra2_digit` string, nullable: Dígito do Campo extra 2.
  - `contract` string: Contrato
  - `contract_type` string: Tipo do Contrato
  - `extra3` string, nullable: Código de Remessa
  - `beneficiary_address_street` string, nullable: Rua do Beneficiário
  - `beneficiary_address_street_number` string, nullable: Numero da rua do Beneficiário
  - `beneficiary_address_complement` string, nullable: Complemento do endereço do Beneficiário
  - `beneficiary_address_neighborhood` string, nullable: Bairro do Beneficiário
  - `beneficiary_address_city` string, nullable: Cidade do Beneficiário
  - `beneficiary_address_state` string, nullable: Estado do Beneficiário
  - `beneficiary_address_zipcode` string, nullable: CEP do Beneficiário (formato 99999999)
  - `beneficiary_address` string, nullable: Endereço completo do Beneficiário.
  - `bolepix_enabled` boolean, nullable: Habilitar Bolepix (legado — prefira o objeto `bolepix`)
  - `bolepix` object, nullable: Configuração de Boleto Híbrido
    - `pix_mode` integer, nullable: Quem irá gerenciar o pix * 1 - Gerenciado pela Kobana * 2 - Gerenciado pelo Banco * 3 - Não configurado
    - `pix_account` union: Escolha um dos formatos para associar uma conta pix a esta carteira
      - object
        - `uid` string, uuid: UID da Conta Pix
      - object
        - `id` string: ID da Conta Pix
    - `pix_billing_options` object, nullable: Opções de cobrança do pix no boleto. Deve ser enviado quando o pix for gerenciado pela Kobana.
      - `kind` string: Tipo de cobrança * instant - Cobrança imediata * billing - Cobrança com vencimento
      - `interest` boolean, nullable: Habilitar juros
      - `fine` boolean, nullable: Habilitar multa
      - `discount` boolean, nullable: Habilitar desconto
      - `revoke_days` boolean, nullable: Habilitar dias para revogação
  - `bolepix_key` string, nullable: Chave Pix que será usada no Bolepix
  - `default` boolean, nullable: Padrão. O campo `default` determina a carteira de cobrança que será usada na criação do boleto quando nenhuma carteira for informada. No momento que a primeira carteira é homologada (passa para o `status` = `active`), ela recebe o valor `default` = `true`
  - `remittance_disabled` boolean, nullable: Desabilita geração de remessas.
  - `next_our_number` integer, nullable: Último nosso número
  - `next_remittance_number` integer, nullable: Último sequencial da remessa Default: 1
  - `bank_billet_account_next_our_number_attributes` object
    - `next_our_number` integer, nullable, required: Próximo Nosso Número. Default: 1
  - `bank_billet_account_next_remittance_number_attributes` object
    - `next_remittance_number` integer, nullable, required: Próximo Número da Remessa. Default: 1

## Response `204`

Carteira atualizada

## Other responses

- `401`: Falha de autenticação. Token inválido
- `403`: Falha de permissão. Você não tem o Scope obrigatório para essa chamada.
- `404`: Carteira não encontrado
- `422`: Unprocessable Entity

---

[API](https://skmtc.dev/kobana/apis/cobran-as.md) - [All operations](https://skmtc.dev/kobana/apis/cobran-as/llms.txt) - [OpenAPI document](https://skmtc.dev/kobana/apis/cobran-as/revisions/728c362ec4d7?raw)