Envio de Remessa de Carteira 17019 Vinculada do Banco do Brasil Via API

---
title: Envio de Remessa de Carteira 17019 Vinculada do Banco do Brasil Via API
slug: envio-remessa-carteira-17019
sistema:
  - Teorema Pay
categoria: user_manual
tipo: how-to
publico: "operadores financeiros responsáveis pela geração de cobranças bancárias"
autor: Mauricio Antunes Fujimoto
setor: Qualidade
modulo: ""
chamado: ""
keywords:
  - remessa
  - carteira 17
  - vinculada
  - Banco do Brasil
  - API Open Bank
  - cobrança bancária
  - subconta
versao_pipeline: 2.5.2
aprovado_em: Agosto de 2025
revisao: Paulo Bley
ultima_revisao: "2026-06-11"
---

## Visão Geral

O envio de remessa pela Carteira 17/019 Vinculada do Banco do Brasil via Interface de Programação de Aplicações (API) requer duas etapas: configurar a subconta bancária com as credenciais fornecidas pelo Banco do Brasil e, em seguida, selecionar os títulos no módulo de remessa e transmiti-los diretamente ao banco. A integração via API dispensa o arquivo de remessa em formato texto e garante transmissão imediata com rastreabilidade.

## Configurar a Subconta Bancária para a Carteira 17/019

Acesse **Gestão Administrativa → Cadastro → Contas → Cadastro de Contas Bancárias**.

Na tela de Cadastro de Contas, selecione a conta vinculada ao Banco do Brasil e abra a aba **SubContas**.

![Tela Cadastro de Contas com a aba SubContas listando as subcontas do Banco do Brasil – FILIAL. A linha destacada em amarelo corresponde à subconta "25 BB 17/019 VINCULADA- FILIAL- API", carteira 17, empresa Repinho Reflorestadora Madeiras E Compensados Ltda, CNPJ 82.196.510/0002-21](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/envio-remessa-carteira-17019/envio-remessa-carteira-17019-06.png)

Selecione a subconta correspondente à Carteira 17/019 Vinculada – API e edite os campos abaixo:

- **Tipo de Cobrança:** BB – Vinculada (Carteira 11,17)
- **Layout Arquivo Remessa:** API
- **Carteira de Cobrança:** 17
- **Variação:** 019
- **API Open Bank Client ID:** chave fornecida pelo Banco do Brasil
- **API Open Bank Client Secret:** chave fornecida pelo Banco do Brasil

![Formulário de edição da subconta BB 17/019 Vinculada – API com campos Tipo de Cobrança, Layout Arquivo Remessa, Carteira de Cobrança, Variação, API Open Bank Client ID e API Open Bank Client Secret destacados](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/envio-remessa-carteira-17019/envio-remessa-carteira-17019-07.png)

> **Pré-requisito:** As credenciais API Open Bank Client ID e Client Secret devem ser obtidas diretamente junto ao Banco do Brasil antes de prosseguir.

## Gerar e Enviar a Remessa via API

Acesse o módulo **PIX – Geração, Retorno de Remessa e Impressão de Boletos**.

No campo **Dados do Banco / Conta**, selecione a subconta **BB 17/019 VINCULADA- FILIAL- API**. Certifique-se de que a aba **1 Remessa Bancária** está ativa.

![Tela PIX – Geração, Retorno de Remessa e Impressão de Boletos com o campo Dados do Banco / Conta preenchido com "BB 17/019 VINCULADA- FILIAL- API", período de 01/08/2025 a 31/08/2025, aba Remessa Bancária selecionada e lista de títulos exibindo documentos das empresas TRANSWOOD GROUP LTDA e 3M GROUP SRL](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/envio-remessa-carteira-17019/envio-remessa-carteira-17019-08.png)

Selecione os títulos desejados e clique no botão **Remessa** na barra de ferramentas. Um menu exibirá duas opções:

- **Enviar Remessa** — transmite os dados diretamente ao Banco do Brasil via API.
- **Enviar e Imprimir** — transmite os dados e gera o relatório impresso da operação.

![Tela PIX – Geração, Retorno de Remessa e Impressão de Boletos com o menu do botão Remessa expandido, exibindo as opções "Enviar Remessa" e "Enviar e Imprimir"](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2025/envio-remessa-carteira-17019/envio-remessa-carteira-17019-09.png)

> ⚠️ **Atenção:** A remessa só será transmitida corretamente se todos os campos obrigatórios (Tipo de Cobrança, Layout, Carteira, Variação e credenciais da API) estiverem preenchidos na subconta. Caso haja inconsistências ou credenciais inválidas, o sistema apresentará mensagens de erro — corrija os parâmetros na subconta antes de reenviar. Mantenha a conexão com a internet estável durante o envio, pois o retorno da API pode demorar alguns instantes.

## Informações do documento

> Autor: Mauricio Antunes Fujimoto
> Setor: Qualidade
> Módulo:
> Chamado:
> Versão do Sistema:
> Versão do documento: 01
> Revisão: Paulo Bley
> Aprovado em: Agosto de 2025

---

> 📎 **Arquivos originais:** [MANUAL DE ENVIO DE REMESSA DE CARTEIRA 17019 VINCULADA DO BANCO DO BRASIL VIA API.docx](https://drive.google.com/uc?export=download&id=1BrbKBI6viBZnsfgV8IvIGO6dfw6_8Job) · [MANUAL DE ENVIO DE REMESSA DE CARTEIRA 17019 VINCULADA DO BANCO DO BRASIL VIA API.pdf](https://drive.google.com/uc?export=download&id=16FmjjLwZN1MT7SE0D7F-hevzIlxl-6gc4)