MaisMei DAS 与 DASN 数据 API
MaisMei: Guias DAS & MEI is the MEI Super App from MaisMei (UTM Tecnologia da Informacao LTDA, CNPJ 37.851.341/0001-80), a private Brazilian company that is not affiliated with the federal government. Individual Microentrepreneurs use it to track monthly DAS payment slips and due dates, copy a boleto barcode or PIX code, prepare the annual DASN statement, share CNPJ details and the CCMEI certificate, open or update an MEI through gov.br, issue NFS-e and NFC-e invoices and PDF receipts, and get help on overdue DAS or Divida Ativa installment plans. The Play listing is rated 4.8 from about 170,000 reviews with 5 million-plus downloads, and the store copy says more than 4 million entrepreneurs use it. It sits alongside Portal do Empreendedor on gov.br as a private DAS/DASN organizer for Brazilian MEIs rather than an official Receita app.
每月 DAS 缴税单与年度 DASN 申报列表是首页要同步的核心记录:每张 guia 带有 dataVencimento、valorGuia 以及可复制的 codigoBarras 或 pixCopiaECola;DASN 行则给出 anoCalendario、receitaBruta 以及该年是否仍 pending。已关联的 MEI 以 cnpj 与 cpf 为键;在 gov.br 的 meiSession 之后,Cartao CNPJ 界面会给出 nomeFantasia、situacaoCadastral 与 ccmeiUrl。
记账机器人可以盯逾期 DAS 并发起 Dívida Ativa 分期检查(hasActiveDebt、numeroParcelas);开票工具可以看 NFS-e 全国开票是否就绪(emissorReady、inscricaoMunicipal、cityIbge)以及 NFC-e 是否已有 inscricaoEstadual。openData Studio 把这些字段变成可调用的开放数据。
应用截图
API 端点一览
以下端点与请求/响应示例均依据应用界面推导重构,为示意说明,并非实际抓包。
开始 gov.br 账号绑定
POST
/v1/govbr/link/startosint启动应用内 gov.br 绑定流程,供后续 MEI 会话、DAS 刷新与 NFS-e 全国开票设置使用。
认证方式: 无前置会话的引导调用。请求体为持有人 CPF 与 gov.br 手机号;手机 OTP 步骤下发的一次性验证码完成绑定,之后的调用携带 mei-session。
- cpf
- phone
- verificationCode
- govBrTempData
- authorized
- nextStep
POST /v1/govbr/link/start HTTP/1.1 Content-Type: application/json { "cpf": "12345678901", "phone": "11987654321", "verificationCode": "847291" }{ "govBrTempData": "tmp_gov_7f3a", "cpf": "12345678901", "phone": "11987654321", "authorized": false, "nextStep": "confirm-phone" }打开 gov.br MEI 会话
POST
/v1/govbr/mei/sessionosint签发 gov.br MEI 会话,供 DAS 缴税单刷新、DASN 申报检查、Dívida Ativa 以及 NFS-e 全国开票设置使用。
认证方式: 应用会话 Bearer,外加 POST /v1/govbr/link/start 返回的 govBrTempData。响应中的 meiSession 会用在对接 Receita / gov.br 的 DAS、DASN、Dívida Ativa 与 NFS-e 调用上。
- meiSession
- cpf
- cnpj
- authorized
- govBrTempData
POST /v1/govbr/mei/session HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.app Content-Type: application/json { "govBrTempData": "tmp_gov_7f3a", "cpf": "12345678901", "cnpj": "12345678000190" }{ "meiSession": "mei_sess_9c21e4", "cpf": "12345678901", "cnpj": "12345678000190", "authorized": true, "govBrTempData": "tmp_gov_7f3a" }按 CPF 查询是否已有 MEI CNPJ
GET
/v1/mei/cnpj/lookuposint查询已登录 CPF 是否已有 MEI CNPJ,以便界面给出「Já sou MEI」或「Abra seu MEI」。
认证方式: 应用会话 Bearer。查询参数为持有人 CPF;用于「Já sou MEI / Nao tem CNPJ」界面,再进入 associate-to-user。
- cpf
- found
- cnpj
- nomeFantasia
- situacaoCadastral
GET /v1/mei/cnpj/lookup?cpf=12345678901 HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.app{ "cpf": "12345678901", "found": true, "cnpj": "12345678000190", "nomeFantasia": "Studio Luz MEI", "situacaoCadastral": "ATIVA" }把 MEI CNPJ 关联到应用用户
POST
/v1/mei/cnpj/attachopendata将 MEI CNPJ 关联到已登录用户,使 DAS、DASN 与 CCMEI 界面加载该公司记录。
认证方式: 应用会话 Bearer。请求体为「Selecione o MEI que deseja acessar」所选 CNPJ;持卡人与登录人不一致时可附带 CPF。
- cnpj
- cpf
- associated
- nomeFantasia
- optanteSimei
POST /v1/mei/cnpj/attach HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.app Content-Type: application/json { "cnpj": "12345678000190", "cpf": "12345678901" }{ "cnpj": "12345678000190", "cpf": "12345678901", "associated": true, "nomeFantasia": "Studio Luz MEI", "optanteSimei": true }刷新全部 DAS 缴税单
GET
/v1/das/guias/refreshopenfinance重新加载「Atualizar guias DAS」上的月度 DAS 缴税单,含到期日、金额以及用于支付的 boleto 条码 / PIX copia-e-cola。
认证方式: 应用会话 Bearer,外加 POST /v1/govbr/mei/session 的 meiSession。范围限定为已关联 CNPJ。
- cnpj
- periodoApuracao
- dataVencimento
- valorGuia
- statusDas
- codigoBarras
- pixCopiaECola
GET /v1/das/guias/refresh HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.app X-Mei-Session: mei_sess_9c21e4{ "cnpj": "12345678000190", "guias": [ { "periodoApuracao": "2026-09", "dataVencimento": "2026-10-20", "valorGuia": 80.90, "statusDas": "ABERTA", "codigoBarras": "8580000000809000302620261020", "pixCopiaECola": "00020126BR.GOV.BCB.PIX..." } ] }DAS 分期同步状态
GET
/v1/das/parcelamento/syncopenfinance读取 DAS 分期模拟是否已同步,以及期数与每期金额。
认证方式: 应用会话 Bearer 加 meiSession。在逾期 DAS 的「Contratar parcelamento」之后使用。
- cnpj
- syncStatus
- installmentId
- numeroParcelas
- valorParcela
- statusDas
GET /v1/das/parcelamento/sync HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.app X-Mei-Session: mei_sess_9c21e4{ "cnpj": "12345678000190", "syncStatus": "READY", "installmentId": "par_das_8821", "numeroParcelas": 8, "valorParcela": 95.40, "statusDas": "PARCELADO" }列出 DASN 年度申报
GET
/v1/dasn/declarationsopendata返回「Declaracao do MEI (DASN)」上的申报年份列表,含未申报年份与已填报的营业收入。
认证方式: 应用会话 Bearer 加 meiSession。可选 id 查询参数指定某个日历年。
- cnpj
- id
- anoCalendario
- statusDasn
- receitaBruta
- pending
GET /v1/dasn/declarations?id=2025 HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.app X-Mei-Session: mei_sess_9c21e4{ "cnpj": "12345678000190", "items": [ { "id": "2025", "anoCalendario": 2025, "statusDasn": "PENDENTE", "receitaBruta": 62400.00, "pending": true } ] }启动 DASN 申报检查
POST
/v1/dasn/declarations/validateopendata启动 DASN 校验,供某个日历年的 MEI 年度申报提交前使用。
认证方式: 应用会话 Bearer 加 meiSession。查询参数 id 为正在申报的日历年。
- cnpj
- anoCalendario
- receitaBruta
- id
- checkStatus
- canDeclare
- pending
POST /v1/dasn/declarations/validate?id=2025 HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.app X-Mei-Session: mei_sess_9c21e4 Content-Type: application/json { "cnpj": "12345678000190", "anoCalendario": 2025, "receitaBruta": 62400.00 }{ "id": "2025", "checkStatus": "OK", "anoCalendario": 2025, "canDeclare": true, "pending": false }启动 Dívida Ativa(欠税)检查
POST
/v1/divida-ativa/checkopenfinance检查该 MEI 是否存在可进入分期计划的 Dívida Ativa / 逾期 DAS。
认证方式: 应用会话 Bearer 加 meiSession。来自逾期 DAS / Dívida Ativa 专家流程。
- cnpj
- checkId
- hasActiveDebt
- debtAmount
- canInstall
POST /v1/divida-ativa/check HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.app X-Mei-Session: mei_sess_9c21e4 Content-Type: application/json { "cnpj": "12345678000190" }{ "cnpj": "12345678000190", "checkId": "debt_chk_441", "hasActiveDebt": true, "debtAmount": 1290.50, "canInstall": true }列出结账支付方式
GET
/v1/checkout/methodsopenbanking返回结账时提供的 PIX copia-e-cola、boleto 条码与银行卡品牌(Pagar.me)。
认证方式: 应用会话 Bearer。用于 MaisMei 服务(开业、分期、Plus)的 PIX / boleto / 银行卡结账。
- method
- pixCopiaECola
- PagarmeEncryptionKey
- boletoBarcode
- cardBrand
GET /v1/checkout/methods HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.app{ "methods": [ { "method": "PIX", "pixCopiaECola": "00020126BR.GOV.BCB.PIX...", "PagarmeEncryptionKey": "ek_live_***" }, { "method": "BOLETO", "boletoBarcode": "23793.38128 60000.000003 00000.000400 1 84470000008090" }, { "method": "CARD", "cardBrand": "Hipercard" } ] }轮询订单支付状态
POST
/v1/checkout/statusopenbanking确认 MaisMei 订单(开业、分期、订阅)在 PIX、boleto 或银行卡支付后是否已到账。
认证方式: 应用会话 Bearer。查询参数 id 为 PIX、boleto、银行卡或应用内购买结账后创建的订单。
- id
- method
- paymentStatus
- paidAt
- cupom
- discountPercent
POST /v1/checkout/status?id=ord_9f12 HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.app Content-Type: application/json { "id": "ord_9f12", "method": "PIX" }{ "id": "ord_9f12", "method": "PIX", "paymentStatus": "PAID", "paidAt": "2026-10-02T15:04:11-03:00", "cupom": "MEI10", "discountPercent": 10 }NFS-e 全国开票 gov.br 会话
POST
/v1/nfse/emissor/sessionopendata在切换城市后打开 NFS-e 全国开票会话,以便从手机开具服务发票。
认证方式: 应用会话 Bearer 加 meiSession。用于「Configuracao de NFS-e / Emissor Nacional de Notas Fiscais」。
- cnpj
- meiSession
- cityIbge
- inscricaoMunicipal
- emissorReady
POST /v1/nfse/emissor/session HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.app X-Mei-Session: mei_sess_9c21e4 Content-Type: application/json { "cnpj": "12345678000190", "cityIbge": "3550308" }{ "cnpj": "12345678000190", "meiSession": "mei_sess_9c21e4", "cityIbge": "3550308", "inscricaoMunicipal": "12345678", "emissorReady": true }NFC-e 标识与州登记表
GET
/v1/nfce/taxpayer/formopendata加载开具 R$ 1,00 测试发票前所需的 NFC-e 纳税人标识与州登记号。
认证方式: 应用会话 Bearer 加 meiSession。配套的 certifier-form 与 ie-form 完成 NFC-e 设置。
- cnpj
- inscricaoEstadual
- uf
- certifierStatus
- nfceEnabled
GET /v1/nfce/taxpayer/form HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.app X-Mei-Session: mei_sess_9c21e4{ "cnpj": "12345678000190", "inscricaoEstadual": "172.016.651.110", "uf": "SP", "certifierStatus": "ACTIVE", "nfceEnabled": true }按邮编取开业地址
GET
/v1/abertura/cepopendata把巴西 CEP 解析为街道、街区、城市、州与 IBGE 代码,供 MEI 开业表单使用。
认证方式: MEI 开业流程中的应用会话 Bearer。CEP 查询也可使用公开的巴西邮编回退。
- cep
- logradouro
- bairro
- localidade
- uf
- ibge
GET /v1/abertura/cep?cep=01310100 HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.app{ "cep": "01310-100", "logradouro": "Avenida Paulista", "bairro": "Bela Vista", "localidade": "Sao Paulo", "uf": "SP", "ibge": "3550308" }CNPJ 卡片与 CCMEI 详情
GET
/v1/cnpj/cardosint返回「Ver certificado / Cartao CNPJ」上展示的 CNPJ 卡片字段与 CCMEI 证明链接。
认证方式: 应用会话 Bearer。查询参数为已关联 CNPJ;fetchCnpjCardStore 加载可分享的 Cartao CNPJ。
- cnpj
- nomeFantasia
- situacaoCadastral
- dataAbertura
- ccmeiUrl
- optanteSimei
GET /v1/cnpj/card?cnpj=12345678000190 HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.app{ "cnpj": "12345678000190", "nomeFantasia": "Studio Luz MEI", "situacaoCadastral": "ATIVA", "dataAbertura": "2021-03-18", "ccmeiUrl": "https://files.example.com/ccmei/12345678000190.pdf", "optanteSimei": true }
数据类别
- DAS 缴税单
- DASN 年度申报
- CNPJ 与 CCMEI 卡片
- gov.br MEI 会话
- NFS-e 全国开票设置
- NFC-e 纳税人标识
- PIX 与 boleto 结账
- Dívida Ativa 分期
- MEI 开业地址
数据使用场景与案例
会计 DAS 日历
记账机器人每晚拉取月度 DAS 缴税单,把 dataVencimento 与 valorGuia 写入客户台账,并在到期日前三天若 statusDas 仍为 ABERTA 则提醒 MEI。
逾期 DAS 分期台
催收流程先检查 Dívida Ativa 再同步 DAS 分期状态,仅在 hasActiveDebt 为真且 numeroParcelas 已模拟时才向顾问展示 Contratar parcelamento。
NFS-e 城市就绪
开票插件读取 NFS-e 全国开票会话与 NFC-e 标识表单,确认 emissorReady、inscricaoMunicipal 与 inscricaoEstadual 齐全后再发服务或消费发票。
带核验邮编的 MEI 开业
正规化漏斗按 CEP 取得 logradouro、bairro、localidade 与 ibge,再查询该 CPF 是否已有 CNPJ,避免再次开业。
常见问题
MaisMei 暴露哪些税务记录?
DAS 中心返回每月 guia 的 dataVencimento、valorGuia、statusDas 以及 boleto 的 codigoBarras 或 pixCopiaECola。DASN 列表按日历年返回 anoCalendario、receitaBruta 与 pending。CNPJ 卡片调用还给出 nomeFantasia、situacaoCadastral 与 ccmeiUrl。
应用里的 gov.br 鉴权如何工作?
POST /v1/govbr/link/start 用 CPF 与手机号启动应用内 gov.br 绑定;POST /v1/govbr/mei/session 随后签发 meiSession,供 DAS 刷新、DASN 申报检查、Dívida Ativa 与 NFS-e 全国开票使用。它们是用户授权 MaisMei 在 Portal do Governo 核验资料之后的第一方调用,不是公开的 Receita 开发者 API。
能从这套接口开 NFS-e 或 NFC-e 吗?
设置端点覆盖全国开票会话(emissorReady、inscricaoMunicipal、cityIbge)以及 NFC-e 标识/州登记表(inscricaoEstadual、certifierStatus)。应用还会生成 PDF 或图片收据;真正开票仍走 Emissor Nacional,需该会话已就绪。
PIX 与 boleto 怎么用?
GET /v1/checkout/methods 返回 PIX copia-e-cola、boleto 条码以及经 Pagar.me(PagarmeEncryptionKey)的银行卡品牌。POST /v1/checkout/status 轮询开业、分期与订阅订单的 paymentStatus。DAS guia 自身也带 codigoBarras 与 pixCopiaECola 用于月度税单。
相关主题
- MaisMei DAS API
- DASN MEI
- gov.br MEI session
- CNPJ CCMEI
- NFS-e 全国开票
- NFC-e 州登记
- PIX boleto MEI
- Dívida Ativa 分期
- guia DAS 条码
- 巴西 MEI 税务数据 API
需要集成这个 App 的数据 API?
我们可为任意指定 App 交付定制集成——源码交付 USD 500 起,或托管 API 按调用计费。告诉我们您需要的数据即可。
- 每个项目均签 NDA 与 SOW
- 3–7 天交付
- 验收通过后才付款
- 仅在授权范围内作业