送り状発行API⑤:送り状PDF取得

※LinkPrint CLOUD Web APIの概要や本記事内に記載されている用語についての説明はこちらをご確認ください。

送り状PDF取得

発行した送り状のPDFを取得します。

URL https://www.lpcloud.jp/okr_api/get_pdffile/
POST情報
キー
*user_id LPC利用時のログインID
*access_token ログイン時に取得した「access_token」
*api_key APIキー
*receipt_file_ids ファイル管理用IDをjson⽂字列で指定(複数可)
例 : [“462_20250729_100″,”462_20250729_101″]
company_ids

利用する運送会社IDをjson⽂字列で指定(複数可)
例 : [“1″,”2”]

※運送会社IDについて、詳しくは「Web API導入について」をご確認ください。

戻り値

<POST情報で「receipt_file_ids」を複数指定した場合>
複数のファイル管理用IDのPDFをまとめたZipファイルを返します。

<「③ファイルアップロード&確認」で複数の運送会社分の登録があり、POST情報で「company_ids」を指定しなかった場合>
複数の運送会社のPDFをまとめたZipファイルを返します。

<POST情報で「company_ids」を指定した場合>
対象の運送会社の送り状PDFファイルを返します。

<エラーがあった場合>
対象のPDFの取得に対して、1つでもエラーが発生した場合はjson⽂字列でエラーを返します。

キー
issue̲result
キー
receipt̲file̲id ファイル管理用ID毎に情報を返します。
⇒ (運送会社ID) 運送会社ID毎に情報を返します。
⇒⇒ error̲infos エラーメッセージを返します。
msg システムエラー等、上記以外のエラーが発生した際にエラーメッセージを返します。
is̲expired

「access_token」の有効期限切れの際に「1」を返します。

※「is_expired」が「1」の場合は、システム内に保管されている「access_token」の有効期限が過ぎている状態になっています。システム内に保管されている「access_token」の値を空にし、再度ログインを実施してください。

「*」 このマークが付いている項目は必須項目です。

PDF取得の有効期限は以下の通りです。
<佐川急便>
「③ファイルアップロード&確認API」を実施してから24時間以内です。24時間を超えている場合はエラーを返します。有効期限が切れた場合、初回発行依頼から72時間以内であれば「⑦送り状再発行(佐川急便用)」より再発行が可能です。72時間を超えた場合は、再度「③ファイルアップロード&確認API」よりファイルアップロードし直してください。

<ヤマト運輸>
「B2クラウドAPI」ご契約時に登録された有効期限が、PDFファイルそのものに設定されます。有効期限が切れた場合は、再度「③ファイルアップロード&確認API」よりファイルアップロードし直してください。

「③ファイルアップロード&確認API」について、詳しくは「送り状発行API③:ファイルアップロード&確認」をご確認ください。

※ファイル名につきまして、LPC Directをご利用のユーザの場合、LPC Directが検知するファイル名でPDFファイルを返します。
LPC Directについて、詳しくは「LPC Directとは」をご確認ください。