Supported Formats

json

GET /ar/balance/:year/:month
指定した年月の売上明細の集計額の一覧を返します。年月パラメータが指定されなかった場合、現在の年月の結果が返されます。

サポートフォーマット

json

エラー

エラーコード エラー説明
401 Not Authorizedアクセストークンが送られていないか正しくありません。もしくはクライアント認証トークンが正しくありません。
403 Forbiddenそのリクエストに必要な権限がありません。
404 Not found指定されたパスは正しくないか、リソースが見つかりません。
422 Unprocessable Entity1つ以上のパラメータが正しくないか不足しています。エラーメッセージで原因が判別できます。
500 Internal Server Errorサーバーで何らかのエラーが起こりました。
503 Service Unavailableあなたの IP アドレスから非常に多くのリクエストがあった場合、このエラーが発生します。次のリクエストまで少し時間を開けてください。

[
  {
    "ym": "2017-01",
    "customer_master_code": "0",
    "ar_segment": 1,
    "start_balance": 262510800,
    "finish_balance": 262510800,
    "received_amount": 0,
    "sales": 0,
    "tax": 0,
    "remittance_charge": 0,
    "exchange_gain_and_loss": 0,
    "memo": null,
    "created_at": null
  },
  {
    "ym": "2017-01",
    "customer_master_code": "101",
    "ar_segment": 1,
    "start_balance": 10000,
    "finish_balance": 10000,
    "received_amount": 0,
    "sales": 0,
    "tax": 0,
    "remittance_charge": 0,
    "exchange_gain_and_loss": 0,
    "memo": null,
    "created_at": null
  }
]

パラメータ

パラメータ名 説明
year
必須

Validations:

  • Must be a String

month
必須

Validations:

  • Must be a String

Returns

コード: 200

説明:

指定した年月の売上明細の集計額の一覧を返します。年月パラメータが指定されなかった場合、現在の年月の結果が返されます。

パラメータ名 説明
ym
任意

年月

Validations:

  • Must be a String

customer_master_code
任意

取引先コード

Validations:

  • Must be a String

ar_segment
任意

販売管理の債権区分

Validations:

  • Must be a String

start_balance
任意

月初残高

Validations:

  • Must be a Integer

finish_balance
任意

月末残高

Validations:

  • Must be a Integer

received_amount
任意

入金予定額

Validations:

  • Must be a String

sales
任意

売上額(税抜)

Validations:

  • Must be a Integer

tax
任意

税額

Validations:

  • Must be a Integer

remittance_charge
任意

当方負担送金手数料

Validations:

  • Must be a Integer

exchange_gain_and_loss
任意

為替差損益

Validations:

  • Must be a Integer

memo
任意

メモ

Validations:

  • Must be a String

created_at
任意

登録日時 (YYYY/MM/DD hh:mm:ss)

Validations:

  • Must be a String


POST /ar/find_or_create
売上管理レコードが作成済であれば検索し、未作成であれば作成します。

サポートフォーマット

json

エラー

エラーコード エラー説明
401 Not Authorizedアクセストークンが送られていないか正しくありません。もしくはクライアント認証トークンが正しくありません。
403 Forbiddenそのリクエストに必要な権限がありません。
404 Not found指定されたパスは正しくないか、リソースが見つかりません。
422 Unprocessable Entity1つ以上のパラメータが正しくないか不足しています。エラーメッセージで原因が判別できます。
500 Internal Server Errorサーバーで何らかのエラーが起こりました。
503 Service Unavailableあなたの IP アドレスから非常に多くのリクエストがあった場合、このエラーが発生します。次のリクエストまで少し時間を開けてください。

パラメータ

パラメータ名 説明
ccode
任意

法人コード

Validations:

  • Must be a Integer

price_including_tax
任意

税込売上高

Validations:

  • Must be a Integer

realization_timestamp
任意

計上日

Validations:

  • Must be a String

customer_master_code
任意

取引先コード

Validations:

  • Must be a String

dept_code
任意

部門コード

Validations:

  • Must be a String

reason_master_code
任意

原因マスタコード

Validations:

  • Must be a String

dc
任意

増減区分、d: 増加, c: 減少

Validations:

  • Must be a String

memo
任意

メモ

Validations:

  • Must be a String

tax_code
任意

税区分

Validations:

  • Must be a String

sales_tax
任意

消費税システム区分

Validations:

  • Must be a String

scheduled_memo
任意

予定メモ

Validations:

  • Must be a String

scheduled_receive_timestamp
任意

入金予定日

Validations:

  • Must be a String

tag_list
任意

セグメント

Validations:

  • Must be an array of any type

data_partner
任意

外部パートナー情報

Validations:

  • Must be an array of any type

key
任意

システム連携情報管理キー

Validations:

  • Must be a String

balance_band_code
任意

消込区分コード

Validations:

  • Must be a String

Returns

コード: 200

説明:

売上管理レコードが作成済であれば検索し、未作成であれば作成します。

パラメータ名 説明
id
任意

レコードId

Validations:

  • Must be a Integer

ccode
任意

法人コード

Validations:

  • Must be a Integer

account_code
任意

勘定科目コード

Validations:

  • Must be a String

realization_timestamp
任意

計上日

Validations:

  • Must be a String

customer_master_code
任意

取引先コード

Validations:

  • Must be a String

dept_code
任意

部門コード

Validations:

  • Must be a String

reason_master_code
任意

原因マスタコード

Validations:

  • Must be a String

dc
任意

増減区分、d: 増加, c: 減少

Validations:

  • Must be a String

memo
任意

メモ

Validations:

  • Must be a String

tax_code
任意

税区分

Validations:

  • Must be a String

sales_tax
任意

消費税システム区分

Validations:

  • Must be a String

scheduled_memo
任意

予定メモ

Validations:

  • Must be a String

scheduled_receive_timestamp
任意

入金予定日

Validations:

  • Must be a String

tag_list
任意

セグメント

Validations:

  • Must be an array of any type

data_partner
任意

外部パートナー情報

Validations:

  • Must be an array of any type

price_including_tax
任意

税込売上高

Validations:

  • Must be a Integer

price_excluding_tax
任意

税抜売上高

Validations:

  • Must be a Integer