Spendia开放接口

工作流回调

接口描述

此接口用于工作流回调第三方接口，同步审批结果给第三方系统

请求URI

第三方提供

请求方式

POST

请求参数示例

第三方提供

请求体示例

{
  "entityKey": "aweFdwsxzBsadV132",
  "workflowCode": "6101",
  "processStatus": 1001,
  "lastApprovalDate": "2023-03-01 11:55:23",
  "lastApproverCode": "2109990",
  "lastApproverMail": "spendia@spendia.jp",
  "processCode": "WK000000001",
  "entityFields": [
    {
      "fieldCode": "47",
      "fieldType": "BANK_ACCOUNT",
      "inputType": "spot",
      "details": {
        "country": "JP",
        "bankCode": "0000",
        "bankName": "日本銀行",
        "branchCode": "567",
        "branchName": "秋田支店",
        "accountCategory": "2",
        "bankAccount": "4",
        "accountName": "4",
        "accountNameKana": "4"
      }
    },
    {
      "fieldCode": "field199",
      "fieldType": "text",
      "value": "テキスト１",
      "name": ""
    },
    {
      "fieldCode": "field299",
      "fieldType": "date",
      "value": "2020-10-01",
      "name": ""
    },
    {
      "fieldCode": "field399",
      "fieldType": "ValueList",
      "value": "1",
      "name": "男"
    },
    {
      "fieldCode": "field3",
      "fieldType": "AMOUNT",
      "amountValue": {
        "amount":2000,
        "currencyCode":"CNY",
        "rate":"5",
        "baseCurrencyAmount":10000,
        "baseCurrency":"JPY",
        "companyCurrencyRate":"4.8"
      }
    },
    {
      "fieldCode": "Control_Amount",
      "fieldType": "AMOUNT",
      "amountValue": {
        "amount": 10000,
        "currencyCode": "JPY",
        "rate": "1",
        "baseCurrencyAmount": 10000,
        "baseCurrency": "JPY",
        "companyCurrencyRate": "1"
      }
    },
    {
      "fieldCode": "Control_VAT",
      "fieldType": "TAX_CATEGORY",
      "value": "1001",
      "name": "10%"
    },
    {
      "fieldCode": "Consumption_Tax",
      "fieldType": "TAX_CATEGORY_AMOUNT",
      "amountValue": {
        "excludingTaxAmount": 9091,
        "includingTaxAmount": 10000,
        "taxAmount": 909,
        "exemptedExcludingTaxAmount": 10000,
        "exemptedTaxAmount": 0
      }
    },
    {
      "fieldCode": "field1",
      "fieldType": "COMPANY",
      "value":"YM01",
      "name":"テスト会社"
    },
    {
      "fieldCode": "field2",
      "fieldType": "DEPARTMENT",
      "value":"Sales01",
      "name":"セールス"
    },
    {
      "fieldCode": "field3",
      "fieldType": "ACCOUNT",
      "account": {
        "accountCode":"1001001",
        "accountName":"現金",
        "auxiliaryAccountCode":"A001",
        "auxiliaryAccountName":"会議費用",
        "accountTypeCode":"123",
        "accountType":"費用"
      }
    },
    {
      "fieldCode": "field999",
      "fieldType": "COSTCENTER",
      "name":"関東事業",
      "value":"A001"
    },
    {
      "fieldCode": "field4",
      "fieldType": "TAXCATEGORY",
      "name":"消費税10%",
      "value": "J0010"
    },
    {
      "fieldCode": "field333",
      "fieldType": "TRADING_DESTINATION",
      "partner": {
        "modeType": "supplier",
        "paymentType": "pre_defined",
        "supplier": {
          "customFormValues": [],
          "vendorCode": "1",
          "vendorName": "供应商名称12345678901234567890123456789012345678901供应商名",
          "vendorSemiangleName": null,
          "postalCode": "123-456",
          "address": "名古屋市天白区",
          "businessRegistrationNumber": null,
          "businessCategory": null,
          "businessRegistrationDate": null,
          "legalRepresentative": null,
          "taxId": null,
          "checkNetNo": null,
          "contact": "かかいとう",
          "contactPhone": null,
          "contactMail": null,
          "fax": null,
          "semiangleAddress": null,
          "remark": null,
          "description": null,
          "paymentTerms": null
        },
        "client": null
      }
    },
    {
      "fieldCode": "field5",
      "fieldType": "EMPLOYEE",
      "value":"A001,A002",
      "name":"厳英明,田中正義"
    },
    {
      "fieldCode": "field6",
      "fieldType": "DATE",
      "value": "2023-11-27"
    },
    {
      "fieldCode": "field7",
      "fieldType": "MONTH",
      "value": "2023-11"
    },
    {
      "fieldCode": "field6",
      "fieldType": "VALUELIST",
      "name": "男",
      "value": "1"
    },
    {
      "fieldCode": "field8",
      "fieldType": "NUMBER",
      "value": "9999.22"
    },
    {
      "fieldCode": "field8",
      "fieldType": "TEXT",
      "value": "わかりました"
    },
    {
      "fieldCode": "field9",
      "fieldType": "REFERENCE",
      "referenceEntity": [
        {
          "fieldCode": "field8",
          "fieldType": "NUMBER",
          "value": "9999.22"
        },
        {
          "fieldCode": "field8",
          "fieldType": "TEXT",
          "value": "わかりました"
        }
      ]
    },
    {
      "fieldCode": "link1",
      "fieldType": "Attachment",
      "attachments": [{
        "linkName": "リンク1",
        "linkValue": "https://service.spendia.jp/"
      },
        {
          "linkName": "リンク2",
          "linkValue": "https://service.spendia.jp/"
        }]
    },
    {
      "fieldCode": "file1",
      "fieldType": "Attachment",
      "attachments": [{
        "fileName": "添付ファイルのfile1.pdf",
        "fileUrl": "https://spendia-dynamic-stage.s3.ap-northeast-1.amazonaws.com/29ad55e2-702d-43be-b525-1b7a173c452b/invoices/5bfc11df-5436-4920-8632-ee1ba74a3bea-%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%BC%E3%83%B3%E3%82%B7%E3%83%A7%E3%83%83%E3%83%88.xlsx?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20231127T014901Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=AKIAJYC4KIDBXXJMJSNQ%2F20231127%2Fap-northeast-1%2Fs3%2Faws4_request&X-Amz-Signature=8c3324b7496df5df48a1eeb486fd89106c60e8d6836a51723f59a9db865d0bd7"
      },
        {
          "fileName": "添付ファイルのfile2.pdf",
          "fileUrl": "https://spendia-dynamic-stage.s3.ap-northeast-1.amazonaws.com/29ad55e2-702d-43be-b525-1b7a173c452b/invoices/5bfc11df-5436-4920-8632-ee1ba74a3bea-%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%BC%E3%83%B3%E3%82%B7%E3%83%A7%E3%83%83%E3%83%88.xlsx?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20231127T014901Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=AKIAJYC4KIDBXXJMJSNQ%2F20231127%2Fap-northeast-1%2Fs3%2Faws4_request&X-Amz-Signature=8c3324b7496df5df48a1eeb486fd89106c60e8d6836a51723f59a9db865d0bd7"
        }]
    },
    {
      "fieldCode": "table1",
      "fieldType": "Table",
      "tableData": [
        [
          {
            "fieldCode": "field6",
            "fieldType": "text",
            "value": "テキスト6",
            "name": ""
          },
          {
            "fieldCode": "field7",
            "fieldType": "date",
            "value": "2020-10-01",
            "name": ""
          },
          {
            "fieldCode": "field8",
            "fieldType": "ValueList",
            "value": "1",
            "name": "男"
          },
          {
            "fieldCode": "field9",
            "fieldType": "Amt.",
            "amountValue": {
              "amount": 100.22,
              "currencyCode": "CNY"
            }
          }
        ],
        [
          {
            "fieldCode": "field6",
            "fieldType": "text",
            "value": "テキスト6",
            "name": ""
          },
          {
            "fieldCode": "field7",
            "fieldType": "date",
            "value": "2020-10-01",
            "name": ""
          },
          {
            "fieldCode": "field8",
            "fieldType": "ValueList",
            "value": "1",
            "name": "男"
          },
          {
            "fieldCode": "field9",
            "fieldType": "Amt.",
            "amountValue": {
              "amount": 100.22,
              "currencyCode": "CNY"
            }
          }
        ]
      ]
    }
  ],
  "approvalHistories": [
    {
      "operation": 2001,
      "operationDetail": "通过后意见3",
      "operationDate": "2023-08-15 17:54:46",
      "operator": {
        "employeeId": "empid1",
        "fullName": "田中"
      },
      "applicant": null,
      "approver": {
        "employeeId": "empid2",
        "fullName": "佐々木"
      },
      "transmit": null
    },
    {
      "operation": 1001,
      "operationDetail": null,
      "operationDate": "2023-08-15 17:52:24",
      "operator": {
        "employeeId": "empid1",
        "fullName": "田中"
      },
      "applicant": {
        "employeeId": "empid2",
        "fullName": "佐々木"
      },
      "approver": null,
      "transmit": null
    }
  ]
}

请求体字段

字段名 类型 规则 说明
entityKey String 业务主键
workflowCode String 工作流编码
processStatus String 流程状态
审批中：1001
驳回：1002
撤回：1003
审批通过：1004
lastApprovalDate String 最终审批时间
lastApproverCode String 最终审批人
lastApproverMail String 最终审批人邮箱
processCode String 流程编号
entityFields entityFields[] 业务实体数组
approvalHistories ApprovalHistories[] 审批历史

entityFields

参数名 类型 规则 说明
fieldCode String 业务实体的字段编码
fieldType String 业务实体的字段类型
value String 业务实体的字段值
name String 名称
amountValue AmountValue{} 金额
tableData TableData[] 下级业务实体列表
attachments Attachments[] 附件列表
inputType String 银行账号的输入方式
details Details{} 银行账号的详情
account account{} 会计科目
partner partner{} 合作方
referenceEntity referenceEntity[] 引用业务实体

amountValue

参数名 类型 规则 说明
amount BigDecimal 金额
currencyCode String 币种编码
rate String 币种汇率
baseCurrencyAmount BigDecimal 本位币金额
baseCurrency String 本位币
companyCurrencyRate String 企业汇率
includingTaxAmount BigDecimal 价税合计金额
excludingTaxAmount BigDecimal 不含税金额
exemptedExcludingTaxAmount BigDecimal 不含税金额（税额减免后）
taxAmount BigDecimal 税额
exemptedTaxAmount BigDecimal 税额（税额减免后）

tableData

参数名 类型 规则 说明
entityFields entityFields[] 业务实体信息項

attachments(ATTACHMENT)

参数名 类型 规则 说明
fileName String 附件名称
fileUrl String 附件Url
参数名 类型 规则 说明
linkName String 链接名称
linkValue String 链接地址

inputType

枚举值 说明
company 公司银行帐户
partner 合作方银行帐户
employee 员工银行帐户
spot 手工录入

details(BANK_ACCOUNT)

パラメータ名 タイプ 規則 説明
country String 国家
bankCode String 银行代码
bankName String 银行名称
branchCode String 支行代码
branchName String 支行名称
accountCategory String 帐户类别
1：活期存款
2：无息存款
4：定期存款
9：其他
bankAccount String 银行账号
accountName String 账户名
accountNameKana String 账户名（半角片假名）

account

参数名 类型 规则 说明
accountCode String 科目代码
accountName String 科目名称
auxiliaryAccountCode String 辅助科目代码
auxiliaryAccountName String 辅助科目名称
accountTypeCode String 科目类型代码
ASSET
COST
LIABILITY
OWNERS_EQUITY
PROFIT_AND_LOSS
accountTypeName String 科目类型名
资产类
成本类
负债类
所有者权益类
收益类

partner

参数名 类型 规则 说明
modeType String 合作方类型
supplier
client
paymentType String 支付类型
pre_defined
spot_payment
supplier supplier{} 供应商
client client{} 客户

modeType=supplier

字段名 类型 必填 主键 约束 说明
customFormValues customFormValues{} 扩展字段
vendorCode String 供应商编码
vendorName String 供应商名称
vendorSemiangleName String 供应商名称（半角假名）
postalCode String 邮编
address String 地址
businessRegistrationNumber String 事业者登记编号
businessCategory String 事业者类别
businessRegistrationDate String 事业者登记日期
legalRepresentative String 法人代表
taxId String 税务登记号
checkNetNo String 电债NetNO.
contact String 联系人
contactPhone String 联系电话
contactMail String 邮箱
fax String 传真
semiangleAddress String 地址（半角假名）
remark String 备注
description String 备注（查询用）
paymentTerms String 付款条件

modeType=client

字段名 类型 必填 主键 约束 说明
customFormValues customFormValues{} 扩展字段
clientCode String 客户编码
clientName String 客户名称
clientSemiangleName String 客户名称（半角假名）
postalCode String 邮编
address String 地址
legalRepresentative String 法人代表
contactPhone String 联系电话
contact String 联系人
contactMail String 邮箱
fax String 传真
semiangleAddress String 地址（半角假名）
collectionTerm String 收款条件
remark String 备注
description String 备注名（查询用）
tradingConditions String 交易条件
effectiveDate String 启用日期
principalDepartment String 负责部门
principalUser String 负责人

customFormValues

字段名 类型 必填 主键 约束 说明
fieldCode String ○ ○ 字段编码（扩展字段）
value String ○ ○ 输入值（扩展字段）

referenceEntity

参数名 类型 规则 说明
entityFields entityFields[] 业务实体信息項

approvalHistories

字段名 类型 约束 说明
operation Integer 参照ApprovalOperation 操作类型
operationDetail String 最大 1000 文字 操作备注
operationDate String 时间格式：yyyy-MM-dd'T'HH:mm:ssZ 审批时间
operator UserSummary 参照UserSummary 操作人
applicant UserSummary 参照UserSummary 申请人
approver UserSummary 参照UserSummary 审批人
transmit UserSummary 参照UserSummary 转交对象

UserSummary

字段名 类型 规则 说明
employeeId String 员工工号
fullName String 员工名称

ApprovalOperation

值 说明
1001 提出
1002 撤回
2001 已审批
2002 驳回
2006 审批人通知
2800 自审批
5009 追加审批人
5010 转交
8004 申请人回复
9001 管理员审批跳转
9004 管理员审批通过
9005 管理员驳回

第三方接口处理结果返回示例

成功

{
  "message": "success",
  "code":1001
}

失败示例

{
  "message": "回调失败，连接超时，请检查网络环境及回调地址配置或修改超时时间并再次尝试 ",
  "code":1002
}

字段说明

字段名称 类型 说明
message String 返回信息说明
code String 返回错误码

错误代码

errorCode message 说明
1002 回调失败，第三方系统 {0}
1002 回调失败，连接超时，请检查网络环境及回调地址配置或修改超时时间并再次尝试

← 作废工作流 →