Flash Benefícios 私有数据 API

Flash Tecnologia · 支付

Flash | Benefícios e Despesas 是 Flash Tecnologia 面向员工的应用。这家圣保罗的福利与企业支出公司同时运营 Flash 卡、Clube Flash 与 Flash OS。员工用 CPF 登录后，首页钱包会列出雇主注入的每一只钱袋——餐、食、出行、健康与激励——旁边是可写入 Google Pay、Samsung Pay 或 Apple Wallet 的实体或虚拟公司卡。员工可以用这些余额发起 PIX 与 TED、给交通卡充值（SPTrans Bilhete Único 及其他城市发卡方）、购买 Clube Flash 券、提交带 GPS 的报销（含小票采集）、申请预支、在 Folha Certa 打卡，并开通薪资信贷或 FGTS 周年产品。应用面向巴西，与 Alelo、Pluxee Brasil、VR Benefícios、Ticket（Edenred）和 Caju 争夺同一批 PAT 与对公支出名额。

PAT 钱袋与报销明细共用登录员工记录：福利对象带 balance 和 flashCategories，每条费用带 value、currencyPrefix 以及付款卡的 lastFourDigits。

报销报告补充 remainingReimbursement 与 advancesValue；账单重分类预览在扣款挪动前对比 currentDebitData.balance 与 previewDebitData.isCorporateCard。PIX 转出返回 pixKey 与 balanceAfter；TED 携带 bankCode、branchCode 与 accountNumber；交通卡列出 issuerName 与 number。

薪酬团队用钱袋余额对 PAT 入账，财务把报告写入总账，资金侧盯公司卡的 flashCategory 合计。openData Studio 把这些字段变成可调用的开放数据。

应用截图

API 端点一览

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

员工福利与卡片品类

POST /v1/wallet/benefits/lookup openfinance

拉取登录员工的福利钱包（餐、食、出行、健康）以及首页公司卡所用的品类键。

认证方式：请求头携带会话令牌与公司范围头；资金类调用另附应用版本头与设备指纹头。

employeeId
_id
benefits
name
key
flashCategories
creditCard
balance

POST /v1/wallet/benefits/lookup HTTP/1.1
X-Session-Token: <session>
X-Company-Id: cmp_8f21
X-App-Version: 6.24.0
Content-Type: application/json

{
  "employeeId": "emp_10482"
}

{
  "employeeId": "emp_10482",
  "benefits": [
    {
      "_id": "ben_refeicao",
      "name": "Flash Refeição",
      "key": "MEAL",
      "flashCategories": [
        {
          "key": "meal"
        }
      ],
      "balance": 842.5
    }
  ],
  "creditCard": {
    "flashCategories": [
      {
        "key": "corporate"
      }
    ]
  }
}

福利钱包对应的商城商品

POST /v1/marketplace/offers/resolve opendata

返回 Clube Flash 商品、可用哪个福利钱包支付，以及购买弹层上的标价子商品。

认证方式：请求头携带会话令牌与公司范围头；资金类调用另附应用版本头与设备指纹头。

productId
benefitsIds
flashCategory
offerType
allowedBenefits
subproducts
price
discountRate
expirationDate

POST /v1/marketplace/offers/resolve HTTP/1.1
X-Session-Token: <session>
X-Company-Id: cmp_8f21
Content-Type: application/json

{
  "productId": "prd_clube_gift",
  "benefitsIds": [
    "ben_refeicao"
  ]
}

{
  "productId": "prd_clube_gift",
  "name": "Vale presente",
  "nickname": "Gift",
  "status": "ACTIVE",
  "flashCategory": "convenience",
  "offerType": "VOUCHER",
  "allowedBenefits": [
    {
      "_id": "ben_refeicao",
      "name": "Flash Refeição",
      "key": "MEAL"
    }
  ],
  "subproducts": [
    {
      "_id": "sub_50",
      "name": "R$ 50",
      "price": 50.0,
      "discountRate": 0,
      "expirationDate": "2026-12-31"
    }
  ]
}

报销费用列表

POST /v1/spend/entries/search openfinance

分页返回员工报销明细：金额、商户、品类、付款卡与 GPS 采集标记，供 Despesas 收件箱使用。

认证方式：请求头携带会话令牌与公司范围头；资金类调用另附应用版本头与设备指纹头。

id
status
value
currencyPrefix
expenseDate
type
cardId
lastFourDigits
category
establishment
gpsStatus
total
currentPage
pages

POST /v1/spend/entries/search HTTP/1.1
X-Session-Token: <session>
X-Company-Id: cmp_8f21
Content-Type: application/json

{
  "page": 1,
  "limit": 20,
  "hasPending": true,
  "onlyWithViolations": false
}

{
  "expenses": [
    {
      "id": 881203,
      "status": "PENDING",
      "value": 87.4,
      "currencyPrefix": "R$",
      "expenseDate": "2026-10-12",
      "type": "CARD",
      "cardId": "crd_corp_19",
      "card": {
        "lastFourDigits": "4412"
      },
      "category": {
        "id": 14,
        "description": "Alimentação"
      },
      "establishment": {
        "place": "Padaria São Paulo"
      },
      "gpsStatus": "CAPTURED"
    }
  ],
  "total": 36,
  "currentPage": 1,
  "pages": 2
}

创建报销费用

POST /v1/spend/entries/create openfinance

从登记页（手工、刷卡或 OCR 小票）创建一条费用，并返回新 id 以及 GPS / 商户快照。

认证方式：请求头携带会话令牌与公司范围头；资金类调用另附应用版本头与设备指纹头。

value
expenseDate
categoryId
costCenterId
projectId
paymentMethodId
placeId
lat
lng
referenceId
gpsStatus

POST /v1/spend/entries/create HTTP/1.1
X-Session-Token: <session>
X-Company-Id: cmp_8f21
Content-Type: application/json

{
  "value": 87.4,
  "expenseDate": "2026-10-12",
  "categoryId": 14,
  "costCenterId": 3,
  "projectId": 9,
  "paymentMethodId": 2,
  "establishment": {
    "placeId": "plc_01",
    "place": "Padaria São Paulo",
    "lat": -23.561,
    "lng": -46.656
  }
}

{
  "id": 881203,
  "status": "DRAFT",
  "value": 87.4,
  "currencyPrefix": "R$",
  "referenceId": "EXP-881203",
  "gpsStatus": "CAPTURED",
  "establishment": {
    "place": "Padaria São Paulo",
    "lat": -23.561,
    "lng": -46.656
  }
}

报销报告列表

POST /v1/spend/reports/search openfinance

分页返回报销报告，含可报销金额、预支合计与当前审批人，对应 Relatórios 界面。

认证方式：请求头携带会话令牌与公司范围头；资金类调用另附应用版本头与设备指纹头。

id
name
referenceId
status
value
currencyPrefix
submittedAt
remainingReimbursement
reimbursableValue
advancesValue
approver

POST /v1/spend/reports/search HTTP/1.1
X-Session-Token: <session>
X-Company-Id: cmp_8f21
Content-Type: application/json

{
  "page": 1,
  "limit": 10,
  "onlyWithPendencies": true
}

{
  "reports": [
    {
      "id": 22011,
      "name": "Viagem SP out/26",
      "referenceId": "RPT-22011",
      "status": "SUBMITTED",
      "value": 1240.0,
      "currencyPrefix": "R$",
      "submittedAt": "2026-10-14T18:02:11Z",
      "remainingReimbursement": 190.0,
      "reimbursableValue": 1050.0,
      "advancesValue": 400.0,
      "approver": {
        "name": "Marina Costa"
      }
    }
  ],
  "total": 4,
  "currentPage": 1,
  "pages": 1
}

预支款项列表

POST /v1/spend/prepayments/search openfinance

列出可挂到报销报告上的预支款，含金额、状态与指定审批人。

认证方式：请求头携带会话令牌与公司范围头；资金类调用另附应用版本头与设备指纹头。

id
referenceId
status
advanceDate
value
currencyCode
currencyPrefix
approver
report

POST /v1/spend/prepayments/search HTTP/1.1
X-Session-Token: <session>
X-Company-Id: cmp_8f21
Content-Type: application/json

{
  "page": 1,
  "limit": 20,
  "isOpenToAttach": true
}

{
  "advances": [
    {
      "id": 5502,
      "referenceId": "ADV-5502",
      "status": "APPROVED",
      "advanceDate": "2026-10-01",
      "value": 400.0,
      "currencyCode": "BRL",
      "currencyPrefix": "R$",
      "approver": {
        "id": 88,
        "name": "Marina Costa"
      },
      "report": {
        "id": 22011,
        "name": "Viagem SP out/26",
        "referenceId": "RPT-22011"
      }
    }
  ],
  "total": 1,
  "currentPage": 1,
  "pages": 1
}

从福利钱包发起 TED 转账
POST /v1/wallet/transfers/bank openbanking
从指定福利钱包向巴西银行账户发起 TED；errors 为空表示转账已被接受。
认证方式：请求头携带会话令牌与公司范围头；资金类调用另附应用版本头与设备指纹头。
- employeeId
- benefitId
- amount
- bankCode
- branchCode
- accountNumber
- errors
- field
- message
- code
```
POST /v1/wallet/transfers/bank HTTP/1.1
X-Session-Token: <session>
X-Company-Id: cmp_8f21
X-Device-Fingerprint: dev_9aa1
Content-Type: application/json

{
  "employeeId": "emp_10482",
  "benefitId": "ben_refeicao",
  "amount": 200.0,
  "bankCode": "001",
  "branchCode": "3410",
  "accountNumber": "12345-6"
}
```
```
{
  "errors": []
}
```

个人交通卡

POST /v1/commute/cards/list openfinance

返回与员工 CPF 绑定的交通卡（发卡方、城市、卡号），供充值流程使用。

认证方式：请求头携带会话令牌与公司范围头；资金类调用另附应用版本头与设备指纹头。

_id
cpf
transportCards
name
number
cityId
cityName
issuerId
issuerName

POST /v1/commute/cards/list HTTP/1.1
X-Session-Token: <session>
X-Company-Id: cmp_8f21
Content-Type: application/json

{}

{
  "_id": "per_771",
  "cpf": "12345678901",
  "transportCards": [
    {
      "name": "Bilhete Único",
      "number": "0012345678",
      "cityId": "sp",
      "cityName": "São Paulo",
      "issuerId": "sptrans",
      "issuerName": "SPTrans"
    }
  ]
}

购买交通卡充值

POST /v1/commute/topups/purchase openbanking

用福利钱包购买交通卡充值，返回 rechargeId 与 ticketTransactionId。

认证方式：请求头携带会话令牌与公司范围头；资金类调用另附应用版本头与设备指纹头。

cardNumber
issuerId
cityId
benefitId
amount
rechargeId
rechargeStatus
ticketTransactionId

POST /v1/commute/topups/purchase HTTP/1.1
X-Session-Token: <session>
X-Company-Id: cmp_8f21
X-App-Version: 6.24.0
X-Device-Fingerprint: dev_9aa1
Content-Type: application/json

{
  "cardNumber": "0012345678",
  "issuerId": "sptrans",
  "cityId": "sp",
  "benefitId": "ben_vt",
  "amount": 50.0
}

{
  "rechargeId": "rch_9981",
  "rechargeStatus": "CONFIRMED",
  "ticketTransactionId": "txn_vt_441",
  "errors": []
}

账单重分类预览

POST /v1/ledger/reassignments/preview openfinance

在确认挪动之前，预览把一笔账单扣款从福利钱包挪到公司卡（或反向）。

认证方式：请求头携带会话令牌与公司范围头；资金类调用另附应用版本头与设备指纹头。

employeeId
transactionId
currentDebitData
previewDebitData
amount
balance
isCorporateCard
name

POST /v1/ledger/reassignments/preview HTTP/1.1
X-Session-Token: <session>
X-Company-Id: cmp_8f21
Content-Type: application/json

{
  "employeeId": "emp_10482",
  "transactionId": "txn_cc_19"
}

{
  "currentDebitData": {
    "amount": 87.4,
    "balance": 842.5,
    "isCorporateCard": false,
    "name": "Flash Refeição"
  },
  "previewDebitData": {
    "amount": 87.4,
    "balance": 1910.0,
    "isCorporateCard": true,
    "name": "Cartão corporativo"
  },
  "error": null
}

按 Flash 品类的支出图

POST /v1/insights/spend/by-category opendata

返回公司卡按品类汇总的支出，供账单洞察图表使用。

认证方式：请求头携带会话令牌与公司范围头；资金类调用另附应用版本头与设备指纹头。

employeeId
creditCard
flashCategories
name
key
summaryByEmployee
total
flashCategory

POST /v1/insights/spend/by-category HTTP/1.1
X-Session-Token: <session>
X-Company-Id: cmp_8f21
Content-Type: application/json

{
  "employeeId": "emp_10482"
}

{
  "employeeId": "emp_10482",
  "creditCard": {
    "flashCategories": [
      {
        "name": "Alimentação",
        "image": "meal.png",
        "description": "Refeições",
        "key": "meal"
      }
    ],
    "summaryByEmployee": [
      {
        "total": 1240.55,
        "flashCategory": "meal"
      }
    ]
  }
}

实体公司卡详情
GET /v1/cards/corporate/face openbanking
读取钱包里展示的实体公司卡卡面（后四位、有效期、是否开通国际交易）。
认证方式：请求头携带会话令牌与公司范围头；资金类调用另附应用版本头与设备指纹头。
- financeCardId
- lastFourDigits
- status
- holderName
- expiryMonth
- expiryYear
- cardType
- internationalEnabled
```
GET /v1/cards/corporate/face?financeCardId=crd_corp_19 HTTP/1.1
X-Session-Token: <session>
X-Company-Id: cmp_8f21
X-App-Version: 6.24.0
```
```
{
  "financeCardId": "crd_corp_19",
  "lastFourDigits": "4412",
  "status": "ACTIVE",
  "holderName": "ANA SOUZA",
  "expiryMonth": 12,
  "expiryYear": 28,
  "cardType": "PHYSICAL",
  "internationalEnabled": false
}
```

PIX 转出预览

POST /v1/wallet/instant-transfers/quote openbanking

在确认之前预览从福利钱包发起的 PIX 转出（收款人、手续费、转后余额）。

认证方式：请求头携带会话令牌与公司范围头；资金类调用另附应用版本头与设备指纹头。

pixKey
amount
benefitId
recipientName
fee
benefitName
balanceAfter

POST /v1/wallet/instant-transfers/quote HTTP/1.1
X-Session-Token: <session>
X-Company-Id: cmp_8f21
X-Device-Fingerprint: dev_9aa1
Content-Type: application/json

{
  "pixKey": "[email protected]",
  "amount": 75.0,
  "benefitId": "ben_refeicao"
}

{
  "recipientName": "ANA SOUZA",
  "pixKey": "[email protected]",
  "amount": 75.0,
  "fee": 0,
  "benefitId": "ben_refeicao",
  "benefitName": "Flash Refeição",
  "balanceAfter": 767.5
}

卡片账单列表

GET /v1/cards/entries openbanking

分页返回公司卡与福利卡账单流水，供 Extrato 界面使用。

认证方式：请求头携带会话令牌与公司范围头；资金类调用另附应用版本头与设备指纹头。

financeCardId
transactionId
amount
currency
merchantName
flashCategory
postedAt
isCorporateCard
lastFourDigits
hasMore

GET /v1/cards/entries?financeCardId=crd_corp_19&page=1 HTTP/1.1
X-Session-Token: <session>
X-Company-Id: cmp_8f21

{
  "items": [
    {
      "transactionId": "txn_cc_19",
      "amount": 87.4,
      "currency": "BRL",
      "merchantName": "Padaria São Paulo",
      "flashCategory": "meal",
      "postedAt": "2026-10-12T12:41:00Z",
      "isCorporateCard": true,
      "lastFourDigits": "4412"
    }
  ],
  "page": 1,
  "hasMore": true
}

创建费用报销

POST /v1/spend/out-of-pocket/create openfinance

创建一笔垫付报销（商户、品类、事由），随后挂到报销报告上。

认证方式：请求头携带会话令牌与公司范围头；资金类调用另附应用版本头与设备指纹头。

amount
date
establishmentName
category
justification
additionalCommentary
id

POST /v1/spend/out-of-pocket/create HTTP/1.1
X-Session-Token: <session>
X-Company-Id: cmp_8f21
Content-Type: application/json

{
  "amount": 120.0,
  "date": "2026-10-11",
  "establishmentName": "Farmácia Droga Raia",
  "category": "health",
  "justification": "Medicamento durante viagem",
  "additionalCommentary": "Receita anexa"
}

{
  "id": "rmb_331",
  "amount": 120.0,
  "date": "2026-10-11",
  "establishmentName": "Farmácia Droga Raia",
  "category": "health",
  "justification": "Medicamento durante viagem",
  "additionalCommentary": "Receita anexa"
}

数据类别

福利余额
报销报告
预支款
TED 转账
PIX 支付
交通卡
公司卡
卡片账单
垫付报销
支出品类

数据使用场景与案例

发薪周期福利对账
HRIS 机器人在发薪后拉取每名员工的 benefits[].balance、key 与 flashCategories，标出余额与 PAT 入账文件不一致的钱袋。
报销报告写入 ERP
财务集成分页读取报销报告的 remainingReimbursement 与 advancesValue，再把每条费用明细（value、lastFourDigits、establishment.place、costCenter）写入总账。
公司卡支出监控
资金看板把账单列表与按 flashCategory 的合计拼在一起，并在 isCorporateCard 支出相对餐补钱袋陡增时告警。
PIX 与 TED 流出审计
合规工具回放 PIX 预览（pixKey、balanceAfter）与 TED 入参（bankCode、branchCode、accountNumber），并对照会话上的反欺诈设备 id。

常见问题

Flash 为员工暴露哪些余额？

员工记录上的每只福利钱袋都有 balance，以及 key 与 flashCategories（餐、食、出行、健康）。公司卡支出按 flashCategory 汇总；PIX 预览会返回将要扣款的钱袋的 balanceAfter。

报销报告和预支款是什么关系？

报告带 remainingReimbursement、reimbursableValue 与 advancesValue。预支款本身有 advanceDate、value、currencyCode 和审批人，并可按 referenceId 挂到报告上。

能看到 PIX 和 TED 的对手方吗？

可以。PIX 预览返回 pixKey、recipientName、fee 与 balanceAfter。TED 请求接受 bankCode、branchCode 与 accountNumber，目标被拒绝时返回字段级 errors。

这些调用如何鉴权？

CPF 登录后，客户端在每次调用上发送会话令牌与公司范围头。转出和卡片路由还会附上应用版本头与设备指纹头。

与 Flash | Benefícios e Despesas 相似的应用

Meu Alelo — Alelo 面向巴西职工发行 PAT 餐补、食品、文化与交通卡，Meu Alelo 应用用来扫码支付、写入 Google Pay 与 Apple Pay，并管理卡片。
Pluxee Brasil — Pluxee Brasil（原 Sodexo Benefícios e Incentivos）是 Pluxee 餐补、食品、文化、礼品与燃油卡的持卡人应用，也覆盖最多七个钱包的 Multibenefícios 卡。
SuperApp VR — SuperApp VR 是 VR Benefícios 的职工应用，用来查看 VR Multi 的餐、食、居家办公、用车和奖励余额，并用二维码或虚拟卡付款。
Ticket — Ticket 是 Edenred 在巴西的员工福利品牌，覆盖 Ticket Restaurante、Alimentação、Flex、Transporte 与 Cultura 卡，由官方 Ticket 应用管理。
Caju — Caju 是巴西的福利与支出平台，把 CLT、PAT 与弹性福利余额以及报销、预支放在一张 Visa 受理卡和员工应用上。
iFood Benefícios — iFood Benefícios 是 PAT 多余额卡，覆盖餐、出行、文化、健康、教育和居家办公津贴，可在 iFood 应用及 Elo 商户消费。
Swile Brasil — Swile Brasil 是已登记 PAT 的多福利 Mastercard，把餐、食、健康、出行、居家办公、教育、燃油和奖励钱包放在一张卡上，并配职工应用与 Dash RH。

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

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

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

获取报价

Flash Benefícios 私有数据 API

应用截图

API 端点一览

员工福利与卡片品类

福利钱包对应的商城商品

报销费用列表

创建报销费用

报销报告列表

预支款项列表

从福利钱包发起 TED 转账

个人交通卡

购买交通卡充值

账单重分类预览

按 Flash 品类的支出图

实体公司卡详情

PIX 转出预览

卡片账单列表

创建费用报销

数据类别

数据使用场景与案例

发薪周期福利对账

报销报告写入 ERP

公司卡支出监控

PIX 与 TED 流出审计

常见问题

与 Flash | Benefícios e Despesas 相似的应用

更多支付类应用

BharatPe for Business

BrasilCard Cliente

BukuWarung Apps for MSMEs

CashBook - Balance & Expense

相关主题

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

Flash Benefícios 私有数据 API

应用截图

API 端点一览

员工福利与卡片品类

福利钱包对应的商城商品

报销费用列表

创建报销费用

报销报告列表

预支款项列表

从福利钱包发起 TED 转账

个人交通卡

购买交通卡充值

账单重分类预览

按 Flash 品类的支出图

实体公司卡详情

PIX 转出预览

卡片账单列表

创建费用报销

数据类别

数据使用场景与案例

发薪周期福利对账

报销报告写入 ERP

公司卡支出监控

PIX 与 TED 流出审计

常见问题

相关应用

与 Flash | Benefícios e Despesas 相似的应用

更多支付类应用

BharatPe for Business

BrasilCard Cliente

BukuWarung Apps for MSMEs

CashBook - Balance & Expense

相关主题

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