用友U8+ API接口使用教程

news/2024/12/11 18:28:19/

前言

U8+和其他的公开的开放API接口有一些差异,他是需要先对接的到代理服务器,通过代理服务器进行对接,所以只要保证U8+能上网就能对接,和畅捷通T+的模式有点类似
流程:

  1. 注册成为开发者(用于创建用友U8 API应用);
  2. 注册企业账号(用于提供数据);
  3. U8服务器上配置用友服务器数据接口,并安装和运行“用友开放平台客户端”;
  4. 开发者账号创建应用,并向企业账号申请授权;
  5. 企业账号审批通过应用授权申请,并在网站后台为应用配置数据源;
  6. 开发接入。

一、开发者和企业账号
首先,开发应用需要注册一个用友开放平台的开发者账号,通过认证后,可以在管理页面创建自己的应用,填写应用的基本信息,并选择需要的接口权限后,应用就创建完成了。
 


然后,用户需要到授权页面向指定的企业账号发起调用申请,在这个页面里也可以看到授权状态、U8开放平台客户端的运行状态。
 


而作为数据源的所有者,企业也需要注册一个开放平台的账号(企业账号应该也可以直接认证成开发者),这个账号主要有三个任务:审批来自开发者的应用授权申请;为开发者的应用配置数据源(网站和服务器);通过U8服务器上的开放平台软件发布数据接口。
下图是企业账号审批、查看应用授权的界面:


二、服务器数据源配置
服务器上一共用到三个软件:

  1. EAI接口设置:身份验证和数据源配置
  2. EAI环境检测与修复工具(平时没什么用,用来检测运行环境)
  3. 用友开放平台客户端(数据代理程序,必须打开才能提供外部数据访问)


三、接入

  1. 开发者:创建应用、申请权限;
  2. 企业账号:审批应用、配置网页数据参数、配置服务器EAI数据源、运行开放平台客户端。
    完成上述工作后,就可以正式接入API并开始开发工作了。
    需要注意的是,应用程序只需要具备Internet访问能力即可,不需要直接访问U8服务器,所有数据请求会从U8开放平台代理到U8服务器上。
    用友开放平台API参考手册:用友U8开放平台 - API中心

在开始前,第一步要做的就是用创建应用时的appkey和appsecret拿到Token,有了Token就可以按业务需求进行数据交互了。
除了token参数,几乎所有接口都有一个from_account参数和to_account参数,就像字面上所说,前者from_account指开发者账号,后者to_account是指数据提供方的企业账号。
Response

/// <summary>
/// 非列表类型的数据接口Response
/// </summary>
public class U8ResponseBase
{
[JsonPropertyName(“errcode”)]
public string ErrorCode { get; set; } = string.Empty;

[JsonPropertyName("errmsg")]
public string ErrorMessage { get; set; } = string.Empty;public bool Succ => ErrorCode == "0";

}
/// <summary>
/// 列表类型的数据接口Response
/// </summary>
public class U8ResponseList : U8ResponseBase
{
[JsonPropertyName(“page_index”)]
public string PageIndex { get; set; } = “0”;

[JsonPropertyName("page_count")]
public string PageCount { get; set; } = "0";[JsonPropertyName("row_count")]
public string RowCount { get; set; } = "0";

}

Token

public class U8ResponseToken : U8ResponseBase
{
[JsonPropertyName(“token”)]
public U8Token? Token { get; set; }
}
public class U8Token
{
[JsonPropertyName(“appKey”)]
public string AppKey { get; set; } = "";
[JsonPropertyName(“expiresIn”)]
public int ExpiresIn { get; set; }
[JsonPropertyName(“id”)]
public string Id { get; set; } = "";
/// <summary>
/// Token过期时间,取真实有效期的90%
/// </summary>
public DateTime Exp { get; set; }
}

GetToken(非列表类型的数据接口)
/// <summary>
/// 获取U8 Api Token
/// </summary>
/// <param name=“source”>调用方,仅用于记录</param>
/// <param name=“force”>不判断当前Token有效性,强制重新请求一个Token</param>
/// <returns></returns>
public static void GetToken(bool force = false)
{
//有效期剩余>10%,并且未要求强制刷新,并且上一次获取Token成功
if (Token.Exp < DateTime.Now && !force && Token.Success)
{
Console.WriteLine(“GetToken: Skip”);
return;
}
using WebClient client = new();

Token.Success = false;
try
{string resp = client.DownloadString($"https://api.yonyouup.com/system/token?" +$"from_account={STRINGS.FROM_ACCOUNT}&app_key={U8Credentials[0].AppKey}&app_secret={U8Credentials[0].AppSecret}");var respObj = JsonSerializer.Deserialize<U8ResponseToken>(resp);if (respObj?.Token is null){Console.WriteLine("GetToken: FAILED");return;}Token = respObj.Token;Token.Success = true;Token.Exp = DateTime.Now.AddSeconds(Token.ExpiresIn * 0.9);Console.WriteLine(JsonSerializer.Serialize(Token));
}
catch (Exception ex)
{Console.WriteLine($"GetToken: Exception {ex.Message}");
}//失败了就等下一次

}

批量获取采购订单(列表类型的数据接口)
public static void GetPurchaseOrders(DateTime start, DateTime end)
{
if (start.Year < 2000) start = DateTime.Now.AddDays(-7);
if (end.Year < 2000) end = DateTime.Now;
if (start > end) (start, end) = (end, start);

string date_begin = start.ToString("yyyy-MM-dd");
string date_end = end.ToString("yyyy-MM-dd");
//https://api.yonyouup.com/api/purchaseorderlist/batch_get
using WebClient client = new();
int pagecount = 1;
int page = 1;
List<U8PurchaseOrderSimple> simples = new();
while (page == 1 || page <= pagecount)
{string resp = client.DownloadString($"https://api.yonyouup.com/api/purchaseorderlist/batch_get?from_account={STRINGS.FROM_ACCOUNT}&to_account={STRINGS.TO_ACCOUNT}&" +$"app_key={U8Credentials[0].AppKey}&token={Token.Id}&rows_per_page=100&page_index={page++}&date_begin={date_begin}&date_end={date_end}");var batch = JsonSerializer.Deserialize<U8ResponsePurchaseOrderList>(resp) ?? new();simples = simples.Concat(batch.Orders).ToList();pagecount = Convert.ToInt32(batch.PageCount);Console.WriteLine($"{batch.PageIndex} of {pagecount}, {simples.Count} of {batch.RowCount}\r\n{resp}");
}

}

public class U8ResponsePurchaseOrderList : U8ResponseList
{
[JsonPropertyName(“purchaseorderlist”)]
public List<U8PurchaseOrderSimple> Orders { get; set; } = new();
}


http://www.ppmy.cn/news/1554289.html

相关文章

解决uview ui赋值后表单无法通过验证

微信小程序中 主要还是文档有这样一段话&#xff1a;//如果需要兼容微信小程序&#xff0c;并且校验规则中含有方法等&#xff0c;只能通过setRules方法设置规则。 添加即可通过 onReady() {//如果需要兼容微信小程序&#xff0c;并且校验规则中含有方法等&#xff0c;只能通过…

在react中使用组件的标签页写订单管理页面

在制作商城类的项目中&#xff0c;成功购物后&#xff0c;会生成订单&#xff0c;我们跳转到订单页面后就会需要使用这个标签页的组件。 首先呢我需要一个来渲染标签标题的一个数组。但是可以更便捷的方法就是直接将数组写入tabs标签内就进行遍历渲染。 // 使用styleCss对象中…

Day2——需求分析与设计

教师端签到应用软件的需求分析&#xff1b; 产品经理如何写好产品需求文档&#xff08;附模板&#xff09; 需求分析是软件开发过程中的关键步骤&#xff0c;它确保了开发的软件能够满足用户的需求。以下是进行需求分析的具体步骤&#xff1a; 1. 确定分析目标 明确教师端签到…

使用go生成、识别二维码

1、下载 # 创建目录 # 进入目录 # 执行 go mod init xxx 命令&#xff08;即&#xff1a;在当前目录初始化创建一个模块&#xff09;# 下载gozxing go get github.com/makiuchi-d/gozxing 2、生成二维码 package mainimport ("image/png""os""gith…

EMQ分布式MQTT消息服务器部署指南

1. EMQ简介 EMQ(Erlang MQTT Broker) 是基于Erlang/OTP平台开发的开源MQTT消息服务器,支持百万级连接和分布式集群。主要特点: 完整支持MQTT v3.1/v3.1.1/v5.0协议支持WebSocket协议支持分布式集群支持SSL/TLS加密传输提供Web管理控制台2. EMQ默认端口说明 EMQ默认开启以下服…

fastadmin集成xunsearch实战应用

背景 项目需求用到搜索引擎功能&#xff0c;fastadmin框架有比较成熟的插件xunsearch&#xff0c;如何灵活的提供给第三方产品使用。实战中根据不同条件查询记录 示例 //全文搜索public function search(){$keywords $this->request->request(keywords);$type (int)…

今天调了个转速的小BUG

同事说转速表有个bug&#xff0c;转速停止后&#xff0c;继电器没有恢复到初始状态。若停止之前是报警&#xff0c;继电器吸合&#xff0c;则停止后继电器还是吸合。我心想不会啊&#xff0c;这软件都弄了好几年了&#xff0c;一直也没出现过状况。 经过与调试同事的沟通&#…

使用Goland对6.5840项目进行go build出现异常

使用Goland对6.5840项目进行go build出现异常 Lab地址: https://pdos.csail.mit.edu/6.824/labs/lab-mr.html项目地址: git://g.csail.mit.edu/6.5840-golabs-2024 6.5840运行环境: mac系统 goland git clone git://g.csail.mit.edu/6.5840-golabs-2024 6.5840 cd 6.5840/src…