Spendia Open API

ワークフロー新規

OpenAPI説明

当該APIは外部システムからSpendiaにプロセスを作成する時に利用します。

リクエストURI

/api/openapi/process/start

リクエスト形式

POST

リクエスト例

/api/openapi/process/start

{
  "entityKey": "152837338",
  "workflowCode": "all",
  "employeeId": "tikk74942no2",
  "baseDate": "2024-11-04",
  "processVariables": [
    {
      "variableCode": "1004",
      "value": ""
    },
    {
      "variableCode": "1005",
      "value": "日本のすべての精算を生産<>[]{}`~≠±×÷⇒⇔∀∂ｱｲあいmailto:!@#$%^&*()のすべての精算を"
    },
    {
      "variableCode": "1006",
      "value": "tikk74942no2,88889"
    },
    {
      "variableCode": "1007",
      "value": "2024-04-04"
    }
  ],
  "entityFields": [
    {
      "fieldCode": "46",
      "fieldName": "46单机成本中心",
      "value": "414"
    },
    {
      "fieldCode": "44",
      "fieldName": "44成本中心1级",
      "value": "1"
    },
    {
      "fieldCode": "45",
      "fieldName": "45成本中心2级",
      "value": "2"
    },
    {
      "fieldCode": "40",
      "fieldName": "40自定义列表2",
      "value": "111"
    },
    {
      "fieldCode": "tax",
      "fieldName": "tax消费税",
      "value": "2"
    },
    {
      "fieldCode": "29",
      "fieldName": "29交易方",
      "partner": {
        "modeType": "supplier",
        "paymentType": "pre_defined",
        "supplier": {
          "vendorCode": "1",
          "vendorName": "株式会社サンキ電子",
          "vendorSemiangleName": "vendorSemiangleName",
          "postalCode": "postalCode",
          "address": "address",
          "businessRegistrationNumber": "1022",
          "businessCategory": "1002",
          "businessRegistrationDate": "2023-02-23",
          "legalRepresentative": "legalRepresentative",
          "taxId": "taxId",
          "checkNetNo": "checkNetNo",
          "contact": "contactName",
          "contactPhone": "contactPhone",
          "contactMail": "contactEmail",
          "fax": "contactFax",
          "semiangleAddress": "semiangleAddress",
          "remark": "remark",
          "description": "description",
          "paymentTerms": "01",
          "customFormValues": [
            {
              "fieldCode": "XX",
              "value": "ss"
            }
          ]
        },
        "client": {
          "clientCode": "1",
          "clientName": "clientName",
          "clientSemiangleName": "clientSemiangleName",
          "postalCode": "postalCode",
          "address": "address",
          "legalRepresentative": "legalRepresentative",
          "contact": "contactName",
          "contactPhone": "contactPhone",
          "contactMail": "contactEmail",
          "fax": "fax",
          "semiangleAddress": "semiangleAddress",
          "remark": "remark",
          "description": "description",
          "collectionTerm": "11",
          "tradingConditions": "01",
          "effectiveDate": "2023-02-23",
          "principalDepartment": "AAAA",
          "principalUser": "18392632831",
          "customFormValues": [
            {
              "fieldCode": "AA",
              "value": "03"
            },
            {
              "fieldCode": "2",
              "value": "s222s"
            }
          ]
        }
      }
    },
    {
      "fieldCode": "30",
      "fieldName": "30员工",
      "value": "1003,1004"
    },
    {
      "fieldCode": "9",
      "fieldName": "9单行文本框",
      "value": "日本のすべての精算を生産<>[]{}`~≠±×÷⇒⇔∀∂ｱｲあいmailto:!@#$%^&*()日本のすべての精算を"
    },
    {
      "fieldCode": "36",
      "fieldName": "36多行文本框",
      "value": "日本のすべての精算を生産<>[]{}`~≠±×÷⇒⇔∀∂ｱｲあい mailto:!@#$%^&*()日本のすべての精算を"
    },
    {
      "fieldCode": "35",
      "fieldName": "35年月",
      "value": "2024-03"
    },
    {
      "fieldCode": "33",
      "fieldName": "33年月日",
      "value": "2024-02-29"
    },
    {
      "fieldCode": "42",
      "fieldName": "42年月日2",
      "value": "2024-01-18"
    },
    {
      "fieldCode": "43",
      "fieldName": "43年月2",
      "value": "2024-09"
    },
    {
      "fieldCode": "31",
      "fieldName": "金额",
      "amountValue": {
        "currencyCode": "JPY",
        "amount": "999999999999"
      }
    },
    {
      "fieldCode": "24",
      "fieldName": "24币种",
      "value": "JPY"
    },
    {
      "fieldCode": "25",
      "fieldName": "25公司",
      "value": "111"
    },
    {
      "fieldCode": "34",
      "fieldName": "34部门",
      "value": "11"
    },
    {
      "fieldCode": "26",
      "fieldName": "26会计科目",
      "account": {
        "accountCode": "101",
        "auxiliaryAccountCode": "434"
      }
    },
    {
      "fieldCode": "32",
      "fieldName": "32整数",
      "value": "1331.00"
    },
    {
      "fieldCode": "37",
      "fieldName": "37正整数",
      "value": 3322
    },
    {
      "fieldCode": "38",
      "fieldName": "38浮点",
      "value": 221.2
    },
    {
      "fieldCode": "13",
      "attachments": [{
        "linkName": "urlllllllll",
        "linkValue": "https://news.ifeng.com/"
      }]
    },
    {
      "fieldCode": "22",
      "fieldName": "22借方",
      "referenceEntity": [
        {
          "fieldCode": "W1",
          "fieldName": "文本 (引）",
          "value": "aaa"
        },
        {
          "fieldCode": "W14",
          "fieldName": "W14部门",
          "value": "11"
        },
        {
          "fieldCode": "W12",
          "fieldName": "金额",
          "amountValue": {
            "currencyCode": "CNY",
            "amount": "9999999999999.555"
          }
        }
      ]
    },
    {
      "fieldCode": "23",
      "fieldName": "23贷方",
      "referenceEntity": [
        {
          "fieldCode": "W1",
          "fieldName": "文本 (引）",
          "value": "aaa"
        },
        {
          "fieldCode": "W14",
          "fieldName": "W14部门",
          "value": "11"
        },
        {
          "fieldCode": "W12",
          "fieldName": "金额",
          "amountValue": {
            "currencyCode": "CNY",
            "amount": "9999999999999.555"
          }
        }
      ]
    },
    {
      "fieldCode": "11",
      "tableData": [[{
        "fieldCode": "a",
        "value": "200"
      },
        {
          "fieldCode": "V",
          "value": "bbb1"
        },
        {
          "fieldCode": "33",
          "value": "2024-09-01"
        },
        {
          "fieldCode": "D"
        },
        {
          "fieldCode": "duohang",
          "value": "towtowojtojwotjwo@#日本のすべての精算を生産<>[]"
        },
        {
          "fieldCode": "amount",
          "amountValue": {
            "currencyCode": "JPY",
            "amount": "9999999"
          }
        }],
        [{
          "fieldCode": "a",
          "value": "30"
        },
          {
            "fieldCode": "V",
            "value": "bbb2"
          },
          {
            "fieldCode": "D",
            "attachments": [{
              "linkName": "url",
              "linkValue": "https://github.com/"
            },
              {
                "linkName": "url",
                "linkValue": "https://github.com/"
              },
              {
                "linkName": "url",
                "linkValue": "https://github.com/"
              }]
          }]
      ]
    }

  ]
}

リクエスト項目

パラメータ名 タイプ 必須 キー 约束 説明
entityKey String ○ ○ 最大 50 文字 業務キー
workflowCode String ○ ○ ワークフローコード
employeeId String ○ ○ 従業員番号
departmentCode String 部門コード
companyCode String 会社コード
baseDate String 時間フォーマット：yyyy-MM-dd 基準日
processVariables processVariables[] パラメータ定義項目リスト
entityFields entityFields[] ○ ○ 最大 100 項目 業務テーブル項目リスト

processVariables

パラメータ名 タイプ 必須 キー 規則 説明
variableCode String ○ ○ パラメータコード
value String 最大 4000 文字
時間フォーマット：yyyy-MM-dd
数字フォーマット：1.0219（整数、小数）
テキストフォーマット："Text"
従業員番号フォーマット：
"empid1,empid2"		 パラメータの値

entityFields

パラメータ名 タイプ 必須 キー 規則 説明
fieldCode String ○ ○ 業務テーブルの項目コード
value String 最大 4000 文字 業務テーブルの項目値
amountValue amountValue{} 金額
tableData tableData[] 下級業務テーブル項目リスト
attachments attachments[] リンクリスト
partner partner{} パートナー

amountValue

パラメータ名 タイプ 必須 キー 規則 説明
amount BigDecimal ○ ○ 金額の値
currencyCode String ○ 通貨コード
includingTaxAmount BigDecimal ○ 税込額
excludingTaxAmount BigDecimal ○ 税抜額
taxAmount String ○ 税額

tableData

パラメータ名 タイプ 必須 キー 規則 説明
fieldCode String ○ ○ 下級業務テーブル項目コード
value String 最大 4000 文字 下級業務テーブル項目の値

attachments

パラメータ名 タイプ 必須 キー 規則 説明
linkName String ○ ○ リンク名称
linkValue String ○ ○ リンクアドレス

partner

パラメータ名 タイプ 規則 説明
modeType String パートナータイプ
supplier
client
paymentType String 支払タイプ
pre_defined
spot_payment
supplier String 仕入先
client String 顧客

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 でんさいネットNO.
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 ○ ○ 入力値（拡張項目）

OpenAPIリターン例

成功例

{
    "message": "success",
    "key": "WK00000001"
}

失敗例

{
    "message": "基準日のフォーマットyyyy-MM-dd",
    "errorCode": "160002"
}

項目説明

項目名 タイプ 説明
message String メッセージを返す
Key String プロセスコード
errorCode String エラーコードを返す

エラーコード説明

errorCode message 説明
120003 パラメータ:{0}は指定必須の項目です
0013 パラメータ:{0}は{1}文字以内で指定してください
2008 次のステージに適用できる承認者はいません。システム管理者に連絡してください
spd.21701.api.001 ワークフローコードが存在しません
spd.21701.api.002 従業員番号は {0} の従業員が見つからない
spd.21701.api.003 指定基準日で有効な職務が存在しません
spd.21701.api.004 無効な部門コードです
spd.21701.api.005 ワークフローに業務テーブルが存在しません
spd.21701.api.006 ワークフローに有効なバージョンが存在しません
spd.21701.api.007 項目テーブルに項目が存在しません:{0}
spd.21701.api.008 パラメータ定義に項目が存在しません:{0}
spd.21701.api.009 パラメータ {0} は数字のみ入力可能
spd.21701.api.010 パラメータ {0} は日付のみ入力可能、フォーマットはyyyy-MM-ddです
spd.21701.api.011 同じ業務キー（{0} {1}）の承認依頼は既に提出済です。重複提出できません。先に差戻し或いは承認依頼を取消してください
spd.21701.api.012 基準日フォーマットはyyyy-MM-ddです
spd.21701.api.013 有効なプロセスが存在しません、ご確認してください
spd.21701.api.014 無効な会社コードです
spd.21701.api.015 複数の職務が存在します、部門あるいは会社パラメータを追加してから再度試してください
spd.21701.api.016 通貨が存在しません
spd.21701.api.017 パラメータ:{0}の整数部分は9999999999999以内で指定してください
spd.21701.api.018 項目 {0} は日付のみ入力可能、フォーマットはyyyy-MM-ddです
spd.21701.api.019 項目 {0} は日付のみ入力可能、フォーマットはyyyy-MMです
spd.21701.api.020 プロセスコードが存在しません
spd.21701.api.021 タスクIDが存在しません
spd.21701.api.022 当該承認タスクは既に処理済でした、重複処理できません
spd.21701.api.023 操作タイプが存在しません
CANNOT_FIND_CURRENT_APPROVAL 承認者が存在しません。システム管理者にご連絡ください
spd.28725.001 {1}: 税込額 != 税抜額+税額
spd.28725.002 {1}&{2}: 金額と税込額が一致しません
spd.21701.api.024 パラメータ{0}とパラメータ{1}の通貨が一致しません
spd.30027.023 テーブル{0}に、{1}行以内で指定ください
spd.30027.025 テーブル{0}に、少なくとも{1}件明細を加えてください

ワークフローコールバック →