Mobills 家庭账本与发票数据 API

3APPS SOLUTIONS · 银行 4.2 ★

Mobills: Budget Planner 是 3APPS SOLUTIONS 的巴西个人理财应用（包名 br.com.gerenciadorfinanceiro.controller，站点 mobills.com.br）。家庭维护支票、现金、储蓄与投资账户，登记支出与收入，在账户间转账，按关闭日与到期日跟踪信用卡账单，设置月度预算与标签，连接 Nubank 卡把发票落入同一本账，扫描小票，并在 web.mobills.com.br 上共用同一本账。高级会员走 Google Play 或 Pagar.me 订阅；Gympass 会员有应用内合作入口。Google Play 以免费 BRL 上架，约 4.2 星、约 29.3 万条评价。它与 Organizze、GuiaBolso、Wallet 同场，面向希望用一本巴西家庭账、而不是只用银行自家 App 的用户。

活期与储蓄行带有 saldo、tipoConta（corrente、dinheiro、poupança、investimentos）和 instituicaoBancariaId；支出落成 valor、dataDespesa 与 status，收入带 dataReceita，转账则是 deContaId / paraContaId 两端。接入 Nubank 的卡给出 limite、diaFechamento、diaPagamento 与 statusIntegracao，前提是 hasCard / statusCard 显示还有卡在等待。

月度快照把这些账折成 somaDespesas、somaReceitas、工作日 valorGastoSeg…valorGastoDom 以及每张卡的 valorFatura。Excel 导出按 dataInicial、contas 与 tipoMovimentacoes 过滤；会话行列出 identifier、type 与 connectionDate。家庭看板、卡片运维机器人与簿记员消费这些对象；openData Studio 把它们变成可调用的开放数据。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

Firebase 外部登录换票

POST /v1/session/exchange opendata

用 Firebase / Google 身份换取 auth_token、assinanteAndroid 与 diasExpiracao，供账本同步携带 bearer 令牌。

认证方式：无需登录。请求体携带联合身份（id 为身份提供方 uid，另有 externalToken、provider、userName、password、nome、idioma、origemCadastro、conviteCodigo）。后续调用携带 Authorization: Bearer <access_token>，以及 X-Client-Platform 与 X-Client-Version 请求头。

id
userName
password
nome
provider
externalId
externalFoto
externalToken
origemCadastro
idioma
conviteCodigo
auth_token
expires_in
dataCadastro
assinanteAndroid
diasExpiracao
isNewUser
migratedUser

POST /v1/session/exchange HTTP/1.1
Content-Type: application/json
X-Client-Platform: android
X-Client-Version: 5.0.5

{
  "id": "firebaseUid_ada",
  "userName": "[email protected]",
  "password": null,
  "nome": "Ada Lovelace",
  "provider": "google",
  "externalId": "116429104109",
  "externalFoto": "https://cdn.example.com/a/photo",
  "externalToken": "<provider_token>",
  "origemCadastro": 1,
  "idioma": "pt-BR",
  "conviteCodigo": null
}

{
  "id": "usr_9f21c0ab",
  "auth_token": "<access_token>",
  "expires_in": 3600,
  "userName": "[email protected]",
  "nome": "Ada Lovelace",
  "dataCadastro": "2019-03-12T11:04:00",
  "assinanteAndroid": true,
  "diasExpiracao": 18,
  "isNewUser": false,
  "migratedUser": false
}

读取用户资料

GET /v1/household/owner/profile opendata

读取登录用户资料，外层 infoUser，含 email、nome、telefone、fotoPerfil、quantidadeMobills 积分与 origemCadastro。

认证方式： Bearer 访问令牌（Authorization: Bearer <access_token>），另带 X-Client-Platform 与 X-Client-Version 请求头。

infoUser
usuarioId
nome
email
fotoPerfil
telefone
quantidadeMobills
dataModificacao
origemCadastro

GET /v1/household/owner/profile HTTP/1.1
Authorization: Bearer <access_token>
X-Client-Platform: android
X-Client-Version: 5.0.5
Accept: application/json

{
  "infoUser": {
    "usuarioId": "usr_9f21c0ab",
    "nome": "Ada Lovelace",
    "email": "[email protected]",
    "fotoPerfil": "https://cdn.example.com/ada.jpg",
    "telefone": "+55 11 99999-0000",
    "quantidadeMobills": 420,
    "dataModificacao": "2026-10-18T14:22:00",
    "origemCadastro": 1
  }
}

同步账户余额

POST /v1/ledger/accounts/sync openbanking

双向同步账户簿（tipoConta 1 活期 / 2 现金 / 3 储蓄 / 4 投资 / 5 其他），含 saldo、telaInicial 与银行机构元数据。

认证方式： Bearer 访问令牌（Authorization: Bearer <access_token>），另带 X-Client-Platform 与 X-Client-Version 请求头。

id
uniqueId
nome
saldo
cor
tipoConta
telaInicial
ativo
arquivado
instituicaoBancariaId
origemIntegracaoId
statusIntegracao
dataContaAutomatica

POST /v1/ledger/accounts/sync HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json
X-Client-Platform: android
X-Client-Version: 5.0.5

[
  {
    "id": 4411,
    "uniqueId": "cap_nubank_corrente",
    "nome": "Nubank conta",
    "saldo": 1840.55,
    "cor": 16711935,
    "tipoConta": 1,
    "telaInicial": true,
    "ativo": true,
    "arquivado": false,
    "instituicaoBancariaId": "nubank",
    "origemIntegracaoId": 1,
    "statusIntegracao": 1,
    "dataContaAutomatica": "2026-10-01T00:00:00"
  }
]

[
  {
    "id": 4411,
    "uniqueId": "cap_nubank_corrente",
    "nome": "Nubank conta",
    "saldo": 1840.55,
    "tipoConta": 1,
    "telaInicial": true,
    "ativo": true,
    "arquivado": false,
    "instituicaoBancariaId": "nubank",
    "origemIntegracaoId": 1,
    "statusIntegracao": 1
  }
]

同步支出流水

POST /v1/ledger/expenses/sync openfinance

同步现金与账户支出：descricao、valor、dataDespesa、status（0 已发生 / 1 待处理）以及可选小票 anexo。

认证方式： Bearer 访问令牌（Authorization: Bearer <access_token>）。

id
uniqueId
descricao
valor
dataDespesa
status
contaId
tipoDespesaId
subcategoriaId
observacao
anexo
favorito
ativo
origemIntegracaoId
despesaFixaId
despesaCartaoId

POST /v1/ledger/expenses/sync HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json
X-Client-Platform: android
X-Client-Version: 5.0.5

[
  {
    "id": 8821,
    "uniqueId": "exp_almoco_20261018",
    "descricao": "Almoço",
    "valor": "42.90",
    "dataDespesa": "2026-10-18T12:30:00",
    "status": 0,
    "contaId": "4411",
    "tipoDespesaId": 3,
    "subcategoriaId": 18,
    "observacao": "com a equipe",
    "anexo": "receipts/almoco.jpg",
    "favorito": true,
    "ativo": true,
    "origemIntegracaoId": 0
  }
]

[
  {
    "id": 8821,
    "uniqueId": "exp_almoco_20261018",
    "descricao": "Almoço",
    "valor": "42.90",
    "dataDespesa": "2026-10-18T12:30:00",
    "status": 0,
    "contaId": "4411",
    "tipoDespesaId": 3,
    "ativo": true
  }
]

同步收入流水

POST /v1/ledger/incomes/sync openfinance

同步收入：dataReceita、valor、status（0 已发生 / 1 待处理）以及可选的周期 receitaFixaId。

认证方式： Bearer 访问令牌（Authorization: Bearer <access_token>）。

id
uniqueId
descricao
valor
dataReceita
status
contaId
tipoReceitaId
receitaFixaId
observacao
favorito
ativo
origemIntegracaoId
subcategoriaId

POST /v1/ledger/incomes/sync HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json
X-Client-Platform: android
X-Client-Version: 5.0.5

[
  {
    "id": 2204,
    "uniqueId": "inc_salario_202610",
    "descricao": "Salário",
    "valor": "8500.00",
    "dataReceita": "2026-10-05T09:00:00",
    "status": 0,
    "contaId": 4411,
    "tipoReceitaId": 1,
    "receitaFixaId": "12",
    "observacao": "CLT outubro",
    "favorito": true,
    "ativo": true,
    "origemIntegracaoId": 0
  }
]

[
  {
    "id": 2204,
    "uniqueId": "inc_salario_202610",
    "descricao": "Salário",
    "valor": "8500.00",
    "dataReceita": "2026-10-05T09:00:00",
    "status": 0,
    "contaId": 4411,
    "receitaFixaId": "12",
    "ativo": true
  }
]

同步账户间转账

POST /v1/ledger/transfers/sync openfinance

同步账户间转账，含 deContaId / paraContaId 两端、valor 与可选 transferenciaFixaId。线路日期字段拼写为 dataTransfencia。

认证方式： Bearer 访问令牌（Authorization: Bearer <access_token>）。

id
uniqueId
dataTransfencia
valor
deContaId
paraContaId
observacao
transferenciaFixaId
ativo

POST /v1/ledger/transfers/sync HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json
X-Client-Platform: android
X-Client-Version: 5.0.5

[
  {
    "id": 91,
    "uniqueId": "tr_poupanca_20261012",
    "dataTransfencia": "2026-10-12T10:00:00",
    "valor": "500.00",
    "deContaId": "4411",
    "paraContaId": "4412",
    "observacao": "reserva poupança",
    "transferenciaFixaId": 0,
    "ativo": true
  }
]

[
  {
    "id": 91,
    "uniqueId": "tr_poupanca_20261012",
    "dataTransfencia": "2026-10-12T10:00:00",
    "valor": "500.00",
    "deContaId": "4411",
    "paraContaId": "4412",
    "ativo": true
  }
]

同步信用卡与额度

POST /v1/ledger/cards/sync openbanking

同步信用卡（bandeira 0 VISA / 1 MASTERCARD / 2 HIPERCARD / 3 AMEX / 8 ELO），含 limite、diaFechamento 与到期日 diaPagamento。

认证方式： Bearer 访问令牌（Authorization: Bearer <access_token>）。

id
uniqueId
nome
limite
bandeira
diaFechamento
diaPagamento
contaId
origemIntegracaoId
statusIntegracao
ativo
arquivado
dataCartaoAutomatico

POST /v1/ledger/cards/sync HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json
X-Client-Platform: android
X-Client-Version: 5.0.5

[
  {
    "id": 12,
    "uniqueId": "card_nubank_roxinho",
    "nome": "Nubank Roxinho",
    "limite": "8000.00",
    "bandeira": "1",
    "diaFechamento": "8",
    "diaPagamento": "15",
    "contaId": 4411,
    "origemIntegracaoId": 1,
    "statusIntegracao": 1,
    "ativo": true,
    "arquivado": false
  }
]

[
  {
    "id": 12,
    "uniqueId": "card_nubank_roxinho",
    "nome": "Nubank Roxinho",
    "limite": "8000.00",
    "bandeira": "1",
    "diaFechamento": "8",
    "diaPagamento": "15",
    "contaId": 4411,
    "statusIntegracao": 1,
    "ativo": true,
    "arquivado": false
  }
]

月度收支快照

POST /v1/insights/monthly-snapshots openfinance

上传月度家庭快照：somaDespesas 对 somaReceitas、工作日支出、分类合计以及每张卡的 valorFatura / valorLimite。

认证方式： Bearer 访问令牌（Authorization: Bearer <access_token>）。

periodo
pais
estado
cidade
moeda
situacao
porcentagem
quantReceitas
somaReceitas
quantDespesas
somaDespesas
somaDespesasFixas
somaInvestimentos
somaContaPoupanca
tipoInvestimento
diaMaiorGasto
categorias.nome
categorias.valorTotal
cartoes.nome
cartoes.valorFatura
cartoes.valorLimite
valorGastoSeg
valorGastoDom

POST /v1/insights/monthly-snapshots HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json
X-Client-Platform: android
X-Client-Version: 5.0.5

{
  "periodo": "2026-10",
  "pais": "BR",
  "estado": "SP",
  "cidade": "São Paulo",
  "moeda": "BRL",
  "situacao": "positivo",
  "porcentagem": 22.5,
  "quantReceitas": 4,
  "somaReceitas": 9200.00,
  "quantDespesas": 38,
  "somaDespesas": 6120.40,
  "quantDespesasDividas": 2,
  "somaDespesasDividas": 800.00,
  "quantDespesasFixas": 6,
  "somaDespesasFixas": 2400.00,
  "quantInvestimentos": 1,
  "somaInvestimentos": 500.00,
  "tipoInvestimento": "renda_fixa",
  "somaContaPoupanca": 12000.00,
  "plataforma": "Android",
  "dispositivo": "Pixel 8",
  "diaMaiorGasto": 12,
  "categorias": [{"nome": "Alimentação", "tipo": 1, "valorTotal": 980.10}],
  "cartoes": [{"nome": "Nubank Roxinho", "bandeira": 1, "tipo": 0, "valorFatura": 1234.67, "valorLimite": 8000.00, "valorPago": 0}],
  "valorGastoSeg": 210.00,
  "valorGastoTer": 95.00,
  "valorGastoQua": 140.00,
  "valorGastoQui": 80.00,
  "valorGastoSex": 310.00,
  "valorGastoSab": 420.00,
  "valorGastoDom": 180.00,
  "porcGastoSeg": 0.14,
  "porcGastoTer": 0.06,
  "porcGastoQua": 0.09,
  "porcGastoQui": 0.05,
  "porcGastoSex": 0.21,
  "porcGastoSab": 0.29,
  "porcGastoDom": 0.16
}

{}

发起 Nubank 卡接入
POST /v1/card-links/start openbanking
发起 Nubank 卡绑定：login、本地 cardId/accountId、cardName，以及 mobillsCategoryId → integrationSourceCategoryId 的分类映射。
认证方式： Bearer 访问令牌（Authorization: Bearer <access_token>）。
- login
- cardName
- cardId
- accountId
- associateCategories
- mobillsCategoryId
- integrationSourceCategoryId
```
POST /v1/card-links/start HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json
X-Client-Platform: android
X-Client-Version: 5.0.5

{
  "login": "[email protected]",
  "cardName": "Nubank Roxinho",
  "cardId": 12,
  "accountId": 1,
  "associateCategories": [
    {"mobillsCategoryId": 3, "integrationSourceCategoryId": 88}
  ]
}
```
```
{}
```
探测未接入的 Nubank 卡
GET /v1/card-links/pending openbanking
查询是否还有待接入的 Nubank 卡（hasCard），并返回 statusCard.hasCredentials / login / status。
认证方式： Bearer 访问令牌（Authorization: Bearer <access_token>）。
- hasCard
- statusCard
- hasCredentials
- login
- status
```
GET /v1/card-links/pending HTTP/1.1
Authorization: Bearer <access_token>
X-Client-Platform: android
X-Client-Version: 5.0.5
Accept: application/json
```
```
{
  "hasCard": true,
  "statusCard": {
    "hasCredentials": true,
    "login": "[email protected]",
    "status": "PENDING_DEVICE"
  }
}
```

导出流水 Excel

POST /v1/exports/transactions openfinance

按 dataInicial/dataFinal、contas、categorias、tipoMovimentacoes 生成账本 Excel 下载地址。另有 CSV 与 PDF 导出选项。

认证方式： Bearer 访问令牌（Authorization: Bearer <access_token>）。

dataInicial
dataFinal
periodoPersonalizado
categorias
contas
tipoMovimentacoes

POST /v1/exports/transactions HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json
X-Client-Platform: android
X-Client-Version: 5.0.5

{
  "dataInicial": "2026-01-01",
  "dataFinal": "2026-10-31",
  "periodoPersonalizado": true,
  "categorias": [1, 3, 8],
  "contas": [1, 2],
  "tipoMovimentacoes": [1, 2, 3]
}

https://downloads.example.com/exports/ada-2026-10.xlsx

列出已连接设备

GET /v1/me/devices opendata

列出这本家庭账上的会话：identifier、name、type（0 手机 / 1 电脑 / 2 平板）、city/state 与 connectionDate。列表旁另有连接、断开与全部断开操作。

认证方式： Bearer 访问令牌（Authorization: Bearer <access_token>）。

success
data
devices
id
identifier
name
type
city
state
status
connectionDate
disconnectionDate

GET /v1/me/devices HTTP/1.1
Authorization: Bearer <access_token>
X-Client-Platform: android
X-Client-Version: 5.0.5
Accept: application/json

{
  "success": true,
  "data": {
    "devices": [
      {
        "id": 88,
        "identifier": "pref_device_uuid_pixel8",
        "name": "Google Pixel 8",
        "type": 0,
        "city": "São Paulo",
        "state": "SP",
        "status": true,
        "connectionDate": "2026-10-18T11:04:00",
        "disconnectionDate": null
      }
    ]
  }
}

数据类别

账户
余额
流水
信用卡
预算
银行接入
设备

数据使用场景与案例

家庭账本对账
夜间任务拉取账户同步行（saldo、tipoConta、instituicaoBancariaId），再叠上支出与收入同步，让 ERP 或家庭看板与 Mobills 对齐，而无需刮取界面。
Nubank 账单接入
卡片运维机器人先调用待接入卡探测，再带 login、cardId 与 associateCategories 提交卡片绑定请求，使 Nubank 发票以信用卡形式落入账本，含 limite、diaFechamento 与 diaPagamento。
月度支出驾驶舱
理财小组件消费月度快照——somaDespesas、somaReceitas、categorias.valorTotal 与 cartoes.valorFatura——绘制工作日支出，而不必回放每一笔流水。
会计 Excel 交接
簿记员把 dataInicial、dataFinal、contas 与 tipoMovimentacoes 提交给流水导出接口，并保存返回的 URL 用于月结。

常见问题

Mobills 能拿到银行实时余额，还是只有本地现金？

同步后的账本余额。账户同步调用（POST /v1/ledger/accounts/sync）返回每本 conta 的 saldo、tipoConta（1 活期 / 2 现金 / 3 储蓄 / 4 投资）与 instituicaoBancariaId。Nubank 卡的绑定请求被接受后还会给出 limite、diaFechamento 与 diaPagamento。

支出和收入在线路上长什么样？

支出同步调用（POST /v1/ledger/expenses/sync）发送 descricao、valor、dataDespesa 与 status（0 已发生 / 1 待处理）。收入用 dataReceita、status 与可选 receitaFixaId。转账携带 deContaId、paraContaId、valor，日期字段为 dataTransfencia。

月度分析快照包含什么？

月度快照调用（POST /v1/insights/monthly-snapshots）上传 periodo、pais、moeda、somaDespesas、somaReceitas、somaInvestimentos、somaContaPoupanca、categorias[].valorTotal、cartoes[].valorFatura 以及工作日 valorGastoSeg 到 valorGastoDom。

会话如何鉴权？

登录换票调用（POST /v1/session/exchange）用联合身份（uid 与 externalToken）换 auth_token、expires_in 与 assinanteAndroid。后续调用携带 Authorization: Bearer <access_token> 以及平台与版本请求头。

与 Mobills: Budget Planner 相似的应用

Organizze — Organizze 是巴西的记账与预算应用，可在多个钱包和账户中登记支出、收入与转账，并在手机或电脑上查看同一本账。
Minhas Economias — Minhas Economias 是巴西个人预算应用，按分类跟踪收支，并可通过 Open Finance 自动拉取银行账户与信用卡变动。
Wallet: Budget Expense Tracker — Wallet 是个人理财应用，可连接银行账户自动跟踪支出、设置自定义预算，并与家人共享账户。
Spendee — Spendee 是预算与支出跟踪应用，可同步银行账户、电子钱包和加密钱包，自动给交易分类，并按类别做预算。
Money Manager Expense & Budget — Money Manager Expense & Budget 用复式记账登记收支，用图表对照预算与实际支出，并跟踪信用卡结账日。
AndroMoney — AndroMoney 覆盖 Android、iOS 和网页，可在多账户、多币种下记录日常支出，并提供分类预算与图表。
Bolso Organizado — Bolso Organizado 是巴西个人理财应用，收支记录保存在本机、可离线使用，并对周期性支出发出提醒。
Money Tracker-Expense & Budget — Money Tracker-Expense & Budget 把支出记录、现金账和账单整理放在同一个理财应用里。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

Mobills 家庭账本与发票数据 API

应用截图

API 端点一览

Firebase 外部登录换票

读取用户资料

同步账户余额

同步支出流水

同步收入流水

同步账户间转账

同步信用卡与额度

月度收支快照

发起 Nubank 卡接入

探测未接入的 Nubank 卡

导出流水 Excel

列出已连接设备

数据类别

数据使用场景与案例

家庭账本对账

Nubank 账单接入

月度支出驾驶舱

会计 Excel 交接

常见问题

与 Mobills: Budget Planner 相似的应用

更多银行类应用

5paisa: Demat, Stocks & IPO

AndroMoney

Angel One: Stocks, Mutual Fund

Bibit- Reksadana & Obligasi

相关主题

需要集成这个 App 的数据 API？

Mobills 家庭账本与发票数据 API

应用截图

API 端点一览

Firebase 外部登录换票

读取用户资料

同步账户余额

同步支出流水

同步收入流水

同步账户间转账

同步信用卡与额度

月度收支快照

发起 Nubank 卡接入

探测未接入的 Nubank 卡

导出流水 Excel

列出已连接设备

数据类别

数据使用场景与案例

家庭账本对账

Nubank 账单接入

月度支出驾驶舱

会计 Excel 交接

常见问题

相关应用

与 Mobills: Budget Planner 相似的应用

更多银行类应用

5paisa: Demat, Stocks & IPO

AndroMoney

Angel One: Stocks, Mutual Fund

Bibit- Reksadana & Obligasi

相关主题

需要集成这个 App 的数据 API？