U8C API中心

API中心

基本档案
部门档案

指导视频
对接方案模板
工具
游客

部门档案新增

接口所在U8C版本:U8 cloud2.7以及更高版本

详细描述:用于部门档案新增

API视频讲解API详情补丁列表常见问题参考

接口地址

请求方式

请求参数header

请求参数body

返回类型参数

代码示例

请求参数示例

正确返回示例

错误返回示例

接口地址:http://ip:port/u8cloud/api/uapbd/bddept/save

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南

参数名	必填	描述	默认值
Content-Type	是	请求体数据类型	application/json
usercode	是	用户
password	是	密码
trantype	否		code
system	是	系统参数
uniquekey	否	幂等唯一key

请求参数(body):

全量参数最简示例有上级部门

参数名	类型	是否数组	必填	描述
deptdoc		是	是	部门档案
addr	string	否	否	部门地址
createDate	string	否	是	创建时间
def1	string	否	否	自定义1
def10	string	否	否	自定义10
def11	string	否	否	自定义11
def12	string	否	否	自定义12
def13	string	否	否	自定义13
def14	string	否	否	自定义14
def15	string	否	否	自定义15
def16	string	否	否	自定义16
def17	string	否	否	自定义17
def18	string	否	否	自定义18
def19	string	否	否	自定义19
def2	string	否	否	自定义2
def20	string	否	否	自定义20
def3	string	否	否	自定义3
def4	string	否	否	自定义4
def5	string	否	否	自定义5
def6	string	否	否	自定义6
def7	string	否	否	自定义7
def8	string	否	否	自定义8
def9	string	否	否	自定义9
deptattr	string	否	是	部门属性（其他部门1，采购2，销售3，采购销售4）
deptcode	string	否	是	编码
deptduty	string	否	否	部门职责
deptlevel	string	否	否	部门级别
deptname	string	否	是	部门名称
deptshortname	string	否	否	简称
depttype	int	否	是	部门类型
isuseretail	boolean	否	是	是否用于零售
memo	string	否	否	备注
phone	string	否	否	部门电话
pk_calbody	string	否	否
pk_corp	string	否	是	公司编码
pk_fathedept	string	否	否	上级编码
pk_psndoc	string	否	否	负责人编码
pk_psndoc2	string	否	否	负责人2
pk_psndoc3	string	否	否	负责人3
remcode	string	否	否	助记码

返回类型参数:

参数名	类型	是否数组	必填	描述	默认值
deptvos
addr	string	否	否	部门地址
cancelDate	string	否	否	部门封存日期
canceled	boolean	否	是	部门是否封存	false
createDate	string	否	是	部门创建日期
def1	string	否	否	自定义项1
def10	string	否	否	自定义项10
def11	string	否	否	自定义项11
def12	string	否	否	自定义项12
def13	string	否	否	自定义项13
def14	string	否	否	自定义项14
def15	string	否	否	自定义项15
def16	string	否	否	自定义项16
def17	string	否	否	自定义项17
def18	string	否	否	自定义项18
def19	string	否	否	自定义项19
def2	string	否	否	自定义项2
def20	string	否	否	自定义项20
def3	string	否	否	自定义项3
def4	string	否	否	自定义项4
def5	string	否	否	自定义项5
def6	string	否	否	自定义项6
def7	string	否	否	自定义项7
def8	string	否	否	自定义项8
def9	string	否	否	自定义项9
deptattr	string	否	是	部门属性（1- 其他部门; 2 - 采购部门; 3 销售部门; 4 - 销售部门; 5 - 工厂;6 - 基本生产车间; 7- 辅助生产车间;）
deptcode	string	否	是	部门编码
deptduty	string	否	否	部门职责
deptlevel	string	否	否	部门级别
deptname	string	否	是	部门名称
deptshortname	string	否	否	部门简称
depttype	int	否	是	部门类型（ 0 - 普通部门; - 虚拟部门）
dr	string	否	否	删除标志
hrcanceled	boolean	否	否	部门撤销（HR模块使用）
innercode	string	否	否	内部编码
isuseretail	boolean	否	否	是否用于零售
maxinnercode	string	否	否	最大下级编码
memo	string	否	否	备注
orgType	int	否	否	组织类别
phone	string	否	否	部门电话
pk_calbody	string	否	否	对应库存组织主键
pk_corp	string	否	否	公司主键
pk_deptdoc	string	否	否	部门档案主键
pk_fathedept	string	否	否	上级部门档案主键
pk_psndoc	string	否	否	负责人主键
pk_psndoc2	string	否	否	部门负责人2
pk_psndoc3	string	否	否	部门负责人3
remcode	string	否	否	助记码
showorder	int	否	否	显示顺序
ts	string	否	否	时间戳
xtersysflag	int	否	否	外部系统标志（0 - 非外部系统; 非0 - 外部系统;）

代码示例:

Java模板示例下载 C#模板示例下载

请求参数示例:

最简示例有上级部门

复制代码

{
    "deptdoc": [
        {
            "createDate": "2023-01-01",
            "deptattr": "1",
            "deptcode": "DEV02",
            "deptname": "API新增部门02",
            "deptshortname": "API新增部门02",
            "depttype": "1",
            "isuseretail": false,
            "pk_corp": "3401"
        }
    ]
}

正确返回示例:

最简示例有上级部门

复制代码

{
    "status": "success",
    "data": "[{\"pk_corp\":\"1015\",\"unitcode\":\"3401\",\"unitname\":\"hjx建设银行有限公司\",\"createdate\":\"2023-01-01\",\"deptattr\":\"1\",\"deptname\":\"API新增部门02\",\"deptcode\":\"DEV02\",\"pk_deptdoc\":\"1015A210000000001QJ7\"}]",
    "taskNumber": "202309110119"
}

错误返回示例:

复制代码

{
status: "falied",
errorcode: "",
errormsg: "nc.vo.pub.BusinessException: 部门编码重复:101010",
stacktrace: "u8c.bs.bd.org.dept.bp.DeptSaveBp.save(DeptSaveBp.java:27);u8c.impl.bd.org.dept.action.DeptAPISaveAction.save(DeptAPISaveAction.java:30);u8c.impl.bd.org.dept.action.DeptAPISaveAction.save(DeptAPISaveAction.java:15);u8c.bs.action.save.AbstractBatchSaveAction.doAction(AbstractBatchSaveAction.java:38);u8c.bs.invoke.bp.JSONInvokeBP.invoke(JSONInvokeBP.java:60);u8c.impl.invoke.json.InvokeWithJSonImpl.invoke(InvokeWithJSonImpl.java:25);sun.reflect.GeneratedMethodAccessor232.invoke(Unknown Source);sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43);java.lang.reflect.Method.invoke(Method.java:606);nc.bs.framework.ejb.CMTProxyImpl.delegate(CMTProxyImpl.java:22);nc.itf.framework.ejb.CMTProxyEjbBean.delegate(CMTProxyEjbBean.java:44);nc.itf.framework.ejb.CMTProxy_Local.delegate(CMTProxy_Local.java:61);sun.reflect.GeneratedMethodAccessor37.invoke(Unknown Source);sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43);java.lang.reflect.Method.invoke(Method.java:606);nc.bs.framework.ejb.AbstractEJBServiceHandler.invoke(AbstractEJBServiceHandler.java:56);nc.bs.framework.ejb.AbstractEJBServiceHandler.invoke(AbstractEJBServiceHandler.java:34);com.sun.proxy.$Proxy11.delegate(Unknown Source);nc.bs.framework.ejb.CMTEJBServiceHandler.invoke(CMTEJBServiceHandler.java:32);com.sun.proxy.$Proxy32.invoke(Unknown Source);u8c.server.APIServletForJSON.doAction(APIServletForJSON.java:117);nc.bs.framework.server.api.InvokerAPIServlet.doAction(InvokerAPIServlet.java:130);nc.bs.framework.server.api.InvokerAPIServlet.doPost(InvokerAPIServlet.java:65);javax.servlet.http.HttpServlet.service(HttpServlet.java:650);javax.servlet.http.HttpServlet.service(HttpServlet.java:731);org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:303);org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:208);org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:52);org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:241);org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:208);nc.bs.framework.server.LoggerServletFilter.doFilter(LoggerServletFilter.java:34);org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:241);org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:208);org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:218);org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:110);org.apache.catalina.authenticator.AuthenticatorBase.invoke(AuthenticatorBase.java:506);org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:169);org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:103);org.apache.catalina.valves.RemoteIpValve.invoke(RemoteIpValve.java:683);org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:116);org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:445);org.apache.coyote.http11.AbstractHttp11Processor.process(AbstractHttp11Processor.java:1115);org.apache.coyote.AbstractProtocol$AbstractConnectionHandler.process(AbstractProtocol.java:637);org.apache.tomcat.util.net.JIoEndpoint$SocketProcessor.run(JIoEndpoint.java:316);java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1145);java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:615);org.apache.tomcat.util.threads.TaskThread$WrappingRunnable.run(TaskThread.java:61);java.lang.Thread.run(Thread.java:745);"
}