---
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}`

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.net/kobana/apis/cobran-as.md) · [All operations](https://skmtc.net/kobana/apis/cobran-as/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kobana/cobran-as/revisions/728c362ec4d7/schema)