Logistivo CLI：物流オペレーションをターミナルから、そして ERP から実行

1 つのコマンドカタログが 3 つの窓口を支えています。lg ターミナルクライアント、ダッシュボード内の AI アシスタント、そして外部 AI アシスタントが接続するチャネルです。機能は一度書かれると 3 つすべてに現れます。さらに、パネルのすべての書き込み操作に対応するコマンドが揃ったため、チームが画面上で行っている作業を、スクリプトや自社の AI エージェントが実行できます。決済、法的同意、アカウントの閉鎖は意図的にブラウザに残しています。 このページは契約（コントラクト）です。下のコマンド表は手書きではなく、リクエストのたびにライブのコマンドレジストリから生成されます。

Logistivo CLI とは何ですか？

Logistivo CLI（lg）は、Logistivo アカウントの業務（貨物と運行、輸送依頼、見積もりと入札、車両とドライバー、書類、取引先と取引先元帳、請求書と会計、倉庫と在庫、チームメンバー、関税率）を、ターミナル、スクリプト、または自社の AI エージェントから実行するコマンドラインクライアントです。コマンドはクライアントに組み込まれていません。クライアントはサーバーからコマンドカタログを取得し、それをもとに自分自身を組み立てます。同じコマンドは何もインストールせずに HTTP 経由でも呼び出せます（ERP・CRM 連携が使うのはこの経路です）。また、外部 AI アシスタントが接続する MCP チャネルからも呼び出せます。

• コマンドの形は 1 つだけです：lg --parameter=value 。カタログには現在 125 ドメインにわたる 519 個のコマンドがあり、1 つのロールが見られる最大の一覧は 112 ドメインにわたる 452 個のコマンドです。
• パネルのすべての書き込み操作にコマンドがあります。パネルの書き込みエンドポイントと照合した結果、対象範囲内のものは 100% カバーされています。決済（3D Secure）、法的同意、アカウントの閉鎖は意図的にブラウザに残しており、これらについてはコマンドが代わりにリンクを返します。
• 書類や写真を受け取るコマンドもブラウザの外で動作します。--attachment_uuid=@./cmr.pdf と書けば、lg が先にファイルをアップロードします。HTTP の場合は /api/common/commands:upload にアップロードし、返された attachment_uuid を渡します。
• 連携キー（integration key）にはアクセスレベルがあります。日常業務には employee（新しいキーのデフォルト）、チーム・設定・キー・お金に関わる操作には manager を使います。キーが、代理で操作する本人より多くの権限を持つことはありません。
• フラグが勝手に作られることはありません。すべてのフラグはそのコマンド自身の JSON Schema にあるパラメータ名であり、型と必須かどうかも同じく JSON Schema で決まります。
• 書き込みコマンドは確認を求めます。取り消せないコマンドは確認なしには決して実行されません（HTTP 409、CLI 終了コード 4）。
• 再試行しても重複は生まれません。idempotency_key を付けた呼び出しは最大 1 回しか実行されません。
• すべての実行は 1 つの監査台帳に記録されます。ターミナル、チャット、アシスタントのどこから来たかも記録に残ります。

現在稼働しているもの、そして準備中のもの

このセクションは意図的にページの先頭に置いています。連携ドキュメントが犯しうる最も高くつく誤りは、まだ公開されていないエンドポイントを公開済みであるかのように説明することです。連携担当者がコードを書き、エンドポイントが 404 を返し、信頼は二度と戻りません。

コントラクトは凍結されているため、今日書いた連携コードは、残りの部分が公開されても動き続けます。知らないフィールドは無視しなければなりません。このルールがあるからこそ、互換性を壊さずに追加できるのです。

• コマンドカタログと識別テーブル — すべてのコマンドの公開 domain/verb 識別子は凍結されており、コントラクトバージョンはすべてのカタログレスポンスと X-Contract-Version ヘッダーで 1 として公開されています。このページの表はライブのレジストリから生成されます。サーバーで追加されたコマンドは自動的にここに現れ、削除されたコマンドは消えます。
• 認証不要のディスカバリーエンドポイント — GET /api/public/cli/catalog ：コマンド名、domain/verb 識別子、説明、JSON Schema パラメータ、ゲートフラグ、バージョニング用フィールド（since、deprecated_at、replaced_by、aliases）を返します。認証は不要です。トークンの発行は連携を決めた「後」のステップであり、「前」ではありません。レスポンスにはテナントデータが一切含まれません。
• 認証付きのカタログ・実行エンドポイント — GET /api/common/commands 、GET /api/common/commands/{name} 、POST /api/common/commands/{name} の 3 つです。ロールゲート、確認ゲート、冪等性、監査台帳は 1 か所の適用ポイントに集約されており、チャットとターミナルも同じポイントを通過します。
• パネルのカバレッジ：すべての書き込み操作にコマンドがある — 125 ドメインにわたる 519 個のコマンドを、パネルの書き込みエンドポイントと照合しました。対象範囲内のすべてのエンドポイントがコマンド（エンドポイントのミラー、または同じ共有サービス）で裏付けられており、未検証のものはありません。意図的に対象外としているのは、ブラウザに残る 3D Secure 決済・法的同意・アカウントの閉鎖・サインイン、lg の組み込みコマンドであるキー・Webhook・サンドボックスの管理、そしてドライバーアプリ専用のエンドポイントです。
• プリフライト（dry_run）：実行せずに結果を確認 — リクエストボディに dry_run: true を含めると、コマンドは実行されません。バリデーション、ロール／スコープゲート、対象の解決、クレジット計算はすべて実行されてプレビューが返りますが、何も書き込まれず、クレジットも消費されず、冪等キーも消費されません。バッチエンドポイントもバッチ単位でこれを受け付けます。プリフライトがコマンドのハンドラーに入ることはありません。リリース時には、当時カタログにあったすべての書き込みコマンドに対する 178 回のプリフライトで、書き込みステートメントは 1 つも発生しませんでした。
• 連携キー — 実在するチームメンバーの代理として動作する API キーで、パネルまたは lg keys create で発行します。read/write スコープ、アクセスレベル（デフォルトは employee、または manager）、有効期間、最終使用日時、ローテーション、移譲、失効を備えています。lg login --api-key、lg whoami、そしてサーバー側でもキーを失効させる lg logout は、このキーの上に構築されています。
• サンドボックス：本番に触れずに書き込みをリハーサル — 企業ごとに、同じコマンドカタログを持つ独立したサンドボックステナントが用意されます。セルフサービスで開設でき、専用のキーを発行します。クレジット、マーケットプレイス、Webhook のルーティングは 2 つの環境で分離されています。環境はキーの所属企業から導出され、リクエストで指定することはできません。
• バージョニング、エラー分類、冪等性、レート制限 — コマンドは since / deprecated_at / replaced_by / aliases を持ち、非推奨のコマンドは X-Deprecated ヘッダー付きで応答します。業務上の失敗には、トランスポートレベルの error_code に加えて安定した error_key が付き、キーの辞書はカタログで公開されています。冪等キーは自社にスコープされ、1 つのコマンドに紐づき、24 時間ロックされます。レート制限はトークン単位で 3 つのバケットに分かれており、すべての 429 には Retry-After が付きます。
• 送信 Webhook：何かが起きたら POST — 署名付きプッシュは 13 種類のイベントで稼働中です。購読はパネルまたは lg webhooks で管理します。署名には独自のタイムスタンプが含まれ、再試行スケジュールは 60 · 300 · 1800 · 7200 · 21600 秒で、ミュートの理由は必ず記録されます。すべてのイベント名は、実際にディスパッチされるイベントクラスに裏付けられています。告知だけして一度も送られないものはありません。プル方式（updated_since + cursor）は廃止していません。プッシュはその代わりではなく、その隣に追加されたものです。
• ファイルを受け取るコマンド — 33 個のコマンドが書類や写真（CMR、請求書、車検証、パレット写真）を受け取ります。POST /api/common/commands:upload に一度アップロードするか、--attachment_uuid=@./file.pdf で lg に任せ、返された attachment_uuid を渡します。MCP クライアントは upload_attachment ツールを使います。ファイル形式は内容から判定され、アップロードは 24 時間利用できます。
• lg ターミナルクライアント — MIT ライセンスで npm に公開されています。`npm install -g @lgstv/lg` でインストールするか、`npx @lgstv/lg` でインストールせずに実行できます。依存関係のない単一ファイルで、HTTP の窓口が公開されているため、これを使わずに連携することもできます。ブラウザで確認する承認コードでサインインし、その後はセッションを自動で更新しながらサインインしたままになります。ローカルファイルを代わりにアップロードし（@path、--file、lg upload）、連携キーを管理し（lg keys）、シークレットをコマンドラインで受け取ることはなく、Retry-After を尊重し、5xx は同じ冪等キーで再試行し、非推奨のコマンドや新しいコントラクトバージョンについて警告します。
• 増分同期：カーソルページネーションと updated_since — 以下のコントラクト（limit + 不透明な署名付き cursor、next_cursor、updated_since）は確定しており、一覧コマンドへ順次展開中です。ある一覧コマンドが JSON Schema で cursor と updated_since を公開するまでは、小さなウィンドウとして扱ってください（上限 20 行、カーソルなし）。

何が違うのか：クライアントはコマンドを知らず、カタログから描き出す

これは、このページの残りすべてに意味を与える唯一の設計判断です。一般的な CLI ではコマンドはクライアントの中にありますが、Logistivo ではサーバー上にあります。

従来の構成では、サーバーに機能が加わるとクライアントの新しいリリースが必要になり、ユーザーはそれをインストールしなければなりません。その間、両者が知っている内容は食い違います。これこそ連携で最も気づかれにくい失敗パターンです。スクリプトは動き、終了コードは 0 なのに、コマンドはサーバーにできることを正しく表していないのです。

Logistivo では、コマンドの定義は 1 つのレコードです。名前、何をするか、JSON Schema パラメータ、どのロールが見られるか、確認が必要か、その効果を元に戻せるか。lg は起動時にこのカタログを取得し、ヘルプテキスト、フラグ、入力バリデーションをそこから生成します。サーバーでコマンドが追加された瞬間に、クライアントを更新しなくても lg はそれを知っています。

同じカタログが、ダッシュボードの AI アシスタントと、外部 AI アシスタントが接続するチャネルも支えています。機能は一度書かれると 3 か所に現れ、3 つすべてが同じロールゲート、同じ確認ゲート、同じ監査台帳を通ります。CLI 専用のコマンド一覧は別に存在しません。もしあれば、3 つの窓口は半年もしないうちに静かに食い違っていくでしょう。

• バージョンのずれがない — クライアントが知っているコマンド一覧は、構造上、サーバーが持つ一覧そのものです。「このコマンドはどの lg バージョンにありますか？」という問いはそもそも存在しません。
• フラグ名を推測する必要がない — コマンドのフラグは、その JSON Schema のパラメータ名そのものです。コマンドが何を受け付けるかを知る方法は、ドキュメントを読むことではなくカタログを読むことです。そしてカタログは常に最新です。
• CLI の大きさはアカウントに応じて決まる — カタログはロールでフィルタリングされます。自分のロールで見られないコマンドが一覧に現れることはありません。運送会社アカウントには 452 個、荷主には 448 個、通関業者には 312 個のコマンドが表示され、アフィリエイト（紹介パートナー）アカウントには独自の 55 個のコマンドが表示されます。
• ドキュメントが遅れることがない — このページのコマンド表も同じレジストリから生成されています。人間が現実と同期させ続けなければならない一覧は、どこにも存在しません。

命名ルール：コマンド名はどのように増えていくか

カタログは今後も成長します。新しいコマンドはその場しのぎで命名されるのではなく、6 つのルールに従います。ここで公開するのは、これらがあなたの連携コードで何年にもわたって書かれ続ける名前であり、その予測可能性があなたにとって価値を持つからです。

• ドメインは複数形のエンティティ — loads、demands、invoices、export-documents。2 語のドメインは kebab-case です。唯一の例外は不可算名詞で、stock は複数形にしません。「stocks」は別の意味になるからです。
• 1 つのエンティティの動詞はすべて 1 つのドメインに置く — loads は貨物に作用するすべての動詞を持ちます：create、list、get、update、set-status、assign-driver、list-problems、archive など。動詞ごとに新しいドメイン（load-statuses、load-drivers）を作ると、ユーザーは同じエンティティを 3 か所で探し回ることになります。
• 動詞はドメインに漏れ出さない。ドメインは「変化するもの」である — ドライバーを割り当てたときに変化するのはドライバーではなく貨物なので、lg loads assign-driver になります。間接目的語（-driver）は動詞に付け、ドメインには決して付けません。
• サブリソースには独自のドメインを与えない — 請求書の明細行や書類の品目は単独では一覧できず、所有者を通じて指定します（lg invoices add-line、lg export-documents add-item）。判断基準は 1 つです。それを単独で list も get もできないなら、それはドメインではありません。
• 絞り込みは新しい動詞ではなくフラグで行う — lg fleet-documents list --days=30 が正しい形です。期間はすでにパラメータなので、「list-expiring」という別の動詞はありません。修飾付きの動詞を使うのは、返す行がそのドメインのエンティティではない場合だけです。loads list-problems が返すのは貨物ではなく問題フラグです。
• （domain, verb）の組はカタログ全体で一意 — ロールが決して重ならない 2 つのコマンドであっても同様です。同じ組が 2 つのコマンドに与えられると、連携コードは 1 つの名前を見ているのに、CLI は呼び出した人によって異なる処理を実行してしまいます。

カバレッジ：パネルのすべてを、コマンドから

多くのチームが Logistivo を自社の AI エージェントや自動化の仕組みに組み込んでいます。エージェントは、仕事を最後までやり遂げられて初めて役に立ちます。そこでルールは単純です。オフィスのユーザーがパネルで変更できるものは、コマンドでも変更できます。同じロールゲート、同じ確認ゲート、同じ監査台帳のもとで。

これは主張ではなく測定結果です。パネルの背後にあるすべての書き込みエンドポイントをコマンドレジストリと照合しており、あるエンドポイントがカバー済みと数えられるのは、コマンドがそれを自身の HTTP ミラーとして宣言しているか、同じ共有サービスを呼び出している場合だけです。対象範囲内の書き込みエンドポイントは 100% カバーされており、未検証のものはありません。除外したすべてのエンドポイントには、理由が文書で記されています（本人確認と決済のステップ、連携のコントロールプレーン、ドライバーアプリ専用のエンドポイント、クライアントのテレメトリー、呼び出し元のない使われていない複製）。連携担当者にとって重要なものは以下に挙げています。

ファイルを受け取るコマンドも同じルールに従います。表のうち 33 個のコマンドが書類や写真を受け取り、そのすべてが lg、HTTP、MCP から動作します（「ファイルを受け取るコマンド」を参照）。

管理業務も、より強いキーのもとでカバーされています。表のうち 62 個のコマンド（チームメンバーとロール、企業設定、銀行口座、保存済みカード、連携キー）には、manager レベルの連携キーが必要です。デフォルトの employee レベルのキーは日常業務を実行し、これらのコマンドは INSUFFICIENT_KEY_LEVEL で拒否されます。

アフィリエイト（紹介パートナー）アカウントには独自のカタログがあります：20 ドメインにわたる 55 個のコマンドで、紹介、リード、CRM のメモとタスク、営業資料、収益と支払いに加え、すべてのロールが持つアカウントとチームのコマンドを含みます。アフィリエイト専用のコマンドは、パネルの 3 つのロールを掲載する下の公開表には含まれていません。アフィリエイトアカウントでは GET /api/common/commands と lg commands で確認できます。アフィリエイトであると同時に荷主、運送会社、通関業者でもある企業には、両方のセットが表示されます。

エージェントは lg users get（API 名 get_current_user）から始めるべきです。ロール、使用中のキーのアクセスレベル、実効権限、そして保留中の法的同意や未認証の電話番号が現在書き込みを妨げていないかを返すため、エージェントは拒否を集めるのではなく、予測できます。

カバレッジは、コマンドレジストリとパネルの書き込みエンドポイントを比較するレポートで測定されます。コマンドなしで追加されたパネルのエンドポイントは、そのレポートに未検証として現れます。コマンドから到達できないパネルの操作を見つけた場合は、サポートに報告してください。

• 1. リンクを要求する — 本人のブラウザセッションで行わなければならない作業はコマンドではありませんが、コマンドの窓口はそれを把握しています。lg handoff-links generate（API 名 get_browser_handoff_link）は、自分のロールで許可された目的のための logistivo.com リンクを返します：package_purchase、payment_cards、legal_documents、integration_keys、affiliate_demo_accounts、account_close。無料で、何も書き込まず、リンクにシークレットは含まれません。本人はいつもどおりサインインします。
• 2. 本人に渡す — リンクをユーザーに表示するか、自社のチャネルで送ります。本人はそこでステップを完了します：パッケージの契約承認と 3D Secure 決済、カードの追加、保留中の法的文書への同意、シークレットが一度だけ表示される API キーの発行、または自分のアカウントの閉鎖です。
• 3. 結果をコマンドで読み取る — ステップが完了すると、その結果は再びコマンドから見えるようになります：パッケージとクレジット残高、保存済みカード（マスク済み、下 4 桁のみ）、キー一覧の新しいキー。エージェントがチャットでカード番号、決済、同意を受け取ることは決してありません。
• 決済と 3D Secure — パッケージの購入やアップグレード、カードの追加には、ブラウザでの 3D Secure が必要です。コマンドでは、パッケージと価格の一覧表示、残高とその履歴の読み取り、保存済みカード（マスク済み）の一覧表示、デフォルトカードの設定とカードの削除ができます。購入そのものは引き渡しリンクを通じて行います。
• 法的同意 — 法的文書への同意は、本人がブラウザで行います。lg users get は同意が保留中であることを教えてくれますが、どのコマンドも同意を与えることはできません。
• アカウントの閉鎖、サインイン、パスワード — 自分のアカウントの閉鎖、サインイン、パスワードの変更は本人確認のステップであり、ブラウザに残ります。lg user-accounts preview は、実際には閉鎖せずに、アカウントを閉鎖すると何が起きるかを示します。
• 連携キー、Webhook、サンドボックス — これらの管理では、ターミナルで一度だけ表示しなければならないシークレットが返されるため、カタログのコマンドではなく、専用の HTTP エンドポイント上で動作する lg の組み込みコマンド（lg keys、lg webhooks、lg sandbox）になっています。カタログに含まれるのは、シークレットを伴わない 2 つのキー用コマンド、integration-keys list と integration-keys revoke だけです。
• ダッシュボードのアシスタントチャット — 連携キーでは、ダッシュボード内の AI アシスタントチャットを操作できません。キーで実行を開始または継続しようとすると 403 が返ります。エージェントは代わりにコマンドエンドポイント、lg、または MCP チャネルを通じて接続します。そこでは各コマンドがキーのアクセスレベルで実行され、その書き込みは連携による書き込みとして記録されます。
• ドライバーアプリ — ドライバーアカウントにはコマンドカタログがなく、ドライバーアプリは専用のエンドポイントを持ち続けます。オフィスのユーザーは、ドライバー、その書類、経費、運行をコマンドで管理します。

インストールと認証

lg は依存関係のない単一ファイルの Node スクリプト（Node 18 以上）で、npm で @lgstv/lg として公開されています。パッケージは同一の 2 つのコマンド lg と logistivo をインストールします。お使いのマシンで lg がすでにエイリアスとして使われている場合は logistivo を使ってください。単一ファイルなので、lg.mjs を顧客の ERP サーバーにコピーするだけでも動作します。ERP/CRM 連携の構築にクライアントは必要ありません。同じコマンドが HTTP で利用できます。

1. インストール — 必要なのは Node 18 以上だけで、ほかに依存関係はありません。グローバルにインストールするか、npx でインストールせずに実行します。

2. 承認コードでサインインする — lg login は短い承認コードを表示し、ブラウザで logistivo.com/connect を開きます。SSH 経由や CI の中、または --no-browser を付けた場合はアドレスを表示するだけなので、スマートフォンを含む任意のデバイスでそのアドレスを開いてください。そこでいつもどおりサインインし、ページに表示されたコードがターミナルのコードと同じであることを確認したうえで、「読み取り専用」か「読み取りと操作」のアクセスを選んで承認します。ターミナルにシークレットを入力することは一切ありません。パスワードも、キーも、ワンタイムコードも不要です。その後、セッションはそのコンピューターでサインインしたまま維持されます。ターミナルを閉じてもサインアウトされず、lg はアクセストークンの有効期限が切れる前に自動で更新します。lg logout はサーバー側でもセッションを終了させます。また、パネルの Settings › Integration keys › AI and CLI connections から削除することもできます。lg login --password（メールアドレスとパスワード）は代替手段として引き続き使えます。lg 0.11 以降が必要です。

3. サーバーと CI では：承認コードではなくキーを — サーバーや CI ジョブには、ブラウザでコードを承認する人がいません。パネル（Settings › Integration keys）または lg keys create でキーを発行し（必要に応じて、権限を絞った専用のチームメンバーの代理として）、LOGISTIVO_TOKEN に設定するか、lg login --api-key で保存します。この変数が設定されている間、設定ファイルは一切読み込まれません。詳しくは「API キーで接続する」セクションを参照してください。

4. 確認してカタログを見てみる — lg commands は、自分のロールで見られるすべてのコマンドをドメインごとに一覧表示します。lg help はそのドメインの動詞を表示し、lg help は 1 つのコマンドの全パラメータを、型と必須かどうかとともに表示します。これらのテキストはどれもクライアントの中にはなく、すべてカタログから来ています。一覧はロールによって異なることに注意してください。同じドメインでも、運送会社と荷主とでは動詞が異なります（たとえば loads set-status は運送会社のカタログにしかありません）。動詞が見つからない場合は、インストールを確認する前にロールを確認してください。

キーをバージョン管理、CI ログ、チャット画面に決して置かないでください。承認コードまたは連携キーでサインインした場合、lg logout はサーバー側でもそれを終了させます。パスワードセッション（lg login --password）では「ローカル」のコピーを削除するだけで、そのことを明示的に表示します。監査台帳は引数を保存しますが、名前に token、password、IBAN、card、OTP を含むフィールドと、コマンドがシークレットと宣言したすべてのパラメータを *** でマスクします。

• LOGISTIVO_TOKEN — パーソナルアクセストークン。設定されている間は設定ファイルが一切読み込まれません。CI やサーバーではこの方法を推奨します。
• LOGISTIVO_BASE_URL — サーバーのルート。デフォルトは https://logistivo.com です。独自の環境を指す場合にのみ変更してください。--base-url フラグは 1 回のコマンドに対して同じことを行います。
• LOGISTIVO_HOME — 設定ファイルとカタログキャッシュのディレクトリ。デフォルトは ~/.logistivo です。1 台のマシンで 2 つのアカウントを使う場合は分けてください。
• LOGISTIVO_PROFILE — どのプロファイルで実行するか。`lg profile use` は永続的な選択で、この変数は 1 回の実行用です。CI で本番プロファイルとサンドボックスプロファイルを切り替える最短の方法です。存在しないプロファイル名は黙って無視されず、エラーになります。
• NO_COLOR — 設定すると ANSI カラーが出力されなくなります（`--no-color` フラグの恒久版）。ログファイルや CI 出力に書き込むブリッジでは有効にしてください。カラーのエスケープシーケンスは、後でそのログを読むツールを壊します。

クライアントの使い勝手

これらの機能は `lg` クライアントの日常的な利用を楽にします。どれも HTTP コントラクトを変更しないため、HTTP で直接連携する場合はこのセクションを読み飛ばしてかまいません。

• 複数の環境とキー — ステージングと本番、あるいは荷主用ブリッジと運送会社用ブリッジを、別々のプロファイルに分けて保持します。プロファイル一覧がトークンを表示することはなく、各行にはトークンの sha256 フィンガープリントが表示されます。コマンドカタログはプロファイル・ホスト・トークンごとにキャッシュされるため、2 つのロールが互いのコマンド一覧を見ることはありません。
• 増分同期：lg sync — クックブックの同期ループを 1 つのコマンドで実行します。エンティティごとのウォーターマーク、cursor 付きの updated_since、JSONL 出力、5 分間の安全マージンを備えています。最初のバックフィルには --full を使います。このコマンドは読み取り専用で、--write フラグはありません。lg sync --list は、自分のロールで同期可能なエンティティをカタログから導出します。
• エラー時の体験とシェル補完 — 422 のとき、クライアントは拒否されたフィールドを、入力したフラグの名前で示し、安定した error_key とカタログ自身によるその説明を表示します。409 のときは --yes を付けたそのまま使えるコマンドラインを表示し、429 のときは Retry-After の間待機します。シェル補完はドメイン、動詞、フラグ、enum 値をカバーし、オフラインでも動作します。
• シークレットパラメータは決してコマンドラインに書かない — いくつかのコマンドはシークレットを受け取ります。たとえば Paraşüt 会計連携の接続には、そのシステムのクライアント認証情報とパスワードが必要です。lg はこのような値をフラグとしては決して受け付けません。シェル履歴や ps の出力に残ってしまうからです。エコーなしで入力を求めるか、---file=PATH または標準入力（---file=-）から読み取り、メモリ上にのみ保持します。必須パラメータがシークレットであるコマンドは lg からしか実行できません。チャット、MCP、または lg batch の中から呼び出すと SECRET_REQUIRES_CLI で拒否されます。監査台帳には値が常に *** として記録されます。

API キーで接続する

ERP、CRM、スクリプト、AI エージェントは、パネルまたは lg keys create で発行した連携キーで Logistivo に接続します。キーは実在するチームメンバーの代理として動作します。その人のロールがコマンド一覧を決め、キーのアクセスレベルが作業の重さを決め、その人がチームを去るとキーも一緒に無効になります。合成の「サービスアカウント」は存在せず、今後も作りません。マルチテナントの分離はユーザーに結びついており、持ち主のいないブリッジこそ、何年も黙って書き込み続けるものだからです。

1. パネルでキーを発行する — Settings › Integration keys › New key を開きます。名前（例：「ERP 夜間同期」）を付け、スコープとアクセスレベルを選び、必要に応じて有効期間を短くします。キーはその画面で一度だけ表示され、サーバーには保存されません。紛失した場合は Rotate で新しいキーが発行され、古いキーは即座に無効になります。

2. ターミナルから接続する — lg login --api-key はキーを検証し、ID とスコープを表示し、コマンドカタログをダウンロードします。lg whoami は、どのユーザー、企業、ロール、スコープで実行しているかをサーバーに問い合わせます。lg logout は、承認コードのセッションをサーバー側で終了させるのと同じように、サーバー側でキーも失効させます（パスワードセッションの lg logout だけはそれができません）。

3. または素の HTTP で — キーは Authorization: Bearer ヘッダーで送るアクセストークンで、3 つのコマンドエンドポイントに対して直接使えます。サーバーや CI では LOGISTIVO_TOKEN に設定してください。この変数が設定されている間、設定ファイルは一切読み込まれません。

4. またはターミナルからキーを管理する：lg keys — lg keys はパネル画面のターミナル版です。エンドポイントも同じ、ゲートも同じです（チーム管理権限と、キーで呼び出す場合は manager レベルのキー）。create、rotate、transfer は新しいトークンを一度だけ返します。--save-profile=NAME を付けるとトークンはそのままローカルのプロファイルに入り、表示されることはありません。付けない場合、lg はトークンを一度だけ表示します。--json モードでは、--show-secret を付けた場合にのみトークンが含まれます。どちらのフラグも付けない --json の呼び出しはリクエスト送信前に拒否されるため、トークンが黙ってスクリプトの出力に紛れ込むことはありません。rotate、transfer、revoke は確認（--yes）を求めます。キーは正確な名前か uuid で指定し、推測で指定されることは決してありません。アクセスレベルは、ローテーションまたは移譲されたキーにそのまま引き継がれます。

スコープはコマンドカタログだけでなく、API の窓口全体で強制されます。読み取り専用のキーは読み取りリクエスト（GET/HEAD/OPTIONS）を通し、それ以外の書き込みリクエストにはすべて 403 forbidden で応答します。意図的な例外が 2 つあり、どちらもより細かいゲートで守られています。コマンド実行エンドポイント（書き込みを伴わないコマンドも POST で呼び出されるため、判断はコマンド自身の read_only フラグに基づきます）と、キーが自分自身を失効させる操作（lg logout。読み取り専用のキーでも許可されます）です。スコープ、ドメイン許可、アクセスレベルは 3 つの独立した軸で、すべてを通過しなければなりません。read キーは manager レベルでも書き込めず、employee の write キーはチームを管理できず、loads:write のドメイン許可で管理業務が開放されることはありません。必要な範囲をカバーする、最も権限の小さいメンバーの代理としてキーを発行してください。そもそもどのレコードを見られるかは、ロールが決めます。

• read — コマンドカタログと、書き込みを伴わないコマンド（list、search、preview）。書き込みコマンドは確認ゲートの前に 403 forbidden を返すため、読み取り専用のキーが 409 を目にすることすらありません。夜間同期やレポーティングに適した選択です。
• write — すべてのコマンド。確認が必要なコマンドは、引き続き 409 で確認を求めます。confirm: true（CLI では --yes）はこれまでとまったく同じように動作します。スコープによって確認ゲートが緩むことはありません。
• employee — すべての新しいキーのデフォルトです。日常業務：貨物、輸送依頼、見積もり、運行、車両と車両書類、書類、取引先。管理権限を必要としないすべてのコマンドに加え、車両関連の権限を含みます。それ以上が必要なコマンドは、error_key INSUFFICIENT_KEY_LEVEL と required_key_level: manager を付けて 422 で応答し、対応する REST エンドポイントは同じエラーキーとともに 403 で応答します。ERP の夜間同期、テレマティクスのブリッジ、業務スクリプトに適したレベルです。
• manager — キーの代理対象の本人が行えることすべてで、管理業務も含みます：チームメンバーとロール、企業設定、連携キー、銀行口座とその検証、保存済みカード、企業間の関係、アフィリエイトの支払い。manager キーが本人の持たない権限を追加することはありません。チーム管理権限がなければ、manager キーでもチームは管理できません。アクセスレベルの導入前から存在していたキーは manager キーなので、これまでとまったく同じように動作します。
• 連携ごとに 1 つのキー — CRM と ERP がキーを共有していると、一方を切ればもう一方も切ることになります。ブリッジごとに専用のキーを与えてください。一覧にはいずれにせよ名前で表示されます。
• ローテーション — 新しいトークンを発行し、古いトークンを即座に失効させます。残りの有効期間は引き継がれます。漏えいの疑いがあるときや、定期的に実施してください。連携側は、新しいトークンに更新されるまで 401 を受け取ります。
• 失効 — キーは恒久的に閉じられます。元に戻すことはできないため、必要なら新しいキーを発行してください。キーの代理対象のメンバーがチームから外されたり無効化されたりすると、キーは自動的に無効になります。
• 有効期間と上限 — デフォルトの有効期間は 180 日です。作成時に短くすることはできますが、延長はできません。1 人のユーザーが持てる有効なキーは最大 10 個です。最終使用日時は一覧で確認でき、一度も使われていないキーはその旨が明示されます。
• 管理できる人 — 発行、ローテーション、移譲、失効は、チーム管理権限を持つマネージャーが行えます（チームメンバーの追加・削除と同じゲートです）。連携キーで行う場合、そのキーは manager レベルでなければなりません。マネージャーは別のメンバーの代理としてキーを発行できます。ブリッジには、権限を絞った専用のメンバーを推奨します。

最初の 10 分間：パネルから最初の呼び出しまで

連携で最も高くつくのは最初の 10 分間です。以下の 4 つのステップは、その道のりを順に示しています。同じ順序はパネルにもウィザード（Settings › Integration › Setup wizard）として用意されており、ウィザードはここで説明するエンドポイントをそのまま呼び出します。ウィザードを使えない開発者も、このセクションを読めば同じ地点にたどり着けます。

4 つのステップのどれも「送信した」で終わりません。キーが本当に機能しているかはリクエスト台帳が答え、Webhook が本当に届いているかは配信台帳が答えます。どちらもパネルと lg で確認できます。一度も測定されない設定は、動くと信じられているだけの設定です。

• 1. 何をするかを決める：まずスコープを設定する — キーが何を見られるかを後から決めることはできません。スコープはキーの発行時に選びます。軸は 2 つあります。粗いスコープ（read / write）が答えるのは「書き込んでよいか」だけです。細かいスコープ（ドメイン許可：loads:read、invoices:write）は、どのドメインに触れてよいかを示し、設定した瞬間にキーはフェイルクローズになります。選択しなかったすべてのドメインと、どのドメインにも対応しないすべてのエンドポイントは 403 を返します。パネルのドメイン一覧は手書きの一覧ではなく、自分のロールのライブのコマンドカタログから導出され、各ドメインがいくつのコマンドと REST エンドポイントを開放するかを表示します。コマンドカタログ、「自分は誰か」（current）、「ログアウト」のエンドポイントは、常にスコープの対象外です。キーは常に自分自身を説明し、閉じることができなければならないからです。3 つ目の軸はアクセスレベルです。employee（デフォルト）は日常業務を実行し、manager はチーム・設定・キー・お金に関わる作業も行います。ブリッジが管理業務を行わない限り、employee を選んでください。
• 2. キーを発行する：トークンは一度だけ表示される — Settings › Integration › New key を開きます。名前（例：「ERP 夜間同期」）を付け、代理で動作するユーザーとアクセスレベルを選び、必要なら有効期間を短くします。生のトークンはそのレスポンスでのみ返されます。サーバーには保存されず、パネルに「もう一度表示」はありません。紛失した場合はローテーションして新しいトークンを取得すれば、古いトークンは即座に無効になります。トークンをバージョン管理、CI ログ、チャット画面に決して置かず、対象システムのシークレットストアに保管してください。
• 3. 最初の呼び出しを行い、それが「本当に」届いたことを確認する — リクエストは 2 つで十分です。1 つ目は本人確認です（スコープの対象外で、どのキーでも動作します）：スコープは想定どおりか、ステータスは有効か、expires_at が近づいていないか。2 つ目は、選んだドメインから実データを読み取ります。これが通れば、ID、スコープ、メールゲート、ネットワーク経路はすべて正しいということです。通らなければ、推測しないでください。キー自身のリクエスト台帳が、どのエンドポイントがどのコードで、どの安定したエラーキー（INSUFFICIENT_SCOPE、IP_NOT_ALLOWED、KEY_ACTOR_BLOCKED …）で拒否されたかを 1 行ずつ示します。パネルではこの台帳は「Recent requests」ウィンドウ、ターミナルでは lg logs です。ウィザードはまさにこの台帳を監視しており、実際に成功した呼び出しを確認するまで、そのステップを緑にしません。
• 4. Webhook を設定し、何よりも先に署名を検証する — 毎分問い合わせるより、イベントを待つほうが安上がりです。https のアドレスを登録し、関心のあるイベントを選び、購読を自分のキーに紐づけます。キーが失効すれば、配信も止まります。シークレットは作成時に一度だけ表示されます。受信側のエンドポイントは、まず署名を検証しなければなりません。署名対象の文字列は "{t}.{raw body}"、アルゴリズムは HMAC-SHA256 です。タイムスタンプは署名の「中に」含まれているため、署名が有効でも 300 秒より古いリクエストは破棄してください。比較は定数時間で行い、ボディを決して再シリアライズしないでください。JSON をパースして再び出力した瞬間に、署名は一致しなくなります。パネルの「Send test」は本物の署名付き ping を送信し、配信の様子を試行ごとに確認できます。

サンドボックス：本番に触れずに書き込みを練習する

プリフライト（dry_run）は、コマンドが何を「するか」を教えてくれます。しかし、冪等性が本当にリプレイされるか、Webhook が本当に配信されるか、エラー分岐がどう見えるか、クレジットがどこから引かれるかは、「実際の」書き込みでしか確かめられません。そのためにあるのがサンドボックスです。自社を映した独立したテナントで、コードもコマンドカタログも同じですが、本番の台帳には決して触れません。

サンドボックスはリクエストのフラグではなく、「テナント」です。自社のために開設される独立した Logistivo 企業で、独自のユーザー、独自のパッケージ、独自のクレジット台帳、独自の Webhook 購読を持ちます。環境はキーの所属企業から「導出」され、呼び出し側が指定することはできません。そのため、誤ったプロファイルを選んでも、リクエストはサーバー側で 403 ENVIRONMENT_MISMATCH となって停止します。「サンドボックスに書き込んだつもりが本番に書き込んでいた」ということは、構造上起こりえません。

窓口は同一です。これは測定済みです。サンドボックスキーで得られるカタログは、本番キーで得られるものと同じです（荷主のキーでは、どちらも 448 個のコマンド）。サンドボックスで動くブリッジは本番でも動きます。学んだことを二度学び直す必要はありません。

サンドボックスは空の状態では開設されません。生成された（コピーでは「ない」）シードデータが入っています：取引先、両方向の貨物、輸送依頼です。名前は明らかに架空のもので、メールアドレスは @sandbox.invalid ドメインにあります。実在するテナントの行が読み取られたり、複製されたり、テンプレートとして使われたりすることは決してありません。

リセットボタンは意図的に「ありません」。レコード、ファイル、書類が削除されることも一切ありません。まっさらな状態から始めたい場合は、更新によって新しい世代が開設され、古い世代は引退した状態で残ります。蓄積された数百行のリハーサルデータのコストは、誤ったテナントにつながった削除処理に比べれば無に等しいものです。

• 1. サンドボックスを開設する — サンドボックスは企業ごとに 1 つです。このエンドポイントにはチーム管理権限（team.manage）が必要なため、自社の管理者が行います。すでに存在する場合は、同じエンドポイントが GET でその状態を返します：企業 id、残りのクレジット、有効なキーの数、購読、世代の履歴、各種上限。
• 2. サンドボックスキーを発行し、2 つ目のプロファイルとして保持する — キーはサンドボックス専用のブリッジユーザーの代理として発行され、environment: sandbox の印が付いて返ります。生のトークンが表示されるのはその 1 回のレスポンスだけです。lg 側では本番キーを置き換えず、「両方」を別々のプロファイルとして保持してください。--sandbox と --live は 1 回の実行ごとの選択子です。
• 3. 実際に書き込む — ここでは --dry-run は使いません。書き込むことこそが目的です。同じ冪等キーを 2 回送り、2 回目のレスポンスが status: replayed で返ってくるのを確認してください。これがサンドボックスで測定された結果です。ゲート付きのコマンドをあえて確認なしで呼び出して 409 のボディを読み、スコープ外のコマンドを試して拒否の内容を読んでください。どれも本番の台帳には痕跡を残しません。同じ実行の間、本番の残高は変わりません。
• 4. 本番移行の前にチェックリストを読む — go-live エンドポイントは、サンドボックスで「実際に」行ったことに基づいて答えます：書き込んだか、エラー分岐を確認したか、Webhook が配信されたか、受信側をリハーサル用のアドレスから移したか、キーに有効期限を設定したか。各項目は pass / todo / unknown で返ります。同じレスポンスには、実際に呼び出したコマンドから導出された「スコープの提案」も含まれます。これを使って、本番キーを必要以上に広くせずに発行してください。
• クレジットと請求 — サンドボックスは独自のクレジット台帳を持ち、本番の残高は動きません。これはチェックではなく構造です。クレジットは企業ごとに数えられ、サンドボックスは別の企業だからです。無料プランで開設され、支払い方法を持たず、月次の請求サイクルの外にあるため、どの経路からも請求書に至ることはありません。
• マーケットプレイス — サンドボックスで作成した輸送依頼は、実在の運送会社の画面に表示され「ず」、メールやプッシュの受信箱にも届き「ません」。また、あなたにも実在の輸送依頼は表示されません。この分離は対称的で、2 つの別々のクエリで強制されます。輸送依頼が誰に「見える」かと、誰に「送られる」かは、別の問いだからです。
• Webhook — 購読にも環境の印が付きます。サンドボックスのイベントが本番の購読に配信されることはなく、本番のイベントがサンドボックスの購読に届くこともありません。印がずれてしまった購読には、配信が一切作成されません。購読の上限は企業ごとなので、リハーサル用の購読が本番の枠を食うことはありません。
• シードデータ — サンドボックス内のサンプルレコードは「生成された」もので、実在のテナントからコピーされることはありません。シードの投入は冪等です。2 回目の呼び出しで、自分のレコードの上に 2 回目のシードが重ねられることはありません。
• 同じカタログ — サンドボックスでもロールは同じで、コマンド一覧も同一です。測定の結果、どちらも 448 個のコマンドです。サンドボックスは機能を削ったデモではなく、自社の双子です。
• 現時点の制限：サンドボックスキーでは Webhook の購読を管理できない — 購読のエンドポイントにはチーム管理権限（team.manage）が必要ですが、サンドボックスのブリッジユーザーはチームロールを持たないため、`lg --sandbox webhooks …` は現時点では 403 を返します。コマンドの窓口はすべて動作し、制限は購読の台帳にのみあります。サンドボックスで Webhook をリハーサルしたい場合はサポートにお問い合わせください。これは測定済みで、未解決の課題として記録されています。
• GET /api/common/integration-sandbox — 状態：存在するかどうか、どの企業か、残りのクレジット、有効なキーと購読の数、世代の履歴、各種上限、そしてどのコマンドがどのイベントを発生させるかを示すトリガーガイド。
• POST /api/common/integration-sandbox — サンドボックスを開設します（企業ごとに 1 つ、冪等）。team.manage 権限が必要です。
• POST /api/common/integration-sandbox/keys — 201 + キーと生のトークン（ここでのみ、一度だけ）。environment: sandbox の印は企業から導出され、呼び出し側が指定することはできません。
• GET /api/common/integration-sandbox/go-live — 本番移行チェックリストとスコープの提案。サンドボックスでの実際のトラフィックから算出されます。
• POST /api/common/integration-sandbox/renew — サンドボックスの新しい「世代」を開設し、前の世代を引退させます。

コマンドモデル

文法は 1 つだけで、例外はありません。コマンドの呼び出し方を知るために必要なのは、カタログがそのコマンドについて述べている内容だけです。

lg loads list --status=in_transport --limit=20 --json

フラグ名はスキーマのパラメータ名であり、lg はどちらの綴りも受け付けます。--load_code と --load-code は同じフィールドに届きます（lg help は kebab-case 形式で表示します）。つまりフラグを見れば、どの JSON フィールドに入るかがわかり、CLI から HTTP に移る際に名前を変換する必要はありません。値なしで書いたブール型パラメータは true になり（--only_open）、その逆は --no-only_open です。値がダッシュで始まる引数は --flag=value の形で書いてください。そうしないと、書き忘れたフラグが次のフラグを黙って値として飲み込んでしまいます。ファイルを受け取るコマンドでは、ローカルパスの前に @ を付けます (--attachment_uuid=@./cmr.pdf)。「ファイルを受け取るコマンド」を参照してください。

• lg — クライアント。
• loads — ドメイン。操作対象のエンティティで、複数形です。
• list — 動詞。そのエンティティに対して何をするかを表し、意図的な判断によってのみ増える閉じた語彙から選ばれます。単純な動詞（list、get、create、update、delete、search、preview、generate、extract …）と、付加・変更する対象を名前に含む複合動詞（add-document、set-status、assign-driver）があります。lg help でドメインの動詞を一覧できます。
• --status=in_transport — パラメータ。名前は JSON Schema のパラメータ名そのもので、値はスキーマの型に一致しなければなりません。enum フィールドへの不正な値がサーバーに届くことはありません。
• --limit=20 — 一覧コマンドの行数。上限は各コマンドのパラメータ説明に記載されています。通常の一覧呼び出しでは一般に 20、同期モード（cursor または updated_since 使用時）では最大 100 です。
• --json — 生の JSON 出力。
• --json — 生の JSON を出力します。スクリプトにとって正しい形式はこれだけです。デフォルトの整形済みテーブルは人間向けで、列をデータから選び、予告なくレイアウトが変わることがあります。テーブル出力をパースするスクリプトは決して書かないでください。
• --yes, -y — 確認ゲートを通過します（HTTP では confirm: true）。これから何をするのかを把握しているスクリプトでのみ使ってください。取り消せないコマンドでは、このフラグは「元に戻せない」の略記です。
• --idempotency-key= — 書き込みコマンドの再試行を安全にします。同じキーでの 2 回目の呼び出しはコマンドを再実行せず、最初の結果を返します。再試行ループを組む場合は、キーを「自分で」生成し、毎回同じキーを送ってください。
• --dry-run — コマンドの代わりにプリフライトを実行します。バリデーション、各ゲート、クレジット計算は実行されますが、何も書き込まれません（プリフライトのセクションを参照）。すべてのコマンドと lg batch で有効です。
• --refresh — カタログの再取得を強制します。lg はカタログを 1 時間キャッシュします。サーバーでコマンドが追加されたばかりだとわかっている場合は、待たずにこれを使ってください。
• --help, -h — コマンドのカタログ上の説明、すべてのパラメータ、その型、enum 値、必須かどうかを表示します。クライアント内にヘルプファイルはありません。
• --profile=, --sandbox, --live — この 1 回の呼び出しをどのプロファイルで実行するか。--sandbox と --live は、サンドボックスキーまたは本番キーを持つプロファイルを選びます。環境はサーバー側でキーから導出されるため、不一致の場合は誤った場所に書き込むのではなく 403 ENVIRONMENT_MISMATCH で停止します。
• --base-url, --timeout, --verbose, --no-color, --version — それぞれ、1 回のコマンドを別のサーバーに向ける、秒単位のタイムアウト、リクエスト／レスポンスの詳細表示、ANSI カラーの無効化、クライアントのバージョン表示です。

実際の例

以下のコマンドはすべて現在のカタログに存在し、ここにある名前やパラメータに作り話は一切ありません。出力は省略しています。出力は `data.result` の階層を示しています。HTTP では同じオブジェクトが `{success, data:{…}}` エンベロープに包まれて届きます（「HTTP コマンド API」を参照）。

• 現在輸送中の貨物 — lg loads list --status=in_transport --limit=20
• 1 件の貨物の全情報（生の JSON） — lg loads get --load_code=FSK2158 --json
• 未解決の書類整合性フラグ — lg loads list-problems --only_open=true --limit=10
• 国を解決する — lg countries search --query=Germany --json
• 解決した id で絞り込む — lg loads list --receiving_country_id=57 --date_from=2026-09-01 --limit=20
• 製品名から HS コードを探す — lg tariffs search --query="aluminium profile"
• 貨物のステータスを進める（運送会社ロールのみ） — lg loads set-status --load_code=FSK2158 --status=transit --date=2026-08-21 --yes
• 下書き — lg export-documents create --doc_type=proforma-invoice --currency_code=EUR --json
• 生成する（ゲート付き） — lg export-documents generate --document_id=8412 --yes

クライアントなしで：HTTP コマンド API

lg は便利な道具であって、入口そのものではありません。カタログと実行はどちらも 3 つの HTTP エンドポイントを通ります（ファイルには 4 つ目としてアップロード用エンドポイントがあります。「ファイルを受け取るコマンド」を参照）。ERP や CRM の連携はここに直接接続します。認証には Authorization: Bearer で送るパーソナルアクセストークンを使います。「すべての」レスポンスは同じエンベロープで返ります：`{ "success": bool, "data": { … }, "code": "…", "message": { … } }`。コントラクト全体は `data` の中にあります。`contract_version`、`command`、`status`、そしてコマンドの出力としての `result`、失敗時には `error_code`、`error_key`、`error` です。このページのレスポンス例は、紙面節約のためエンベロープではなく `data` オブジェクトを示しています。自分のコードで `data` を取り出すのを忘れないでください。`lg --json` もエンベロープ「全体」を出力するため、jq パスは `.data.result…` で始まります。唯一の例外は `/api/public/status` です。このエンドポイントはエンベロープを持たないため、監視ツールはパースせずにアラートを出せます。

200 + ok:false で確認を求めることは禁止されており、決して起こりません。理由は単純です。クライアントは 200 を成功として扱うため、200 で返された確認要求はフローを黙って止めてしまい、誰も気づきません。確認は常に 409 です。

• GET /api/common/commands — 自分のロールで見られるカタログ全体を返します。contract_version、コマンドごとに name、domain、verb、description、JSON Schema、read_only、confirmation_needed、irreversible、credit_cost、since、deprecated_at、replaced_by、aliases、およびアクセス関連のフィールド key_level、permission、file_params、secret_parameters、cli_only を含みます。トップレベルには error_keys 辞書、rate_limits、idempotency_ttl_hours、自分のカタログロール、attachments（アップロード）コントラクト、呼び出しに使っているキーのアクセスレベルがあります。ETag を送信し、If-None-Match には 304 で応答します。?domain= は古い（エイリアスの）ドメインにも一致します。クライアントはここから組み立て、コマンド一覧をハードコードしないでください。
• GET /api/common/commands/{name} — 1 つのコマンドの全情報。name はカタログ上の凍結されたコマンド名（list_loads）であり、CLI 上の識別子ではありません。非推奨のコマンドは X-Deprecated ヘッダー付きで応答します。
• POST /api/common/commands/{name} — 実行。ボディ：{ args, confirm?, idempotency_key? }。レスポンスの HTTP ステータスが結果そのものです。200 以外はノイズではなく情報です。エラーには error_code（トランスポート）が付き、業務上の拒否の場合は error_key も付きます。

ファイルを受け取るコマンド

表のうち 33 個のコマンドが書類や写真を受け取ります：貨物に CMR を添付する、請求書から HS コードを読み取る、車検証から車両を作成する、写真からパレットを推定する、企業書類をアップロードする、請求書をパッキングリストと照合する、などです。ブラウザではファイルをフォームにドロップしますが、それ以外の場所では 2 つのステップが必要です。ファイルをアップロードし、その id をコマンドに渡します。

名前が attachment_uuid または attachment_uuids で終わるパラメータはファイルを受け取ります。リスト内なら photos[].attachment_uuid、小切手なら front_attachment_uuid です。これを覚えておく必要はありません。カタログの各行には正確なパスを含む file_params があり、スキーマはそれらのフィールドに印を付け（format: uuid、x-logistivo-file: true）、カタログのレスポンスにはアップロード先、受け付ける形式、サイズ上限、有効期間を含む attachments ブロックがあります。lg help でも表示されます。

アップロードは書き込みなので、read スコープのキーではアップロードできません。write スコープのキーなら、どちらのアクセスレベルでもアップロードできます。アップロードしたファイルはキーではなくユーザーに属します。同じユーザーの 2 つのキーは同じアップロードを参照でき、他人のアップロードは誰も使えません。未知の id、期限切れの id、自分のものではない id は単に「見つからない」とされ、その理由は開示されません。

ダッシュボードのチャットの添付ファイルとコマンドのアップロードは別々の領域です。アシスタントチャットで添付したファイルを id でコマンドに渡すことはできず、コマンドのアップロードがチャットのスレッドに現れることもありません。

アップロードはコマンドではなく、それ自体に業務上の効果はありません。コマンドがその id を使うまで、データには何も起こりません。アップロードで確認が求められないのもそのためです。ゲートを持つのは、ファイルを消費するコマンドのほうです。

• 1. lg：ローカルパスの前に @ を付ける — lg はまずファイルをアップロードし、返された id でコマンドを実行します。@ のない値は、以前にアップロードしたファイルの id です。リストにはカンマ区切りのパスか、フラグの繰り返しを指定し、ネストしたフィールドには JSON を指定します。コマンドにトップレベルのファイルフィールドがちょうど 1 つしかない場合は、--file が近道になります。lg は何かを送信する前に各ファイルをローカルで検証し（存在、サイズ、形式）、lg batch はバッチの実行前に、重複しない各ファイルを 1 回ずつアップロードします。
• 2. HTTP：アップロードしてから attachment_uuid を渡す — ファイルを multipart/form-data として、file という名前のフィールドで送ります。新しいアップロードには 201 が返ります。同じユーザーが同じファイルを再度アップロードすると、status replayed と同じ id とともに 200 が返り、何も書き込まれません。このページの他の箇所と同様、例はエンベロープ内の data オブジェクトを示しています。
• 3. MCP：upload_attachment ツール — MCP クライアントは multipart を送信できないため、チャネルはカタログにない追加のツールを 1 つ提供しています。upload_attachment はファイル名と base64 の内容を受け取り、同じ attachment_uuid を返します。HTTP のアップロードと同じサービスを、同じルールのもとで呼び出します。
• 形式は内容から判定される — ファイル名と申告された形式は無視され、保存される拡張子は判定されたものになります。アップロードで受け付ける形式：jpg, jpeg, png, webp, heic, heif, pdf, xlsx, xls, csv, txt, doc, docx, xml, zip。さらに各コマンドは、実行前にそれぞれのより狭いリストを適用し、受け付ける形式を添えた UNSUPPORTED_FILE_TYPE、または FILE_TOO_LARGE で応答します。
• サイズ — 画像は最大 10 MB、その他のファイルは最大 15 MB です。
• 有効期間 — アップロードは 24 時間利用できます。それを過ぎると解決されなくなります（ATTACHMENT_NOT_FOUND）が、削除はされません。その理由でコマンドが失敗した場合は、再度アップロードしてください。
• 同じファイルなら同じ id — 同じファイル（名前、サイズ、内容が同じ）を再度アップロードすると、残りの有効期間が 1 時間以上ある限り、新しく書き込む代わりに既存の id が返り、1 日あたりの上限も消費しません。
• 1 日あたりの上限 — ユーザーごとに 1 日 300 件のアップロード（TOO_MANY_FILES）、企業ごとに 1 日 2 GB（DAILY_LIMIT_REACHED）。どちらも retry_after 付きで 429 を返します。
• POST /api/common/commands:upload — file フィールドでの multipart アップロード。新しいアップロードには 201、同じファイルには status replayed とともに 200 を返します。data.attachment を返します：attachment_uuid、filename、mime_type、size_bytes、sha256、extraction_status、expires_at、reused。

確認ゲートと取り消せないコマンド

カタログのすべてのコマンドは 2 つのフラグを持ちます。confirmation_needed（実行前に明示的な承認が必要か）と irreversible（その効果を元に戻せるか）です。これらは別々の問いであり、どちらもクライアントの行儀の良さに任せるのではなく、サーバー側で強制されます。

このゲートは業務ルールではなく、責任のためのものです。見積もりを提出することは運送契約への第一歩であり、請求書を発行すれば会計仕訳が生まれ、在庫移動は台帳を変えます。どれも、うっかり 2 回実行できてしまってよいものではありません。

ゲートは「実際に実行される」コマンドから読み取られます。チャットの汎用実行コマンドのように、あるコマンドが別のコマンドをラップする場合、ゲートはラッパーではなく、実際に実行されるコマンドのフラグから決まります。フラグが固定されていたら、2 つの失敗のどちらかが避けられません。請求書コマンドが確認なしで実行されるか、国を検索するたびに確認カードが表示されるかです。

read_only と「ゲートなし」は同じではありません。3 つの異なる状態があります。invoices preview はゲートがなく、何も書き込みません。loads create はゲート付きで、書き込みます。invoices create はゲートがないものの書き込みます（下書きが生まれます）。判断基準は 1 つです。コマンドが戻ったとき、データベースの行が変わっているかどうかです。

一部の操作は、そもそもコマンドではないため、このゲートの対象外です。パッケージの購入、3D Secure によるカードの追加、法的文書への同意、アカウントの閉鎖は、本人のブラウザで行われます。これらについては lg handoff-links generate が logistivo.com のリンクを返し（無料で、何も書き込まず、シークレットも含みません）、本人がそこでステップを完了します。どのフラグをどう設定しても、決済や同意が API 呼び出しになることはありません。

連携側ですべての呼び出しでゲートを自動的に通過させることは技術的には可能ですが、推奨しません。正しいパターンは、元に戻せるとわかっているコマンドに限ってゲートを自動化し、取り消せないコマンドは人間のキューに回すことです。

• 1. 呼び出す — ゲート付きのコマンドを confirm なしで呼び出します。何も変わりません。
• 2. 要約を読む — 409 が返ります。ボディ内の confirmation.summary は、生の引数をダンプしたものではなく、人間向けに書かれた文です（"About to issue an invoice: X Ltd, 1,200.00 TRY"）。金銭に関わるコマンドは、明細行、合計、警告を含む構造化されたプレビューも返します。
• 3. 確認する — 同じ呼び出しを confirm: true を付けて繰り返します（CLI では --yes）。取り消せないコマンドには、最大 1 回しか実行されないよう印が付けられています。

プリフライト：書き込みコマンドを実行せずに、何が起きるかを確認する

ERP ブリッジの組み込みで最も高くつくのは、リクエストボディが正しいかどうかを、コマンドを「実際に」実行して確かめることです。本番の台帳に下書きの請求書が残り、クレジットが消費され、手作業での後始末が必要になります。dry_run はそれを終わらせます。リクエストにフィールドを 1 つ追加するだけで、コマンドは実行されず、何が起きるかを読み取れます。

レジストリには現在 519 個のコマンドがあり、そのうち 233 個は読み取りのみで何も書き込みません。残りの 286 個の書き込みコマンドのうち 251 個はゲート付きで、confirm なしで呼び出すとすでに 409 を返し、何をするかを説明します。抜け穴は残りの 35 個でした。請求書の下書き、輸出書類の下書き、明細行といった、まさにブリッジが最初に組み込む一連の処理です。これらは、呼び出すことがそのまま実行することでした。

ゲート付きのコマンドにも 2 つ目の抜け穴がありました。スキーマバリデーションはゲートの「後」に実行されます。そのため、引数が欠けた呼び出しはまず確認カードを受け取り、確認し、その後でようやく「このフィールドがありません」と知らされていました。プリフライトは 1 回の往復で両方に答えます。

そして、最もよくあり、かつ最も発見が遅れるブリッジのバグはこれです。スキーマにないフィールドを送る（recipient_contact_id が期待される箇所に customer_id を送る）と、サーバーはそれを黙って捨て、コマンドは 200 を返し、レコードは誤った場所に作られます。プリフライトのレスポンスは、そうしたフィールドを arguments.ignored の下に名前付きで列挙します。エラーメッセージがそれを教えてくれることは決してありません。

プリフライトは何も書き込みません。これは測定結果である以前に、構造上の性質です。プリフライトの経路はコマンドのハンドラーに決して入らないため、後から追加されるものも含め、すべてのコマンドに当てはまります。リリース時には測定も行いました。当時カタログにあったすべての書き込みコマンドをプリフライトした際（2 種類の引数セット、2 つのロール、178 回のプリフライト）に発行されたすべての SQL ステートメントを記録しました。INSERT/UPDATE/DELETE は 1 つもなく、キューに入ったジョブも、メールも 1 通もありませんでした。31 テーブルの行数とクレジット残高も変わりませんでした。

終了コードは実際の呼び出しが返すものと同じです（実行可能なら 0、確認ゲートなら 4、冪等性の衝突なら 2、それ以外は 1）。そのため "lg … --dry-run || exit" は CI ステップで意味のあるゲートになります。

• 1. dry_run 付きで呼び出す — リクエストボディに "dry_run": true を追加します。バリデーション、ロールとスコープのゲート、対象の解決、クレジット計算はすべて実行されますが、コマンド自体は実行されません。
• 2. would_execute を読む — 分岐に使うフラグはこれ 1 つです。false の場合、would_stop.at が、実際の呼び出しがどこで止まるかを示します：idempotency、target_precheck、confirmation_gate、arguments のいずれかです。
• 3. ボディを修正する — arguments.ignored は黙って捨てられるフィールドを、missing_required は書き漏らした必須フィールドを、would_charge は消費されるクレジット数と残高で足りるかどうかを示します。
• 4. dry_run を外す — would_execute が true になるまで繰り返し、その後フラグを外して実際の呼び出しを行います。プリフライト中に送った冪等キーは消費されていないため、実際の呼び出しは通常どおり実行されます。
• HTTP は常に 200 — 「コマンドは失敗するだろう」という結果が 4xx で届くことはありません。プリフライト自体は成功しており、予測はボディに入っています。例外はトランスポートレベルの拒否で、その場合は実際の呼び出しとまったく同じように振る舞います：404 は未知のコマンド、403 はロール／スコープ、429 はレート制限です。
• read スコープのキーでは書き込みコマンドをプリフライトできない — 403 が返ります。プリフライトが答えるのは「今、このキーで呼び出したら何が起きるか」です。read キーに青信号を出しておいて実際の呼び出しで 403 を返すことは、まさにプリフライトが防ぐために存在する不意打ちです。
• 冪等キーは消費されない — プリフライト中に送ったキーは台帳の行を作らず、期限切れのロックも解放されません。ですから、本番で使うつもりのキーを送ってください。プリフライトは、そのキーがまだ空いているか、以前の実行をリプレイすることになるか、別のコマンドと衝突するかを教えてくれます。
• confirm と組み合わせられる — dry_run と confirm を一緒に送ると、問いは「確認したら何が起きるか」になります。それでも何も実行されません。
• バッチのプリフライトはバッチ単位 — commands:batch も dry_run を受け付けますが、このフラグは個々の項目ではなくバッチに属します（項目に付けて送ると 422 になります）。項目ごとのレポートに加えて、バッチ全体のクレジットコストが返ります。残高不足は拒否されるのではなく、報告されます。
• 無料ではない — プリフライトは毎回実際のクエリ（プレビュー、残高）を実行し、レート制限にカウントされます。デプロイのたびにカタログ全体をプリフライトするのではなく、変更したコマンドだけをプリフライトしてください。

冪等性：再試行しても重複が生まれない理由

ERP はエラーメッセージを読まず、画面も見ず、タイムアウトの後には同じリクエストを再送します。このセクションはまさにその振る舞いのためにあります。

idempotency_key を付けた呼び出しは最大 1 回しか実行されません。2 回目の呼び出しはコマンドを再実行せず、記録された結果を status replayed で返します。ネットワークが切れたとき、リクエストがタイムアウトしたとき、キューが同じジョブを 2 回拾ったときも、重複した請求書ではなく最初の結果が返ります。

すべての書き込みコマンドでキーを使ってください。カタログの read_only フィールドが、その区別を労せず教えてくれます。read_only: false のコマンドにはすべて冪等キーを付けるべきです。

再試行戦略では指数バックオフを使い、毎回「同じ」キーを送ってください。試行ごとに新しいキーを生成するのは、冪等性をまったく使わないのと同じです。同じキーを並列に送らないでください。at-most-once（最大 1 回）が保証されるのは順次の再試行に対してであり、互いに競合する 2 つのリクエストに対してではありません。

• 落とし穴 1：失敗もロックされる — 最初の実行が業務ルールによって拒否された場合（failed）、同じキーでの 2 回目の呼び出しは同じエラーと同じ error_key を返し、再試行はしません。引数を直してもう一度試すには「新しい」キーが必要です。キーが表すのは意図ではなく、1 回の試行です。
• 落とし穴 2：大きな結果はボディなしでリプレイされる — 台帳が結果を保存するのは 64 KB 未満の場合だけです。それより大きな結果は status replayed でリプレイされますが、ボディは空です。連携側はボディではなく「replayed」というシグナルに頼り、対応する get コマンドでデータを取得してください。
• 落とし穴 3：キーは 1 つのコマンドに属する — 同じキーを別のコマンドで送ると、conflicting_command とともに 409 idempotency_conflict が返ります。何も実行されず、何もリプレイされません。1 つのキーを 2 つの動詞で共有するクライアントは壊れており、そのことを黙ったリプレイではなくエラーで知ることになります。
• 落とし穴 4：ロックは永遠ではなく 24 時間 — 24 時間が経つと、同じキーは新しい実行として扱われます。ネットワークの再試行は数分以内に届きますし、ERP で毎年繰り返し使われる伝票番号がいつまでも「replayed」のままであってはなりません。カタログはこの期間を idempotency_ttl_hours として公開しています。
• 落とし穴 5：サーバーエラーではキーはロックされない — 5xx の server_error は業務上の拒否ではありません。キーは紐づけられないため、同じキーで再試行すると実際にコマンドが実行されます。ロックされるのは failed だけです（落とし穴 1）。
• スコープと形式：自社単位、任意の文字列、推奨は UUID — 一意性は（自社, キー）の組で強制されます。別テナントの INV-1001 があなたのキーと衝突することはなく、あなたの結果をリプレイすることもできません。単純な UUID か、{ERP-document-no}:{verb} のように構造上一意になる複合値を使ってください。

増分同期とページネーション

ERP/CRM ブリッジは、毎時すべてを取得するのではなく、変更されたものだけを取得すべきです。すべての一覧コマンド（loads list、demands list-own、contacts list、invoices list、teammates list、load-groups list、reservations list、drivers list、tenders list、products search、warehouses search）は、2 つの共通パラメータを受け付け、1 つの共通フィールドを返します。

offset がない理由：稼働中のテーブルでは offset がずれます。2 つのページの間に挿入された行のせいで、レコードを黙って読み飛ばしたり二重に数えたりします。カーソルは前進のみなので、走査の途中で挿入・更新されたレコードは一覧の末尾に来ます。何も失われず、何も重複しません。

最初の全件取得も同じ仕組みです。updated_since=1970-01-01T00:00:00Z から始め、next_cursor が null になるまでたどります。必要がないため、別の「エクスポート」エンドポイントはありません。

lg でも同じことができます：lg loads list --updated_since=2026-09-01T00:00:00Z --limit=100 --json を実行し、続いて lg loads list --cursor= --json を実行します。

次回の同期では、updated_since に、これまでに見た最大の updated_at を設定します。タイムスタンプの精度は 1 秒なので、境界上のレコードが 2 回届くことがありますが、自分の側で external_ref または code をキーに upsert していれば無害です。updated_since も cursor もない場合、コマンドはチャットモードで実行されます：人間向けの並び順、最大 20 行、next_cursor は null で、truncated が「まだある」ことを示します。このモードを同期に使わないでください。

このセクションの機械可読なエラーキー：INVALID_CURSOR、INVALID_UPDATED_SINCE、DUPLICATE_EXTERNAL_REF、EXTERNAL_REF_TOO_LONG、EXTERNAL_REF_INVALID。いずれも HTTP 422 で応答し、ボディには error_code: "failed" と result.error_key が入ります。テキストではなく、キーで分岐してください。

• updated_since — ISO-8601 タイムスタンプ（UTC を推奨。例：2026-09-01T00:00:00Z）。この時刻以降に更新された行が対象です。コマンドを同期モードに切り替えます：順序は（updated_at, id）の昇順に固定され、limit の上限は 100 です。
• cursor — 前回のレスポンスの next_cursor をそのまま渡します。不透明で署名付きなので、自分で組み立てたり編集したりせず、別の企業や別のコマンドのカーソルを再利用しないでください。これらはすべて INVALID_CURSOR で拒否されます。
• limit — ページサイズ。同期モードでは 1-100（デフォルト 10）。
• next_cursor（レスポンス） — 次のページのカーソル。null は一覧が完結したことを意味し、「まだあるか」に対する唯一の正しい答えです。
• total（レスポンス） — ページに関係なく、フィルターに一致する行数。進捗表示に使います。

自社のキー：external_ref

こちらの自動採番 id（invoice_id、contact_id）を ERP の業務キーにしないでください。これらは不透明で、自社内に閉じたものです。代わりに、貨物、輸送依頼、取引先、請求書、製品、倉庫は、あなたのキーを保持できます。

• 書き込み時に設定する — loads create、demands create、contacts create と contacts update、invoices create は、任意の external_ref（最大 120 文字）を受け付け、そのまま返します。
• 読み取り時に使う — loads get --external_ref=ORD-2026-0917, invoices get --external_ref=..., contacts get --external_ref=..., demands get --external_ref=... のいずれも動作します。list と search のコマンドでは、--external_ref= は完全一致のフィルターです。
• 企業ごとに一意 — 同じキーを持つ 2 件目のレコードは 422 で拒否され、result.error_key = DUPLICATE_EXTERNAL_REF となります。別の企業のキーに対しては「見つかりません」と応答します。照合は大文字・小文字を区別しません（ord-1 = ORD-1）。アーカイブされたレコードはキーを保持し続けるため、キーを再利用する前にそのレコードを復元してください。
• idempotency_key も送る — ネットワークのタイムアウト後に再試行しても、重複を作らずに最初の結果が返ります。この 2 つは互いの代わりにはなりません。external_ref はあなたの業務キーであり、idempotency_key は 1 回の試行を識別します。

送信 Webhook：何かが起きたら、こちらからあなたへ POST します

ここまでの内容はすべてプル方式でした。あなたが尋ね、こちらが答えます。ERP ブリッジは、貨物のステータスが変わった、請求書が発行された、見積もりが届いたといったことを知るために、1 分ごとに問い合わせる必要がありました。今は違います。https のアドレスを登録し、関心のあるイベントを選べば、それが起きたときに署名付きの POST が届きます。

プッシュはプルの代わりではなく、プルの「隣に」追加されました。増分同期（updated_since + cursor）には手を加えておらず、今も正しい手段です。最初の全件取得、履歴のバックフィル、「何か見落としていないか」の確認は、すべてそちらで行います。Webhook は遅延を数分から数秒に短縮します。健全なブリッジは両方を使います。Webhook をトリガーとして、同期をセーフティネットとして。

ペイロードはレコードのコピーではなく「シグナル」です。識別子（id、あなた自身の external_ref、status、時刻）を運びます。詳細は自分のキーを使って GET で取得し、その呼び出しはすでにあなた自身の認可ゲートを通過します。そのため、露出面は識別子のレベルにとどまります。2 つのフィールドは意図的に含めていません。見積もりを出した企業の身元（ブラインド見積もりはパネルでは別名で表示されます。Webhook に身元を入れると、2 つ目の経路からそのプライバシーを破ることになります）と、予約の連絡先情報（個人データを余計な経路で動かす必要はありません）です。

イベント名は「凍結」されています。名前の意味が変わる場合は新しい名前が作られ、古い名前は非推奨期間のあいだ存続します。ペイロードに新しいフィールドを追加しても、コントラクトバージョンは上がり「ません」。受信側は知らないフィールドを無視しなければなりません。

• GET /api/common/integration-webhooks — 台帳に加えて、イベントカタログ、上限、ヘッダー名を返します。各行にはミュートの理由と 7 日間の配信サマリーが含まれます。
• POST /api/common/integration-webhooks — 201 + { webhook, secret, shown_once: true }。シークレットが表示されるのはここだけです。
• PATCH /api/common/integration-webhooks/{uuid} — 名前／アドレス／イベント／有効フラグ。シークレットには影響「しません」。
• DELETE /api/common/integration-webhooks/{uuid} — 購読を削除します。行はソフトデリートされ（履歴は引き続き照会可能）、保留中の配信はキャンセルされます。
• POST /api/common/integration-webhooks/{uuid}/rotate-secret — 201 + 新しいシークレット。古い値はその時点で使えなくなります。
• POST /api/common/integration-webhooks/{uuid}/test — ping イベント。本物の署名、本物の経路、本物の再試行スケジュールで送られます。
• GET /api/common/integration-webhooks/{uuid}/deliveries — 直近の配信：ステータス、試行回数、HTTP コード、所要時間、エラータグ。
• POST /api/common/integration-webhooks/deliveries/{uuid}/replay — 1 件の配信を再送します。event_id は「保持」され、配信 id は新しくなり、ペイロードはそのままコピーされます。

イベントカタログ

以下の 13 種類のイベントはどれも、「実際に」ディスパッチされるイベントクラスに裏付けられています。カタログに「あったらいいな」という名前はありません。告知されたのに一度も発火しないイベントは、連携担当者が永遠に待ち続けるイベントであり、その失敗は気づかれません。この表も手書きではなく、ページを読み込むたびにライブのカタログから生成されます。

invoice.payment_recorded は意図的に「含めていません」。このイベントクラスはコード上に存在しますが、どこからもディスパッチされていません。支払いイベントは、このクラスが実際に発火するようになった日に追加されます。それより前には追加しません。イベントを早まって告知することは、まったく追加しないことよりも悪いのです。

• load.created — A load became visible to your company (created by you or shared with you). (load)
• load.status_changed — A load moved to a new status (pending, in_transport, transit, done). (load)
• load.driver_assigned — A driver was assigned to a load. (load)
• demand.created — A freight demand was created by your company. (demand)
• demand.status_changed — A freight demand changed status. (demand)
• demand_bid.created — A bid was placed on a demand you are party to. (demand_bid)
• demand_bid.revised — A bid was revised (a new revision replaced the previous one). (demand_bid)
• demand_bid.accepted — A bid was accepted. (demand_bid)
• invoice.created — An invoice draft was created. (invoice)
• invoice.issued — An invoice was issued (it now carries an invoice number). (invoice)
• invoice.cancelled — An invoice was cancelled. (invoice)
• warehouse_reservation.created — A warehouse dock/area reservation was created. (warehouse)
• warehouse_reservation.status_changed — A warehouse reservation was approved, rejected or otherwise moved. (warehouse)

署名の検証

すべてのリクエストに X-Logistivo-Signature ヘッダーが付きます：t=,v1=。署名対象の文字列は "." で、アルゴリズムは HMAC-SHA256 です。v1 プレフィックスによって方式をバージョン管理できます。将来 2 つ目の方式が加わった場合、ヘッダーは t=…,v1=…,v2=… となり、知っている方式を選べばよいのです。

依存関係のないリファレンス受信側を 2 つ公開しています。1 つは Node 用、もう 1 つは素の PHP 用です。どちらも上記の 4 つのルールを適用し、--selftest で自己テストします：有効な署名、改ざんされたボディ、誤ったシークレット、許容幅外のタイムスタンプ、不正な形式のヘッダー、再シリアライズの落とし穴、そして 2 種類の繰り返し（同じ配信／同じ事実）です。検証ロジックは、私たち自身が使っているコードとまったく同じものです。私たちは自ら公開するコントラクトを自分でも使っています。

• 「生の」ボディを検証する — 署名はバイト列に対して計算されます。ボディをデコードして再シリアライズすると（JSON.stringify(req.body)、json_encode($request->all())）、同じ「データ」が異なる「バイト列」になり、署名が一致しなくなります。Node での落とし穴は数値の書式（通信上の 1.50 が 1.5 になる、大きな整数の精度が失われる）、PHP では文字のエスケープ（/ が \/ に、İ が \u0130 になる）です。Express では express.raw を、Laravel では $request->getContent() を使ってください。これは受信側を書くときに最もよくある間違いです。
• タイムスタンプを確認する — t は署名の「中に」含まれています。署名だけを検証すると、有効なリクエストを傍受した誰もが数時間後にそれをリプレイでき、受信側はそれを検証済みのイベントとして扱ってしまいます。署名が正しくても、|now − t| > tolerance となるリクエストは破棄してください。推奨される許容幅は 300 秒です。
• 定数時間で比較する — hash_equals / timingSafeEqual を使います。== で比較すると、攻撃者が署名を 1 バイトずつ推測できてしまいます。
• 重複排除は id ではなく event_id で行う — event_id は「事実」を識別します。同じイベントを受け取る 2 つの購読者で同じ値になり、リプレイ時にも「保持」されます。id（= X-Logistivo-Delivery）は「配信」を識別し、リプレイ時に変わります。「これはもう処理したか」の判断には event_id を使ってください。id で判断すると、リプレイで同じ処理が 2 回実行されてしまいます。

配信、再試行、ミュート

受信側が常に稼働しているとは限りません。この仕組みはそれを前提としています。一時的な失敗は再試行スケジュールに入り、恒久的な失敗は購読をミュートします。そしてミュートの「理由」は必ず記録されます。

ミュートの理由は機械可読で安定しており（delivery_failures、endpoint_gone、unsafe_target、key_revoked、by_user）、パネルと `lg webhooks list` の両方に表示されます。理由のないミュートでは、「なぜ何も届かないのか」に答えられなくなります。再有効化するとカウンターと記録時刻がリセットされます。

アドレスを書くのはあなたですが、リクエストを送るのは「こちらの」サーバーです。ゲートがなければ、クラウドのメタデータアドレスを入力したテナントが、こちらのネットワーク内部からリクエストを発行させることができてしまいます。そのため、アドレスは登録時と「毎回の」配信時の両方でチェックされます：

• タイムアウト — 合計 8 秒、接続 4 秒。遅い受信側がワーカーを占有してはなりません。処理はキューに入れ、すぐに 2xx を返してください。
• 再試行スケジュール — 60 · 300 · 1800 · 7200 · 21600 秒 → 計 6 回の試行、期間はおよそ 8.6 時間です。
• 唯一の恒久的な失敗：410 Gone — 「削除してほしい」という意味です。再試行はせず、購読は即座にミュートされます。署名の検証失敗に対して 410 を返しては「いけません」。
• その他すべての失敗 — 4xx も含め、「すべて」再試行されます。業務イベントを失う損失は、数回の余分なリクエストよりも大きいのです。4xx を恒久的な失敗として扱う仕組みでは、WAF ルールの更新中に 403 を返した受信側は「請求書発行」イベントを黙って失ってしまいます。
• Retry-After — 429 と 503 で尊重されます（上限 6 時間）。
• リダイレクト — 追従「しません」。302 で内部アドレスに飛ばされると、別の経路からアドレスゲートを破られてしまうからです。
• 自動ミュート — 再試行を使い切った配信が 10 回連続した後にミュートされます。410、安全でない宛先、紐づいた連携キーの失効の場合は「即座に」ミュートされます。
• https のみ、ポートは 443/8443 のみ、埋め込まれた認証情報 (https://user:pass@…) は拒否。
• localhost、単一ラベルの名前、.internal / .local / .svc などの内部向けサフィックスは拒否。名前解決の結果を見る前に意図そのものを拒否するため、スプリットホライズン DNS でゲートを破ることはできません。
• IP リテラルと DNS 解決の「すべての」レコードがパブリックでなければなりません。ある名前がパブリックとプライベートの両方のアドレスに解決される場合、どちらを選ぶかを誰かがこちらに尋ねてくれるわけではありません → その名前はそのまま拒否されます。
• 配信時にはアドレスを 1 回だけ解決し、接続を検証済みのアドレスに固定します。これにより DNS リバインディングの隙は閉じられています。
• 受信側のレスポンスの「ボディ」はどこにも保存されません（保存するのはステータスコード、所要時間、短いエラータグのみ）。そのため、アドレスゲートの穴が実際に持つ価値である「読み取り」経路は閉じたままです。
• 「プライベートアドレスを許可する」設定スイッチは意図的に「ありません」。そのようなスイッチは、いつか誤ってオンのまま放置されるものだからです。
• 購読の作成時と rotate-secret の実行時にだけ、「一度だけ」返されます。サーバー上では暗号化して保存され、読み戻すことはできません。「もう一度表示」はありません。
• lg はそれを画面に表示するだけで、設定ファイルにもキャッシュファイルにも書き込みません。
• 紛失した場合はローテーションします。古い値は「その時点で」使えなくなります。途切れなく切り替えるには、移行期間中は受信側で両方のシークレットを試すようにしてください。
• アドレスを変更してもシークレットには影響「しません」。「URL が移った」といった日常的なメンテナンスで、受信側の検証が壊れてはならないからです。

ヘルスとステータス：沈黙したブリッジに、あなたより先に誰かが気づくことがないように

連携ブリッジが派手に停止することはめったにありません。たいていは深夜に静かに止まります。トークンの期限が切れる、キーの代理対象の人がチームを離れる、スコープが狭められる、受信側のエンドポイントが 403 を返し始める。最初に気づくのは、ほとんどの場合顧客です。lg status はその順序を逆転させるためにあります。

1 つのコマンドが 2 つの問いに同時に答えます。障害時にはどちらも同じ瞬間に問われるからです。プラットフォームは稼働しているか、そして自分のブリッジは健全か。プラットフォームの行はトークンなしで動作します。障害時にはトークンそのものが最初の容疑者であり、ステータスの問いをトークンに結びつけてしまうと、答えが最も必要なときに答えが得られなくなるからです。

ヘルスサマリーは新しい台帳を持たず、既存の 3 つの情報源を 1 つの文にまとめます：日次の利用カウンター（どれだけ呼び出し、どれだけ失敗したか）、リクエスト台帳（どのリクエストが、いつ、なぜ拒否されたか）、送信 Webhook の配信台帳（イベントが受信側に届いたか）。エラー率は常に日次カウンターから読み取ります。詳細台帳には上限があり、上限に達した場合はその旨をはっきりと示します。

同じサマリーはパネルにも表示されます。Settings › Integration › Keys の下で、各行にバッジが付き、その下に理由が表示されます。しきい値はクライアント側では計算しません。サーバーが割り当てたレベルを、パネルと lg status の両方がそのまま表示するため、2 つの画面が同じキーについて異なることを言うことはありません。

監視ツールにトークンは不要です。このエンドポイントが返すのはステータスを表す単語だけで、バージョン、ホスト名、キュー名、ジョブ数、エラーテキスト、顧客データは含まれません。含めることもできません。

ヘルスサマリーは、リクエストごとに一定数のクエリで生成されます。クエリ数はキーの数に応じて増えません。詳細は、そのキーの最近のリクエストを lg logs で、送信側のブリッジを lg webhooks list で確認してください。

• 正常 — 測定された障害がなく、成功の証拠があります。台帳に成功した呼び出しがある、またはカウンター上でエラーのないトラフィックが続いている状態です。
• 要注意 — 何かが壊れ始めています。エラー率または連続失敗回数がしきい値を超えた、リクエストがゲートで拒否されている、キーの有効期限が近い、または定期的に通信していたブリッジが沈黙した、のいずれかです。
• 障害中 — ブリッジは現在動作していません。トークンが意図せず失効した、クローズ済みのキーがまだ呼び出されている、5 回連続で失敗している、エラー率が 50% を超えている、または Webhook の購読がミュートされた、のいずれかです。
• クローズ済み — キーが意図的にクローズされ、誰も呼び出していません。これは障害ではなく判断であり、赤では表示されません。
• データなし — 測定値がありません。キーが一度も呼び出されていないか、測定そのものに失敗しています。どちらも緑ではありません。
• 偽の緑はありません。正常バッジには、測定された成功の証拠が必要です。一度も呼び出されていないキーが緑になることはありません。動作することを示す測定値が 1 つもないからです。
• 偽の赤もありません。意図的にクローズしたキーは「クローズ済み」と表示されます。何でも赤にすると赤の意味がなくなります。クローズ済みのキーが赤になるのは、クローズ後もまだ呼び出されている場合だけです。そのときは本当にブリッジが壊れています。
• 「測定できなかった」は「データなし」と同じではありません。サーバー側でクエリが失敗した場合、その行は黙ってゼロを表示するのではなく、測定できなかったことを示します。
• 沈黙は常に報告されますが、機械的に警告に変えられることはありません。月末にだけ動くブリッジが 30 時間沈黙するのは正常です。直近 7 日のうち少なくとも 5 日通信していたブリッジが沈黙するのは障害です。リズムは推測ではなく測定されます。
• ステータスの照会そのものがヘルスの数値を汚すことはありません。lg status による呼び出しはリクエスト台帳には記録されますが、ヘルスの計算からは除外されます。そうしなければ、自分自身のステータス照会の成功が連続失敗回数をリセットし、この画面が示すために存在する障害そのものを隠してしまいます。
• すべての行が測定に基づきます。データベースに対して実際にクエリを実行し、コマンドカタログを実際に構築し、キューワーカーのライブ記録を実際に読み取ります。推測は一切ありません。
• レスポンスそのものも測定です。ボディを読めるなら、Web 層は稼働しています。
• トップレベルの値は必須コンポーネントだけから導出されます。キューが止まった場合の答えは down ではなく degraded です。同期的な API 呼び出しにキューは不要であり、プラットフォームを down と宣言すれば誤報になるからです。
• キューの状態を測定できない場合、トップレベルの値はそのままにします。「わからない」ことは「壊れていると測定した」ことと同じではありません。
• プラットフォームが停止している場合、エンドポイントは HTTP 503 を返します。ボディはエンベロープを持たないため、監視ツールはパースせずにアラートを出せます。また、レスポンスがキャッシュに保存されることはありません。

エラーと終了コード

機械が分岐に使うのは安定した文字列です。error フィールドのテキストは人間向けで、ローカライズされ、予告なく変わります。メッセージのテキストで分岐する連携はサポート対象外であり、それが壊れてもバグではありません。

2 つの分類、2 つのフィールドがあります。error_code はトランスポート層（上の表）で、最初に分岐に使うものです。error_key は failed の中に入る安定した業務ルールのキー（INSUFFICIENT_CREDITS、NOT_FOUND、DUPLICATE_CONTACT、INSUFFICIENT_STOCK）で、カタログ内の辞書（error_keys）と以下で公開されています。まだキーを出力しないコマンドは error_key: null を返します。辞書にないキーは一般的な失敗として扱ってください。

• ok — HTTP 200 · error_code — · CLI 0 · —
• replayed — HTTP 200 · error_code — · CLI 0 · 冪等なリプレイ。処理は再実行されて「いません」。
• failed — HTTP 422 · error_code failed · CLI 1 · いいえ。業務ルールによって拒否されました（error_key を参照）。引数を変えない限り無意味です。
• needs_confirmation — HTTP 409 · error_code needs_confirmation · CLI 4 · はい。confirm: true を付けて再試行します。
• idempotency_conflict — HTTP 409 · error_code idempotency_conflict · CLI 2 · いいえ。そのキーは最初に別のコマンドで使われています（conflicting_command）。新しいキーを発行してください。
• forbidden — HTTP 403 · error_code forbidden · CLI 3 · いいえ。ロールゲートによる拒否、または read スコープのキーで書き込みコマンドを呼び出しています。
• not_found — HTTP 404 · error_code not_found · CLI 2 · いいえ。コマンド名が誤っているか、削除されています。
• （スキーマ） — HTTP 422 · error_code invalid_request · CLI 2 · いいえ。リクエストボディまたは引数がスキーマバリデーションに失敗しました（errors{}）。業務ルールによるものではありません。
• server_error — HTTP 500 · error_code server_error · CLI 6 · はい。「同じ」冪等キーで、指数バックオフしながら再試行します。キーはロックされていません。
• 401 unauthenticated — トークンの期限が切れたか、失効しています。再試行しても解決しないため、トークンを差し替える必要があります。
• 429 rate_limited — このトークンがレート制限を受けています。レスポンスには常に Retry-After と、retry_after、limit、bucket を含むボディが付きます。固定の待ち時間を自分で決めるのではなく、これに従ってください。lg は待機して最大 3 回再試行し、その後終了コード 5 で終了します。
• 5xx server_error / ネットワークエラー — 指数バックオフで、「同じ」冪等キーを使って再試行します。キーを変えると、サーバーがすでに完了しているかもしれない処理が再実行されます。lg は 3 回（1 秒、2 秒、4 秒）再試行し、その後 error_code network_error または server_error とともに終了コード 6 で終了します。

安定性の約束

連携コントラクトで最も重い問いは「今日書いたコードは明日も動くか」です。それに答えるのが 1 つの数値、つまりカタログ内の contract_version と、すべてのレスポンスに付く X-Contract-Version ヘッダーです。この数値が答えるのはただ 1 つの問い、「以前に書いたコードが変更なしで今も動くか」です。数値が増えていなければ、動きます。増えていれば、動きません。あなたが依存していた何かが削除されたか、狭められたのです。

告知は何も削除しないからです。告知の翌日も、既存のコードはまったく以前どおりに動きます。告知でバージョンを上げると、1 つの変更に対して 2 つのシグナルを出すことになり、最初のシグナルを無視する癖をつけさせてしまいます。それは本当に重要なシグナルを弱めます。告知は、あなたが行っている呼び出しにすでに乗っています。カタログの行の deprecated_at と replaced_by、そのコマンドのレスポンスに付く X-Deprecated ヘッダーと deprecated ブロック、そして lg を使っていれば stderr への 1 行の警告です。何かが廃止予定であることを知るために、何かをする必要はありません。それはすでにあなたのログにあります。

告知から削除までには、少なくとも暦の上で 2 四半期が経過します。猶予期間中、古いコマンドは引き続き応答し、呼び出しのたびに警告します。CLI 名が廃止される場合は、後継のコマンドがその名前をエイリアスとして引き継ぎます。猶予期間中は古い名前で古いコマンドに届き、削除された日からは同じ呼び出しが新しいコマンドに届きます。クライアントの新しいリリースを出す必要はありません。

preview_invoice → get_invoice（2026 年 9 月 3 日に告知）。get_invoice は同じ preview ブロックを返し、さらに明細行、税の内訳、記録済みの入金、残高、自社 ERP キー（external_ref）による指定を追加します。preview_invoice は引き続き動作し、lg invoices preview も同様です。どちらも警告を出します。

• 変更なし — 新しいコマンド · 新しい「任意」パラメータ · 新しいレスポンスフィールド · 新しいエラーキー · 新しいエンドポイント — 何もする必要はありません。知らないフィールドは無視しなければなりません。未知のフィールドで失敗するパーサーは仕様に準拠していません。
• 変更なし — 非推奨の「告知」：コマンドが廃止予定であるという通知 — コードは動き続けます。カレンダーにタスクを入れておいてください。猶予期間は最低 6 か月です。
• 上がる — コマンドの削除 · 古い CLI 名の廃止 · レスポンスフィールドの削除 · 任意パラメータの必須化 · enum の縮小 — 猶予期間を逃したということです。通知は 3 つの別々の場所であなたに届いていました。
• コマンドの API 名（list_loads など）は永久に凍結されています。HTTP 呼び出しで使うのはこの名前です。
• error_code（トランスポート）と error_key（業務ルール）は安定した文字列です。新しいものが現れることはあります。辞書に見つからないキーは、互換性の破壊ではなく一般的な失敗として扱ってください。
• HTTP ステータスとボディ内の status フィールドの対応は固定されています。
• バージョン番号が下がることはなく、ボディのない 304 や 429 も含め、すべてのレスポンスで読み取れます。
• エラーや説明の「テキスト」。ローカライズされ、予告なく変わります。メッセージのテキストによる分岐はサポートされていません。
• 知らないフィールドが存在しないこと。フィールドの追加ではバージョンは上がりません。
• 業務キーとしての自動採番 id。自社のキーは external_ref で持たせてください。
• クラス名から派生した動的なエラーキー。これらはコントラクトの一部ではありません。

コマンド識別テーブル

下の表は手書きではありません。このページが配信されるたびに、ライブのコマンドレジストリから生成されます。サーバーで追加されたコマンドは自動的にここに現れます。「ゲート」列は、コマンドが確認を求めるか、その効果を元に戻せるかを示し、「ロール」列は、どのアカウント種別のカタログにそのコマンドが含まれるかを示します。バッジは、manager レベルのキーが必要なコマンド、ファイルを受け取るコマンド、lg からしか実行できないコマンドを示します。

API 名（list_loads）は凍結されており、変わることはありません。HTTP 呼び出しで使うのはこの名前です。CLI 識別子（loads list）はバージョニングポリシーに従います。一度告知されると、バージョンの引き上げと移行期間を伴う場合にのみ変更され、その期間中、カタログは古い組をエイリアスとして提供します。ここにある説明は各コマンド自身のレコードから取られており、短縮されています。全文、パラメータの型、enum 値については、カタログエンドポイントを読むか lg help を実行してください。アフィリエイト専用のコマンドはここには掲載していません。アフィリエイトアカウントでは自分のカタログで確認できます。

• lg account-settings get — Read the account settings (Settings → Account): the company display name (and legal name, read-only), the signed-in user's own name and e-mail (e-mail is read-only here), the saved load code prefix and how the company… (読み取り · — · 荷主 · API: get_account_settings) [manager キー]
• lg account-settings update — Change account settings (Settings → Account): company_name (the company's display name, company-wide), first_name / last_name (the signed-in user's own name — when only one is given the other part is kept),… (書き込み · 確認 · 荷主 · API: update_account_settings) [manager キー]
• lg accounting-settings get — Read the company's accounting and invoicing settings and say whether they are set up (muhasebe ayarları, fatura ayarları, e-fatura / e-invoice profile, KDV / VAT tax regime, fatura numaralandırma serisi / invoice… (読み取り · — · 全ロール · API: get_accounting_settings)
• lg accounting-settings set-status — Turn the company's accounting module on or off (muhasebe modülünü aç/kapa). (書き込み · 確認 · 全ロール · API: set_accounting_module)
• lg accounting-settings update — Update the company's accounting/invoicing settings (muhasebe ve fatura ayarlarını değiştir): legal name, default currency, provider (local/parasut), country, tax regime (KDV/VAT/GST/none), default invoice line… (書き込み · 確認 · 全ロール · API: update_accounting_settings)
• lg addresses list — Loading and delivery addresses already used on this company's previous loads (newest first): address_id, name, street, city and country. query filters by name, street or city. limit 1-50 (default 20). (読み取り · — · 全ロール · API: list_worked_addresses)
• lg addresses search — Find a place for a route plan stop: the company's own address book first, then a geocoder (counted against the daily routing allowance) when the book has fewer than 3 hits. (読み取り · — · 運送会社 · API: lookup_address)
• lg ai-settings get — Read our company's AI switches (Settings → AI), e.g. ai_file_classify ("AI document analysis"): whether files posted into our load chats are read by AI, sorted into document types and split into company documents, or… (読み取り · — · 荷主 · API: get_ai_settings) [manager キー]
• lg ai-settings update — Turn our company's AI switches on or off (Settings → AI) — e.g. "stop AI from analysing the files in our load chats" → settings=[{"slug":"ai_file_classify","enabled":false}]. settings is a list of {slug, enabled}; slugs… (書き込み · 確認 · 荷主 · API: update_ai_settings) [manager キー]
• lg announcements list — Show the system announcements Logistivo sent to this user (new features, maintenance, policy changes) — newest first. (読み取り · — · 全ロール · API: list_announcements)
• lg announcements mark-read — Mark system announcements as read for this user. (書き込み · — · 全ロール · API: mark_announcements_read)
• lg attachments get — Read a file the user attached to THIS conversation (listed in the user message as [Attachments] with their attachment_uuid). (読み取り · — · 全ロール · API: read_attachment) [ファイルを受け取る: attachment_uuid]
• lg background-jobs get — Check a background job that another command queued and returned a job_id for (document consistency re-analysis, file classification, tariff inquiry, tariff invoice reading, receipt pack…): status pending / running /… (読み取り · — · 全ロール · API: get_background_job)
• lg bank-accounts create — Add one of YOUR OWN company bank accounts to the account book (the accounts you get paid into). (書き込み · 確認 + 取り消し不可 · 全ロール · API: create_company_bank_account) [manager キー]
• lg bank-accounts delete — Delete one of OUR OWN company bank accounts (for example a closed account). (書き込み · 確認 + 取り消し不可 · 全ロール · API: delete_company_bank_account) [manager キー]
• lg bank-accounts extract — Read a supplier's bank accounts (IBAN, bank, holder, currency) from one of ITS invoices and save them on that business contact. (書き込み · 確認 + 取り消し不可 · 全ロール · API: extract_supplier_bank_accounts) [ファイルを受け取る: attachment_uuid]
• lg bank-accounts list — List bank accounts. (読み取り · — · 全ロール · API: list_bank_accounts)
• lg bank-accounts preview — Check an IBAN without saving anything: is it valid (country, length, checksum) and which bank it belongs to (detected offline from the bank code where known). (読み取り · — · 全ロール · API: preview_bank_account_iban)
• lg bank-accounts set-default — Make one of OUR OWN bank accounts the default — the IBAN printed on our invoices and e-invoices. (書き込み · 確認 + 取り消し不可 · 全ロール · API: set_default_company_bank_account) [manager キー]
• lg bank-accounts set-status — Confirm or reject a bank account that was read from a document by AI or written by an integration — your own account or a business contact's account (find the ones waiting with list_bank_accounts… (書き込み · 確認 + 取り消し不可 · 全ロール · API: decide_bank_account_verification) [manager キー]
• lg bank-accounts update — Update one of OUR OWN company bank accounts (the accounts customers pay us into): IBAN, bank, account holder, branch code, account number or currency. (書き込み · 確認 + 取り消し不可 · 全ロール · API: update_company_bank_account) [manager キー]
• lg banks list — List the banks of Turkey with their bank_id and SWIFT/BIC code — the bank_id that create_company_bank_account and update_company_bank_account need. (読み取り · — · 全ロール · API: list_banks)
• lg bids accept — Accept a carrier's bid on one of this company's demands. (書き込み · 確認 + 取り消し不可 · 荷主 · API: accept_demand_bid)
• lg bids calculate — Before bidding: what this carrier would earn and how many credits a bid would cost if the customer accepts it. (読み取り · — · 運送会社 · API: calculate_bid_earnings)
• lg bids cancel — Withdraw (geri çek) one of THIS carrier company's PENDING bids. (書き込み · 確認 + 取り消し不可 · 運送会社 · API: cancel_demand_bid)
• lg bids create — Submit a bid (teklif ver) on an open demand. amount_per_vehicle is the freight PER VEHICLE, not the total. (書き込み · 確認 + 取り消し不可 · 運送会社 · API: create_demand_bid)
• lg bids get — Detail of ONE bid this carrier company submitted: demand, status (pending / accepted / revised / cancelled / price_too_high), price per vehicle and total, currency, vehicle count, customs included or customs price,… (読み取り · — · 運送会社 · API: get_my_demand_bid)
• lg bids list — List the bids (teklif) THIS carrier company has submitted, newest first, with their outcome. (読み取り · — · 運送会社 · API: list_my_bids)
• lg bids revise — Revise this carrier's own PENDING bid on a demand: the old bid is marked revised and a NEW bid replaces it (it gets a new bid code). (書き込み · 確認 + 取り消し不可 · 運送会社 · API: revise_demand_bid)
• lg carbon-reports calculate — Calculate the CO2 emission of an EXISTING load (load_code: weight and route from the load, including its Ro-Ro leg) OR of a route you describe (transport_mode road|roro + weight_kg + departure_address + arrival_address,… (読み取り · — · 全ロール · API: calculate_load_carbon_emission)
• lg carbon-reports download — Export ALL of the company's saved CO2 emission reports to one Excel file (one row per report: date, route, mode, weight, distance, emission, factor, method) and return a short-lived download link. (読み取り · — · 全ロール · API: export_carbon_emission_reports)
• lg carbon-reports generate — Produce the signed CO2 emission report (PDF, with QR code) for a load OR for a route, save it to the company's report list and return a download link. (書き込み · 確認 + 取り消し不可 · 全ロール · API: generate_carbon_emission_report)
• lg carbon-reports get — Read one CO2 emission report in full: total emission in kg, transport mode, weight, distance, emission factor, calculation method and source, the departure/arrival addresses, the leg breakdown for multi-modal routes… (読み取り · — · 全ロール · API: get_carbon_emission_report)
• lg carbon-reports list — List the CO2 emission reports this company has generated (newest first): report number, file name, who created it and when. (読み取り · — · 全ロール · API: list_carbon_emission_reports)
• lg carrier-routes get — This carrier's route definitions (Rota Yönetimi): the countries served — always ↔ Türkiye in both directions — and the vehicle types and load types operated, with ids and names. (読み取り · — · 運送会社 · API: get_carrier_routes)
• lg carrier-routes set — REPLACE this carrier's route definitions (Rota Yönetimi) with the given FULL sets: countries served (each to/from Türkiye, both directions), vehicle types and load types. (書き込み · 確認 · 運送会社 · API: set_carrier_routes) [manager キー]
• lg chart-of-accounts list — List the chart of accounts available to this company (Turkish uniform chart: 100 Kasa, 102 Bankalar, 120 Alıcılar, 320 Satıcılar, 391 Hesaplanan KDV, 600/601 Satışlar…), optionally filtered by code/name text or type. (読み取り · — · 全ロール · API: list_chart_of_accounts)
• lg checks assign-invoices — Allocate a pending, field-confirmed cheque to one or more open LOCAL invoices of the same contact and currency: in = sales invoices (collection), out = purchase invoices (payment). (書き込み · 確認 + 取り消し不可 · 全ロール · API: attach_check_to_invoices) [manager キー]
• lg checks bounce — Record that a cheque BOUNCED (came back unpaid). (書き込み · 確認 + 取り消し不可 · 全ロール · API: mark_check_bounced)
• lg checks cancel — CANCEL a pending cheque (e.g. registered by mistake, returned before use): no journal entry is written and any invoice reservation is released. (書き込み · 確認 + 取り消し不可 · 全ロール · API: cancel_settlement_check) [manager キー]
• lg checks collect — Record that a cheque was COLLECTED (money reached the bank for an incoming cheque, or left the bank for an outgoing one) on its due date. (書き込み · 確認 + 取り消し不可 · 全ロール · API: mark_check_collected)
• lg checks create — Register a cheque in the cheque portfolio. (書き込み · 確認 · 全ロール · API: create_settlement_check) [manager キー] [ファイルを受け取る: front_attachment_uuid, back_attachment_uuid]
• lg checks get — Read one cheque in full: its identity (number, serial, bank and branch, drawer with tax number, IBAN), the face amount and currency, issue and due dates, the counterparty, the status with every timestamp (executed,… (読み取り · — · 全ロール · API: get_settlement_check)
• lg checks list — List the cheque portfolio of this company: cheque number, direction (in = received from a customer, out = given to a supplier), drawer and bank, face amount with its currency, issue and DUE date, the counterparty… (読み取り · — · 全ロール · API: list_settlement_checks)
• lg checks remove-invoices — Release a pending cheque's invoice allocation: the reservations are removed (invoices become payable again) and the cheque goes back to the unallocated pending cheques. (書き込み · 確認 · 全ロール · API: detach_check_from_invoices) [manager キー]
• lg checks run — EXECUTE a pending, allocated cheque against its invoices: the reservations become payments (the invoice balances close), and the notes receivable (121, received cheque) or notes payable (321, given cheque) journal… (書き込み · 確認 + 取り消し不可 · 全ロール · API: execute_settlement_check) [manager キー]
• lg checks update — Correct a pending cheque's fields and CONFIRM them — the human sign-off on what AI read from the photo (or on a manual entry). (書き込み · 確認 · 全ロール · API: update_settlement_check) [manager キー]
• lg companies add-role — Add a role to this company (firmaya rol ekle): customer (shipper), carrier, customs (customs broker) or affiliate. (書き込み · 確認 + 取り消し不可 · 全ロール · API: add_company_role) [manager キー]
• lg companies delete-logo — Remove this company's logo (firma logosu) from the branded login portal, documents and the panel. (書き込み · 確認 + 取り消し不可 · 全ロール · API: delete_company_logo) [manager キー]
• lg companies get — This company's own profile (firma profili): legal name, tax number and tax office, address and postal code, city/country, payment term (vade), the company roles it has (customer/carrier/customs/affiliate) and the roles… (読み取り · — · 全ロール · API: get_company_profile)
• lg companies invite — Invite a company that is NOT on Logistivo yet by e-mail (e.g. a carrier we want to give a load to). (書き込み · 確認 + 取り消し不可 · 全ロール · API: invite_company_to_platform)
• lg companies list — Logistivo platform companies this company has already worked with on loads (shared load chats), by company_type: customer (shippers), carrier or customs (customs brokers). (読み取り · — · 全ロール · API: list_platform_companies)
• lg companies search — Check whether a company is on Logistivo — by EXACTLY ONE of: tax_number (exact VKN / tax id), vat_number (exact EU/UK VAT number) or email (any e-mail of that company, matched by its domain; then company_type is… (読み取り · — · 全ロール · API: search_platform_companies)
• lg companies set-brand-colors — Set the two colours of this company's branded login portal (markalı giriş portalı, /p//login) — primary_color and secondary_color as #RRGGBB hex. (書き込み · 確認 · 運送会社, 通関業者 · API: set_company_brand_colors) [manager キー]
• lg companies set-logo — Make an uploaded image this company's logo (firma logosu) — shown on the branded login portal, documents and the panel. attachment_uuid is a JPEG or PNG image (max 8 MB) uploaded to this conversation or with `lg upload`. (書き込み · 確認 + 取り消し不可 · 全ロール · API: set_company_logo) [manager キー] [ファイルを受け取る: attachment_uuid]
• lg companies update — Update this company's profile (firma profili) — send ONLY the fields that change: legal_name (ticaret unvanı), tax_number (VKN / VAT id), tax_branch (vergi dairesi), address_street, postal_code, city_id, country_code… (書き込み · 確認 · 全ロール · API: update_company_profile) [manager キー]
• lg company-documents create — File a document the user attached (in this chat, or uploaded to the command surface) as one of the company's own documents (firma evrakı yükle): tax certificate (vergi levhası), signature circulars (imza sirküleri),… (書き込み · 確認 · 全ロール · API: upload_company_document) [ファイルを受け取る: attachment_uuid]
• lg company-documents delete — Remove one of the company's own documents (tax certificate, signature circular, trade registry gazette, permits…) from its document list — e.g. a wrong or outdated upload. document_id is the one shown by… (書き込み · 確認 + 取り消し不可 · 全ロール · API: delete_company_document)
• lg company-documents list — List this company's own filed documents (tax certificate, signature circulars, trade registry gazette, contracts, TIO/L2 permits, files uploaded to chats…) with their type, number, validity date and verification status. (読み取り · — · 全ロール · API: list_company_documents)
• lg company-documents list-missing — Which company documents (tax certificate, signature circulars, trade registry gazette, TIO/L2/C2 permits …) this company is REQUIRED to have for its company type and country, which of them are on file and verified, and… (読み取り · — · 全ロール · API: list_missing_company_documents)
• lg company-domains create — Add an e-mail domain to our company (e.g. firma.com.tr) and e-mail a 6-digit verification code to a mailbox ON that domain. (書き込み · 確認 + 取り消し不可 · 全ロール · API: create_company_domain) [manager キー]
• lg company-domains delete — Remove one of our UNVERIFIED company domains (e.g. added by mistake). (書き込み · 確認 + 取り消し不可 · 全ロール · API: delete_company_domain) [manager キー]
• lg company-domains list — List our company's e-mail domains (Company settings → Domains): each row has company_domain_id, domain, verified (true once the 6-digit code was entered) and, for unverified ones, the mailbox the last code was sent to. (読み取り · — · 全ロール · API: list_company_domains)
• lg company-domains resend — E-mail a NEW 6-digit verification code for one of our unverified company domains (the previous code stops working). (書き込み · 確認 + 取り消し不可 · 全ロール · API: resend_company_domain_code) [manager キー]
• lg company-domains verify — Verify one of our unverified company domains with the 6-digit code that was e-mailed to the mailbox on that domain. (書き込み · 確認 + 取り消し不可 · 全ロール · API: verify_company_domain) [manager キー]
• lg company-relationships accept — Accept a connection proposal another company sent us (relationship_id from list_company_relationships direction=incoming). (書き込み · 確認 + 取り消し不可 · 全ロール · API: accept_company_relationship) [manager キー]
• lg company-relationships create — Send a connection proposal to link one of our business contacts with its company on the Logistivo platform (company_id from search_platform_companies). (書き込み · 確認 + 取り消し不可 · 全ロール · API: create_company_relationship) [manager キー]
• lg company-relationships list — List our company connections on the platform (direction=outgoing, default: the connections in our directory, with status and roles such as carrier/customs_broker/supplier) or the connection proposals other companies… (読み取り · — · 全ロール · API: list_company_relationships)
• lg company-relationships reject — Reject a connection proposal another company sent us (relationship_id from list_company_relationships direction=incoming). (書き込み · 確認 + 取り消し不可 · 全ロール · API: reject_company_relationship) [manager キー]
• lg company-relationships revoke — End a company connection we are a party of (either side may end it), or withdraw a pending proposal. (書き込み · 確認 + 取り消し不可 · 全ロール · API: revoke_company_relationship) [manager キー]
• lg contacts add-address — Add an address to a business contact (e.g. a warehouse or branch): a label, the full street address and the country (ISO-2 code); postal code optional. (書き込み · 確認 · 全ロール · API: add_business_contact_address)
• lg contacts add-bank-account — Add a bank account (IBAN) to a business contact so it can be used on payment instructions and invoices. (書き込み · 確認 + 取り消し不可 · 全ロール · API: add_business_contact_bank_account)
• lg contacts add-person — Add a person (yetkili kişi) to a business contact: first name, last name and e-mail are required; phone, phone country code, job title and a note are optional. (書き込み · 確認 · 全ロール · API: add_business_contact_person)
• lg contacts archive — Archive a business contact (cariyi arşivle): it disappears from lists and pickers and becomes read-only, but nothing is deleted — invoices, loads and bank accounts stay linked, and restore_business_contact brings it… (書き込み · 確認 · 全ロール · API: archive_business_contact)
• lg contacts create — Create a new business contact (cari) in the company directory. (書き込み · 確認 · 全ロール · API: create_business_contact)
• lg contacts delete-address — Delete one of a business contact's addresses. (書き込み · 確認 + 取り消し不可 · 全ロール · API: delete_business_contact_address)
• lg contacts delete-bank-account — Delete one of a business contact's bank accounts (for example an old or wrong IBAN). (書き込み · 確認 + 取り消し不可 · 全ロール · API: delete_business_contact_bank_account)
• lg contacts delete-person — Delete a person from a business contact, together with that person's notification preferences. (書き込み · 確認 + 取り消し不可 · 全ロール · API: delete_business_contact_person)
• lg contacts extract — Read a business card, letterhead or invoice header (image or PDF) and return the company details on it — legal name, tax number and office, VAT number, e-mail, phone, IBAN (checksum-checked, bank detected), address,… (読み取り · — · 全ロール · API: extract_business_contact_from_image) [ファイルを受け取る: attachment_uuid]
• lg contacts extract-text — Read pasted text (Excel/CSV rows, e-mail signatures, a typed list) and return up to 100 draft records of ONE kind: companies, persons, addresses or bank_accounts. (読み取り · — · 全ロール · API: extract_business_contacts_from_text)
• lg contacts get — Read one business contact in full (identity, tax data, address, e-mail/phone, bank accounts, platform link) together with its account summary: ledger balance (positive = they owe us), open receivables and open payables. (読み取り · — · 全ロール · API: get_business_contact)
• lg contacts invite — Invite a business contact to join Logistivo by e-mail. (書き込み · 確認 + 取り消し不可 · 全ロール · API: invite_business_contact)
• lg contacts list — List the company's business contacts (customers, carriers, suppliers, consignees) with optional text search over name, legal name and tax number. (読み取り · — · 全ロール · API: list_business_contacts)
• lg contacts list-addresses — List the saved addresses of one business contact (label, street address, postal code, country) with address_id, needed by update/delete. (読み取り · — · 全ロール · API: list_business_contact_addresses)
• lg contacts list-person-notifications — Show which load notifications a contact person receives and on which channel (e-mail, push, SMS), plus the notification types that can be chosen with their allowed channels — use those slugs with… (読み取り · — · 全ロール · API: list_business_contact_person_notifications)
• lg contacts list-persons — List the people (yetkili kişiler) saved on one business contact: name, e-mail, phone, job title, note, and which load notifications each one receives. (読み取り · — · 全ロール · API: list_business_contact_persons)
• lg contacts list-routes — Show which countries a business contact that is linked to a carrier on the platform serves: its declared route pairs (from-country → to-country) and the distinct country list. (読み取り · — · 全ロール · API: list_business_contact_routes)
• lg contacts remove-company-link — Remove the link between a business contact and its company on the Logistivo platform. (書き込み · 確認 + 取り消し不可 · 全ロール · API: unlink_business_contact_company) [manager キー]
• lg contacts restore — Bring an archived business contact back (cariyi arşivden geri al): it returns to lists and pickers and can be edited again. (書き込み · 確認 · 全ロール · API: restore_business_contact)
• lg contacts search — Resolve a business contact (customer/partner/recipient) by name, legal name or tax number to its contact_id. (読み取り · — · 全ロール · API: lookup_business_contact)
• lg contacts set-default-bank-account — Make one of a business contact's bank accounts its DEFAULT account — the one pre-selected when you pay this contact. (書き込み · 確認 + 取り消し不可 · 全ロール · API: set_default_business_contact_bank_account)
• lg contacts set-person-notifications — Turn load notifications on or off for a contact person, per notification type and channel (e-mail, push, SMS). (書き込み · 確認 · 全ロール · API: set_business_contact_person_notifications)
• lg contacts update — Update fields of an existing business contact. (書き込み · 確認 · 全ロール · API: update_business_contact)
• lg contacts update-address — Correct one of a business contact's addresses. (書き込み · 確認 · 全ロール · API: update_business_contact_address)
• lg contacts update-bank-account — Correct one of a business contact's bank accounts: IBAN, account holder, bank name, BIC/SWIFT, currency, label, account type, branch code or account number. (書き込み · 確認 + 取り消し不可 · 全ロール · API: update_business_contact_bank_account)
• lg contacts update-person — Correct a contact person's details. (書き込み · 確認 · 全ロール · API: update_business_contact_person)
• lg containers calculate — Decode and validate a container number (konteyner numarası) per ISO 6346 — owner code, category, serial, check digit (is it correct, and what it should be) and, when known, the operating line with its public tracking… (読み取り · — · 全ロール · API: decode_container_number)
• lg conversations add-file — Post a file into an OFFER (demand-bid) chat as this user — e.g. a price sheet or a vehicle photo for the other company. conversation_code comes from list_conversations (rows whose subject is demand_bid). (書き込み · 確認 + 取り消し不可 · 全ロール · API: send_conversation_file) [ファイルを受け取る: attachment_uuid]
• lg conversations add-invitation — Invite a person from ANOTHER company into a load chat by e-mail (sohbete dışarıdan davet). (書き込み · 確認 + 取り消し不可 · 全ロール · API: invite_to_conversation)
• lg conversations add-message — Post a message into a load/bid conversation AS THIS USER (not as an assistant). (書き込み · 確認 + 取り消し不可 · 全ロール · API: send_conversation_message)
• lg conversations add-participants — Add people to a load/demand conversation (sohbete kişi ekle) — "Ayşe'yi FKZ8515 sohbetine ekle". (書き込み · 確認 · 全ロール · API: add_conversation_participants)
• lg conversations create — Open the freight chat with a carrier that bid on one of OUR demands (navlun sohbetini başlat) — bid_code comes from get_demand / the bids of a demand. (書き込み · 確認 + 取り消し不可 · 荷主 · API: start_bid_conversation)
• lg conversations list — List the chat conversations this user is a member of (load chats, bid chats and private carrier channels), newest activity first. (読み取り · — · 全ロール · API: list_conversations)
• lg conversations list-files — List the files shared in a load/bid chat, newest first: document type, title, file name, who posted it and when. (読み取り · — · 全ロール · API: list_conversation_files)
• lg conversations list-invitations — Show the e-mail invitations to a load chat that have not been accepted yet: who was invited, by whom and when, and what they will be allowed to see. (読み取り · — · 全ロール · API: list_conversation_invitations)
• lg conversations list-messages — Read the most recent messages of one conversation — give it a load code (e.g. (読み取り · — · 全ロール · API: list_conversation_messages)
• lg conversations list-participants — Who is in this conversation — name and company of every participant. (読み取り · — · 全ロール · API: list_conversation_participants)
• lg conversations mark-read — Mark one conversation as read for this user (clears its unread badge), or with all=true every load, bid and direct-message chat at once. (書き込み · — · 全ロール · API: mark_conversation_read)
• lg conversations remove-message — Delete one of THIS user's own messages from a conversation (message_id from list_conversation_messages with `mine` true). (書き込み · 確認 + 取り消し不可 · 全ロール · API: delete_conversation_message)
• lg conversations remove-participant — Remove someone from a load/bid chat, cancel a pending e-mail invitation to it, or leave it yourself (give your own user_id). (書き込み · 確認 + 取り消し不可 · 全ロール · API: remove_conversation_participant)
• lg conversations update-message — Edit one of THIS user's own messages in a conversation (message_id comes from list_conversation_messages, where `mine` is true). (書き込み · 確認 · 全ロール · API: update_conversation_message)
• lg countries search — Resolve a country by name (Turkish, English or the local/native name) or ISO 3166-1 alpha-2 code to its country_id, for the sending/receiving country on a load. (読み取り · — · 全ロール · API: lookup_country)
• lg currencies list — The currencies the platform knows (currency_id, code, name, symbol) with the latest exchange rate against the Turkish lira (buying / selling, rate date). currency_id is what forms such as bank accounts take. (読み取り · — · 全ロール · API: list_currencies)
• lg custom-reports generate — Custom report counted server-side over ALL records of a dataset: filter, group (dates by month etc.), count/sum/avg/min/max (money per currency) or list rows; format=xlsx|pdf|csv gives a file. (読み取り · — · 全ロール · API: build_report)
• lg customs-companies list — Customs broker companies this customer can assign when accepting a bid (accept_demand_bid customs_company_id): the Logistivo customs companies you already work with in your chats. (読み取り · — · 荷主 · API: list_customs_companies)
• lg customs-locations search — Search customs offices / customs locations (gümrük müdürlüğü, gümrük lokasyonu) by name or street — for the exit and destination customs of a load. (読み取り · — · 全ロール · API: lookup_customs_location)
• lg demand-bid-reports get — Bid report across ALL demands at once, counted server-side: for a customer the bids RECEIVED on its demands, for a carrier the bids it PLACED. (読み取り · — · 荷主, 運送会社 · API: get_demand_bid_report)
• lg demand-reports get — Demand report (Talep Raporu) with optional filters: status, demanding company, transport mode, pickup / delivery countries, loading-date window. (読み取り · — · 荷主, 運送会社 · API: get_demand_report)
• lg demand-settings get — This carrier company's demand settings: whether demands opened by forwarder companies reach the company (accept_demands_from_forwarders). (読み取り · — · 運送会社 · API: get_demand_settings) [manager キー]
• lg demand-settings update — Change this carrier company's demand settings. accept_demands_from_forwarders=false stops demands opened by forwarder companies from reaching the company (only shippers' demands remain); true lets them in again. (書き込み · 確認 · 運送会社 · API: update_demand_settings) [manager キー]
• lg demand-targets search — Resolve a pickup/delivery location for a demand to a target token ("5-" = district/postal area, "10-" = seaport address). (読み取り · — · 荷主 · API: lookup_demand_target)
• lg demands create — Open a freight demand (talep) so carriers can bid. (書き込み · 確認 + 取り消し不可 · 荷主 · API: create_demand) [ファイルを受け取る: attachment_uuids]
• lg demands download — File for ONE demand owned by this company. export_type=details_pdf: the demand's detail sheet (route, dates, cargo, pallets) as PDF. export_type=sales_xlsx: the sales report workbook — demand information, every bid… (読み取り · — · 荷主 · API: download_demand_export)
• lg demands extract — Read a freight request text (an e-mail body, a note, a voice transcript) and return the demand fields it contains in the demand wizard's shape: transport mode, countries, ports, locations, dates, load type, vehicle… (読み取り · — · 荷主 · API: extract_demand_from_text)
• lg demands get — Detail of ONE freight demand. (読み取り · — · 荷主, 運送会社 · API: get_demand)
• lg demands list — List freight demands (talep) this carrier is allowed to bid on, newest first. (読み取り · — · 運送会社 · API: list_open_demands)
• lg demands list-own — List the freight demands (talep) OWNED by this customer company, newest first, with route, dates, vehicles, status and bid count. (読み取り · — · 荷主 · API: list_demands)
• lg demands options — Reference lists needed to build a freight demand (talep) with create_demand: vehicle types (id, name, transport mode), payment maturity options (id + days; company_default_maturity_option_id is what the company normally… (読み取り · — · 荷主 · API: get_demand_form_options)
• lg demands set-status — Close (make passive) one of this company's ACTIVE demands so carriers stop bidding. (書き込み · 確認 + 取り消し不可 · 荷主 · API: close_demand)
• lg demands update — Edit one of this company's ACTIVE demands that has NO bids yet (a demand with bids or a closed one cannot be edited). (書き込み · 確認 · 荷主 · API: update_demand) [ファイルを受け取る: attachment_uuids]
• lg direct-conversations add-message — Send a direct message AS THIS USER (never as an assistant) — either into an existing chat (conversation_code from list_direct_conversations) or to one person (to_user_id from list_direct_message_contacts; their private… (書き込み · 確認 + 取り消し不可 · 全ロール · API: send_direct_message)
• lg direct-conversations create — Start a direct chat. (書き込み · 確認 + 取り消し不可 · 全ロール · API: create_direct_conversation)
• lg direct-conversations download — Produce the whole direct-message or group chat as a PDF (the same file as the panel's export button: participants and every message with date and time) and return a short-lived download link. (読み取り · — · 全ロール · API: export_direct_conversation_pdf)
• lg direct-conversations list — List this user's direct-message (DM) chats and group chats — person-to-person messaging, separate from load/bid chats (those are list_conversations). (読み取り · — · 全ロール · API: list_direct_conversations)
• lg direct-conversations list-contacts — List the people this user can direct-message: their own teammates plus people they share a load/bid chat with. (読み取り · — · 全ロール · API: list_direct_message_contacts)
• lg direct-conversations list-messages — Read the latest messages of one direct-message or group chat (conversation_code from list_direct_conversations), oldest→newest, with who wrote them. `mine: true` marks this user's own messages; only those, and only… (読み取り · — · 全ロール · API: list_direct_conversation_messages)
• lg direct-conversations mark-read — Mark one direct-message or group chat as read for this user (clears its unread badge). (書き込み · — · 全ロール · API: mark_direct_conversation_read)
• lg direct-conversations remove-message — Delete one of THIS user's own direct messages (message_id from list_direct_conversation_messages, mine and editable true), only within 5 minutes of sending. (書き込み · 確認 + 取り消し不可 · 全ロール · API: delete_direct_message)
• lg direct-conversations update — Rename a GROUP direct chat (private one-to-one chats have no title). (書き込み · 確認 · 全ロール · API: rename_direct_conversation)
• lg direct-conversations update-message — Edit one of THIS user's own direct messages (message_id from list_direct_conversation_messages, where mine and editable are true). (書き込み · 確認 · 全ロール · API: update_direct_message)
• lg document-checks run — Cross-check documents the user attached to THIS conversation against each other and report the discrepancies: mismatched party names, quantities, weights, amounts, dates, container or reference numbers between an… (書き込み · — · 全ロール · API: check_document_compliance) [ファイルを受け取る: attachment_uuids]
• lg document-types list — List the platform's document types (slug and name) — the values document_type_slug accepts in upload_company_document, add_driver_document and the vehicle document commands. (読み取り · — · 全ロール · API: list_document_types)
• lg documents download — Get a short-lived (15 minute) download/preview link for one document by its document_id (from list_load_documents or list_company_documents). (読み取り · — · 全ロール · API: get_document_link)
• lg drive-rest-estimates get — One driver's GPS-ESTIMATED driving/rest status and driving time left under EU 561/2006 / AETR: current activity and since when, driving_left_today_s = the legal driving time left today under the daily, weekly (56 h) AND… (読み取り · — · 運送会社 · API: get_driver_drive_rest_estimate)
• lg drive-rest-estimates list — Fleet overview of the GPS-ESTIMATED driving/rest status and driving time left (EU 561/2006 / AETR): per driver the current activity, driving_left_today_s = the legal driving time left today under the daily, weekly (56… (読み取り · — · 運送会社 · API: list_driver_drive_rest_estimates)
• lg driver-accounts get — Answer "how much do we owe this driver / how much does the driver owe us". (読み取り · — · 荷主, 運送会社 · API: get_driver_account_summary)
• lg driver-accounts list-candidates — Before opening or filling a driver settlement statement: which of ONE driver's receipts and advances can go on it, and why the others cannot. (読み取り · — · 荷主, 運送会社 · API: list_driver_account_candidates)
• lg driver-advances cancel — Cancel (void) a recorded driver money movement that did not really happen or was entered with the wrong amount. (書き込み · 確認 + 取り消し不可 · 荷主, 運送会社 · API: cancel_driver_advance)
• lg driver-advances create — Record a money movement between the company and a driver: an advance handed to the driver, money the driver gave back, a closing payout, or a carry-forward opening balance. (書き込み · 確認 · 荷主, 運送会社 · API: create_driver_advance) [ファイルを受け取る: attachment_uuid]
• lg driver-advances delete — Delete a driver money movement that was entered by mistake (duplicate, wrong driver). (書き込み · 確認 + 取り消し不可 · 荷主, 運送会社 · API: delete_driver_advance)
• lg driver-advances list — List the money movements between the company and its drivers: cash advances handed out, money paid back by the driver, closing payouts and carry-forward opening balances. (読み取り · — · 荷主, 運送会社 · API: list_driver_advances)
• lg driver-advances update — Correct the non-money details of a recorded driver money movement: its reference, note, or the load it belongs to. (書き込み · 確認 · 荷主, 運送会社 · API: update_driver_advance)
• lg driver-availabilities create — Record that a driver is unavailable on some days — "Ali is on leave 14-20 November", "Mehmet rests at home next week", "Kemal is sick from today". (書き込み · 確認 · 運送会社 · API: create_driver_availability)
• lg driver-availabilities delete — Delete ONE availability period (id from list_driver_availabilities) — the driver counts as available again on those days. (書き込み · 確認 + 取り消し不可 · 運送会社 · API: delete_driver_availability)
• lg driver-availabilities list — List drivers' leave, home-rest, sick and other unavailability periods (newest planning input), optionally for one driver and/or a date window. (読み取り · — · 運送会社 · API: list_driver_availabilities)
• lg driver-availabilities update — Correct one availability period (id from list_driver_availabilities): kind, dates, Schengen presence or note. (書き込み · 確認 · 運送会社 · API: update_driver_availability)
• lg driver-expense-settings get — Read this company's driver expense module settings: is the module switched on, which currency receipts and advances are converted into, whether receipts need approval (and above which amount), whether drivers may… (読み取り · — · 荷主, 運送会社 · API: get_driver_expense_settings)
• lg driver-expense-settings update — Change this company's driver expense module settings — only the fields you pass change. (書き込み · 確認 · 荷主, 運送会社 · API: update_driver_expense_settings) [manager キー]
• lg driver-expenses create — File one or MANY expense receipts the user attached to this conversation (fuel, toll, ferry, parking, repair, meal…) into the driver expense ledger as pending expenses of ONE of this company's drivers. (書き込み · 確認 + 取り消し不可 · 荷主, 運送会社 · API: process_receipt) [ファイルを受け取る: attachment_uuid, attachment_uuids]
• lg driver-expenses declare — Record a driver expense WITHOUT a receipt (fişsiz şoför harcaması) — "Mehmet dün 40 EUR otopark ödedi, fişi yok", "log 120 PLN toll for driver X". (書き込み · 確認 · 荷主, 運送会社 · API: create_driver_expense)
• lg driver-expenses delete — Delete a driver expense entered by mistake (duplicate receipt, wrong driver, test entry). (書き込み · 確認 + 取り消し不可 · 荷主, 運送会社 · API: delete_driver_expense)
• lg driver-expenses download — Get the download link of a receipt pack that generate_driver_receipt_pack prepared in the background. (読み取り · — · 荷主, 運送会社 · API: download_driver_receipt_pack)
• lg driver-expenses generate — Produce ONE PDF that contains the driver receipts of a selection — for a trip, a load, a driver statement or a date window — e.g. to hand to accounting or the customer. (読み取り · — · 荷主, 運送会社 · API: generate_driver_receipt_pack)
• lg driver-expenses get — Read one driver expense (receipt) by its id: merchant, amount, currency, converted amount, category, payment channel, whether it is charged to the driver, and the approval status. (読み取り · — · 荷主, 運送会社 · API: get_driver_expense)
• lg driver-expenses list — List driver expense receipts (fuel, toll, ferry, parking, food, repair…) with a converted total. (読み取り · — · 荷主, 運送会社 · API: list_driver_expenses)
• lg driver-expenses list-loads — For ONE driver: which loads they carried and, per load, how many receipts there are, how many still await approval, how much is reimbursable to the driver, how much is company-billed (fuel card / DKV / UTA — never the… (読み取り · — · 荷主, 運送会社 · API: list_driver_expense_loads)
• lg driver-expenses list-trips — For ONE driver: which trips (load groups) they drove and, per trip, the number of loads and the driver's OWN receipt figures (count, awaiting approval, reimbursable, company-billed fuel-card / DKV / UTA, still… (読み取り · — · 荷主, 運送会社 · API: list_driver_expense_trips)
• lg driver-expenses review — Approve or reject ONE driver expense (receipt) from the chat, or send an already-decided one back to pending. status=approved means the company accepts the expense (an approved reimbursable receipt can then be counted… (書き込み · 確認 · 荷主, 運送会社 · API: review_driver_expense)
• lg driver-expenses set-in-account — Count driver receipts INTO the driver's account (include=true, default) or take them OUT of it (include=false). (書き込み · 確認 · 荷主, 運送会社 · API: set_driver_expenses_in_account)
• lg driver-expenses update — Correct a recorded driver expense (receipt or no-receipt): amount, currency, date, category, how it was paid, merchant, description or the load it belongs to — "the parking was 45 EUR not 40", "that fuel was paid with… (書き込み · 確認 · 荷主, 運送会社 · API: update_driver_expense)
• lg driver-expenses update-conversion — Retry the currency conversion of ONE driver receipt whose exchange rate could not be resolved (it then sits outside every total and cannot go into a driver statement). (書き込み · — · 荷主, 運送会社 · API: retry_driver_expense_conversion)
• lg driver-schedules accept — Apply ONE schedule suggestion (suggestion_id from get_driver_schedule): the proposed driver is assigned to the load (or every consignment of the trip — consignments still held by another driver are taken over, and the… (書き込み · 確認 · 運送会社 · API: apply_driver_schedule_suggestion)
• lg driver-schedules generate — Compute schedule suggestions for a 7-90 day window starting within 30 days: which driver should take each unassigned load, trip and route plan so that nobody runs out of Schengen days, leave is respected and vehicles do… (書き込み · 確認 · 運送会社 · API: generate_driver_schedule)
• lg driver-schedules get — Read one schedule run (schedule_id from generate_driver_schedule / list_driver_schedules): summary (jobs covered, unassignable jobs and why, vehicle idle days before → after, lowest Schengen margin), the suggestions in… (読み取り · — · 運送会社 · API: get_driver_schedule)
• lg driver-schedules list — List the company's schedule-suggestion runs, newest first: id (schedule_id), status (queued | running | completed | failed), the planned window, objective and whether the run is out of date (is_stale — planning inputs… (読み取り · — · 運送会社 · API: list_driver_schedules)
• lg driver-schedules reject — Dismiss ONE open schedule suggestion (suggestion_id from get_driver_schedule) so it is no longer offered; nothing is assigned or changed elsewhere. (書き込み · — · 運送会社 · API: dismiss_driver_schedule_suggestion)
• lg driver-statements cancel — Cancel a statement that should not exist (opened by mistake, duplicated). (書き込み · 確認 + 取り消し不可 · 荷主, 運送会社 · API: cancel_driver_account)
• lg driver-statements create — Open a NEW draft settlement statement for a driver. (書き込み · 確認 · 荷主, 運送会社 · API: create_driver_account)
• lg driver-statements download — Give a short-lived download link to the PDF statement of a FINALISED driver settlement statement — the document the driver sees and signs, with every line, the fuel-card block that is outside the driver maths, and the… (読み取り · — · 荷主, 運送会社 · API: download_driver_account_pdf)
• lg driver-statements finalize — FINALISE a draft settlement statement — it freezes the document, makes it visible to the driver and (for settle_cash) writes the counter-entry into the advance ledger. (書き込み · 確認 + 取り消し不可 · 荷主, 運送会社 · API: finalize_driver_account) [manager キー]
• lg driver-statements get — Read one driver settlement statement in full: its status and revision, the driver, the currency, every total (expenses, advances, repayments, receiptless declarations), the NET balance with the sentence that says which… (読み取り · — · 荷主, 運送会社 · API: get_driver_account)
• lg driver-statements list — List the driver settlement statements (mutabakat belgesi) of this company: code, which driver, status (draft / finalized / cancelled), currency, the net balance and what it means, how many expense and advance lines it… (読み取り · — · 荷主, 運送会社 · API: list_driver_accounts)
• lg driver-statements reopen — Reopen a FINALISED statement so it can be corrected (a late receipt arrived, a line was wrong). (書き込み · 確認 · 荷主, 運送会社 · API: reopen_driver_account) [manager キー]
• lg driver-statements update — Change the note printed on a DRAFT driver settlement statement (e.g. "September trips, fuel excluded"). (書き込み · 確認 · 荷主, 運送会社 · API: update_driver_account)
• lg driver-statements update-lines — Attach receipts/advances to a DRAFT statement, or detach ones that should not be on it. (書き込み · 確認 · 荷主, 運送会社 · API: update_driver_account_lines)
• lg driver-statuses list — Fleet command centre — every driver's live operational status in one list: last position and its AGE, signal health (streaming / delayed / stale / no_signal / permission_denied / app_missing), duty (on_trip / assigned /… (読み取り · — · 荷主, 運送会社 · API: list_fleet_driver_statuses)
• lg drivers add-document — Record a driver paper — visa, passport, residence permit, driving licence, SRC certificate, psychotechnic certificate, travel health insurance — for ONE of this carrier's drivers, so its expiry is tracked. (書き込み · 確認 · 運送会社 · API: add_driver_document) [ファイルを受け取る: attachment_uuid]
• lg drivers archive — Archive (deactivate) a driver: their account is disabled, open mobile sessions are revoked and the login link stops working. (書き込み · 確認 + 取り消し不可 · 運送会社 · API: archive_driver)
• lg drivers calculate — Check whether ONE driver can take a job: Schengen 90/180 days left at the end of the trip (expected and worst case, counting the drive back out and the driver's later planned work), leave / home-rest / sick periods,… (読み取り · — · 運送会社 · API: check_driver_for_trip)
• lg drivers create — Create a new driver account for this carrier company. (書き込み · 確認 · 運送会社 · API: create_driver)
• lg drivers delete-document — Remove a driver paper from the driver's file. (書き込み · 確認 + 取り消し不可 · 運送会社 · API: delete_driver_document)
• lg drivers get — Full detail of ONE driver of this carrier: identity, archive state, mobile app state, last GPS position, assigned load codes, ALL driver documents (passport, visa, licence, SRC… with expiry and days_to_expiry) and the… (読み取り · — · 運送会社 · API: get_driver)
• lg drivers list — List this carrier company's drivers with their status, current country, expiring/expired document counts, assigned load codes and vehicle plates. (読み取り · — · 運送会社 · API: list_drivers)
• lg drivers list-candidates — Rank the company's drivers for a job — which drivers are available and can do it (Schengen days at trip end incl. the drive back, leave/home-rest, other jobs, estimated driving/rest readiness, distance to the start)… (読み取り · — · 運送会社 · API: list_trip_driver_candidates)
• lg drivers list-documents — List ONE driver's documents (passport, visa, residence permit, licence, SRC, ADR, health insurance…) with document number, issuing country, valid_until, days_to_expiry, is_expired and AI extraction status. (読み取り · — · 運送会社 · API: list_driver_documents)
• lg drivers list-locations — A driver's GPS trail — the raw position pings from the driver app in a time window, oldest to newest, with the first and last timestamps and the point count. (読み取り · — · 運送会社 · API: list_driver_locations)
• lg drivers login-link — Produce the driver's 48-hour mobile app login link (sensitive credential). (書き込み · 確認 · 運送会社 · API: get_driver_login_link)
• lg drivers request-location — Ask a driver's phone for a fresh position ("where is Ahmet right now — ping him"). (書き込み · — · 運送会社 · API: request_driver_location)
• lg drivers search — Resolve one of this company's drivers by name to its driver_id. (読み取り · — · 運送会社 · API: lookup_driver)
• lg drivers update — Correct a driver's first/last name. (書き込み · 確認 · 運送会社 · API: update_driver)
• lg drivers update-document — Correct a driver paper already on file — most often its expiry date (valid_until) after a renewal, but also the document number, the issuing country, the type or the note. (書き込み · 確認 · 運送会社 · API: update_driver_document)
• lg drivers update-login-link — Generate a NEW 48-hour mobile login link for a driver and kill the old one (lost phone, expired or leaked link). (書き込み · 確認 + 取り消し不可 · 運送会社 · API: refresh_driver_login_link)
• lg equipment-damages create — Open a damage record on one of the company's own vehicles or trailers (dorse hasar kaydı aç) — "33ABC12 dorsesinin sol arka kapısında ezik var", "record a scratch on the rear bumper of the truck". (書き込み · 確認 · 全ロール · API: create_equipment_damage)
• lg equipment-damages delete — Delete a damage record that was opened by mistake (a duplicate, the wrong vehicle). (書き込み · 確認 + 取り消し不可 · 全ロール · API: delete_equipment_damage)
• lg equipment-damages generate — Produce the equipment damage ledger as an Excel file (the same file as the panel's export button) and return a short-lived download link — e.g. "give me this year's open trailer damages as Excel". (読み取り · — · 全ロール · API: export_equipment_damages)
• lg equipment-damages list — List the equipment/trailer damages recorded for this company: which vehicle, where on it (area and angle), damage type and severity, whether it is still open or repaired, the estimated and actual repair cost, who is… (読み取り · — · 全ロール · API: list_equipment_damages)
• lg equipment-damages update — Update an existing damage record: mark it repaired (with repair date, cost and note), dismissed or disputed, change severity/type/area/description, set the estimated cost, or set/clear the responsible driver. (書き込み · 確認 · 全ロール · API: update_equipment_damage)
• lg equipment-inspection-links create — Create a one-time link so a driver or agent who is NOT on the platform (port agent, another company's driver) can upload the hand-over photos of one of the company's trailers/vehicles from a phone, without an account. (書き込み · 確認 · 全ロール · API: create_equipment_inspection_link)
• lg equipment-inspections create — Record an equipment hand-over inspection of one of the company's own trailers or vehicles on behalf of a driver or the office — "record the pickup inspection of trailer 34ABC12 with these 4 photos, driver Ali".… (書き込み · 確認 · 全ロール · API: create_equipment_inspection) [ファイルを受け取る: photos[].attachment_uuid]
• lg equipment-inspections delete — Delete an equipment inspection that was recorded by mistake (wrong vehicle, duplicate), together with its photos. (書き込み · 確認 + 取り消し不可 · 全ロール · API: delete_equipment_inspection)
• lg equipment-inspections get — Full detail of ONE equipment hand-over inspection: vehicle, event (pickup / dropoff / interim), who did it and where and when, the AI analysis status with its overall condition and summary, the damages that inspection… (読み取り · — · 全ロール · API: get_equipment_inspection)
• lg equipment-inspections list — List the equipment hand-over inspections (teslim-tesellüm controls) of this company: which vehicle, the event type (hand-over, take-over, interim), when and where it happened, who performed it (driver or office user, or… (読み取り · — · 全ロール · API: list_equipment_inspections)
• lg equipment-inspections run — Run the AI damage analysis again on the photos of one equipment inspection (for example after the analysis failed, or photos were added later). (書き込み · 確認 · 全ロール · API: reanalyze_equipment_inspection)
• lg equipment-settings get — Read the company's equipment inspection settings: whether the module is on, at which hand-overs an inspection is required (pickup / dropoff), whether photos are required, the minimum photo count, which angles are… (読み取り · — · 全ロール · API: get_equipment_settings)
• lg equipment-settings update — Change the company's equipment inspection settings — e.g. "turn on equipment inspection and require at least 4 photos with front, rear, left and right at pickup". (書き込み · 確認 · 全ロール · API: update_equipment_settings) [manager キー]
• lg equipment-timelines get — Who has one trailer/vehicle right now (custody: in custody of a driver since the last pickup, or released at the last dropoff), the inspections it went through (newest first) and its OPEN damages — in one read. (読み取り · — · 全ロール · API: get_equipment_timeline)
• lg export-documents add-item — Append a line item to an export document. (書き込み · — · 全ロール · API: add_export_document_item)
• lg export-documents create — Create a new export document draft. (書き込み · — · 全ロール · API: create_export_document_draft)
• lg export-documents create-set — Create SEVERAL export document drafts (a set, e.g. commercial invoice + packing list) from ONE source in one go: the source is read once by AI and every chosen document is filled from it. (書き込み · — · 全ロール · API: create_export_document_set) [ファイルを受け取る: attachment_uuid]
• lg export-documents delete — Delete one export document of this company (draft or generated). (書き込み · 確認 + 取り消し不可 · 全ロール · API: delete_export_document)
• lg export-documents duplicate — Copy an existing export document into a NEW draft of the same type (same parties, items and terms; no document number, not generated). (書き込み · — · 全ロール · API: duplicate_export_document)
• lg export-documents extract — Read a pasted order e-mail, offer or confirmation — or an Excel/CSV/TXT item list given as attachment_uuid — and fill an export document from it. (書き込み · — · 全ロール · API: extract_export_document_from_text) [ファイルを受け取る: attachment_uuid]
• lg export-documents generate — Produce the final PDF of an export document AND return a short-lived signed download link for it, so the user gets the file straight from the chat. (書き込み · 確認 + 取り消し不可 · 全ロール · API: generate_export_document)
• lg export-documents generate-set — Generate several export documents as PDFs in one go and return a short-lived download link for each generated one. (書き込み · 確認 + 取り消し不可 · 全ロール · API: generate_export_document_set)
• lg export-documents get — Read one export document in full: every filled field as dot-paths, the line items with their 1-based positions, the server-computed totals and which required fields are still empty. (読み取り · — · 全ロール · API: get_export_document)
• lg export-documents list — List the export documents of the current company (proforma invoice, commercial invoice, packing list, shipping instruction, delivery note, certificate/movement applications, exporter declaration, insurance request). (読み取り · — · 全ロール · API: list_export_documents)
• lg export-documents options — List the export document types and the ready-made document sets with their credit cost. (読み取り · — · 全ロール · API: get_export_document_options)
• lg export-documents preview — Before generating several export documents as PDFs, show what it would cost: which documents would spend a credit, which are free (already generated), the total, the remaining balance and the required fields still empty… (読み取り · — · 全ロール · API: plan_export_document_generation)
• lg export-documents remove-item — Delete one line item by its 1-based position. (書き込み · — · 全ロール · API: remove_export_document_item)
• lg export-documents set — Set one or more fields on an export document draft. (書き込み · — · 全ロール · API: set_export_document_fields)
• lg export-documents update-item — Change columns of one existing line item, addressed by its 1-based position from get_export_document. (書き込み · — · 全ロール · API: update_export_document_item)
• lg finance calculate — Build a budget / financial forecast (bütçe tahmini, gelecek yıl bütçesi, nakit/ciro projeksiyonu) from the company's MEASURED history, month by month. (読み取り · — · 全ロール · API: generate_budget_forecast)
• lg finance get — One call that returns the measured financial BASE for a period — the numbers a budget, a forecast, a business plan, a cash-flow projection or a board summary is built on, instead of chaining six separate reads. (読み取り · — · 全ロール · API: get_financial_snapshot)
• lg fleet-documents list — List fleet documents that expire soon (or already expired): vehicle papers (insurance, inspection, permits) and — for carriers — driver papers (passport, visa, licence, SRC). (読み取り · — · 荷主, 運送会社 · API: list_expiring_documents)
• lg freight-invoices archive — Archive (remove from the active list) a freight invoice YOUR company uploaded — e.g. a duplicate or the wrong file. (書き込み · 確認 + 取り消し不可 · 全ロール · API: archive_freight_invoice)
• lg freight-invoices create — Attach 1-20 freight invoices (navlun faturası) to a load. (書き込み · 確認 · 全ロール · API: upload_freight_invoices) [ファイルを受け取る: attachment_uuids]
• lg freight-invoices list — List the freight invoices (navlun faturaları) of a load that your company is a party to: who uploaded it, amount and currency, invoice date, the AI reading status, and which load parties it is shared with. (読み取り · — · 全ロール · API: list_freight_invoices)
• lg freight-invoices set-visibility — Choose which load parties can see a freight invoice YOUR company uploaded — e.g. "share the invoice with the receiver too", "only we should see it". (書き込み · 確認 · 全ロール · API: set_freight_invoice_visibility)
• lg freight-reports get — Freight (navlun) cost report over the loads this company can see: agreed freight totals per currency plus the EUR equivalent, freight-invoice totals, how many loads have NO freight recorded (listed by code), a breakdown… (読み取り · — · 荷主, 運送会社 · API: get_freight_cost_report)
• lg fuel-cards create — Register a fuel card (DKV, UTA and the like) in the fleet card book, optionally tied to a driver or a vehicle. (書き込み · 確認 · 荷主, 運送会社 · API: create_fuel_card)
• lg fuel-cards delete — Delete a fuel / toll card (DKV, UTA, Shell…) that was entered BY MISTAKE. (書き込み · 確認 + 取り消し不可 · 荷主, 運送会社 · API: delete_fuel_card)
• lg fuel-cards list — List the company's fuel and toll cards (DKV, UTA, Eurowag, E100, Shell, OMV, Aral, Petrol Ofisi, Opet…) with the last four digits, the driver or vehicle they are tied to, and whether they are active. (読み取り · — · 荷主, 運送会社 · API: list_fuel_cards)
• lg fuel-cards update — Update a fuel card: move it to another driver or vehicle, change its label or note, or DEACTIVATE it (is_active false) when the card is cancelled. (書き込み · 確認 · 荷主, 運送会社 · API: update_fuel_card)
• lg handoff-links generate — Get the logistivo.com link for work that deliberately stays in the browser: package_purchase (buy or upgrade a package; optional package_slug from list_packages and billing_period monthly|yearly pre-select it — the… (読み取り · — · 全ロール · API: get_browser_handoff_link)
• lg import-duties get — Read the Turkish import duty table for one GTİP code: customs duty (İthalat Rejimi Kararı) and additional customs duty / İGV, with every country-group column, plus the statutory duty from the nomenclature. (読み取り · — · 全ロール · API: get_import_duty_rates)
• lg integration-keys list — List the company's integration (API) keys: name, uuid, which teammate it acts as, scope (read/write) and allowed domains, access level (manager/employee), environment (live/sandbox), status (active/revoked/expired),… (読み取り · — · 全ロール · API: list_integration_keys) [manager キー]
• lg integration-keys revoke — Revoke one of the company's integration (API) keys by its uuid from list_integration_keys: the key stops working immediately and cannot be re-enabled (issue a new key instead). (書き込み · 確認 + 取り消し不可 · 全ロール · API: revoke_integration_key) [manager キー]
• lg invitations create — Invite colleagues to this company by e-mail — one address in email, or up to 20 at once in emails (all-or-nothing: the seat limit and every address's domain are checked before anything is sent). (書き込み · 確認 + 取り消し不可 · 全ロール · API: invite_teammate) [manager キー]
• lg invitations list — List teammate invitations of this company that are not completed yet (pending / e-mail verified / account created), with invitation_code, e-mail, role and expiry. (読み取り · — · 全ロール · API: list_pending_invitations)
• lg invitations resend — Re-send a pending teammate invitation e-mail and extend its expiry by 14 days. (書き込み · 確認 + 取り消し不可 · 全ロール · API: resend_invitation) [manager キー]
• lg invitations revoke — Cancel a pending teammate invitation so its link stops working (it can later be re-sent). (書き込み · 確認 · 全ロール · API: revoke_invitation) [manager キー]
• lg invoice-settings get — Read the invoice document settings (fatura ayarları, fatura şablonu ayarları): which invoice templates exist, which template configuration is the company default, which fields of it are filled (logo, seller address,… (読み取り · — · 全ロール · API: get_invoice_settings)
• lg invoice-templates create — Create a new invoice template configuration for your company: a base template plus field values (colours, font, header / footer text, IBANs shown, QR code, language; logo and signature from uploaded images). (書き込み · 確認 + 取り消し不可 · 全ロール · API: create_invoice_template) [manager キー] [ファイルを受け取る: logo_attachment_uuid, signature_image_attachment_uuid]
• lg invoice-templates delete — Delete one of your invoice template configurations. (書き込み · 確認 + 取り消し不可 · 全ロール · API: delete_invoice_template) [manager キー]
• lg invoice-templates get — Show the fillable fields of an invoice template (logo, colours, font, header / footer text, IBANs shown, QR code, signature, language) with their types, options and defaults — and, for one of your configurations, its… (読み取り · — · 全ロール · API: get_invoice_template)
• lg invoice-templates set-default — Make one of your invoice template configurations the company default; the previous default stops being default. (書き込み · 確認 · 全ロール · API: set_default_invoice_template) [manager キー]
• lg invoice-templates update — Edit one of your invoice template configurations: switch its base template, rename it, change field values (merged over the stored ones — only the keys you pass change), replace the logo / signature image, or make it… (書き込み · 確認 + 取り消し不可 · 全ロール · API: update_invoice_template) [manager キー] [ファイルを受け取る: logo_attachment_uuid, signature_image_attachment_uuid]
• lg invoices add-line — Add a line item to a DRAFT invoice and recompute totals (tax auto-resolved if tax_rate_id omitted). (書き込み · — · 全ロール · API: add_invoice_line)
• lg invoices add-payment — Record money received (sales invoice) or paid (purchase invoice) against ONE issued invoice: writes the payment, posts the balanced journal entry and reduces the remaining balance. (書き込み · 確認 + 取り消し不可 · 全ロール · API: record_invoice_payment)
• lg invoices cancel — Cancel an ISSUED invoice this company issued: posts the reversing journal entry and marks the invoice cancelled. (書き込み · 確認 + 取り消し不可 · 全ロール · API: cancel_invoice)
• lg invoices create — Create a DRAFT invoice (reversible) issued by the current company to a recipient business contact. (書き込み · — · 全ロール · API: create_invoice_draft)
• lg invoices delete-draft — Delete a DRAFT invoice of this company together with its lines and taxes. (書き込み · 確認 + 取り消し不可 · 全ロール · API: delete_invoice_draft)
• lg invoices download — Get a short-lived download link for the PDF of an invoice visible to this company (and the e-invoice XML when one exists). (読み取り · — · 全ロール · API: download_invoice_pdf)
• lg invoices get — Read one invoice in full: parties, load link, dates, every line with tax, tax breakdown, totals, remaining balance and the payments recorded against it. (読み取り · — · 全ロール · API: get_invoice)
• lg invoices issue — Issue (finalize) a DRAFT invoice: assigns a number and posts accounting entries. (書き込み · 確認 + 取り消し不可 · 全ロール · API: issue_invoice)
• lg invoices list — List invoices visible to this company — the ones it issued and the ones issued to it (as a linked party). (読み取り · — · 全ロール · API: list_invoices)
• lg invoices preview — Show the user a full preview of a DRAFT invoice (recipient, line items, tax breakdown, totals) WITHOUT issuing it. (読み取り · — · 全ロール · API: preview_invoice · 非推奨: 2026-09-03 · 移行先 get_invoice)
• lg invoices remove-line — Remove one line from a DRAFT invoice your company issued; the totals are recalculated. (書き込み · 確認 · 全ロール · API: remove_invoice_line)
• lg invoices reverse-payment — Undo ONE payment/collection recorded on an invoice: posts the reversing journal entry, gives the amount back to the invoice's remaining balance and removes the payment row. (書き込み · 確認 + 取り消し不可 · 全ロール · API: reverse_invoice_payment)
• lg invoices update — Edit the header of a DRAFT invoice your company issued: recipient contact, currency, issue / due date, the printed note and the invoice template. (書き込み · — · 全ロール · API: update_invoice_draft)
• lg invoices update-line — Edit one line of a DRAFT invoice your company issued (text, quantity, unit, net unit price, discount, tax rate, order). (書き込み · — · 全ロール · API: update_invoice_line)
• lg join-requests approve — Approve a pending join request: the applicant becomes a user of our company with the EMPLOYEE role, takes one team seat and is e-mailed the decision. (書き込み · 確認 + 取り消し不可 · 全ロール · API: approve_join_request) [manager キー]
• lg join-requests list — List PENDING requests from people asking to join our company (they signed up with an e-mail on one of our verified domains and picked our company). (読み取り · — · 全ロール · API: list_join_requests) [manager キー]
• lg join-requests reject — Reject a pending join request: the applicant does not join our company and is e-mailed the decision. (書き込み · 確認 + 取り消し不可 · 全ロール · API: reject_join_request) [manager キー]
• lg journal-entries create — Post a manual double-entry journal entry (yevmiye fişi). (書き込み · 確認 + 取り消し不可 · 全ロール · API: create_journal_entry)
• lg journal-entries get — Read one journal entry with its lines (account code/name, debit, credit, counterparty) and totals. (読み取り · — · 全ロール · API: get_journal_entry)
• lg journal-entries list — List journal entries (yevmiye fişleri) of the company, newest first, with optional date window. (読み取り · — · 全ロール · API: list_journal_entries)
• lg language-settings get — Read the signed-in user's own language settings (dil ayarları). (読み取り · — · 全ロール · API: get_language_settings)
• lg language-settings update — Change the signed-in user's OWN language settings — "dilimi İngilizce yap", "e-postalarım Türkçe gelsin", "sohbet mesajlarını Almancaya çevir". (書き込み · — · 全ロール · API: set_language)
• lg load-ai-settings get — Read our company's load AI reminder setting (Settings → Loads): whether the assistant posts reminders into load chats about loads whose status was not updated (ai_warning_enabled) and on which days (warning_frequency:… (読み取り · — · 全ロール · API: get_load_ai_settings)
• lg load-ai-settings update — Change our company's load AI reminders (Settings → Loads): ai_warning_enabled turns the reminders the assistant posts into load chats on or off; warning_frequency picks the days (daily, mon_wed_fri, weekly_wed,… (書き込み · 確認 · 全ロール · API: update_load_ai_settings) [manager キー]
• lg load-containers create — Add a sea container number to a load (yüke konteyner ekle) — "add MSC container MSCU1234565 to FKZ8515". (書き込み · 確認 · 荷主, 運送会社 · API: add_load_container)
• lg load-containers delete — Delete a container record from a load (konteyneri sil) — only while its vessel tracking has NOT started (otherwise refused with INVALID_STATUS). (書き込み · 確認 + 取り消し不可 · 全ロール · API: delete_load_container)
• lg load-containers get — Show one container of a load and the last known position of the ship carrying it (konteyner konumu): ship name/IMO, latitude/longitude, speed, course, destination, ETA and the position time. (読み取り · — · 全ロール · API: get_load_container)
• lg load-containers list — List the sea containers recorded on a load (konteynerler) with their shipping line, whether vessel tracking has started and which ship carries them. (読み取り · — · 全ロール · API: list_load_containers)
• lg load-containers set-tracking — Start vessel tracking for a load from its containers (konteyner takibini başlat): the shipping line is queried for each container until the vessel carrying it is found; that ship is then tracked on the load's map and… (書き込み · 確認 · 全ロール · API: start_load_container_tracking)
• lg load-documents create — File one or MANY documents the user attached to this conversation onto a load: each file is stored as a company document and posted into the load's chat, where every participant (customer, carrier, customs broker) sees… (書き込み · 確認 + 取り消し不可 · 全ロール · API: attach_chat_file_to_load) [ファイルを受け取る: attachment_uuid, attachment_uuids]
• lg load-documents list — List the documents (CMR, invoice, packing list, customs papers, photos…) filed on a load — i.e. the files shared in that load's chat. (読み取り · — · 全ロール · API: list_load_documents)
• lg load-groups add-loads — Merge EXISTING loads into a groupage trip you own as consignments (they keep their own code, chat, documents and participants; only the trip membership changes — nothing is duplicated and NO credit is used). (書き込み · 確認 · 荷主, 運送会社 · API: add_loads_to_group)
• lg load-groups create — Create a groupage trip (parsiyel/sefer): ONE truck carrying several ISOLATED consignments; each consignment is its own load with its own chat/documents/status and receivers never see each other. (書き込み · 確認 + 取り消し不可 · 荷主, 運送会社 · API: create_load_group)
• lg load-groups download — Download the route report of a groupage trip (sefer / parsiyel, code like LGV00253): route_pdf = detailed route report with map and itinerary, route_xlsx = the same as Excel, driver_sheet_pdf = the simplified driver… (書き込み · — · 荷主, 運送会社 · API: download_load_group_report)
• lg load-groups get — Detail of one groupage trip: consignments visible to you (load code, status, receiver, route, driver), planned date, optimised master route summary and stop count. (読み取り · — · 荷主, 運送会社 · API: get_load_group)
• lg load-groups list — List groupage trips (parsiyel / sefer: one truck, several isolated consignment loads) this company owns or — for carriers — carries, newest first, with visible consignment count and route optimisation state. (読み取り · — · 荷主, 運送会社 · API: list_load_groups)
• lg load-groups optimize — Re-optimise the master route of a groupage trip you own and RETURN the new itinerary: the ordered stops (pickup → export customs → import customs → dropoff), each stop's address and consignment codes, the total distance… (書き込み · — · 荷主, 運送会社 · API: optimize_trip_route)
• lg load-groups remove-load — Take one consignment out of a groupage trip you own. (書き込み · 確認 · 荷主, 運送会社 · API: remove_load_from_group)
• lg load-heatmaps generate — Produce the load heatmap report (PDF, with QR code and the list of your active loads: code, departure, arrival, date, weight), save it to the company's reports and return a download link. (書き込み · 確認 + 取り消し不可 · 全ロール · API: generate_load_heatmap_report)
• lg load-heatmaps get — Load heatmap data in words: the densest departure and arrival areas of your active loads, ranked by number of loads and by total kilograms. (読み取り · — · 全ロール · API: get_load_heatmap)
• lg load-locations create — Report a position for a load on behalf of the carrier (konum bildir) — "FKZ8515 is at Kapıkule now", "the truck is at 41.0, 28.9". (書き込み · 確認 + 取り消し不可 · 運送会社 · API: report_load_location)
• lg load-locations list — Show a load's position history (konum geçmişi) and its last known position — "where is FKZ8515 now", "where was it yesterday", "show the truck's track". (読み取り · — · 全ロール · API: list_load_locations)
• lg load-locations list-routes — Show the road route segments drawn on a load's tracking map (rota parçaları), each with distance (metres) and duration (seconds): from the pickup address to the first reported position, between reported positions, and… (読み取り · — · 全ロール · API: list_load_route_segments)
• lg load-notifications list-recipients — Show which load parties can receive a load notification (departure, arrival, daily location) and how many of their people are subscribed per channel (e-mail, push, SMS). (読み取り · — · 全ロール · API: list_load_notification_recipients)
• lg load-notifications send — Send a departure / arrival / daily-location notification about a load to chosen load parties — e.g. "notify the receiver that FRT6470 arrived". (書き込み · 確認 + 取り消し不可 · 全ロール · API: send_load_notification)
• lg load-notifications send-email — E-mail a departure / arrival / location update about a load to people you choose from YOUR OWN company directory (business contact persons) — e.g. "e-mail Mehmet at Arkas the location of FKZ8515". (書き込み · 確認 + 取り消し不可 · 全ロール · API: send_load_email_notification)
• lg load-participants create — Add a party to a load (yüke taraf ekle) — "FKZ8515'e Arkas'ı alıcı olarak ekle" — or assign a sub-carrier. business_contact_id comes from lookup_business_contact (your own directory). (書き込み · 確認 · 全ロール · API: add_load_participant)
• lg load-participants delete — Remove a party or a sub-carrier from a load (yükten taraf çıkar) — "FKZ8515'ten alt taşıyıcı Yılmaz Nakliyat'ı kaldır". participant_id comes from list_load_participants. (書き込み · 確認 · 全ロール · API: remove_load_participant)
• lg load-participants list — List a load's parties (yük tarafları): sender, receiver, carrier and sub-carriers, organizer, sender/receiver customs brokers — with participant_id (needed by every other load-participant command), position (0 = primary… (読み取り · — · 全ロール · API: list_load_participants)
• lg load-participants set-order — Put the parties of one role in a new order (load owner only); the first id becomes the primary. participant_ids must list ALL current rows of that role (from list_load_participants). (書き込み · 確認 · 全ロール · API: reorder_load_participants)
• lg load-participants set-primary — Make a party the primary one in its role (load owner only) — e.g. the main receiver or main customs broker. participant_id from list_load_participants. (書き込み · 確認 · 全ロール · API: set_primary_load_participant)
• lg load-participants update — Change one load party's settings (load owner only) — "Arkas FKZ8515'i görmesin": share_with_assigned_company (can the linked company see the load; cannot be turned off for a sub-carrier), conversation_user_ids (only… (書き込み · 確認 · 全ロール · API: update_load_participant)
• lg load-party-suggestions approve — Accept a party suggestion: link the suggested business contact to your OWN load as sender or receiver (business_contact_id and party_role from list_load_party_suggestions). (書き込み · 確認 · 全ロール · API: confirm_load_party_suggestion)
• lg load-party-suggestions list — Show sender/receiver suggestions for one of your OWN loads: parties named in the load's documents that match a contact in your directory but are not linked to the load yet. (読み取り · — · 全ロール · API: list_load_party_suggestions)
• lg load-party-suggestions reject — Close wrong party suggestions on your OWN load so they are not suggested again — "bu önerileri bir daha gösterme". (書き込み · — · 全ロール · API: dismiss_load_party_suggestions)
• lg load-reports get — Build a report of your ACTIVE loads, optionally filtered by sender, receiver, transport mode, departure country or arrival country. format=summary (default) answers in chat: the number of loads and how many are in each… (読み取り · — · 全ロール · API: get_load_report)
• lg load-reports options — List the companies you can filter the load report by — the senders, receivers, carriers and other parties that appear on your active loads — with their company id and role. (読み取り · — · 全ロール · API: get_load_report_options)
• lg load-types search — Resolve a load/transport type (e.g. (読み取り · — · 全ロール · API: lookup_load_type)
• lg load-vehicles delete — Detach the fleet equipment from a load: both slots by default, or only the tractor unit / only the trailer. (書き込み · 確認 · 全ロール · API: clear_load_equipment)
• lg load-vehicles get — Show which tractor unit (or truck/van) and which trailer are attached to a load, whether they belong to your own fleet, and whether the load can still be changed. (読み取り · — · 全ロール · API: get_load_equipment)
• lg load-vehicles set — Attach one of your own fleet vehicles to a load: the tractor unit / truck slot (plate) and/or the trailer slot (trailer_plate). (書き込み · 確認 · 全ロール · API: assign_vehicle_to_load)
• lg loads add-order-reference — Attach an order reference to a load (sipariş referansı ekle) — "FKZ8515'e satın alma siparişi PO-4471 ekle". order_type is the kind of order (e.g. purchase, sales), order_no the number. (書き込み · 確認 + 取り消し不可 · 全ロール · API: add_load_order_reference)
• lg loads analyze-documents — Re-run the background AI consistency analysis of a load's documents (does the invoice contradict the CMR, the packing list, the declared weight…) and refresh the load's problem flag with the outcome. (書き込み · — · 全ロール · API: reanalyze_load_documents)
• lg loads archive — Archive one of the company's OWN loads (yükü arşivle) — "FKZ8515'i arşive al". (書き込み · 確認 + 取り消し不可 · 全ロール · API: archive_load)
• lg loads assign-driver — Assign one of this company's drivers to a load so the driver sees it in the mobile app and starts reporting position. (書き込み · 確認 · 運送会社 · API: assign_driver_to_load)
• lg loads audit-documents — Cross-check the documents already attached to loads and report, PER LOAD, whether their package counts and gross weights agree. (読み取り · — · 全ロール · API: audit_load_documents)
• lg loads close-problem — Close the open document-consistency flag of ONE load, from the chat. action=resolved means the contradiction was actually fixed (a corrected document was uploaded); action=dismissed means it was a false alarm and should… (書き込み · 確認 · 全ロール · API: resolve_load_problem_flag)
• lg loads create — Open a freight load (yük). (書き込み · 確認 + 取り消し不可 · 全ロール · API: create_load)
• lg loads download — Generate a load's CMR consignment note as a PDF and return a short-lived download link — "FKZ8515'in CMR'ını ver". (読み取り · — · 全ロール · API: download_load_cmr)
• lg loads extract — Read a booking/order text (an e-mail body, a note, an ERP export line) and return the load fields it contains, in the quick-load form's shape: transport mode, countries, dates, load type, vehicle type, weight, goods… (読み取り · — · 荷主 · API: extract_load_from_text)
• lg loads get — Read one load in full by its code: route, dates, weight, current status, parties (sender/receiver/carrier), agreed freight (freight_amount + freight_currency) with its freight invoices (number, date, total), latest… (読み取り · — · 全ロール · API: get_load)
• lg loads list — List the freight loads (yük) this company can see, newest first. (読み取り · — · 全ロール · API: list_loads)
• lg loads list-associated — List the loads of the same multi-vehicle order as a given load (aynı siparişin diğer araçları) — every active load that shares its vehicle group code (LG…) and that your company can see, with status, date and carrier. (読み取り · — · 全ロール · API: list_associated_loads)
• lg loads list-billing-targets — Show who you can invoice for a load: its commercial parties (sender, receiver, carrier) you are allowed to bill, each with recipient_contact_id to pass to create_invoice_draft and in_my_directory (true = already in your… (読み取り · — · 全ロール · API: list_load_billing_targets)
• lg loads list-problems — List loads whose uploaded documents the AI consistency check found to CONTRADICT each other (e.g. invoice weight vs CMR weight). (読み取り · — · 全ロール · API: list_load_problem_flags)
• lg loads list-status-history — Show a load's status history (durum geçmişi) in order — when it went pending, in transport, transit, delivered (done). (読み取り · — · 全ロール · API: list_load_status_history)
• lg loads list-stops — List the stops of a multi-stop load (çok duraklı yük — several pickups/drop-offs on one load) in route order, with type (pickup, dropoff, customs_exit, customs_entry), company, address, leg distance/duration and whether… (読み取り · — · 全ロール · API: list_load_stops)
• lg loads optimize — Re-order the stops of a multi-stop load for the shortest driving route (pickups first, then drop-offs) and store the new order with leg distances — "optimise FKZ8515's stops". (書き込み · — · 全ロール · API: optimize_load_stops)
• lg loads options — Read a load's editable fields, their current values and the allowed options (load types, vehicle types, goods classes, stackability, incoterms, movement types) — "FKZ8515'te neyi değiştirebilirim?". (読み取り · — · 全ロール · API: get_load_edit_form)
• lg loads preview-copy — Prepare a copy draft of one of your company's OWN loads (yükü kopyala) — "FKZ8515'in aynısından bir tane daha açalım": transport mode, countries, addresses, load type, vehicle type, weight, goods class, incoterms, ports… (読み取り · — · 全ロール · API: get_load_copy_template)
• lg loads remove-driver — Remove the driver from a load (the opposite of assign_driver_to_load): the load disappears from the driver's app and GPS tracking of the load stops. (書き込み · 確認 · 運送会社 · API: unassign_driver_from_load)
• lg loads search — Full-text search across your loads (yük ara) — company names, pickup/delivery address, order references, load code, text written in the load chat and text read from documents shared in the chat: "içinde PO-4471 geçen… (読み取り · — · 全ロール · API: search_loads)
• lg loads set-status — Move a load to a new transport status and append it to the load's status history (this is what the customer sees on the tracking screen). (書き込み · 確認 + 取り消し不可 · 運送会社 · API: update_load_status)
• lg loads set-stop-status — Mark one stop of a multi-stop load as completed, or undo it (completed=false) — "FKZ8515's second drop-off is done". (書き込み · 確認 · 運送会社 · API: mark_load_stop_completed)
• lg loads set-tracking — Turn a load's GPS location tracking on or off (konum takibi) — "stop location tracking for FKZ8515", "resume tracking". (書き込み · 確認 · 運送会社 · API: set_load_location_tracking)
• lg loads update — Edit an existing load (yükü düzenle): loading date, weight, load type, vehicle types, goods class, stackability, pickup/delivery address, incoterms, movement type, loading/destination port. (書き込み · 確認 + 取り消し不可 · 全ロール · API: update_load)
• lg maturity-options list — The selectable payment terms (vade): maturity_option_id and the number of days (0 = cash / peşin). maturity_option_id is what update_company_profile takes. (読み取り · — · 全ロール · API: list_maturity_options)
• lg notification-settings get — Read our company's notification switches (Settings → Notifications): which e-mail notifications (type "notification") and push notifications (type "web-push") are on for the whole company — e.g. message, load, demand… (読み取り · — · 荷主 · API: get_notification_settings) [manager キー]
• lg notification-settings update — Turn our company's notification switches on or off (Settings → Notifications) — e.g. stop load chat push notifications or message e-mails for the whole company. settings is a list of {slug, enabled}; slugs come from… (書き込み · 確認 · 荷主 · API: update_notification_settings) [manager キー]
• lg notifications list — Read the signed-in user's own notification inbox (the bell icon): what happened, which kind of event it was, when, whether it is still unread, and the panel address the notification points at. (読み取り · — · 全ロール · API: list_notifications)
• lg notifications mark-read — Mark ALL of the signed-in user's unread notifications as read (empty the bell). (書き込み · — · 全ロール · API: mark_notifications_read)
• lg packages get — Read this company's package and CREDIT balance: how many credits are left, how many the package grants per year, how many were used, the renewal date, and the assistant token usage of the current period (1,000,000… (読み取り · — · 全ロール · API: get_credit_balance)
• lg packages list — List the Logistivo packages this company can buy: slug, name, monthly price and yearly upfront total in the company's BILLING currency (TRY for Türkiye-billed companies, EUR otherwise — never converted with an exchange… (読み取り · — · 全ロール · API: list_packages)
• lg pallets add-measurement — Record a NEW measurement for an existing pallet (dimensions in centimetres and/or gross weight in kilograms). (書き込み · 確認 · 全ロール · API: add_pallet_measurement)
• lg pallets add-proof — Attach a proof photo to one of this company's pallets (e.g. the wrapped pallet, its label, damage on arrival). (書き込み · — · 全ロール · API: add_pallet_proof) [ファイルを受け取る: attachment_uuid]
• lg pallets calculate — Suggest the missing base side of a pallet from a standard footprint (EUR 120×80, industrial 120×100, half 80×60; ±5 cm) when only one base side is known, and compute the volume when length, width and height are all… (読み取り · — · 全ロール · API: complete_pallet_dimensions)
• lg pallets create — Register a NEW pallet in a warehouse, optionally with its first measurement. warehouse_id is required — resolve the warehouse name with lookup_warehouse first. (書き込み · 確認 · 全ロール · API: create_pallet)
• lg pallets delete — Delete one of this company's pallet records. (書き込み · 確認 + 取り消し不可 · 全ロール · API: delete_pallet)
• lg pallets delete-proof — Remove one proof photo from one of this company's pallets. (書き込み · 確認 + 取り消し不可 · 全ロール · API: delete_pallet_proof)
• lg pallets extract — Estimate a pallet's content label, dimensions (cm) and gross weight (kg) from photo(s) the user attached to THIS conversation. (書き込み · — · 全ロール · API: extract_pallet_from_photos) [ファイルを受け取る: attachment_uuids]
• lg pallets get — Read one pallet in full: its identity (code, label, SKU, barcode), status, warehouse and area, the FULL measurement history (each row with its id, source — manual, lidar, arcore or ai_photo — and confidence), its proof… (読み取り · — · 全ロール · API: get_pallet)
• lg pallets list — List the pallets of this company: code, label, SKU/barcode, status, which warehouse and area it sits in, its latest measured dimensions (cm) and gross weight, and how many proof photos it has. (読み取り · — · 全ロール · API: list_pallets)
• lg pallets update — Update an existing pallet: its status (in_stock, in_transit, reserved, shipped, disposed), its label/SKU/barcode/note, or MOVE it to another warehouse or area. (書き込み · 確認 · 全ロール · API: update_pallet)
• lg parasut-contacts create — Create a new customer or supplier contact IN PARAŞÜT and keep its local copy. (書き込み · 確認 + 取り消し不可 · 全ロール · API: create_parasut_contact)
• lg parasut-contacts list — List the customer / supplier contacts held in Paraşüt (the local copy synchronised from Paraşüt): parasut_contact_id (the Paraşüt id used by create_parasut_sales_invoice — NOT a business contact id), name, short name,… (読み取り · — · 全ロール · API: list_parasut_contacts)
• lg parasut-invoices create — Issue a SALES invoice in Paraşüt for one of this company's Paraşüt contacts, as an e-invoice (scenario commercial or basic — the recipient must be an e-invoice user) or an e-archive invoice (scenario e_archive); check… (書き込み · 確認 + 取り消し不可 · 全ロール · API: create_parasut_sales_invoice)
• lg parasut-invoices list — List invoices held in Paraşüt (local copy): sales invoices (default) or purchase bills, newest issue date first — invoice id and number, item type, description, issue / due date, net / gross / VAT totals, currency,… (読み取り · — · 全ロール · API: list_parasut_invoices)
• lg parasut-invoices options — Return the options of the Paraşüt invoice form: income/expense categories (category_id), the Paraşüt bank and cash accounts, and — with tax_number — whether that VKN is a registered e-invoice user (then use scenario… (読み取り · — · 全ロール · API: get_parasut_invoice_options)
• lg parasut-settings delete — Disconnect Paraşüt from this company: the saved credentials are removed, the accounting provider switches back to local when it was Paraşüt, and the LOCAL copies pulled from Paraşüt (contacts, invoices, bank accounts,… (書き込み · 確認 + 取り消し不可 · 全ロール · API: disconnect_parasut) [manager キー]
• lg parasut-settings get — Show the Paraşüt integration status of this company: whether it is connected, the Paraşüt firm number, the user name, the client id/secret MASKED (last 4 characters only), when it was connected, the token status and the… (読み取り · — · 全ロール · API: get_parasut_settings) [manager キー]
• lg parasut-settings update — Connect this company's Paraşüt account or renew its credentials (replaces an existing connection). (書き込み · 確認 · 全ロール · API: connect_parasut) [manager キー] [CLI のみ]
• lg payables list — Payables ("whom do we owe how much"): per-supplier totals of recorded purchase invoices — invoiced, paid, remaining, earliest due date — with a per-currency breakdown and an overall summary. (読み取り · — · 全ロール · API: list_payables)
• lg payment-cards delete — Remove a saved payment card (card_id from list_payment_cards). (書き込み · 確認 + 取り消し不可 · 全ロール · API: delete_payment_card) [manager キー]
• lg payment-cards list — List the company's saved payment cards, MASKED (last four digits only), with the card holder name, expiry and which one is the default card the monthly subscription is charged to. (読み取り · — · 全ロール · API: list_payment_cards)
• lg payment-cards set-default — Make one of the saved cards (card_id from list_payment_cards) the DEFAULT card: the monthly package payment is charged to it from now on, and every other card loses the default flag. (書き込み · 確認 + 取り消し不可 · 全ロール · API: set_default_payment_card) [manager キー]
• lg payment-instructions cancel — CANCEL a pending bank payment instruction: the reservation on its invoices is released so they can be paid another way, and the instruction becomes "cancelled". (書き込み · 確認 + 取り消し不可 · 全ロール · API: cancel_settlement_instruction)
• lg payment-instructions download — Get the bank payment instruction document (PDF) with a short-lived download link. (読み取り · — · 全ロール · API: download_settlement_instruction)
• lg payment-instructions get — Read one bank payment instruction: its code, template, effective date, status with timestamps and cancel reason, its note, and — when the PDF has already been rendered — a short-lived signed link to it so the user gets… (読み取り · — · 全ロール · API: get_settlement_instruction)
• lg payment-instructions list — List the bank payment instructions of this company: instruction code, which template (bank format) it uses, its effective date, status (pending, executed, cancelled) and when it was executed or cancelled. (読み取り · — · 全ロール · API: list_settlement_instructions)
• lg payment-instructions run — EXECUTE a pending bank payment instruction (banka talimatını yürüt / uygula): the reserved invoices are paid, the payments and journal entries are written with the instruction's effective date, and the instruction… (書き込み · 確認 + 取り消し不可 · 全ロール · API: execute_settlement_instruction)
• lg planning-boards get — The planning calendar: for every driver, the stretches of days with planned work inside the Schengen area (planned_in), days assumed inside (drive back, assumed_in), planned work outside (planned_out), leave / rest… (読み取り · — · 運送会社 · API: get_planning_board)
• lg plans archive — Close a plan because the user says the work is finished or abandoned. (書き込み · — · 全ロール · API: archive_plan)
• lg plans create — Write down a multi-step job so it survives between conversations ("link these 5 loads to a trip, then invoice them"). (書き込み · 確認 · 全ロール · API: create_plan)
• lg plans get — Read one plan: the steps that were agreed AND the commands that actually ran while it was active. (読み取り · — · 全ロール · API: get_plan)
• lg plans list — List this company's plans, newest first. (読み取り · — · 全ロール · API: list_plans)
• lg ports search — Find a seaport by name or UN/LOCODE (liman ara) — "Mersin", "TRMER", "Trieste". (読み取り · — · 全ロール · API: lookup_port)
• lg preferences create — Remember a lasting preference of THIS user, so it applies to every future conversation too ("always show amounts in EUR", "write driver names surname first", "I want the weekly summary on Mondays"). (書き込み · — · 全ロール · API: remember_preference)
• lg preferences delete — Forget one stored preference of this user. (書き込み · — · 全ロール · API: forget_preference)
• lg preferences list — List what you have been asked to remember about THIS user, with the labels. (読み取り · — · 全ロール · API: list_preferences)
• lg product-brands create — Create a new product brand for this company (the panel's "new brand"). (書き込み · 確認 · 荷主 · API: create_product_brand)
• lg product-brands list — List this company's product brands (id, name, code, active flag, number of products). (読み取り · — · 荷主 · API: list_product_brands)
• lg product-categories create — Create a new product category for this company (the panel's "new category"). (書き込み · 確認 · 荷主 · API: create_product_category)
• lg product-categories list — List this company's product categories (id, name, code, active flag, number of products). (読み取り · — · 荷主 · API: list_product_categories)
• lg products add-image — Add a photo to a product's gallery. (書き込み · — · 荷主 · API: add_product_image) [ファイルを受け取る: attachment_uuid]
• lg products create — Define a new product in this company's catalogue so stock can be recorded against it: name plus optionally its unit of measure, SKU, barcode, category, brand, minimum stock level, reorder quantity and lot tracking. (書き込み · 確認 · 荷主 · API: create_product)
• lg products delete — Delete a product from this company's catalogue. (書き込み · 確認 + 取り消し不可 · 荷主 · API: delete_product)
• lg products delete-image — Remove one photo from a product's gallery (image_id from get_product). (書き込み · 確認 + 取り消し不可 · 荷主 · API: delete_product_image)
• lg products extract — Read product details (name, description, SKU, barcode, unit, category, brand) from 1-5 photos of the product or its label — the panel's "fill from photo" button. (書き込み · — · 荷主 · API: extract_product_from_photos) [ファイルを受け取る: attachment_uuids]
• lg products get — Show one product of this company in full: code, SKU, barcode, unit, category and brand, low-stock threshold and reorder quantity, lot tracking, its photos (with image_id for delete_product_image /… (読み取り · — · 荷主 · API: get_product)
• lg products list — List the products of this company: code, name, SKU/barcode, unit, category and brand, whether it is active, and its low-stock threshold. (読み取り · — · 荷主 · API: list_products)
• lg products list-low-stock — List the products whose quantity on hand is BELOW their low-stock threshold (strictly below — a product exactly at the threshold is not listed), with the quantity on hand and the threshold itself. (読み取り · — · 荷主 · API: list_low_stock_products)
• lg products options — List the units of measure a product can be held in (slug for create_product / update_product unit, with Turkish and English names). (読み取り · — · 荷主 · API: get_product_options)
• lg products search — Resolve a product to its product_id + on-hand quantity. (読み取り · — · 荷主 · API: lookup_product)
• lg products set-primary-image — Make one of a product's photos its cover image (image_id from get_product). (書き込み · — · 荷主 · API: set_product_primary_image)
• lg products update — Correct an existing product: its name, unit, SKU, barcode, category, brand, minimum stock level, reorder quantity, lot tracking, note, or whether it is active. (書き込み · 確認 · 荷主 · API: update_product)
• lg receivables get — Account statement of one contact: every sales invoice issued to them and every collection, in date order with a running balance, plus totals (invoiced, paid, open balance, open invoice count). (読み取り · — · 全ロール · API: get_receivable_statement)
• lg receivables list — Receivables ("who owes us how much"): per-contact totals of issued sales invoices — invoiced, paid, remaining — with a per-currency breakdown and an overall summary. (読み取り · — · 全ロール · API: list_receivables)
• lg report-files create — Turn a table you compiled from tool results into a downloadable Excel (default), PDF or CSV file — any custom table, list, comparison or export, with optional charts. (読み取り · — · 全ロール · API: create_report_file)
• lg reports get — Financial reports from posted journal entries: trial_balance (per-account debit/credit/balance as of a date), balance_sheet (as of a date) or income_statement (revenues/expenses/net income for a date range; defaults to… (読み取り · — · 全ロール · API: get_accounting_report)
• lg reservations approve — As the warehouse owner, approve a pending reservation received at your warehouse (the booker is notified). (書き込み · 確認 · 荷主 · API: approve_reservation)
• lg reservations cancel — Cancel (withdraw) a warehouse reservation you booked, or — as the warehouse owner (customer) — cancel a reservation received at your warehouse. (書き込み · 確認 + 取り消し不可 · 全ロール · API: cancel_reservation)
• lg reservations complete — As the warehouse owner, mark an APPROVED reservation at one of your warehouses as completed (the vehicle came and the work is done). (書き込み · 確認 + 取り消し不可 · 荷主 · API: complete_reservation)
• lg reservations create — Book a warehouse dock time slot. (書き込み · 確認 · 全ロール · API: create_reservation)
• lg reservations get — Detail of one warehouse reservation you booked or (customer) one received at your warehouse: warehouse, area, time window, status, contact, notes, rejection reason. (読み取り · — · 全ロール · API: get_reservation)
• lg reservations list — List warehouse dock reservations. side=booked_by_me (default): reservations this user/company booked at other companies' warehouses. side=received (customer role only): reservations other companies made at ONE of your… (読み取り · — · 全ロール · API: list_reservations)
• lg reservations list-slots — Available dock time slots of one day with remaining capacity. (読み取り · — · 全ロール · API: list_reservation_slots)
• lg reservations reject — As the warehouse owner, reject a pending reservation received at your warehouse, with an optional reason shown to the booker. (書き込み · 確認 + 取り消し不可 · 荷主 · API: reject_reservation)
• lg reservations reschedule — As the warehouse owner, move a PENDING or APPROVED reservation at one of your warehouses to a new time. (書き込み · 確認 · 荷主 · API: reschedule_reservation)
• lg roro-routes list — For a load you are carrying, list the Ro-Ro (ferry) lines closest to its PICKUP address, nearest first: the line name, its departure and arrival ports and how many kilometres the pickup point is from the departure port. (読み取り · — · 運送会社 · API: list_nearby_roro_routes)
• lg roro-routes select — Select the Ro-Ro (ferry) line a load you are carrying will use. (書き込み · 確認 · 運送会社 · API: select_roro_route)
• lg roro-routes set-required — Mark whether a load you are carrying will travel by Ro-Ro (ferry) or not. (書き込み · 確認 · 運送会社 · API: set_load_roro_required)
• lg route-plans assign-driver — Assign a driver (and, on a double-crew plan, a co-driver; optionally the vehicle/trailer) to a saved route plan (route_plan_id or route_plan_code). (書き込み · 確認 · 運送会社 · API: assign_driver_to_route_plan)
• lg route-plans calculate — Calculate a multi-stop truck journey WITHOUT saving it: truck driving time (car time × hgv_factor, capped speed), the EU 561/2006 / AETR breaks, daily and weekly rests, weekend/holiday driving bans and border waits, and… (書き込み · 確認 · 運送会社 · API: calculate_route_plan)
• lg route-plans create — Save a route plan as a DRAFT (same arguments as calculate_route_plan, plus name, vehicle_id, trailer_id, start_flex_days). (書き込み · 確認 · 運送会社 · API: create_route_plan)
• lg route-plans delete — Cancel and delete a route plan (route_plan_id or route_plan_code). (書き込み · 確認 + 取り消し不可 · 運送会社 · API: delete_route_plan)
• lg route-plans get — One saved route plan: stops with arrival/departure ranges, the summary (distance, truck driving time, arrival optimistic / expected / conservative, breaks, daily/weekly rests, reduced rests, border waits), Schengen days… (読み取り · — · 運送会社 · API: get_route_plan)
• lg route-plans list — List the company's saved route plans, newest first: code, name, status (draft | assigned | converted | cancelled), departure, crew, driver, vehicle, linked load/trip, stops, arrival range and Schengen day count. (読み取り · — · 運送会社 · API: list_route_plans)
• lg route-plans preview — Compare 1-6 variants of the same journey side by side — different drivers, departure days or a double crew: arrival range, driving and rest counts, Schengen days left at the end for every crew member, availability /… (書き込み · 確認 · 運送会社 · API: compare_route_plan_scenarios)
• lg route-plans remove-driver — Take the driver (and co-driver) off an assigned route plan (route_plan_id or route_plan_code); the plan goes back to draft and stops counting as planned Schengen days for them. (書き込み · 確認 · 運送会社 · API: unassign_driver_from_route_plan)
• lg route-plans select — Link a saved route plan (route_plan_id or route_plan_code) to the load or trip it was planned for — give load_code OR trip_code; give neither to remove the link. (書き込み · 確認 · 運送会社 · API: link_route_plan)
• lg route-plans update — Change a saved route plan (route_plan_id or route_plan_code): any create_route_plan field — name, departure, stops, crew, options, vehicle. (書き込み · 確認 · 運送会社 · API: update_route_plan)
• lg schengen-stays calculate — Project ONE driver's Schengen 90/180 days into the future: days used today, then how the remaining days move with the loads, trips and route plans already assigned to him (plus the drive back out) and his leave /… (読み取り · — · 運送会社 · API: get_driver_schengen_projection)
• lg schengen-stays create-set — Import drivers' past Schengen entry/exit periods (passport stamps) from an Excel/CSV file — one row per stay: driver code or name, entry date, exit date (empty = still inside). (書き込み · 確認 · 運送会社 · API: import_driver_schengen_periods) [ファイルを受け取る: attachment_uuid]
• lg schengen-stays download — Give a short-lived download link to the Schengen history import template, pre-filled with the company's active drivers (user code + name; entry/exit date cells empty). (読み取り · — · 運送会社 · API: download_schengen_import_template)
• lg schengen-stays get — One driver's full Schengen 90/180 picture: days used (confirmed / declared / inferred), days left (signed; negative = overstay), latest exit date, breach date, when days come back (regain schedule), per-country day… (読み取り · — · 運送会社 · API: get_driver_schengen_detail)
• lg schengen-stays list — Fleet-wide Schengen 90/180 compliance: which drivers breached the 90-days-in-180 rule or are close to it, how many days each has left (days_remaining is SIGNED — negative means overstay), the latest exit date… (読み取り · — · 運送会社 · API: list_schengen_compliance)
• lg schengen-stays list-periods — List the Schengen stay periods DECLARED for a driver (passport stamps / starting balance) with their period_id, entry and exit dates and day count. (読み取り · — · 運送会社 · API: list_driver_schengen_periods)
• lg schengen-stays remove-period — Delete ONE wrongly entered declared Schengen period of a driver (period_id from list_driver_schengen_periods). (書き込み · 確認 + 取り消し不可 · 運送会社 · API: delete_driver_schengen_period)
• lg schengen-stays set-baseline — Set a driver's Schengen starting balance — what happened BEFORE GPS tracking: either the exact periods inside the zone from passport stamps (baseline_mode=periods) or just "X days used in the last 180"… (書き込み · 確認 · 運送会社 · API: set_driver_schengen_baseline)
• lg schengen-stays set-exemption — Exempt a driver from Schengen 90/180 tracking (EU/EFTA passport, residence permit, national long-stay visa) or switch the rule back on. (書き込み · 確認 · 運送会社 · API: set_driver_schengen_exemption)
• lg settlements cancel — CANCEL a bulk collection / payment (settlement batch). (書き込み · 確認 + 取り消し不可 · 全ロール · API: cancel_settlement_batch) [manager キー]
• lg settlements create — Close several open invoices of ONE contact in ONE currency in a single bulk collection (direction in) or bulk payment (direction out). instrument transfer = money already moved by bank transfer (payments + journal… (書き込み · 確認 + 取り消し不可 · 全ロール · API: create_settlement_batch)
• lg settlements get — Read one bulk collection / payment (settlement batch) in full: code, direction (in = collection, out = payment), instrument (transfer, bank instruction or cheque), status, counterparty, currency and total, value date,… (読み取り · — · 全ロール · API: get_settlement_batch)
• lg settlements list — List bulk collection/payment batches (code, direction, instrument, contact, currency, total, value date, status), newest first. (読み取り · — · 全ロール · API: list_settlement_batches)
• lg settlements list-counterparties — List the business contacts that have OPEN local invoices in one money direction — in = customers owing us (sales invoices), out = suppliers we owe (purchase invoices) — each with its default open-invoice currency and… (読み取り · — · 全ロール · API: list_settlement_counterparties)
• lg settlements list-invoices — Open LOCAL invoices of one contact in one currency that can be allocated in a bulk collection (direction in = sales invoices) or bulk payment (direction out = purchase invoices), each with payable_remaining (remaining… (読み取り · — · 全ロール · API: list_settlement_invoices)
• lg settlements options — Return the options of the bulk collection / payment form: allowed currencies, this company's OWN bank accounts (bank_account_id for create_settlement_batch / attach_check_to_invoices), bank instruction templates, batch… (読み取り · — · 全ロール · API: get_settlement_options)
• lg ship-trackings create — Attach a ship to a load and track it on the load's map (yüke gemi bağla), or swap the ship (replace_ship_id = the ship being replaced) — "FKZ8515 sails on MSC Gülsün, track it". (書き込み · 確認 · 荷主, 運送会社 · API: track_ship_for_load)
• lg ship-trackings delete — Stop tracking a ship on a load (gemi takibini durdur). (書き込み · 確認 · 荷主, 運送会社 · API: stop_ship_tracking)
• lg ship-trackings get — Show the ship(s) tracked on a load and their position history since the load was created (yükün gemi takibi) — "where is FKZ8515's ship now". (読み取り · — · 全ロール · API: get_load_ship_tracking)
• lg ships search — Search the ship registry (gemi sicili) by name, IMO or MMSI — "what is MSC Gülsün's IMO", "find the vessel 9839430". (読み取り · — · 全ロール · API: lookup_ship)
• lg stock adjust — Record a stock count correction (sayım düzeltme) or write-off (fire). mode=set sets the absolute on-hand at the slot; mode=delta applies a signed change (negative reduces). reason is required. (書き込み · 確認 + 取り消し不可 · 荷主 · API: create_stock_adjustment)
• lg stock list — Read current on-hand stock levels. (読み取り · — · 荷主 · API: check_stock_level)
• lg stock list-movements — List the stock movements of this company, newest first: which product moved, in or out (or a transfer or a count adjustment), how much, in which warehouse and area, on which pallet, who performed it and when. (読み取り · — · 荷主 · API: list_stock_movements)
• lg stock move — Record a stock movement: inbound (giriş), outbound (çıkış), or transfer between locations. (書き込み · 確認 + 取り消し不可 · 荷主 · API: create_stock_movement)
• lg stock options — List the stock movement types (receipt, issue, transfer, count adjustment …) with their slug and Turkish/English names — the values create_stock_movement and list_stock_movements use. (読み取り · — · 荷主 · API: get_stock_options)
• lg sub-companies create — Add a group / sub company (alt firma) to this customer company: legal_name (ticaret unvanı), tax_office (vergi dairesi), tax_number and the full address — all four required. (書き込み · 確認 · 荷主 · API: create_sub_company) [manager キー]
• lg sub-companies delete — Delete one of this customer company's group / sub companies (alt firma) by sub_company_id from list_sub_companies. (書き込み · 確認 + 取り消し不可 · 荷主 · API: delete_sub_company) [manager キー]
• lg sub-companies list — This customer company's group / sub companies (alt firmalar, grup şirketleri — Settings › Sub Companies): sub_company_id, legal name, tax office, tax number and address. (読み取り · — · 荷主 · API: list_sub_companies)
• lg tariff-chapters get — Answer "which chapter is this GTİP in / what does chapter 76 cover / what do the chapter notes say?". (読み取り · — · 全ロール · API: get_tariff_chapter)
• lg tariff-matrices get — FREE. (読み取り · — · 全ロール · API: get_tariff_matrix)
• lg tariff-matrices list — FREE. (読み取り · — · 全ロール · API: list_tariff_matrix_runs)
• lg tariff-matrices preview — FREE. (読み取り · — · 全ロール · API: plan_tariff_matrix)
• lg tariff-matrices run — Run an official duty + anti-dumping inquiry for ONE tariff code across MANY origin and destination countries at once, and record it. (書き込み · 確認 + 取り消し不可 · 全ロール · API: run_tariff_matrix)
• lg tariffs coverage — FREE. (読み取り · — · 全ロール · API: get_tariff_coverage)
• lg tariffs extract — Read an invoice or proforma the user attached to THIS conversation and pull out its product lines with candidate GTİP/HS codes, plus the origin and destination it names. (書き込み · — · 全ロール · API: extract_tariff_codes_from_invoice) [ファイルを受け取る: attachment_uuid]
• lg tariffs get — Read the result of a tariff inquiry that was already run: duty rate, the column it came from, the statutory rate, anti-dumping measures and the data notes. (読み取り · — · 全ロール · API: get_tariff_inquiry)
• lg tariffs inquiry — Start an official duty / anti-dumping inquiry for one GTİP/HS code and a COUNTRY PAIR (origin → destination). (書き込み · 確認 + 取り消し不可 · 全ロール · API: run_tariff_inquiry)
• lg tariffs list — List this company's recent tariff inquiries (code, direction, counterpart country, status, date) so the user can find an earlier one by code or country instead of running a new inquiry. (読み取り · — · 全ロール · API: list_tariff_inquiries)
• lg tariffs search — Search the Turkish customs nomenclature (GTİP / HS) by goods description or by a partial code, and return matching codes with their official descriptions. (読み取り · — · 全ロール · API: lookup_tariff_code)
• lg teammates delete — Remove a person from the company team. (書き込み · 確認 + 取り消し不可 · 全ロール · API: remove_teammate) [manager キー]
• lg teammates list — List the other users of this company (drivers excluded) with e-mail, active state and RBAC role (manager | employee | fleet-manager), plus seat_usage (team seats used / limit / remaining under the package). role narrows… (読み取り · — · 全ロール · API: list_teammates)
• lg teammates set-role — Change a team member's role (for example make them a manager, or move them back to employee). (書き込み · 確認 · 全ロール · API: update_teammate_role) [manager キー]
• lg teammates set-status — Activate or deactivate a team member. (書き込み · 確認 · 全ロール · API: set_teammate_status) [manager キー]
• lg tender-bids create — Submit YOUR bid for a tender using a file the user attached to THIS conversation (the filled specification spreadsheet, a PDF offer, or a zip). (書き込み · 確認 + 取り消し不可 · 運送会社 · API: submit_tender_bid) [ファイルを受け取る: attachment_uuid]
• lg tender-bids get — Read YOUR OWN bid on a tender: its status (submitted, revision requested, accepted, rejected), when it was submitted and which files it carries. (読み取り · — · 運送会社 · API: get_my_tender_bid)
• lg tender-bids set-status — As the tender owner, ACCEPT a carrier's bid, REJECT it, or ask for a REVISION. (書き込み · 確認 + 取り消し不可 · 荷主 · API: decide_tender_bid)
• lg tenders add-document — Attach a file to one of YOUR tenders as an additional specification document (accepted: pdf, xlsx, xls, doc, docx; at most 10 MB). (書き込み · 確認 · 荷主 · API: add_tender_document) [ファイルを受け取る: attachment_uuid]
• lg tenders create — Open a NEW document-based freight tender and generate its specification Excel from the lanes the user gives (origin → destination, vehicle/load type, monthly volume). (書き込み · 確認 · 荷主 · API: create_tender) [ファイルを受け取る: attachment_uuid]
• lg tenders delete-document — Remove a specification file from one of YOUR tenders (document_id from get_tender → documents[]). (書き込み · 確認 + 取り消し不可 · 荷主 · API: delete_tender_document)
• lg tenders extract — Draft the specification (terms) text of a tender from a tender document the user supplies (accepted: pdf, xlsx, xls; at most 10 MB). (読み取り · — · 荷主 · API: extract_tender_specification) [ファイルを受け取る: attachment_uuid]
• lg tenders generate — Generate a specification Excel for an EXISTING tender from the lanes/items the user gives and attach it to the tender as a document; returns a short-lived download link. (書き込み · 確認 · 荷主 · API: generate_tender_excel)
• lg tenders get — Read one tender in full: specification text, dates, attached specification files (with short-lived download links) and — for the tender owner — every carrier bid with its status; a carrier sees only its own bid. (読み取り · — · 荷主, 運送会社 · API: get_tender)
• lg tenders list — List document-based freight tenders. (読み取り · — · 荷主, 運送会社 · API: list_tenders)
• lg tenders update — Edit one of YOUR tenders: title, description, specification text, the bidding window (start_date / end_date), the price-validity window, whether it still accepts bids (is_active), its status, and who it is shared with. (書き込み · 確認 · 荷主 · API: update_tender)
• lg trade-measures get — Answer "is there an anti-dumping / countervailing / safeguard measure on this GTİP code when importing INTO TURKEY?" straight from the Ministry of Trade's measures-in-force list, which we sync every day. (読み取り · — · 全ロール · API: get_trade_measures)
• lg trade-measures list — Browse Türkiye's trade-defence measures WITHOUT a GTİP code: by origin country ("which measures apply to goods from China"), by product ("which countries have a measure on aluminium foil"), by measure type, or by end… (読み取り · — · 全ロール · API: list_trade_measures)
• lg user-accounts preview — Show what closing MY OWN account would do, without closing it: whether I am a manager, whether I am the only user (then the company is deactivated too), whether I must first hand the manager role to a teammate… (読み取り · — · 全ロール · API: preview_account_closure)
• lg users get — Who am I? (読み取り · — · 全ロール · API: get_current_user)
• lg vehicle-assignments create — Hand a fleet vehicle over to a driver (open an assignment), so their expense receipts and trips are attached to the right tractor unit or trailer. (書き込み · 確認 · 荷主, 運送会社 · API: assign_vehicle_to_driver)
• lg vehicle-assignments list — List which driver currently holds which vehicle (tractor unit / trailer). (読み取り · — · 荷主, 運送会社 · API: list_vehicle_assignments)
• lg vehicle-assignments revoke — Close an open vehicle assignment: the driver hands the vehicle back. (書き込み · 確認 · 荷主, 運送会社 · API: end_vehicle_assignment)
• lg vehicle-expenses create — Record a cost against one of the company's own vehicles without an invoice file — category, amount and currency are required, the rest is optional. (書き込み · 確認 · 荷主, 運送会社 · API: create_vehicle_expense) [ファイルを受け取る: attachment_uuid]
• lg vehicle-expenses delete — Delete a vehicle cost entered by mistake (duplicate, wrong plate, test entry). (書き込み · 確認 + 取り消し不可 · 荷主, 運送会社 · API: delete_vehicle_expense)
• lg vehicle-expenses list — List the cost records of the company's own vehicles (maintenance, tyres, repair, roadworthiness test, insurance, fuel, tolls, parts) with a EUR total and a breakdown per category and per currency. (読み取り · — · 荷主, 運送会社 · API: list_vehicle_expenses)
• lg vehicle-expenses update — Correct a recorded vehicle cost: category, amount, currency, vendor, invoice number, invoice date or description — "the tyre invoice was 580 not 850". (書き込み · 確認 · 荷主, 運送会社 · API: update_vehicle_expense)
• lg vehicles add-document — File a paper of one of the company's own vehicles — registration (ruhsat), traffic or kasko insurance, roadworthiness inspection, tachograph calibration, CMR insurance, green card, ADR certificate — from an uploaded… (書き込み · 確認 · 荷主, 運送会社 · API: add_vehicle_document) [ファイルを受け取る: attachment_uuid]
• lg vehicles archive — Take a vehicle out of service (archive it) or put an archived one back into service. (書き込み · 確認 · 荷主, 運送会社 · API: archive_vehicle)
• lg vehicles create — Add a vehicle to this company's fleet: plate plus its kind (truck, tractor unit, trailer, van, pickup, car), optionally brand, model, model year, VIN and a note. (書き込み · 確認 · 荷主, 運送会社 · API: create_vehicle) [ファイルを受け取る: attachment_uuid]
• lg vehicles delete — Delete a vehicle record that was created BY MISTAKE (wrong plate, duplicate). (書き込み · 確認 + 取り消し不可 · 荷主, 運送会社 · API: delete_vehicle)
• lg vehicles delete-document — Remove a paper from a vehicle's file (a duplicate row, a paper filed on the wrong vehicle, an old registration). (書き込み · 確認 + 取り消し不可 · 荷主, 運送会社 · API: delete_vehicle_document)
• lg vehicles get — Full detail of ONE fleet vehicle: identity (plate, kind, brand, model, model year, VIN), whether it is active or archived, ALL of its papers with their expiry date and days_to_expiry, how many papers expire soon or… (読み取り · — · 荷主, 運送会社 · API: get_vehicle)
• lg vehicles list — List this company's fleet vehicles with plate, kind (truck / tractor unit / trailer / van / pickup / car), brand, model, model year, VIN and how many of their papers (insurance, inspection, permits) expire soon or have… (読み取り · — · 荷主, 運送会社 · API: list_vehicles)
• lg vehicles search — Resolve one of this company's fleet vehicles (truck, tractor unit, trailer, van, pickup, car) to its vehicle_id by plate, brand, model or VIN. (読み取り · — · 荷主, 運送会社 · API: lookup_vehicle)
• lg vehicles update — Correct a fleet vehicle's fields: plate, kind, brand, model, model year, VIN or note. (書き込み · 確認 · 荷主, 運送会社 · API: update_vehicle)
• lg vehicles update-document — Correct a vehicle paper already on file — most often its expiry date (valid_until) after a renewal or a wrong AI reading, but also its type, number, issue date, issuer, the plate printed on it, issuing country, title or… (書き込み · 確認 · 荷主, 運送会社 · API: update_vehicle_document)
• lg wallets get — Read this company's Logistivo WALLET balance — the prepaid MONEY balance (amount + currency). (読み取り · — · 全ロール · API: get_wallet_balance)
• lg wallets list-transactions — List this company's Logistivo WALLET movements, newest first: top-ups and money spent on packages or paid features, with the amount, the balance before/after, who did it and when. (読み取り · — · 全ロール · API: list_wallet_transactions)
• lg warehouse-areas create — Add a new area to one of this company's warehouses — an open area, a closed area or a loading ramp — with how many vehicles it can take at the same time (its booking slot capacity). (書き込み · 確認 · 荷主 · API: create_warehouse_area)
• lg warehouse-areas delete — Delete one area/ramp of a warehouse. (書き込み · 確認 + 取り消し不可 · 荷主 · API: delete_warehouse_area)
• lg warehouse-areas update — Change a warehouse area's name, type (open_area, closed_area, ramp), vehicle capacity, display order or active flag. (書き込み · 確認 · 荷主 · API: update_warehouse_area)
• lg warehouse-links create — Create a public booking link for one of this company's warehouses, to share with a carrier, supplier or customer: anyone holding the URL can book a slot (the booking still waits for your approval). (書き込み · 確認 · 荷主 · API: create_warehouse_link)
• lg warehouse-links list — List the public booking links shared for one of this company's warehouses: the full URL (anyone holding it can book a slot), the area it is limited to (if any), the expiry, and whether it is active. (読み取り · — · 荷主 · API: list_warehouse_links)
• lg warehouse-links revoke — Permanently revoke a warehouse booking link: the URL stops working for everyone and cannot be brought back (create a new link if needed). (書き込み · 確認 + 取り消し不可 · 荷主 · API: revoke_warehouse_link)
• lg warehouse-links set-status — Turn a warehouse booking link off (nobody can book through it) or back on. (書き込み · 確認 · 荷主 · API: set_warehouse_link_status)
• lg warehouses create — Define a new warehouse for this company so stock can be held and dock slots booked there: a name and its street address are enough. (書き込み · 確認 · 荷主 · API: create_warehouse)
• lg warehouses delete — Delete one of this company's warehouses. (書き込み · 確認 + 取り消し不可 · 荷主 · API: delete_warehouse)
• lg warehouses get — Read one warehouse in full: its identity and address, working days and hours, holiday opening, capacity, reservation slot rules (slot length, minimum and maximum duration), its safety and driver rules, the… (読み取り · — · 荷主 · API: get_warehouse)
• lg warehouses list — List the warehouses of this company: name, address, whether it is active, its working days and hours, open/closed area capacity, the dock slot length and how many areas (racks/bays) it has. (読み取り · — · 荷主 · API: list_warehouses)
• lg warehouses search — Resolve a warehouse by name to its warehouse_id, with its areas. (読み取り · — · 荷主 · API: lookup_warehouse)
• lg warehouses set-equipment — Set a warehouse's equipment list IN FULL (forklift, transpallet = pallet truck, other; with quantity and an optional name/specification). (書き込み · 確認 · 荷主 · API: set_warehouse_equipment)
• lg warehouses update — Update a warehouse: its name or address, working days and hours, holiday opening, capacity, dock slot rules, the driver/safety flags or the active flag. (書き込み · 確認 · 荷主 · API: update_warehouse)

ERP・CRM 連携 — 認証主体：サービスアカウントではなく、実在のユーザー

ERP や CRM は、パネルで発行したパーソナルアクセストークンを持つ、実在する企業ユーザーとして Logistivo に接続します。企業に属さず、スコープの制約を受けず、誰も責任を負わない合成のサービスアカウントが作られることは決してありません。

これは好みではなく、アーキテクチャの問題です。マルチテナントの分離は、すべてユーザーの所属企業に依存しています。企業を持たない主体では分離スコープが機能しなくなり、そのトークンでの誤ったクエリ 1 つで、自分のものではないデータを読めてしまいます。2 つ目の理由は監査です。台帳のユーザー列は「誰がこれを実行したか」を人に結びつけますが、サービスアカウントはその列を無意味にし、請求書を発行する連携から責任者をなくしてしまいます。3 つ目は失効です。トークンが人に属していれば、その人が去ったときに連携は止まります。持ち主のいないブリッジこそ、何年も黙って書き込み続けるブリッジなのです。

• 実際には、企業はパネルで通常のユーザー（たとえば、特定の従業員が責任を持つ「ERP Bridge」）を作成し、狭いロールを与え、そのユーザーのセッションでトークンを発行して ERP に設定します。
• そのユーザーは権限システムで確認でき、権限を絞ることができ、そのトークンだけを個別に失効させることもできます。禁止されているのはアカウントの作成ではなく、テナントに紐づかないアカウントの作成です。
• トークン 1 つにつき連携 1 つ。2 つのシステムがトークンを共有すると、失効の粒度が失われます。CRM を切り離すと、ERP も切り離すことになります。

ERP・CRM 連携 — バージョニングと非推奨化

カタログのレスポンスには整数の contract_version が含まれ、コマンドの各行には since、deprecated_at、replaced_by が含まれます。コントラクトバージョンが上がるのは、互換性を壊す変更のときだけです。

• バージョンが上がら「ない」もの：新しいコマンド、新しい任意パラメータ、レスポンスの新しいフィールド。利用側は知らないフィールドを無視しなければなりません。未知のフィールドでエラーになるクライアントは仕様に準拠していません。
• バージョンが「上がる」もの：コマンドの削除または名前変更、レスポンスフィールドの削除、任意パラメータの必須化、enum の縮小。古い形式は deprecated_at と replaced_by を伴って、少なくとも暦の上で 2 四半期（6 か月）存続します。
• 非推奨化は変更履歴だけでなく、カタログで告知されます。クライアントはカタログから自身を組み立てるため、deprecated_at が設定されたコマンドは、クライアントの新リリースなしに警告を表示し、連携担当者はそれをログで確認できます。
• API 名は永久に凍結されています。CLI 識別子（domain/verb）は告知前なら自由に組み直せましたが、告知後はバージョンの引き上げと移行期間を伴う場合にのみ変更され、その期間中は古い組がエイリアスとして提供されます。
• 実際には、カタログのレスポンスと X-Contract-Version ヘッダーがバージョンを運び、コマンドの各行には since、deprecated_at、replaced_by、aliases（古い domain/verb の組）が含まれます。非推奨のコマンドも引き続き呼び出すことができ、X-Deprecated: name; deprecated_at=…; replaced_by=… ヘッダーと、ボディ内の deprecated オブジェクトで応答します。カタログの ?domain= は、古いエイリアスのドメインを現在のコマンドに解決します。
• バージョン 1 を理解するクライアントがより大きな数値に出会った場合は、警告をログに記録して処理を続けるべきです。lg はまさにそうしています。現在有効な廃止予定は、上の「安定性の約束」に掲載しています。

ERP・CRM 連携 — 安定した識別子：自動採番 id を ERP にキーとして渡さない

内部の自動採番 id は不透明で、テナントにスコープされています。別の企業の有効な id を指定しても、データではなく「見つかりません」が返ります。しかし、不透明であることは業務キーであることを意味しません。ERP が自分のレコードに保存するものは、業務キーでなければなりません。

• 貨物：code（顧客コード、例：FSK2158）。loads get はすでに code で動作します。
• 国：ISO 3166-1 alpha-2。countries search がそのコードを返します。
• HS／関税率：コードそのもの。品目分類はすでに国際的に共通です。
• 請求書：発行後の請求書番号。下書きには画面上の id しかなく、下書きの id は業務キーでは「ありません」。ERP は自社の参照番号を持ち、下書きの id を決して永続化しないでください。
• 製品、倉庫、取引先：現在は画面上の id のみです。新しいコマンドのルールは明確です。画面上の id を返すコマンドは、ERP 側で照合できるよう、テナント自身の業務キー（SKU、コード、税番号）も返します。

ERP・CRM 連携 — ページネーション、フィルタリング、増分同期

一覧コマンドは limit を受け取り、count を返します。夜間同期のために、コントラクトは以下を約束しています。これを採用した一覧コマンドは JSON Schema で cursor と updated_since を公開します。そうなるまでは、小さなウィンドウとして扱ってください（上限 20 行、カーソルなし）。

• リクエスト：limit（1 からコマンドごとの上限まで）と cursor（不透明、前進のみ、サーバーによる署名付き）。offset は使い「ません」。稼働中のテーブルでは offset がずれます。2 つのページの間に挿入されたレコードのせいで、ERP は行を読み飛ばしたり二重に数えたりし、しかもそれは黙って起こります。
• レスポンス：{ count, total?, next_cursor|null }。count はこのレスポンスの行数で、next_cursor が null なら一覧は完結しています。next_cursor は変更せずにそのまま返してください。これはページ番号ではなく、あなたが組み立てるものでもありません。
• 改ざんされたカーソルや他者のカーソルは 422 invalid_request で拒否されます。カーソルはそれを受け取った企業に紐づいており、別テナントのデータをページングすることはできません。
• フィルタリング：JSON Schema の名前付きパラメータを AND で組み合わせます。自由なクエリ言語はありません。DSL があれば、守らなければならない 2 つ目のクエリの窓口になってしまうからです。
• 増分同期：updated_since（ISO-8601、UTC）とカーソル。これまでに見た最新の updated_at を保存し、次回の実行時に渡してください。これがなければ、どの ERP も毎時すべてを再取得することになります。
• 外部参照：書き込みコマンドは external_ref（自社の伝票キー）を受け付け、これは企業ごとに一意です。同じ external_ref で 2 回目の作成を行うと、重複して作られるのではなく拒否されます。list/get はこれを返すため、自分の側でレコードを照合できます。

ERP・CRM 連携 — レート制限

制限のキーは IP ではなくトークンです。ERP は単一の NAT の背後からアクセスしてくるため、IP ベースの制限では企業全体が 1 人のユーザーとして数えられてしまいます。2 つのキーを持つ 2 つの連携が、互いの割り当てを食い合うことはありません。これが「キー 1 つにつき連携 1 つ」の 2 つ目の理由です。

• 認証不要のディスカバリー（public/cli/catalog）：毎分 30 回。これは辞書であってデータソースではありません。ブリッジを書くときに一度読むだけにし、本番のループの中では決して読まないでください。
• カタログエンドポイント（GET common/commands、GET common/commands/{name}）：トークンごとに毎分 120 回。カタログはめったに変わらず、If-None-Match には 304 で応答します。コマンドのたびに再取得しないでください。lg はカタログを 1 時間キャッシュします。
• 読み取りコマンド（read_only: true の POST common/commands/{name}）：トークンごとに毎分 120 回。
• 書き込みコマンド（read_only: false の POST common/commands/{name}。未知の名前もここに数えられます）：トークンごとに毎分 30 回。書き込みには副作用があり、暴走したループには課金が発生します。
• クレジットを消費するコマンド（カタログ行の credit_cost がゼロでないもの。たとえば tariffs inquiry や export-documents generate）：実際の制限はリクエスト数ではなく「クレジット」です。200 のレスポンスでもクレジットを消費している場合があります。
• 企業ごとの 1 日あたりの上限（パネルと共有）：社外の人にメールやプッシュを送るコマンドは 1 日 300 件の外部通知枠を、有料のコンテナ追跡や船舶追跡の開始は 1 日 100 件の枠を消費します。上限を超えると、コマンドは retry_after 付きで DAILY_LIMIT_REACHED を返します。ファイルアップロードには独自の上限があります（「ファイルを受け取るコマンド」を参照）。
• 429 には常に Retry-After と、ボディ { error_code: "rate_limited", retry_after, limit, bucket } が付きます。固定の待ち時間を自分で決めるのではなく、これに従ってください。カタログは現在の数値を rate_limits の下で公開しています。

ERP・CRM 連携 — 私たちがやらないこと

これはしばしば、コントラクトの中で最も役に立つ部分です。決して実現しないものがわかっていれば、それを前提に設計できます。

• サービスアカウントも、テナントに紐づかない主体も作りません。
• API やチャットを通じて決済、カード番号、法的同意を扱うことはありません。これらのステップは本人のブラウザに残り、コマンドはそのリンクを渡します。
• 2 つ目の経路はありません。データベースへの直接アクセスも、シェルアクセスも、単一の適用ポイントを迂回する一括エンドポイントもありません。ロールゲート、確認ゲート、冪等性、監査台帳は、そこでのみ適用されます。
• エラーメッセージのテキストによる分岐はサポートしません。テキストはローカライズされ、予告なく変わります。
• offset によるページネーションはありません。
• 画面上の id を ERP の業務キーとして使うことはサポートしません。
• 送信 Webhook をこのコントラクトに押し込むことはしません。ただし、Webhook は現在「存在し」、このページ（上の Webhook のセクション）で説明しています。カタログはプル型の窓口であり、イベントストリームは「別の」コントラクトです。イベント名とペイロードのスキーマは独自のルールでバージョン管理され、コマンドカタログのコントラクトバージョンには結びついていません。

機械可読なカタログ

このページは人間向けに書かれています。AI アシスタントや自動化されたクライアント向けには、同じ情報が、構造化された認証不要のコピーとして存在します。

GET /api/public/cli/catalog は認証不要で、コマンドの公開識別情報を返します：凍結された API 名、CLI の domain/verb 識別子、説明、JSON Schema パラメータ、read_only、confirmation_needed、irreversible の各フラグ、credit_cost、そしてアクセス関連のフィールド key_level、permission、file_params、secret_parameters、cli_only です。個人データ、テナントデータ、サンプルレコードは一切返しません。返すのは、窓口がどういうものかだけです。

外部エージェントの正しい使い方：カタログを読み、どの作業が可能かを「自分の言葉で」説明し、実行が必要になったら、ユーザー自身の環境でユーザー自身のトークンを使って実行するよう案内します。エージェントがユーザーのトークンを求めたり、生成したり、中継したりすることは決してありません。

会員登録や輸送依頼のために Logistivo を AI アシスタントに接続するのは別のチャネルで、専用のページがあります：

• カタログは認証不要ですが、実行はそうではありません。エージェントの名義でコマンドを実行する方法はありません。実行されるのは常にユーザー自身の ID です。
• Logistivo のパスワード、認証コード、アクセストークンがチャットを通ることは決してありません。それらを求めたり、生成したり、中継したりするフローを作らないでください。
• コマンドが取り消せないかどうかはカタログに書かれています。irreversible: true のコマンドで「試してみましょう」と提案しないでください。
• credit_cost がゼロでないコマンド（たとえば tariffs inquiry や export-documents generate）は金銭的な結果を伴います。自動化されたループの中で呼び出さないでください。
• 決済、カード番号、法的同意がチャットやエージェントを通ることは決してありません。代わりに handoff-links generate のリンクを提示し、本人が自分のブラウザでステップを完了します。
• ユーザーのキーで動作するエージェントは、最初に users get を呼び出すべきです。ロール、キーのアクセスレベル、実効権限、そして保留中の同意や電話番号認証が書き込みを妨げていないかを返します。拒否を集めるのではなく、予測してください。
• このページのプレーンテキスト版は /cli.md にあります。HTML よりも markdown のほうが確実にパースできる場合はこちらを使ってください。

機械可読な定義：OpenAPI 3.1 と Postman

上のカタログは Logistivo 独自の形式です。同じ情報は、お使いのツールがすでに理解できる 2 つの業界標準形式でも公開しています：OpenAPI 3.1 の定義と Postman コレクションです。どちらも手書きではなく、リクエストのたびにライブのコマンドレジストリから生成されるため、古くなることはありません。

定義はカタログ「そのもの」であり、2 つ目の現実ではありません。すべてのコマンドは POST /api/common/commands/ オペレーションとして現れます。ボディのスキーマはそのコマンド自身の JSON Schema（アシスタントが見るものとバイト単位で同一）、レスポンスのスキーマは共通のエンベロープで、ゲートフラグ（read_only、confirmation_needed、irreversible とクレジットバッジ）は x-logistivo 拡張に、業務エラーキーは x-error-keys の下にあります。廃止予定のコマンドには deprecated: true が付き、6 か月の猶予期間中は呼び出し可能なままです。

コマンドの窓口に加えて、連携コントラクトを担う REST エンドポイントも定義に含まれています：増分同期（updated_since + cursor + limit）に対応した 10 個の一覧エンドポイントと、自社のキー（external_ref）を受け付ける 7 個の書き込みエンドポイントです。Logistivo の REST の窓口はそれよりはるかに大きいのですが、残りは「意図的に」除外しています。それらのペイロードは製品自身のコントラクトであり、推測で書いたスキーマは、生成したクライアントを最初の呼び出しで壊してしまいます。そしてあなたは、こちらではなく自分のコードの中にバグを探すことになるでしょう。

定義は、要求した人の「ロール」に合わせて生成されます。別のロールのコマンドがドキュメントに入ることはありません。定義は辞書ではなくコントラクトであり、その中のすべてがそのトークンで呼び出せなければならないからです。認証不要版は 3 つのロールの和集合で、そこでは各オペレーションがどのロールに表示されるかを x-logistivo.roles に記載しています。

私たちの言葉をうのみにせず、検証してください：npx @redocly/cli lint logistivo-openapi.json は警告ゼロで通ります。

• GET /api/common/spec/openapi.json — 自分のトークンのロール向けの OpenAPI 3.1 定義。ETag が付いており、If-None-Match には 304 が返るため、ビルドのたびに再ダウンロードすることはありません。
• GET /api/common/spec/postman.json — 同じ範囲を Postman v2.1 コレクションとして提供します。base_url と token の変数があり、フォルダーはコマンドのドメインごとにグループ化済みです。
• GET /api/public/cli/openapi.json — 認証不要版で、3 つのロールの和集合です。トークンを入手する前に、ブリッジを設計し、コストを見積もるためのものです。
• GET /api/public/cli/postman.json — 認証不要の Postman コレクション。チームにそのまま渡せる 1 つのファイルです。
• 559 個のオペレーション — 519 個のコマンド + 36 個の REST およびコントロールプレーンのオペレーション + 4 個のカタログ・ID エンドポイント。このページの数値は手入力ではなく、リクエストのたびにライブのドキュメントから数えられています。そのため、コマンドがリリースされた日にはここの数値も増え、合計も一致します。
• セキュリティスキーム — bearerAuth：実在するユーザーに対して発行された Passport トークン。read スコープのキーが呼び出せるのは、x-logistivo.read_only: true のフラグが付いたオペレーションだけです。書き込みを試みると確認ゲートの「前に」 403 が返るため、読み取り専用のキーが 409 を目にすることはありません。
• すべてのエラー分岐が明記されている — 各オペレーションは 401/403/404/409/422/429/500 を個別に記述しています。409 の 2 つの意味（確認が必要／冪等性の衝突）と 422 の 2 つの意味（スキーマエラー／業務上の拒否）はドキュメント内で区別されているため、ジェネレーターがそれらを 1 つの分岐にまとめてしまうことはありません。
• タイムスタンプなし — ドキュメントには生成時刻が含まれません。同じカタログからは同じバイト列が生成されるため、ETag が実際に機能し、バージョン管理にコミットした定義がダウンロードのたびに「変更あり」に見えることもありません。
• 製品のペイロードをでっち上げていない — REST の書き込みエンドポイントでは、コントラクトのフィールド（external_ref）だけを記述しています。ボディの残りは additionalProperties: true として開いたままにし、読み手には製品ドキュメントを案内しています。不完全でも正しい定義は、完全でもでっち上げた定義に勝ります。
• オペレーションごとのエラーキー一覧は網羅的では「ない」 — x-error-keys には、コマンド自身のレコードから確実に導かれるキーだけを列挙し、x-error-keys-exhaustive: false でそのことを明示しています。完全な辞書はドキュメントのルートにあります。認識できないキーは一般的な失敗として扱ってください。でっち上げた「完全な一覧」があれば、default 分岐を書かないように仕向けてしまったでしょう。
• ディスカバリー用ツールは定義に含まれない — search_commands、run_command、list_capabilities はチャットのループ内にのみ存在し、HTTP では呼び出せません。もし含めていたら、ジェネレーターは決して動かない 3 つのメソッドを書いていたでしょう。

コード生成：定義から型付きクライアントを

定義は手に入りました。次はそこから動作するコードを生成しましょう。`lg codegen` は OpenAPI ドキュメントを読み込み、依存関係のない単一ファイルのクライアントを書き出します。TypeScript（型宣言と薄い呼び出しラッパー）または PHP（PHPDoc の array shape を備えたクライアントクラス）です。`npm install` も composer も不要です。TypeScript 側は `fetch`、PHP 側は `ext-curl` を使います。

生成はこちらのサーバーではなく、「あなたの」マシンで行われます。これは好みの問題ではありません。定義を一度リポジトリに固定すれば（`lg spec --out=...`）、同じコマンドがビルドのたびにネットワークもトークンもなしで実行されるため、CI がこちらの稼働状況に依存することはありません。さらに、生成されたコードはあなたの ERP の中で「動く」コードなので、API から取得するのではなくリポジトリに置いておけば、すべての変更が `git diff` に現れます。

生成されたクライアントは Logistivo の 3 つの経路（レール）をすべて正しく扱い、どれがどれかを推測ではなくドキュメントから知ります。すべてのオペレーションは `x-logistivo.surface` で自身の経路を宣言しています。コマンドの経路では `{success, data:{…}}` エンベロープを取り外します。REST の同期一覧はエンベロープに包まれて「おらず」、そのまま返されます（取り外すと `next_cursor` が失われます）。REST の書き込みは、そのエンドポイント自身の製品ボディを返します。汎用のジェネレーターはこの区別を知りませんが、私たちのジェネレーターは知っています。

型は推測ではありません。各コマンドの引数インターフェースは、アシスタントが見るのとまったく同じ JSON Schema から生成されます。必須は必須のまま、enum はユニオン型に、ネストしたオブジェクトはネストした型になります。実際には、サーバーが必須とするフィールドを書き忘れた呼び出しは、本番環境で 422 で失敗するのではなく、コンパイル時に失敗します。

ファイルには生成時刻を書き込みません。同じ定義と同じフラグからは同じバイト列が生成されます。そのため再生成しても `git diff` にノイズは出ず、本当に変わったただ 1 つのもの、つまりコントラクトが見えるままになります。

• 1. 定義を固定する — 定義は自分のロール向けに生成され、その中のすべてのオペレーションはそのトークンで呼び出せます。ファイルをコミットしてください。 lg login --api-key= lg spec --out=logistivo-openapi.json
• 2. クライアントを生成する — 1 つのファイルが出力され、固定した定義内の「すべての」オペレーションがメソッドとして含まれます：自分のロールで呼び出せるコマンド、連携コントラクトを担う REST エンドポイント、そしてディスカバリー用エンドポイントです。数はプラットフォーム全体ではなく「あなたの」ロールのものです。現在、荷主のキーでは 448 個、運送会社では 452 個、通関業者では 312 個のコマンドメソッドが生成されます。認証不要の公開定義から生成した場合、上限は 559 個のオペレーションです。 lg codegen ts --from=logistivo-openapi.json --out=logistivo-client.ts lg codegen php --from=logistivo-openapi.json --out=LogistivoClient.php --namespace="Acme\\Logistivo" # or straight from the server, without downloading first: lg codegen ts --out=logistivo-client.ts
• 3. 検証してから使う — 生成されたコードがコンパイルできない場合、その責任はあなたではなく私たちにあります。定義の整合性は、サーバー上で実行可能なチェックによって守られています。 npx tsc --noEmit --strict --target ES2022 --module ESNext --moduleResolution bundler logistivo-client.ts php -l LogistivoClient.php
• オペレーションごとに 1 つのメソッド — ドキュメント内のすべてのコマンド、連携コントラクトを担うすべての REST エンドポイント、そしてディスカバリー用エンドポイントです。自分のロールの定義から生成すれば、呼び出せるものだけが得られます（荷主なら 448 個のコマンド）。公開定義から生成すれば、559 個のオペレーションすべてが得られます。サーバーでコマンドが追加された日に再生成すれば、それも取り込まれます。クライアントのリリースを待つ必要はありません。
• 引数の型 — 各コマンドの `args` スキーマはインターフェース（PHP では array shape）になります。必須フィールドは必須のまま、enum はユニオン型になります。TypeScript では必須フィールドの書き忘れはコンパイルエラーになり、PHP では IDE と PHPStan が同じ形を認識します。
• エラークラス — トランスポートの分類（`error_code`）と業務の分類（`error_key`）は別々のフィールドで、確認ゲートとレート制限は別々のエラー型です。エラーキーのユニオン型は未知の値にも開かれているため、サーバーが新しいキーを宣言してもコードがコンパイルできなくなることはなく、`default` 分岐に入ります。
• 正しい再試行ポリシー — 自動再試行は安全な呼び出し、つまり読み取りと、冪等キーを付けた書き込みにのみ適用されます。キーのない書き込みがタイムアウトしても「何も書き込まれなかった」とは限らないため、クライアントがそれを闇雲に繰り返すことはありません。429 の場合は、待ち時間を自分で決めるのではなく、サーバーの `Retry-After` に従って待機します。
• 結果のボディには型を付けていない — コマンドの結果は `unknown`（PHP では `mixed`）として返ります。理由は定義そのものと同じで、結果の形はコマンドの業務上の出力であり、コントラクトの一部ではないからです。推測した結果型は、フィールドが初めて移動した時点で嘘をつき始めるでしょう。
• 生成されたファイルは手で編集しない — それはソースではなく出力です。追加の振る舞いが必要なら、生成されたクラスをラップしてください。その中に書いたものは、次の生成で失われます。
• ディスカバリー用ツールは生成されない — `search_commands`、`run_command`、`list_capabilities` はチャットのループ内にのみ存在し、HTTP では呼び出せません。定義に含まれていないため、クライアントにも含まれません。含めていたら、決して動かない 3 つのメソッドを書くことになっていたでしょう。

正直な適用範囲

このセクションは縮めるよりも、むしろ増やしていきたいと考えています。連携コントラクトの価値は、何を約束するかよりも、何を約束しないかをどれだけ明確に述べるかにあります。

• CLI はテナントユーザーのコンテキストで動作する — すべてのコマンドは、提示されたトークンのユーザーの企業とロールのもとで実行されます。プラットフォーム運営者モード（企業をまたいで読み取る管理モード）はこの窓口の範囲外であり、ここから開放されることはありません。
• コマンド一覧はロールによって異なる — 荷主アカウントには 448 個、運送会社には 452 個、通関業者には 312 個、アフィリエイトには 55 個のコマンドが表示されます。カタログにコマンドが見当たらない場合は、まずロールを確認してください。掲載されているのに拒否される場合は、キーのスコープとアクセスレベルを確認してください。ドライバーアカウントは、この窓口に一切アクセスできません。
• クレジットを消費するコマンドがある — 関税率の照会、書類の生成、その他いくつかの AI を利用するコマンドは、プランのクレジット残高を消費します。カタログの各行には credit_cost {mode, credits} が含まれます。fixed は 1 回の呼び出しごとの正確な消費量、read_only は消費なし、computed は消費量が呼び出し内容によって決まることを意味します。その場合 credits は null となり、実際の数値は確認カードに表示されます。プリフライト（dry_run）で、1 回の呼び出しでどれだけ消費するか、残高で足りるかを確認できます。
• 連携キーではダッシュボードのチャットを操作できない — ダッシュボード内の AI アシスタントは人間のためのものです。連携キーでアシスタントの実行を開始または継続しようとすると、403 で拒否されます。エージェントはコマンドエンドポイント、lg、または MCP チャネルを使います。そこではすべてのコマンドがキーのアクセスレベルで実行され、その書き込みは連携による書き込みとして記録されます。
• カタログは既存の REST API を置き換えない — Logistivo の Web アプリとモバイルアプリを支える REST の窓口はそのまま残り、引き続き後方互換性のルールのもとにあります。コマンドカタログはリソースの CRUD を置き換えるものではなく、「動詞」の層、つまり何かを行うための唯一の監査された方法です。
• 一覧コマンドは現在、小さなウィンドウを返す — 一覧コマンドがスキーマで cursor と updated_since を公開するまでは、上限は 20 行で、カーソルはありません。データの完全なコピーを取り出すための設計ではありません。増分同期はコマンドごとに順次展開中です。

よくある質問

Logistivo CLI は何に使うのですか？

Logistivo アカウントの業務を、ターミナル、スクリプト、または自社の AI エージェントから実行します：貨物と運行、輸送依頼、見積もりと入札、車両、ドライバーとその経費、書類、取引先と取引先元帳、請求書と会計、倉庫と在庫、チームメンバー、HS 関税率とアンチダンピング関税。パネルのすべての書き込み操作にコマンドがあり、決済、法的同意、アカウントの閉鎖は意図的にブラウザに残しています。同じコマンドは、ERP/CRM 連携のために HTTP で、また MCP チャネルからも呼び出せます。

Logistivo CLI のコマンドはどのように命名されていますか？

形は lg --parameter=value です。ドメインは複数形のエンティティ（loads、demands、invoices、export-documents）で、動詞は意図的な判断によってのみ増える閉じた語彙（list、get、create、update、search、set-status、generate など）から選ばれます。1 つのエンティティの動詞はすべて 1 つのドメインにあり、（domain, verb）の組はカタログ全体で一意です。

CLI ではどのように認証しますか？

対話的に使う場合は、lg login が承認コードを表示し、Logistivo にサインインしたあと、ブラウザでそのコードを確認して承認します。ターミナルにパスワードやキーを入力することはなく、セッションは lg logout を実行するまでサインインしたまま維持され、自動で更新されます。lg login --password（メールアドレスとパスワード）は代替手段として引き続き使えます。サーバーや CI では、パネルまたは lg keys create で発行した連携キーを使います。lg login --api-key でローカルのプロファイルに保存するか、LOGISTIVO_TOKEN 環境変数に設定してください。HTTP では、トークンは Authorization: Bearer ヘッダーで送られます。

ERP 連携用にサービスアカウントを作成できますか？

いいえ。連携は、パネルで作成した実在の企業ユーザーのトークンで接続します。企業を持たない合成の主体は、マルチテナントの分離を機能させなくし、監査台帳の「誰がこれを実行したか」の列を無意味にし、持ち主が去っても止まらないブリッジを残してしまいます。正しいパターンは、狭いロールと責任者が明確な専用ユーザーです。

Logistivo にはテスト（サンドボックス）環境がありますか？

はい。セルフサービスで利用できます。自社用に独立したサンドボックステナントが開設されます。コードもコマンドカタログも同じで、クレジット台帳は独自のものです。環境はキーの所属企業から導出され、リクエストで指定することはできません。誤ったプロファイルで行った呼び出しは、サーバー側で 403 ENVIRONMENT_MISMATCH となって停止します。サンドボックスで作成した輸送依頼が実在の運送会社に届くことはなく、サンドボックスのイベントが本番の Webhook 購読に配信されることもなく、本番の残高も動きません。エンドポイント：POST /api/common/integration-sandbox （開設）、POST /api/common/integration-sandbox/keys （キー）、GET /api/common/integration-sandbox/go-live （本番移行チェックリスト）。lg 側では、lg --sandbox と lg --live が 1 回の実行ごとのプロファイル選択子です。

スクリプトで lg --json の出力を読むにはどうすればよいですか？

出力は HTTP エンベロープ全体です：{ "success": bool, "data": { "contract_version", "command", "status", "result" }, "code", "message" }。業務ペイロードは .data.result の下にあります。一覧コマンドでは行が .data.result.、件数が .data.result.count、次のページが .data.result.next_cursor です。したがって正しい jq パスは lg loads list --json | jq -r '.data.result.loads[].load_code' のようになります。エンベロープを飛ばしたパスはエラーにならず、黙って null を返します。監視スクリプトでは、それが鳴りやまないアラームになります。唯一の例外は /api/public/status で、そのボディは意図的にエンベロープを持ちません。

同じリクエストを 2 回送ると、レコードが重複しますか？

idempotency_key を送っていれば重複しません。同じキーでの 2 回目の呼び出しはコマンドを再実行せず、最初の結果を status replayed で返します。キーは UUID にすべきで、再試行の間は「同じ」でなければなりません。試行ごとに新しいキーを生成するのは、冪等性を使わないのと同じです。

--yes は何をしますか？

確認ゲートを通過させます。ゲート付きのコマンドを --yes なしで呼び出しても何も変わりません。サーバーはこれから行う内容を 1 文で要約し、取り消せないかどうかを伝えて停止します（HTTP 409、CLI 終了コード 4）。--yes を付けてコマンドを繰り返すと、処理が実行されます。

スクリプトでコマンドの失敗を検出するにはどうすればよいですか？

メッセージのテキストではなく、終了コードを読んでください：0 は成功、1 は業務ルールによる拒否、2 はコマンドまたは引数のエラー、3 は認証またはロールのエラー、4 は確認が必要。HTTP で対応するものは 200、422、404、403、409 で、ボディ内の error_code フィールドは安定しています。エラーの「メッセージ」はローカライズされ、予告なく変わります。

利用可能なコマンドをプログラムから調べるにはどうすればよいですか？

認証不要のディスカバリーには GET /api/public/cli/catalog を、自分のアカウントで実際に見られる一覧には GET /api/common/commands を使います。どちらも各コマンドの JSON Schema パラメータを返します。コマンド一覧をハードコードせず、これらからクライアントを組み立ててください。

新しいコマンドが追加されたら、クライアントを更新する必要がありますか？

いいえ。クライアントはコマンド一覧をカタログから取得するため、サーバーで追加されたコマンドは、クライアントの新しいリリースなしに現れます。更新が必要なのは、コントラクトバージョンを上げる互換性のない変更の場合だけで、その場合も古い形式は少なくとも 6 か月間存続します。

CLI は既存の REST API を置き換えますか？

いいえ。Web アプリとモバイルアプリを支える REST の窓口はそのまま残ります。コマンドカタログはリソースの CRUD を置き換えるものではなく、「動詞」の層、つまりロールゲートと確認ゲートを備え、監査される、操作を実行するための唯一の方法です。

Logistivo の API キーはどうやって取得し、何ができますか？

チーム管理権限を持つマネージャーが、パネルの Settings › Integration keys で、またはターミナルから lg keys create で発行します。キーは実在するチームメンバーの代理として動作し、3 つの独立した設定を持ちます：スコープ（read はカタログと書き込みを伴わないコマンドを、write はすべてのコマンドを開放します。確認ゲートはそのまま残ります）、任意のドメイン許可、そしてアクセスレベル（日常業務向けのデフォルトである employee、またはチーム・設定・キー・お金に関わる操作向けの manager）です。キーは一度だけ表示され、サーバーには保存されません。ローテーション、移譲、失効が可能です。代理対象のメンバーが去ると、キーも閉じられます。サービスアカウントはありません。

冪等キーを別のコマンドで再利用するとどうなりますか？

サーバーは 409 idempotency_conflict で応答し、そのキーが最初に使われたコマンドを示します。何も実行されず、何もリプレイされません。キーは自社にスコープされ、1 つのコマンドに紐づき、24 時間ロックされます。その後は、同じキーで新しい実行が始まります。

連携にはどのようにレート制限が適用されますか？

トークンごと、毎分、3 つのバケットで適用されます：カタログの読み取り 120 回、読み取りコマンド 120 回、書き込みコマンド 30 回。429 には常に Retry-After と、retry_after、limit、bucket を含むボディが付きます。その時間だけ待ってから再試行してください。カタログは現在の数値を rate_limits の下で公開しています。

業務上の拒否とトランスポートエラーはどう見分けますか？

まず error_code で分岐します。failed（422）は業務上の拒否で、INSUFFICIENT_CREDITS や NOT_FOUND といった安定した error_key が付きます。server_error（5xx）とネットワークエラーは同じ冪等キーで再試行します。rate_limited（429）は待機してやり過ごします。エラーのテキストで分岐してはいけません。

Logistivo は Webhook を送信しますか？どのイベントについてですか？

はい。https のアドレスを登録し、関心のあるイベントを選ぶと、それが起きたときに署名付きの POST が届きます。現在購読できるイベントは 13 種類です：貨物の作成／ステータス変更／ドライバー割り当て、輸送依頼の作成とステータス変更、見積もりの提出／修正／承認、請求書の下書き／発行／取り消し、倉庫予約の作成／ステータス変更。すべての名前は、実際にディスパッチされるイベントクラスに裏付けられています。告知したのに一度も発火しないものはありません。そのようなイベントは、連携担当者が永遠に待ち続ける、気づかれない失敗だからです。購読は Settings › Integration › Webhooks で、またはターミナルから lg webhooks create で作成します。

Logistivo から届く Webhook の署名は、どのように検証すればよいですか？

すべてのリクエストに X-Logistivo-Signature ヘッダーが付きます：t=,v1=。署名対象の文字列は "."、アルゴリズムは HMAC-SHA256、鍵は購読のシークレットです。ルールは 4 つあります。(1)「生の」バイト列を検証する：ボディをデコードして再シリアライズする（JSON.stringify / json_encode）と、同じデータが異なるバイト列になり、署名が一致しなくなります。これが最もよくある間違いです。(2) タイムスタンプを確認し、署名が正しくても |now − t| > 300 秒のものは破棄する。(3) hash_equals / timingSafeEqual で定数時間比較する。(4) 重複排除は配信 id ではなく event_id で行う：event_id はリプレイ時にも保持されますが、配信 id は変わります。動作する Node と PHP の受信側はリポジトリの examples/webhook-receiver/ にあり、--selftest で自己テストします。

Webhook を配信できなかった場合はどうなりますか？イベントは失われますか？

失われません。受信側が 2xx を返さない場合、配信は再試行スケジュールに入ります：60 · 300 · 1800 · 7200 · 21600 秒、合計 6 回の試行、期間はおよそ 8.6 時間です。410 Gone を除く「すべての」失敗は、4xx も含めて再試行されます。業務イベントを失う損失は、数回の余分なリクエストよりも大きいからです。再試行を使い切った配信が 10 回連続すると購読はミュートされ、その理由が記録されるため、「なぜ何も届かないのか」に答えられる状態が保たれます。配信台帳はすべての試行（ステータスコード、所要時間、エラー）を保持し、パネルまたは lg webhooks replay で 1 件の配信を再送できます。増分同期（updated_since + cursor）も引き続きセーフティネットとして使えます。

自社の AI エージェントは、ユーザーがパネルでできることをすべて行えますか？

ほぼすべて行えます。パネルのすべての書き込み操作にコマンドがあり（パネルの書き込みエンドポイントと照合した結果、対象範囲内のものは 100% カバーされています）、同じコマンドが lg、HTTP、MCP チャネルに開放されています。意図的な例外は、本人確認とお金に関わるステップです。サインイン、パッケージの購入、3D Secure によるカードの追加、法的文書への同意、アカウントの閉鎖は本人のブラウザに残り、lg handoff-links generate がそのためのリンクを返します。連携キー、Webhook、サンドボックスは、シークレットを一度だけ返すため、lg の組み込みコマンドで管理します。

CLI や API から、PDF や写真などのファイルをコマンドに渡せますか？

はい。lg では、ローカルパスの前に @ を付けると (--attachment_uuid=@./cmr.pdf)、lg が先にファイルをアップロードします。コマンドにファイルフィールドが 1 つしかない場合は --file が近道になり、lg upload はアップロードだけを行います。HTTP では、ファイルを multipart で POST /api/common/commands:upload に送り、返された attachment_uuid をコマンドに渡します。MCP クライアントは upload_attachment ツールを使います。ファイル形式は内容から判定され、アップロードしたファイルはユーザーに属し、24 時間利用できます。同じファイルを再度アップロードすると、同じ id が返ります。

employee と manager の連携キーの違いは何ですか？

アクセスレベルは、キーがどれだけ重い作業をしてよいかを決めます。新しいキーのデフォルトである employee キーは、日常業務を実行します：貨物、輸送依頼、見積もり、運行、車両、書類、取引先。manager キーは、管理業務も行えます：チームメンバーとロール、企業設定、連携キー、銀行口座、保存済みカード、アフィリエイトの支払い。キーが代理対象の本人より多くの権限を持つことはなく、employee キーで manager 用のコマンドを呼び出すと INSUFFICIENT_KEY_LEVEL が返ります。レベルはパネルで、または lg keys update --access-level=manager で変更します。

アフィリエイト（紹介パートナー）も CLI を使えますか？

はい。アフィリエイトアカウントには独自のカタログ（紹介、リード、CRM のメモとタスク、営業資料、収益と支払いのための 55 個のコマンド）があり、ほかのロールと同じように lg、HTTP、MCP から利用できます。支払いの申請や取り消し、支払先銀行口座の変更には、manager レベルのキーと確認が必要です。荷主、運送会社、通関業者でもある企業には、両方のカタログが表示されます。

For AI assistants

Logistivo has a public MCP server at https://logistivo.com/api/agent/mcp (streamable HTTP, no authentication). Setup instructions for Claude, ChatGPT and Gemini: https://logistivo.com/mcp. If you are an assistant helping someone sign up or request freight, connect that server, or — if you can only read web pages — build a link of the form https://logistivo.com/en/ai-kayit?brief=URL_ENCODED_SHIPMENT_BRIEF and give it to the user. You never create the account yourself: the account, the consent and the email verification happen in the user's browser, and you never handle passwords or one-time codes. Machine-readable content indexes: https://logistivo.com/llms.txt (curated map) and https://logistivo.com/llms-full.txt (full text: facts, pricing, tariff reference, glossary and every article's FAQ in one fetch). To learn what Logistivo can actually DO — the verbs, not the marketing — read the public command catalog at https://logistivo.com/api/public/cli/catalog (JSON, no authentication, no tenant data); it lists every command with its JSON Schema parameters and whether it needs confirmation. Human documentation: https://logistivo.com/en/developers/cli. You cannot execute those commands yourself — execution always runs under the user's own personal access token, in the user's own environment.