概要

佐川急便の「スマートAPI」と連携すると、管理画面から佐川急便の送り状を発行し、印刷用のPDFをその場で取得できます。
送り状の発行に成功すると、お荷物伝票番号の登録や受注ステータスの更新などの出荷処理まで自動で行われるため、CSVファイルのやり取りが不要になります。

  • 送り状発行API:選択した受注の送り状を発行し、印刷用PDFを取得します。
  • 荷物受渡書API:送り状を発行済みの荷物について、ドライバーへ引き渡す際の「荷物受渡書」PDFを発行します。

なお、従来のCSVによる送り状発行も引き続きご利用いただけます。運用に合わせて使い分けてください。

ご利用前にご確認ください
  • ご利用には、佐川急便との契約(お客様コードの取得)と、スマレジEC・リピート BBCエディションへのお申し込みが必要です。詳細は本記事内の<利用前の準備>をご参照ください。
  • 対応しているのは元払いの宅配便のみです。着払い・メール便などは対象外です。詳細は本記事内の<ご利用いただけない内容>をご参照ください。
  • 選択できる送り状のレイアウトは4種類です。レイアウトにこだわりがある場合は、従来のCSVによる送り状発行をご利用ください。
  • 送り状PDFのダウンロードURLの有効期限は24時間です。発行後は速やかにPDFを保存・印刷してください。

利用前の準備

店舗様には、以下の準備をお願いいたします。

STEP
佐川急便と契約し、「お客様コード」を取得する

お客様コードをお持ちでない場合は、佐川急便の最寄り営業所へお問い合わせいただくか、佐川急便のWeb申請フォームからご登録ください。
※登録完了まで、最短で1〜2週間程度かかります。

代金引換・運送保険をご利用の場合

事前に佐川急便へお申し込みのうえ、サービスを利用できる状態にしておく必要があります。
新規でお申し込みの場合は、佐川急便の最寄り営業所へお問い合わせください(登録完了まで、最短で1か月程度かかります)。

STEP
スマレジEC・リピート BBCエディションのサポート窓口へ、利用を申し込む

取得したお客様コードを添えて、サポート窓口までご連絡ください。

スマレジEC・リピート BBCエディションから佐川急便へ、お客様コードの登録を依頼します。
※登録完了まで、7営業日程度かかります。

お客様コードについて

お客様コードは、管理画面に入力するだけではご利用いただけません。スマレジEC・リピート BBCエディションから佐川急便への登録が完了していない場合、送り状の発行時に「未登録の顧客コードです」というエラーが表示されます。

STEP
登録完了のご連絡を受け取る

佐川急便での登録が完了しましたら、弊社サポートからご連絡いたします。
ご連絡を受け取りましたら、本記事内の<初期設定>へお進みください。

初期設定

API連携を利用するための初期設定を行います。

1.佐川急便の配送設定

  • 送り状の発行に使用する「お客様コード」と「送り状種別」を設定します。
  • ご依頼主情報・保険金額・代引の決済種別・航空便の対象都道府県・置き配情報の転記などは、既存の佐川急便の設定がそのまま使われます。

操作手順

STEP
管理画面の[基本設定>店舗設定>送り状出力設定タブ]を開く

STEP
「配送業者別設定」欄まで画面をスクロールし、「佐川急便」の[編集]をクリックする
STEP
「お客様コード」を入力する

佐川急便から取得したお客様コードを入力します。送り状・荷物受渡書は、ここで設定したお客様コードで発行されます。

STEP
「送り状発行API設定」の「送り状種別」を選択する

使用する送り状用紙を、以下から選択します。

  • 佐川急便A5サイズ圧着式送り状
  • 佐川急便A5サイズ圧着式送り状(透かし文字無版)
  • 佐川急便統一圧着サーマル送り状
  • 佐川急便統一圧着サーマル送り状(透かし文字無版)
送り状種別が未設定の場合

送り状種別を設定していない店舗の受注は、送り状が発行されません。

STEP
ページ下部の[この内容で登録する]をクリックする

2.接続先・出荷日に関する設定

  • スマレジEC・リピート BBCエディションと佐川急便の接続設定を行います。
  • 送り状発行時の出荷日の扱いを確認します。

操作手順

STEP
管理画面の[基本設定>管理システム設定>業務フロー設定タブ]を開く

STEP
「■6.出荷業務」欄までスクロールする

STEP
「佐川急便送り状発行API接続先」から、[本番環境]を選択する
接続先について

[利用しない]のままでは、受注一覧に送り状発行APIの選択肢が表示されません。
[テスト環境]で発行した送り状には「SAMPLE」の透かしが入ります。実際の発送には使用できませんので、破棄してください。

STEP
「出荷日の更新」の設定を確認する

送り状発行時の出荷日は、お荷物伝票番号CSV取込後処理の「出荷日の更新」の設定に従って登録されます。

  • CSV内の出荷日項目を転記する(出荷日項目がない場合はシステム内の出荷予定日を転記する):
    API連携で出荷日が更新されます。
  • CSV内の出荷日項目を転記する(出荷日項目がない場合はシステム内の出荷予定日を転記しない):
    API連携では出荷日は更新されません。
  • システム内の出荷予定日を転記する:
    送り状の発行時に、受注の出荷予定日が出荷日として登録されます。
  • 出荷日を設定しない:
    API連携では出荷日は更新されません。

送り状の発行後に受注ステータスや在庫などがどう処理されるかは、従来どおりの送り状出力後の設定(「出荷システム実績取込後処理」など)に従います。

STEP
ページ下部の[この内容で登録する]をクリックする

送り状を発行する

操作手順

STEP
管理画面の[受注>受注一覧]を開く

STEP
送り状を発行したい受注データにチェックを入れる

絞り込みパネルや受注ステータスを選択して受注データを表示し、送り状を発行する受注にチェックを入れます。

[検索結果全て]は選択できません

API連携では、[検索結果全て]を対象に実行することはできません。必ずチェックボックスで対象の受注を選択してください。

個口数は事前に正しく設定してください

送り状は、受注データの「個口数」をもとに発行されます。発行前に、受注編集の配送情報にある「個口数」を正しく設定してください。
送り状の発行後に受注の個口数を変更しても、発行済みの送り状や、荷物受渡書の総出荷個数には反映されません。個口数を変更する場合は、送り状を出し直してください(新しいお荷物伝票番号で発行されます)。

STEP
「伝票出力・CSV出力パネル」から[送り状CSV出力]タブを開く

パネルが表示されていない場合は、(表示/非表示)のテキストをクリックしてください。

 ※ご契約状況によりタブの内容は変わります。
STEP
「送り状タイプ」のリストを開き、佐川急便の[送り状発行API]を選択する

選択すると、ボタンの表示が[API連携する]に切り替わります。

必要に応じて、以下の項目を指定してください。

  • 出荷予定日を更新する:チェックを入れると、出荷予定日が登録されていない受注にのみ、パネルで指定した日付を設定してから発行します。出荷予定日が登録済みの受注は変更されません。
  • 出力対象:[未出力]を選択した場合、過去に送り状を出力済みの受注は発行されません。出し直しの場合は、[過去分含む]を選択してください。
締め切り後の注文の送り状を事前に発行する場合

翌日以降に出荷する受注は、出荷予定日を出荷する日に設定してから発行してください。

STEP
[API連携する]をクリックする

STEP
処理結果を確認し、PDFを保存・印刷する

処理結果画面に、処理結果の一覧とPDFのダウンロードリンクが表示されます。リンクを開き、送り状PDFを保存・印刷してください。
※1つのPDFに複数の送り状がまとめて出力されることがあります。

PDFのダウンロードについて
  • ダウンロードURLの有効期限は、作成から24時間です。期限内に保存したPDFは、期限後もそのままご利用いただけます。
  • 処理結果画面を閉じると、あとからPDFのリンクを確認することはできません。必ずその場でPDFを保存してください。
  • 送り状を出し直すと、新しいお荷物伝票番号で発行されます。再印刷が必要になった場合に備えて、初回に保存したPDFを使って印刷することをおすすめします。

送り状の発行時に自動で行われる処理

送り状PDFの取得に成功した受注は、以下の出荷処理が自動で行われます。

  • お荷物伝票番号の登録
  • 受注ステータスの更新
  • 出荷日・売上日の登録
  • 商品在庫数の引当
  • ポイントの付与
  • 受注履歴の登録
  • 発送完了メール・モールへの出荷通知の対象になる
ポイント
  • 送り状が発行されても、PDFを取得できるまでは出荷処理は行われません。PDFを取得できなかった受注に、発送完了メールが送られることはありません。
  • 同梱注文の場合は、同梱されたすべての受注に同じお荷物伝票番号が登録されます。
  • 複数の店舗の受注をまとめて選択した場合は、店舗ごとに分けて発行されます。

処理結果の見方

表示内容対応方法
発行成功(URL取得済み・完了)送り状の発行・PDFの取得・出荷処理まで完了しました。PDFを保存・印刷してください。
発行済み・PDF確認待ち送り状は発行されましたが、PDFの準備が間に合いませんでした。出荷処理はまだ行われていません。時間をおいて、同じ受注で再度実行してください。
PDFダウンロードURL失効PDFのダウンロードURLの有効期限(24時間)が切れています。同じ受注で再度実行してください。
未発行一緒に処理した他の受注のエラーの影響で、発行されませんでした。同じ受注で再度実行してください。
発行エラー受注内容や設定に問題があり、発行できませんでした。メッセージを確認し、受注内容や設定を修正してから再度実行してください。

荷物受渡書を発行する

送り状を発行した荷物について、ドライバーへの引き渡し時に使用する「荷物受渡書」を発行します。

操作手順

STEP
管理画面の[受注>受注一覧]を開き、対象の受注にチェックを入れる

送り状発行APIで送り状を発行済みの受注を選択します。

STEP
[送り状CSV出力]タブの「送り状タイプ」から、佐川急便の[荷物受渡書API]を選択する
 ※ご契約状況によりタブの内容は変わります。
STEP
「出荷予定日」に、出荷する日付を入力する

受注の出荷予定日と、ここで入力した日付が一致する受注だけが対象になります。

STEP
[API連携する]をクリックする

STEP
処理結果を確認し、PDFを保存・印刷する

荷物受渡書のダウンロードURLも、有効期限は24時間です。

ポイント
  • 荷物受渡書を発行しても、受注ステータスなどは変わりません。
  • 同じ受注で何度発行しても問題ありません(新しいPDFが発行されます)。
  • 発行されるのは荷物受渡書のみです。出荷明細書は発行されません。
  • 総出荷個数は、送り状を発行したときの個口数で計算されます。
    送り状の発行後に受注の個口数を変更しても反映されません。

エラーになったときは

処理結果画面のメッセージには、佐川急便の結果コードと内容(例:「E1-0001:必須項目に値がありません」)がそのまま表示されます。
主なケースと対処方法は以下のとおりです。

送り状が発行されない主なケース

ケース対処方法
出荷予定日が登録されていない受注の出荷予定日を入力するか、[出荷予定日を更新する]にチェックを入れて再度実行してください。
店舗の送り状種別が未設定佐川急便の配送設定で、送り状種別を設定してください。
配送業者が佐川急便以外になっている受注の配送業者をご確認ください。
着払いの受注・メール便の受注API連携の対象外です。CSVによる送り状発行をご利用ください。
伝票出力オプションが「送り状を出力しない」になっている受注の伝票出力オプションをご確認ください。
出力対象が[未出力]で、過去に出力済みの受注出力対象で[過去分含む]を選択して、再度実行してください。
「未登録の顧客コードです」と表示されるお客様コードの入力内容に誤りがないかご確認ください。誤りがない場合は、佐川急便への登録が完了していない可能性があります。サポート窓口へお問い合わせください。
郵便番号と住所が一致しない・住所や郵便番号の誤りお届け先(またはご依頼主)の住所・郵便番号を修正してください。
電話番号・メールアドレスの形式の誤り正しい形式に修正してください。
住所・氏名・品名の文字数オーバー文字数を減らしてください。
配達指定日が過去の日付、または30日より先配達指定日を修正してください。
代金引換・クール便が利用できないエリア配送方法・お支払方法を見直してください。
代金引換・運送保険の契約がない佐川急便との契約内容をご確認ください。
時間帯指定ができないエリア(警告)時間帯指定を外すなど、内容を確認してから再度実行してください。
中継エリア(離島など)(警告)内容をご確認のうえ、必要に応じてCSVによる送り状発行をご利用ください。
「警告」の場合も送り状は発行されません

警告が表示された受注も、送り状は発行されません。内容を確認・修正してから再度実行してください。
上記以外のメッセージが表示された場合も、メッセージの内容に沿って受注内容や設定を見直してください。原因が分からない場合や、見直しても解消しない場合は、サポート窓口へお問い合わせください。

通信エラーが表示された場合

佐川急便との通信に失敗した場合は、そのとき処理したすべての受注が発行エラーになります。時間をおいて再度実行し、解消しない場合はサポート窓口へお問い合わせください。

荷物受渡書の対象外になる主なケース

表示される理由対処方法
対象の送り状発行API連携データが見つからない送り状発行APIで送り状を発行していない受注です。先に送り状を発行してください。
送り状発行APIが完了していないPDFの取得・出荷処理まで完了していません。送り状発行を再度実行してください。
出荷予定日が未入力受注の出荷予定日を入力してください。
画面入力の出荷日と受注の出荷予定日が一致しない画面の出荷予定日を、受注の出荷予定日に合わせて実行してください。

送り状を出し直したいときは

PDFのダウンロードURLの有効期限が切れた場合などは、同じ受注を選択して、再度[送り状発行API]を実行してください。

出し直しの注意点
  • 出し直すと、新しいお荷物伝票番号で発行され、受注のお荷物伝票番号も新しい番号に置き換わります。同じ番号での再発行はできません。
  • 発送完了メールやモールへの出荷通知が送信済みの場合、お客様に通知したお荷物伝票番号と、新しい番号が異なる状態になります。
  • 出荷処理が完了済みの受注で再度実行しても、受注ステータス・在庫・ポイントが二重に処理されることはありません。
  • 印刷したものの使わなかった送り状は、担当の佐川急便営業所(ドライバー)へお渡しください。使わなかったお荷物伝票番号は、そのままにしていただいて問題ありません。

ご利用いただけない内容

内容補足
着払い元払いのみ対応しています。
飛脚メール便・ゆうパケット便・ゆうメール便・国際配送対応する送り状がありません。
飛脚ラージサイズ宅配便(30kg超)対応していません。
発行した送り状の取消取消の操作はありません。
同じお荷物伝票番号での再発行出し直しは、常に新しい番号での発行になります。
出荷明細書の発行荷物受渡書のみ発行できます。
あとから発行結果・PDFを確認する処理結果は、実行直後の画面でのみ確認できます。
受注一覧での連携状況の表示・絞り込み対応していません。
上記に該当する場合

着払い・メール便などAPI連携の対象外の受注は、従来のCSV等による送り状発行をご利用ください。