Minha Vero 数据 API：账单、Wi-Fi 与芯片

Vero Internet · 电信

Minha Vero 是 Vero Internet 面向巴西光纤宽带家庭用户的自助应用：以 CPF 或 CNPJ 登录（之后可用生物识别再次解锁），即可查看当期账单、缴费或协商欠费，在信用卡扣款与自动借记间切换，为电子账单开启邮件或 WhatsApp 推送，并修改合同计费日。同一客户端还能重置家庭 Wi-Fi 名称与密码、预约或评价技术员上门、提交客服工单，并办理过户——现任与新任持有人都需提供 CPF 及 RG 或 CNH。telefonia 板块涵盖附加手机线路：套餐详情、NF-e、SIM 卡激活、芯片锁定与寄送追踪，另有 Globoplay 等增值服务。它是 Vero 光纤覆盖区（米纳斯吉拉斯州，以及以 Vero / Quero Vero 品牌销售的巴西其他市场）的自助渠道，与公开的 FAQ 和测速网站并行，而非面向全国的通用电信超级应用。

未结账单在 link_pagamento、valorTotal、linhaDigitavel 与 pixCopiaCola 旁标有 data_vencimento 和 dia_cobranca；扣款方式要么是信用卡的 creditCardNumber/item_brand 组合，要么是记在 NOME_BANCO、COD_CLIE_DEBITO_EM_CONTA、agencia_numero 与 conta_numero 下的银行借记。电子账单投递存为 fatura_digital，外加 envio_por_email 与 envio_por_whatsapp。家庭接入由带 pppoe_username 与 statusConexao 的 wifi_ssid 构成；上门作业是按 bairro（街区）划分的日历，最终落成 data_hora_agendada。过户流程携带双方持有人的 cpf_cnpj；手机板块列出 numero_simcard、status_chip 与 codigo_rastreio。

催收团队把未结账单与 PIX 复制粘贴码对账，现场运营按街区填满技术员时段，客服台无需二次登录即可叠加查看 Wi-Fi 与芯片状态。openData Studio 把这套订阅用户侧的接口面变成可调用的开放数据。

应用截图

API 端点一览

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

登录订阅用户会话
POST /v1/auth/subscriber-session osint
验证 Vero 光纤订阅用户身份，返回会话令牌及计费、Wi-Fi、客服调用所用的合同标识。
认证方式：无需认证。JSON 请求体含 username（CPF/CNPJ 或合同登录名）与 password。返回的 access_token 存放在设备上，之后通过生物识别解锁。
- username
- password
- access_token
- expires_in
- token_expires_in
- numero_contrato
- id_contrato
- cpf_cnpj
```
POST /v1/auth/subscriber-session HTTP/1.1
Content-Type: application/json

{
  "username": "12345678901",
  "password": "********"
}
```
```
{
  "access_token": "<accessToken>",
  "expires_in": 86400,
  "token_expires_in": 86400,
  "numero_contrato": "C-88421",
  "id_contrato": "88421",
  "cpf_cnpj": "12345678901"
}
```
检查登录账号是否已存在
GET /v1/identity/lookup osint
查询某个 CPF/用户名是否已开通，据此把用户引向登录、找回密码或新线索表单。
认证方式：无需认证。在输入密码之前，于登录/线索界面使用的身份探测。
- cliente_existe
- username
- cpf_cnpj
```
GET /v1/identity/lookup?username=12345678901 HTTP/1.1
```
```
{
  "cliente_existe": true,
  "username": "12345678901",
  "cpf_cnpj": "12345678901"
}
```
列出密码重置选项
GET /v1/auth/credential-recovery/options osint
发送验证码前，告知找回密码界面可用哪些渠道（短信、邮件、WhatsApp）重置登录。
认证方式：无需认证。查询参数 username 为在找回密码界面输入的 CPF/CNPJ 或合同登录名。
- username
- sms_enviado
- email
- whatsapp
- password_reset_code
```
GET /v1/auth/credential-recovery/options?username=12345678901 HTTP/1.1
```
```
{
  "username": "12345678901",
  "sms_enviado": false,
  "email": "a***@example.com",
  "whatsapp": "55319****7766"
}
```

签发账单支付链接

GET /v1/billing/invoices/payment-link openfinance

返回未结账单的托管收银台 URL、金额、到期日、boleto 的 linhaDigitavel 与 PIX 复制粘贴码，供缴费或协商。

认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。

numero_contrato
id_fatura
erp_invoice_id
link_pagamento
valorTotal
data_vencimento
linhaDigitavel
pixCopiaCola
status

GET /v1/billing/invoices/payment-link?numero_contrato=C-88421 HTTP/1.1
Authorization: Bearer <accessToken>

{
  "numero_contrato": "C-88421",
  "id_fatura": "FT-202610-88421",
  "erp_invoice_id": "88421-202610",
  "link_pagamento": "https://checkout.example/pay/ft-202610-88421",
  "valorTotal": 129.90,
  "data_vencimento": "2026-10-15",
  "linhaDigitavel": "23793.38128 60000.000003 00000.000000 1 00000000012990",
  "pixCopiaCola": "00020126...",
  "status": "VENCIDO"
}

获取欠费协商 URL

GET /v1/billing/invoices/negotiation-link openfinance

订阅用户对逾期账单点按“协商账单”时，返回托管的欠费协商会话 URL。

认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。

url
id_fatura
numero_contrato
valorTotal
status

GET /v1/billing/invoices/negotiation-link?numero_contrato=C-88421&id_fatura=FT-202610-88421 HTTP/1.1
Authorization: Bearer <accessToken>

{
  "url": "https://pay.example/session/nf-441",
  "id_fatura": "FT-202610-88421",
  "numero_contrato": "C-88421",
  "valorTotal": 129.90,
  "status": "EM NEGOCIAÇÃO"
}

登记新的循环扣款信用卡
POST /v1/billing/recurring-methods/card openfinance
应用内收银台面板关闭后，把新令牌化的信用卡保存为合同的循环扣款方式。
认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。在此持久化调用之前，卡片录入会先交给 Smart Checkout 面板。
- numero_contrato
- creditCardNumber
- item_brand
- brand
- forma_pagamento
```
POST /v1/billing/recurring-methods/card HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "numero_contrato": "C-88421",
  "creditCardNumber": "************4421",
  "item_brand": "MASTERCARD",
  "forma_pagamento": "CARTAO"
}
```
```
{
  "ok": true,
  "forma_pagamento": "CARTAO",
  "creditCardNumber": "************4421",
  "item_brand": "MASTERCARD",
  "brand": "MASTERCARD"
}
```
列出合同已登记信用卡
GET /v1/billing/recurring-methods/cards openfinance
读取已存档的信用卡，使循环支付界面能展示当前方式或提供更换。
认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。
- cadastros
- creditCardNumber
- item_brand
- brand
- forma_pagamento
```
GET /v1/billing/recurring-methods/cards?numero_contrato=C-88421 HTTP/1.1
Authorization: Bearer <accessToken>
```
```
{
  "cadastros": [
    {
      "creditCardNumber": "************4421",
      "item_brand": "MASTERCARD",
      "brand": "MASTERCARD",
      "forma_pagamento": "CARTAO"
    }
  ]
}
```

登记银行自动借记

POST /v1/billing/recurring-methods/bank-debit openfinance

把合同切换为从指定银行账户自动借记，是信用卡循环扣款之外的另一选择。

认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。

numero_contrato
NOME_BANCO
COD_CLIE_DEBITO_EM_CONTA
agencia_numero
agencia_digito
conta_numero
conta_digito
forma_pagamento
FAT_CLIENTE_DEBITO_EM_CONTA

POST /v1/billing/recurring-methods/bank-debit HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "numero_contrato": "C-88421",
  "NOME_BANCO": "Banco do Brasil",
  "COD_CLIE_DEBITO_EM_CONTA": "001-12345-6",
  "agencia_numero": "1234",
  "agencia_digito": "5",
  "conta_numero": "12345",
  "conta_digito": "6",
  "FAT_CLIENTE_DEBITO_EM_CONTA": true,
  "forma_pagamento": "DEBITO_EM_CONTA"
}

{
  "ok": true,
  "forma_pagamento": "DEBITO_EM_CONTA",
  "NOME_BANCO": "Banco do Brasil",
  "COD_CLIE_DEBITO_EM_CONTA": "001-12345-6",
  "agencia_numero": "1234",
  "conta_numero": "12345",
  "FAT_CLIENTE_DEBITO_EM_CONTA": true
}

读取合同的借记账户
GET /v1/billing/recurring-methods/bank-debit-account openfinance
返回当前挂在合同上的银行借记账户，使支付设置界面能展示或取消它。
认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。
- forma_pagamento
- NOME_BANCO
- COD_CLIE_DEBITO_EM_CONTA
- agencia_numero
- conta_numero
- numero_contrato
- FAT_CLIENTE_DEBITO_EM_CONTA
```
GET /v1/billing/recurring-methods/bank-debit-account?numero_contrato=C-88421 HTTP/1.1
Authorization: Bearer <accessToken>
```
```
{
  "forma_pagamento": "DEBITO_EM_CONTA",
  "NOME_BANCO": "Banco do Brasil",
  "COD_CLIE_DEBITO_EM_CONTA": "001-12345-6",
  "agencia_numero": "1234",
  "conta_numero": "12345",
  "FAT_CLIENTE_DEBITO_EM_CONTA": true,
  "numero_contrato": "C-88421"
}
```

把账单切换为电子投递

PUT /v1/billing/invoices/digital-delivery openfinance

关闭纸质账单，把 fatura 发到订阅用户的邮箱和/或 WhatsApp。

认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。

numero_contrato
fatura_digital
envio_por_email
envio_por_whatsapp
email
whatsapp

PUT /v1/billing/invoices/digital-delivery HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "numero_contrato": "C-88421",
  "fatura_digital": true,
  "envio_por_email": true,
  "envio_por_whatsapp": true,
  "email": "[email protected]",
  "whatsapp": "5531999887766"
}

{
  "ok": true,
  "fatura_digital": true,
  "envio_por_email": true,
  "envio_por_whatsapp": true,
  "email": "[email protected]",
  "whatsapp": "5531999887766"
}

修改合同计费日

POST /v1/billing/subscription/billing-day openfinance

到期日设置界面确认修改后，更新合同的扣款日以及由此产生的到期日。

认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。

numero_contrato
dia_cobranca
diaVencimento
dataPagamento
data_vencimento

POST /v1/billing/subscription/billing-day HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "numero_contrato": "C-88421",
  "dia_cobranca": 10,
  "diaVencimento": 15
}

{
  "ok": true,
  "dia_cobranca": 10,
  "diaVencimento": 15,
  "dataPagamento": "2026-10-15",
  "data_vencimento": "2026-10-15"
}

列出可选的计费日
GET /v1/billing/subscription/billing-day-options openfinance
返回到期日设置界面可选的到期日，之后再保存扣款日修改。
认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。
- diasVencimento
- diaVencimento
- dia_cobranca
```
GET /v1/billing/subscription/billing-day-options?numero_contrato=C-88421 HTTP/1.1
Authorization: Bearer <accessToken>
```
```
{
  "diasVencimento": [5, 10, 15, 20],
  "diaVencimento": 15,
  "dia_cobranca": 10
}
```
签发 Smart Checkout 嵌入令牌
GET /v1/payments/checkout/embed-token openfinance
签发短时有效的嵌入令牌；保存信用卡到合同前，应用内卡片录入面板需要它。
认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。查询参数 key 标识收银台商户。
- token
- bemobi_recorrencia_token
- token_expires_in
- tokenExpiresIn
- key
```
GET /v1/payments/checkout/embed-token?key=recurring-card HTTP/1.1
Authorization: Bearer <accessToken>
```
```
{
  "token": "<embedToken>",
  "embed_token": "<embedToken>",
  "token_expires_in": 900,
  "tokenExpiresIn": 900,
  "key": "recurring-card"
}
```
取消合同的循环扣款
POST /v1/billing/recurring-methods/cancel openfinance
停用信用卡或借记的循环扣款，下一期 fatura 改用其他方式收取。
认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。
- numero_contrato
- forma_pagamento
```
POST /v1/billing/recurring-methods/cancel HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "numero_contrato": "C-88421",
  "forma_pagamento": "CARTAO"
}
```
```
{
  "ok": true,
  "numero_contrato": "C-88421",
  "forma_pagamento": "CARTAO"
}
```
打开更换支付方式收银台
GET /v1/payments/checkout/change-method openfinance
加载嵌入式收银台，在应用内更改下一期 fatura 的支付方式（信用卡、借记或 PIX）。
认证方式：登录后签发的查询参数 token；内嵌收银台视图只接受来自其自身来源的消息。
- token
- forma_pagamento
- status
```
GET /v1/payments/checkout/change-method?token=<checkoutToken> HTTP/1.1
```
```
{
  "token": "<checkoutToken>",
  "forma_pagamento": "PIX",
  "status": "READY"
}
```
读取家庭 Wi-Fi 名称与凭据
GET /v1/broadband/gateway/wifi opendata
返回 Wi-Fi 设置客服界面所用的网关 Wi-Fi 名称、密码、PPPoE 用户名与链路状态。
认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。
- wifi_ssid
- wifiNome
- wifiSenha
- wifi_password
- pppoe_username
- statusConexao
- frequencia
- canal
```
GET /v1/broadband/gateway/wifi?numero_contrato=C-88421 HTTP/1.1
Authorization: Bearer <accessToken>
```
```
{
  "wifi_ssid": "VERO-88421",
  "wifiNome": "VERO-88421",
  "wifiSenha": "********",
  "wifi_password": "********",
  "pppoe_username": "c88421@vero",
  "statusConexao": "ONLINE",
  "frequencia": "5GHz",
  "canal": 36
}
```

列出账号下的设备

POST /v1/broadband/devices/list opendata

返回挂在光纤合同下的 CPE/用户设备，即设备客服界面背后的清单。

认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。

dispositivos
host
wifi_ssid
statusConexao

POST /v1/broadband/devices/list HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "numero_contrato": "C-88421"
}

{
  "dispositivos": [
    {
      "host": "ONU-Sala",
      "wifi_ssid": "VERO-88421",
      "statusConexao": "ONLINE"
    }
  ]
}

发起过户
POST /v1/account/ownership-transfer osint
开启更换持有人流程，收集现任与新任持有人的身份信息，并返回用于跟踪签署的协议号。
认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。双方持有人均需附上 CPF 以及 RG 或 CNH。
- numero_contrato
- cpf_cnpj
- documento
- numero_protocolo_atendimento
- status
```
POST /v1/account/ownership-transfer HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "numero_contrato": "C-88421",
  "cpf_cnpj": "12345678901",
  "documento": "RG"
}
```
```
{
  "numero_protocolo_atendimento": "TT-2026-44119",
  "status": "AGUARDANDO_ASSINATURA",
  "numero_contrato": "C-88421",
  "cpf_cnpj": "12345678901"
}
```
列出客服工单原因
GET /v1/support/tickets/reasons opendata
返回新建客服工单时展示的原因目录；另有相关调用可为工单上传附件。
认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。
- motivos
- codigo
- descricao
```
GET /v1/support/tickets/reasons HTTP/1.1
Authorization: Bearer <accessToken>
```
```
{
  "motivos": [
    {"codigo": "WIFI", "descricao": "Wi-Fi lento ou instavel"},
    {"codigo": "FATURA", "descricao": "Duvida de cobranca"}
  ]
}
```
列出可预约的上门日期
GET /v1/field-service/visit-slots opendata
返回订阅用户所在街区的技术员时段日历，供上门预约流程使用。
认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。
- bairro
- dias
- data_hora_agendada
- periodo
- turno
```
GET /v1/field-service/visit-slots?bairro=Savassi HTTP/1.1
Authorization: Bearer <accessToken>
```
```
{
  "bairro": "Savassi",
  "dias": ["2026-10-12", "2026-10-13", "2026-10-15"],
  "data_hora_agendada": null,
  "periodo": "manha",
  "turno": "AM"
}
```

评价已完成的上门服务

POST /v1/field-service/visits/rating opendata

评分界面提交后保存已完成上门的技术员星级评分；另有相关调用返回评分历史。

认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。

numero_contrato
numero_protocolo_atendimento
score
comentario

POST /v1/field-service/visits/rating HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "numero_contrato": "C-88421",
  "numero_protocolo_atendimento": "OS-55210",
  "score": 5,
  "comentario": "Tecnico pontual"
}

{
  "ok": true,
  "numero_protocolo_atendimento": "OS-55210",
  "score": 5
}

加载手机线路总览

GET /v1/mobile/lines/overview opendata

列出订阅用户 CPF/CNPJ 名下手机线路及其套餐和 SIM 状态，是 Mobile 标签页的载荷。

认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。

cpf_cnpj
linhas
numero_simcard
nome_plano
plano_movel
status_chip
codigo_rastreio

GET /v1/mobile/lines/overview?cpf_cnpj=12345678901 HTTP/1.1
Authorization: Bearer <accessToken>

{
  "cpf_cnpj": "12345678901",
  "linhas": [
    {
      "numero_simcard": "31998887766",
      "nome_plano": "Vero Movel 20GB",
      "plano_movel": "Vero Movel 20GB",
      "status_chip": "ATIVA",
      "codigo_rastreio": null
    }
  ]
}

锁定手机芯片

POST /v1/mobile/sim/block opendata

锁定一张 Vero móvel 芯片（丢失或被盗），并返回锁定线路界面展示的协议号。

认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。

cpf_cnpj
numero_simcard
motivo
status_chip
numero_protocolo_atendimento

POST /v1/mobile/sim/block HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "cpf_cnpj": "12345678901",
  "numero_simcard": "31998887766",
  "motivo": "PERDA"
}

{
  "ok": true,
  "numero_simcard": "31998887766",
  "status_chip": "BLOQUEADA",
  "numero_protocolo_atendimento": "CH-88102"
}

获取手机套餐的 NF-e
GET /v1/mobile/billing/tax-invoices opendata
返回针对订阅用户 CPF/CNPJ 的 móvel 套餐所开具的电子发票（NF-e）。
认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。
- cpf_cnpj
- notas_fiscais
- id_fatura
- valorTotal
- data_vencimento
```
GET /v1/mobile/billing/tax-invoices?cpf_cnpj=12345678901 HTTP/1.1
Authorization: Bearer <accessToken>
```
```
{
  "cpf_cnpj": "12345678901",
  "notas_fiscais": [
    {
      "id_fatura": "NF-202610-01",
      "valorTotal": 39.90,
      "data_vencimento": "2026-10-10"
    }
  ]
}
```
追踪 SIM 卡寄送
GET /v1/mobile/sim/shipment-tracking opendata
在申请激活之后，返回芯片/SIM 卡寄送的邮政追踪码。
认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。
- codigo_rastreio
- status_chip
- numero_simcard
```
GET /v1/mobile/sim/shipment-tracking?cpf_cnpj=12345678901 HTTP/1.1
Authorization: Bearer <accessToken>
```
```
{
  "codigo_rastreio": "AM123456789BR",
  "status_chip": "EM_TRANSITO",
  "numero_simcard": "31998887766"
}
```

读取增值服务配置

POST /v1/subscription/addons/config opendata

列出光纤合同上已启用的增值服务（SVA），例如 Globoplay。

认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。

svas
codigo
ativo
nome
numero_contrato

POST /v1/subscription/addons/config HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "numero_contrato": "C-88421"
}

{
  "svas": [
    {"codigo": "GLOBOPLAY", "ativo": true, "nome": "Globoplay"}
  ],
  "numero_contrato": "C-88421"
}

查询大面积故障公告
GET /v1/network/outage-bulletin opendata
开工单前，告知客服首页订阅用户所在街区是否处于全网故障。
认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。
- bairro
- massiva
- statusConexao
```
GET /v1/network/outage-bulletin?bairro=Savassi HTTP/1.1
Authorization: Bearer <accessToken>
```
```
{
  "bairro": "Savassi",
  "massiva": true,
  "statusConexao": "INSTAVEL"
}
```
为合同启用信任复机
PUT /v1/billing/subscription/trust-reactivation opendata
按 Vero 的信任复机政策，为被停用的光纤合同重新开通，限每 30 天一次。
认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。
- numero_contrato
- podeSolicitarHabilitacaoEmConfianca
```
PUT /v1/billing/subscription/trust-reactivation HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "numero_contrato": "C-88421"
}
```
```
{
  "ok": true,
  "numero_contrato": "C-88421",
  "podeSolicitarHabilitacaoEmConfianca": false
}
```
列出年度结清凭证
GET /v1/billing/receipts/annual-payoff openfinance
返回按年度归档的结清文件，供凭证界面预览或下载。
认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。
- quitacoes
- ano
- numero_contrato
- receiptId
- valorTotal
```
GET /v1/billing/receipts/annual-payoff?numero_contrato=C-88421 HTTP/1.1
Authorization: Bearer <accessToken>
```
```
{
  "quitacoes": [
    {
      "ano": 2025,
      "numero_contrato": "C-88421",
      "receiptId": "QA-2025-88421",
      "valorTotal": 1558.80
    }
  ]
}
```

导出账单 PDF

GET /v1/billing/invoices/export-pdf openfinance

从账单导出界面返回光纤 fatura 的可下载 PDF。

认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。

numero_contrato
id_fatura
erp_invoice_id
url

GET /v1/billing/invoices/export-pdf?numero_contrato=C-88421&id_fatura=FT-202610-88421 HTTP/1.1
Authorization: Bearer <accessToken>

{
  "numero_contrato": "C-88421",
  "id_fatura": "FT-202610-88421",
  "erp_invoice_id": "88421-202610",
  "url": "https://cdn.example/invoices/FT-202610-88421.pdf"
}

列出光纤税务发票（NF）
GET /v1/billing/tax-invoices openfinance
列出针对光纤合同开具的电子发票（nota fiscal），与 móvel 的 NF-e 调用相互独立。
认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。
- notas_fiscais
- id_fatura
- valorTotal
- data_vencimento
- numero_contrato
- cpf_cnpj
```
GET /v1/billing/tax-invoices?numero_contrato=C-88421 HTTP/1.1
Authorization: Bearer <accessToken>
```
```
{
  "notas_fiscais": [
    {
      "id_fatura": "NF-202610-88421",
      "valorTotal": 129.90,
      "data_vencimento": "2026-10-15",
      "numero_contrato": "C-88421",
      "cpf_cnpj": "12345678901"
    }
  ]
}
```

列出已预约的上门服务

GET /v1/field-service/visits opendata

返回已预约的技术员上门记录，可查询、改期或取消。

认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。

numero_protocolo_atendimento
bairro
data_hora_agendada
data_hora_baixada
dataHoraBaixada
dataHoraCancelamento
periodo
turno

GET /v1/field-service/visits?numero_contrato=C-88421 HTTP/1.1
Authorization: Bearer <accessToken>

{
  "visitas": [
    {
      "numero_protocolo_atendimento": "OS-55210",
      "bairro": "Savassi",
      "data_hora_agendada": "2026-10-12T09:00:00-03:00",
      "data_hora_baixada": null,
      "dataHoraCancelamento": null,
      "periodo": "manha",
      "turno": "AM"
    }
  ]
}

读取 móvel 套餐详情

GET /v1/mobile/lines/plan-details opendata

返回单条 móvel 线路的套餐名称与芯片状态，即套餐选择界面背后的详情载荷。

认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。

cpf_cnpj
numero_simcard
nome_plano
plano_movel
status_chip
chip_status_nome

GET /v1/mobile/lines/plan-details?cpf_cnpj=12345678901&numero_simcard=31998887766 HTTP/1.1
Authorization: Bearer <accessToken>

{
  "cpf_cnpj": "12345678901",
  "numero_simcard": "31998887766",
  "nome_plano": "Vero Movel 20GB",
  "plano_movel": "Vero Movel 20GB",
  "status_chip": "ATIVA",
  "chip_status_nome": "Ativo"
}

列出可用于自动借记的银行
GET /v1/billing/bank-catalog openfinance
返回直接借记设置界面在保存借记账户之前所用的银行目录。
认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。
- bancos
- codigo
- NOME_BANCO
```
GET /v1/billing/bank-catalog HTTP/1.1
Authorization: Bearer <accessToken>
```
```
{
  "bancos": [
    {"codigo": "001", "NOME_BANCO": "Banco do Brasil"},
    {"codigo": "237", "NOME_BANCO": "Bradesco"}
  ]
}
```

按 ICCID 查询芯片

GET /v1/mobile/sim/lookup opendata

把扫描或手动输入的 ICCID 解析为 SIM 状态，使查找芯片 / 激活芯片流程得以继续。

认证方式： Bearer access_token，来自 POST /v1/auth/subscriber-session。

iccid
chip_iccid
numero_simcard
status_chip
chip_status_nome
codigo_rastreio

GET /v1/mobile/sim/lookup?iccid=89550000000000000000 HTTP/1.1
Authorization: Bearer <accessToken>

{
  "iccid": "89550000000000000000",
  "chip_iccid": "89550000000000000000",
  "numero_simcard": "31998887766",
  "status_chip": "PRONTO_ATIVACAO",
  "chip_status_nome": "Pronto para ativacao",
  "codigo_rastreio": null
}

数据类别

账单
支付
用户资料
Wi-Fi
设备
客服工单
技术员上门
手机线路
税务票据
故障停网
增值服务

数据使用场景与案例

对账光纤账单与 PIX、条码支付
账单机器人按 numero_contrato 拉取 link_pagamento、valorTotal、data_vencimento、linhaDigitavel 与 pixCopiaCola，并与 PIX 或 boleto 的结算记录匹配，把超过 diaVencimento 仍为 VENCIDO 的行标记出来。
把循环扣款方式同步到 ISP 的 CRM
夜间任务读取 forma_pagamento，加上 creditCardNumber/item_brand，或 NOME_BANCO 连同 COD_CLIE_DEBITO_EM_CONTA、agencia_numero 与 conta_numero，再写入 fatura_digital、envio_por_email 和 envio_por_whatsapp，让催收部门知道下一期账单走信用卡、借记还是仅电子投递。
按街区日历调度技术员
现场运营按 bairro 列出可选日期，用 periodo 与 turno 预订 data_hora_agendada，再把 visita tecnica 的 score 记在协议号下，使 SLA 看板既能看到上门时段，也能看到上门后的评分。
为客服盘点 Wi-Fi 与 móvel 线路
客服台叠加层展示 wifi_ssid、pppoe_username、statusConexao 与网关 dispositivos，以及 telefonia 的 linhas（含 numero_simcard、nome_plano、status_chip 和 codigo_rastreio），无需让订阅用户重复输入标识，即可直接触发芯片锁定。

常见问题

Minha Vero 如何认证订阅用户的调用？

登录提交 username（CPF/CNPJ 或合同登录名）与 password，返回 access_token 及合同标识 numero_contrato、id_contrato；后续调用以 Bearer 令牌携带，已存会话可用生物识别解锁。另有无需认证的查询在输入密码前检查 cliente_existe。

有哪些账单与支付字段可用？

未结账单返回 link_pagamento、valorTotal、data_vencimento、linhaDigitavel 与 pixCopiaCola，逾期账单返回托管协商 URL。循环扣款存信用卡（creditCardNumber、item_brand）或银行借记（NOME_BANCO、COD_CLIE_DEBITO_EM_CONTA、agencia_numero、conta_numero）作为 forma_pagamento；计费日写入 dia_cobranca 与 diaVencimento；电子投递存 fatura_digital 及 envio_por_email、envio_por_whatsapp。

接口面是否包含 Wi-Fi、上门服务与 móvel 线路？

包含。网关读取返回 wifi_ssid、wifiSenha、pppoe_username 与 statusConexao，设备调用列出 CPE 清单。技术员预约按 bairro 列出可约日期，含 data_hora_agendada、periodo 与 turno，上门评分记在 numero_protocolo_atendimento 下。手机总览列出 linhas（nome_plano、status_chip、numero_simcard），另有芯片锁定、NF-e 发票与 codigo_rastreio 追踪。

这是 Vero 公开的开发者 API 吗？

不是。这些是应用登录后调用的自有端点，覆盖计费、Wi-Fi、上门服务与手机线路，此处作为数据面记录，而非开放的合作伙伴计划。

与 Minha Vero 相似的应用

Minha Claro — Minha Claro 是巴西 Claro 的自助服务应用，覆盖手机、家庭宽带和电视：用户可查看并支付账单、下载第二联、开通电子账单或自动扣款、跟踪上门维修并配置家用 Wi-Fi。
Vivo — 巴西 Telefónica 旗下的 Vivo 应用把手机和家庭光纤业务放在同一客户端管理，覆盖账单、客服与充值。
MEU TIM — MEU TIM 是 TIM 巴西的用户应用，管理手机与家庭套餐：可开具账单第二联、通过 PIX 或 Open Finance 付款，并在应用内处理 Ultra Fibra 网络问题。
Algar — Algar 是 Algar Telecom 的自助应用，面向预付费和后付费用户，可跟踪账单、查询流量、申请技术支持、为线路充值并协商未结款项。
Nio — Nio 是巴西 Nio 光纤用户的自助应用，可查询账单、用 Pix 或银行卡付款、处理故障并配置家用 Wi-Fi。
Desktop — Desktop 是巴西光纤运营商 Desktop 的用户应用，可开具 boleto 第二联、查看近期账单、更新账户资料，并在暂停后申请信用重开。
Minha Unifique — Minha Unifique 是 Unifique 的自助应用，面向互联网、数字固话、移动、电视和数据中心用户，可查看已订服务、付款、待缴账单、提交支持并修改 Wi-Fi 密码。

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

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

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

获取报价

Minha Vero 数据 API：账单、Wi-Fi 与芯片

应用截图

API 端点一览

登录订阅用户会话

检查登录账号是否已存在

列出密码重置选项

签发账单支付链接

获取欠费协商 URL

登记新的循环扣款信用卡

列出合同已登记信用卡

登记银行自动借记

读取合同的借记账户

把账单切换为电子投递

修改合同计费日

列出可选的计费日

签发 Smart Checkout 嵌入令牌

取消合同的循环扣款

打开更换支付方式收银台

读取家庭 Wi-Fi 名称与凭据

列出账号下的设备

发起过户

列出客服工单原因

列出可预约的上门日期

评价已完成的上门服务

加载手机线路总览

锁定手机芯片

获取手机套餐的 NF-e

追踪 SIM 卡寄送

读取增值服务配置

查询大面积故障公告

为合同启用信任复机

列出年度结清凭证

导出账单 PDF

列出光纤税务发票（NF）

列出已预约的上门服务

读取 móvel 套餐详情

列出可用于自动借记的银行

按 ICCID 查询芯片

数据类别

数据使用场景与案例

对账光纤账单与 PIX、条码支付

把循环扣款方式同步到 ISP 的 CRM

按街区日历调度技术员

为客服盘点 Wi-Fi 与 móvel 线路

常见问题

相关应用

与 Minha Vero 相似的应用

更多电信类应用

Asiacell

Azercell

hambi (Beeline Uzbekistan)

Hathway Broadband

相关主题

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