柠檬云财税能力开放平台
首页
登录服务
登录服务
  • 验证码登录
发票服务
发票服务
  • 发票同步
  • 发票开具
  • 发票查验
首页
登录服务
登录服务
  • 验证码登录
发票服务
发票服务
  • 发票同步
  • 发票开具
  • 发票查验
  1. 快速开始
  • 基本介绍
  • 快速开始
    • 开发必读
    • 认证鉴权
    • 调用模式
    • 接口调用
    • 对接地址
    • 错误码说明
    • 回调通知配置
  • 接口调用鉴权
    • 获取 access_token
      POST
    • 刷新访问令牌
      POST
  • 公共参数
    • 地区编码
  • 登录
    • 验证码登录
      • 创建企业登录任务
      • 创建代理企业登录任务
      • 登录任务状态查询
      • 提交短信验证码
  • 发票查验
    • 全国增值税查验平台查验
      POST
    • 电子税局电票平台查验
      POST
  • 发票同步
    • 发票数据同步
      • 发起发票数据同步
      • 发票数据同步状态查询
      • 发票数据同步结果查询
    • 勾选数据同步
      • 发起勾选数据同步
      • 勾选数据同步状态查询
      • 勾选数据同步结果查询
    • 附件下载
      • 创建发票附件下载任务
      • 发票附件下载任务状态查询
      • 发票附件下载结果查询
  • 发票开具
    • 人脸认证
      • 获取二维码
      • 人脸认证状态查询
      • 二维码状态查询
    • 基础信息
      • 获取用户信息
      • 授信额度查询
      • 本月开票统计查询
    • 字典数据
      • 获取指定类型字典数据
    • 开票信息维护
      • 项目信息维护
        • 商品分类查询
        • 商品分类新增
        • 商品分类编辑
        • 商品分类删除
        • 商品查询
        • 商品新增
        • 商品编辑
        • 商品删除
      • 客户信息维护
        • 客户分类查询
        • 客户分类新增
        • 客户分类编辑
        • 客户分类删除
        • 客户查询
        • 客户新增
        • 客户编辑
        • 客户删除
      • 附加信息维护
        • 模板查询
        • 模板新增
        • 模板编辑
        • 模板删除
        • 字段查询
        • 字段新增
        • 字段编辑
        • 字段删除
    • 红字发票开具
      • 确认单处理-异步任务
        • 确认单创建
        • 确认单创建任务状态查询
        • 确认单拒绝任务创建
        • 确认单拒绝任务状态查询
        • 确认单撤销任务创建
        • 确认单撤销任务状态查询
        • 确认单确认任务创建
        • 确认单确认任务状态查询
      • 确认单列表同步-异步任务
        • 发起确认单列表数据同步
        • 确认单列表数据同步状态查询
        • 已同步确认单列表查询
        • 已同步确认单文件下载
      • 获取确认单初始化数据
      • 发票列表数据查询
      • 确认单详情数据查询
      • 确认单列表数据查询
    • 蓝字发票开具
      • 相关前置查询
        • 成品油
          • 成品油库存查询
          • 成品油换算标准查询(税收商品)
          • 成品油换算标准查询(海关商品)
          • 成品油商品税收分类编码查询
          • 查询成品油税目编码
        • 建筑服务
          • 跨区域涉税事项报验管理编号信息查询
        • 金银首饰
          • 查询是否金银首饰企业试点企业
        • 涉税专业服务
          • 涉税专业服务协议要素采集信息表
      • 创建蓝字发票开具任务
      • 蓝字发票开具任务状态查询
      • 蓝字发票开具结果查询
      • 创建发票开具数据补齐任务
      • 发票开具数据补齐任务状态查询
  1. 快速开始

对接地址

柠檬云通过 HTTPS 协议对外提供 REST 风格的 API 服务。接入方完成商务签约后,将获得接口基础地址(apiHost)及专属的配套凭证,所有接口请求均需基于此地址发起。

API 环境说明#

环境接口地址说明
正式环境由商务团队随凭证一并提供联调与生产共用,需使用真实纳税人账号
💡
注意:当前仅开放正式环境,测试时须使用真实有效的纳税人账号。请在联调前与商务确认测试账号已就绪。

地址拼接规则#

接口完整地址 = https://<apiHost> + 接口路径,示例:
POST https://<apiHost>/api/v1/open/auth/login

快速验证#

拿到凭证后,可通过以下请求验证网络连通与鉴权是否正常:
若返回 access_token 字段,说明对接地址和凭证均已生效。

Apifox 调试#

接口规范文件支持导入 Apifox 进行可视化调试,如需获取请联系技术支持。
修改于 2026-05-22 09:16:22
上一页
接口调用
下一页
错误码说明
Built with