洗替 SFTPファイル連携
SFTPを利用して洗替依頼データを連携する手順を説明します。
洗替依頼ファイル・結果ファイルのフォーマットは
洗替ファイルフォーマットを参照してください。
洗替 概要も併せて参照してください。
SFTPを利用するには、別途SFTPサーバー利用の契約が必要です。
SFTPファイル連携の流れで基本的な接続手順を参照してください。
洗替依頼ファイルアップロード
加盟店様のSFTPアカウントでSFTPサーバに接続し、以下の手順でファイルを配置してください。
1. ファイルの準備
洗替ファイルフォーマットに従って、洗替依頼データの元ファイル（csv または txt）を作成します。
2. 圧縮前ファイル名の形式
arai + ショップID + 処理日YYYYMM + 月内通番 + .csv（または .txt）
例：ショップIDが
0000000000001で2026年8月洗替処理分の場合
arai000000000000120260801.csv（または.txt）
3. 圧縮してアップロード
元ファイルを tar.gz 形式に圧縮し、以下のファイル名でアップロードしてください。
arai + ショップID + 処理日YYYYMM + 月内通番 + .tar.gz
例：ショップIDが
0000000000001で2026年8月洗替処理分の場合
arai000000000000120260801.tar.gz
4. OKファイル
(洗替依頼ファイル名) + .ok
洗替依頼ファイル名に.okを付与します。ファイルの中身は空です。
例：
arai000000000000120260801.tar.gz.ok
- 月内通番には、同月内の同名ファイルを区別するため半角数字2桁を設定します。
01から開始し、再送時は02、03と連番で採番してください。 - 複数のショップIDの洗替ファイルをまとめて圧縮する場合は、
最も小さいショップIDを代表ショップIDとして[ショップID]に設定してください。
結果ファイルダウンロード
原則27日正午までに、以下のファイルが加盟店様のSFTPディレクトリに配置されます。
1. ダウンロードファイル名
R + (洗替依頼ファイル名)
例1：
arai000000000000120260801.tar.gzをアップロードした場合
Rarai000000000000120260801.tar.gz
例2：ショップIDが
0000000000001で2022年8月自動洗替（SFTP利用）の場合
Rarai000000000000120220801.tar.gz
2. OKファイル
R + (洗替依頼ファイル名) .ok
ファイルの中身は空です。
例：
Rarai000000000000120260801.tar.gz.ok
※自動洗替利用の場合でもOKファイルは返却されます。
3. ファイルの内容
洗替ファイルフォーマットで定義する結果ファイルを、tar+gzip圧縮したものです。
4. 解凍後ファイル名
R + (洗替依頼ファイル名の拡張子を .txt にしたもの)
配置ファイル再送で月内通番がカウントアップされた場合でも、結果ファイル名の月内通番は01固定です。
解凍後の拡張子は.txt固定です。
例：
Rarai000000000000120260801.txt
その他注意事項
一度に処理可能なファイル数
一度にアップロード可能なファイルは1ファイルです。
必ず1ファイル（データファイルとOKファイルの1ペア）ずつアップロードしてください。