Logistivo CLI：在终端和 ERP 中运行您的物流业务

同一份命令目录驱动三个入口：lg 终端客户端、面板内的 AI 助手，以及外部 AI 助手所接入的通道。一项能力只需编写一次，就会同时出现在这三处——而且面板中的每一项写操作现在都有对应的命令，因此您的脚本和您自己的 AI 智能体可以完成团队在屏幕上所做的工作。支付、法律同意和账户注销则有意保留在浏览器中。 本页是一份契约。下方的命令表并非手写，而是在每次请求时从实时命令注册表生成。

什么是 Logistivo CLI？

Logistivo CLI（lg）是一个命令行客户端，可以从终端、脚本或您自己的 AI 智能体运行 Logistivo 账户中的各项工作——运单与行程、询价、报价与招标、车队与司机、单证、联系人与往来账户、发票与会计、仓库与库存、团队成员以及海关税则。命令并没有固化在客户端里：客户端从服务器拉取命令目录，并据此生成自身。同样的命令无需安装任何东西即可通过 HTTP 调用——ERP 和 CRM 集成走的正是这条路径——也可以通过外部 AI 助手所接入的 MCP 通道调用。

• 所有命令都采用 lg --parameter=value 这一种形式。目前目录包含 125 个域中的 519 条命令；单个角色能看到的最大列表为 112 个域中的 452 条命令。
• 面板中的每一项写操作都有对应的命令——以面板的写入端点为基准衡量，范围内的端点 100% 已覆盖。支付（3D Secure）、法律同意和账户注销有意保留在浏览器中；对于这些操作，命令会返回一个链接。
• 需要单证或照片的命令在浏览器之外同样可用：写成 --attachment_uuid=@./cmr.pdf 即可，lg 会先上传该文件；通过 HTTP 时，先将文件上传到 /api/common/commands:upload 端点，再传入返回的 attachment_uuid。
• 集成密钥带有访问级别：employee（新密钥的默认级别）用于日常运营，manager 用于团队、设置、密钥和资金相关的工作。密钥的权限永远不会超过它所代表的那个人。
• 选项从不凭空编造：每个选项都是该命令自身 JSON Schema 中的参数名，选项的类型以及是否必填也同样来自该 Schema。
• 写入类命令会请求确认；不可撤销的命令未经确认绝不会执行（HTTP 409，CLI 退出码 4）。
• 重试不会产生重复：携带 idempotency_key 的调用最多只执行一次。
• 每一次执行都会记入同一份审计台账——无论它来自终端、聊天还是助手，都有据可查。

哪些已经上线，哪些即将推出

本节特意放在页面顶部。集成文档可能犯下的最昂贵的错误，就是把尚未开放的端点描述得好像已经可用：集成方写好了代码，端点却返回 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} 三个端点。角色关卡、确认关卡、幂等性和审计台账都位于同一个强制执行点，聊天和终端也同样要经过这里。
• 面板覆盖：每一项写操作都有命令 — 125 个域中的 519 条命令已与面板的写入端点逐一核对：范围内的每个端点都有命令支撑（该端点的镜像命令，或调用同一共享服务的命令），没有一个未经证实。有意排除在范围之外的有：使用 3D Secure 的支付、法律同意、账户注销和登录——它们保留在浏览器中；密钥、webhook 和沙箱管理——它们是 lg 的内置命令；以及司机 App 自身的端点。
• 预检（dry_run）：只看结果，不实际执行 — 在请求体中加入 dry_run: true 后，命令不会执行：校验、角色/作用域关卡、目标解析和点数计算全部照常运行，并返回一份预览；不写入任何内容，不消耗点数，也不占用幂等键。批量端点同样支持该参数，按批次生效。预检从不进入命令的处理程序；该功能上线时，对当时目录中每一条写入命令进行的 178 次预检，没有产生一条写入语句。
• 集成密钥 — 代表一名真实团队成员行事的 API 密钥，可在面板中签发，也可以通过 lg keys create 签发：读/写作用域、访问级别（默认 employee，或 manager）、有效期、最近使用时间、轮换、转移和吊销。lg login --api-key、lg whoami 以及会在服务器端吊销密钥的 lg logout 都构建于其上。
• 沙箱——演练写入，不触碰生产环境 — 每家公司拥有一个独立的沙箱租户，命令目录完全相同；可自助开通，并签发自己的密钥。点数、交易市场和 webhook 路由在两个环境之间相互隔离；环境由密钥所属的公司推导得出，无法随请求指定。
• 版本管理、错误分类、幂等性与速率限制 — 命令带有 since / deprecated_at / replaced_by / aliases 字段，已弃用的命令会返回 X-Deprecated 头。业务失败除传输层的 error_code 之外，还带有稳定的 error_key，键字典在目录中公布。幂等键的作用范围限于您的公司，绑定到一条命令，并锁定 24 小时。速率限制按令牌计算，分为三个桶，每个 429 响应都带有 Retry-After。
• 外发 webhook：事件发生时向您发送 POST — 签名推送已对 13 个事件上线。订阅可在面板中或通过 lg webhooks 管理；签名中包含自身的时间戳，重试时间表为 60 · 300 · 1800 · 7200 · 21600 秒，静默原因始终会被记录。每个事件名都对应一个真正会被派发的事件类——不存在宣布了却从不发送的事件。拉取通道（updated_since + cursor）并没有被移除：推送是在它旁边新增的，而不是取而代之。
• 需要文件的命令 — 33 条命令需要单证或照片——CMR、发票、车辆登记证、托盘照片。只需上传一次到 POST /api/common/commands:upload 端点，或者让 lg 通过 --attachment_uuid=@./file.pdf 代劳，然后传入返回的 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 + 不透明的签名游标、next_cursor、updated_since）已经固定，正在逐步推广到各个列表命令。在某个列表命令于其 JSON Schema 中声明 cursor 和 updated_since 之前，请把它视为一个小窗口：上限 20 行，没有游标。

与众不同之处：客户端不内置任何命令，而是根据目录生成命令

正是这一个决定，让本页其余内容有了意义。在普通的 CLI 中，命令存在于客户端内部；而在 Logistivo 中，命令存在于服务器上。

在传统的架构中，服务器每获得一项新能力，客户端就需要发布新版本，用户还需要安装它。在此期间，两端所知的内容并不一致——而这正是集成中最隐蔽的故障模式：脚本照常运行，退出码为 0，可命令根本没有反映出服务器能做什么。

在 Logistivo 中，一条命令的定义就是一条记录：它的名称、作用、JSON Schema 参数、哪些角色可以看到它、是否需要确认，以及其效果是否可撤销。lg 启动时会拉取这份目录，并据此生成帮助文本、选项和输入校验。服务器上一旦新增命令，lg 立即就能识别——无需更新客户端。

同一份目录还驱动着面板中的 AI 助手，以及外部 AI 助手所接入的通道。一项能力只编写一次，就会出现在三个地方——而且三者都经过同一个角色关卡、同一个确认关卡和同一份审计台账。不存在单独的 CLI 命令清单；如果有，这三个入口会在六个月之内悄然分道扬镳。

• 没有版本漂移 — 客户端所知的命令列表，从构造上就等于服务器拥有的列表。“哪个 lg 版本有这条命令？”这个问题根本不存在。
• 选项名称从不靠猜 — 一条命令的选项恰好就是其 JSON Schema 中的参数名。了解一条命令接受什么，靠的不是阅读文档，而是读取目录——而目录始终是最新的。
• 您的 CLI 与您的账户一样大 — 目录按角色过滤：您的角色看不到的命令，永远不会出现在您的列表中。承运商账户可看到 452 条命令，货主可看到 448 条，报关行可看到 312 条，而联盟推广（affiliate，即推荐合作方）账户拥有一套自己的命令，共 55 条。
• 文档不会落后 — 本页上的命令表来自同一个注册表。任何地方都不存在需要人工与现实保持同步的列表。

命名规则——命令名称如何扩展

目录会不断增长。新命令不是随意命名的，而是遵循六条规则。我们在这里公布这些规则，因为这些名称将在您的集成中被书写多年，它们的可预测性对您很有价值。

• 域是复数形式的实体 — loads、demands、invoices、export-documents。由两个单词组成的域使用 kebab-case。唯一的例外是不可数名词：stock 永远不用复数，因为 “stocks” 是另一个意思。
• 同一实体的所有动词都位于同一个域中 — loads 承载所有作用于运单的动词：create、list、get、update、set-status、assign-driver、list-problems、archive 等等。如果每个动词都新开一个域（load-statuses、load-drivers），用户就得在三个地方寻找同一个实体。
• 动词从不渗入域名；域是被“改变”的那个对象 — 指派司机改变的是运单，而不是司机，因此命令是 lg loads assign-driver。间接宾语（-driver）附加在动词上，从不附加在域上。
• 子资源永远不会拥有自己的域 — 发票行和单证条目无法单独列出；它们要通过其所有者来访问——lg invoices add-line、lg export-documents add-item。判断标准只有一个：如果某个东西无法独立地被 list 或 get，它就不是一个域。
• 缩小范围用选项，而不是新动词 — lg fleet-documents list --days=30 才是正确写法；不存在单独的 “list-expiring” 动词，因为时间窗口本身已经是一个参数。只有当返回的行不是该域的实体时，才使用限定动词：loads list-problems 返回的是问题标记，而不是运单。
• (domain, verb) 组合在整个目录中唯一 — 即使两条命令的角色从不重叠也是如此。如果同一组合被分配给两条命令，您的集成代码看到的是同一个名称，而 CLI 却会因调用者不同而执行不同的操作。

覆盖范围：面板中的一切，都能通过命令完成

许多团队把 Logistivo 接入自己的 AI 智能体或自动化框架，而智能体只有能把工作做完才有用。因此规则很简单：办公室用户能在面板中更改的任何东西，命令也能更改——并且经过同样的角色关卡、同样的确认关卡和同样的审计台账。

这是测量出来的，而不是断言出来的。面板背后的每个写入端点都会与命令注册表进行核对，只有当某条命令将该端点声明为自己的 HTTP 镜像，或调用同一个共享服务时，该端点才算被覆盖。在范围内的写入端点中，100% 已被覆盖，没有一个未经证实。每个被排除的端点都附有书面理由——身份和支付步骤、集成控制平面、司机 App 自身的端点、客户端遥测、没有调用方的废弃副本——其中与集成方相关的端点列在下方。

需要文件的命令也遵循同样的规则：表中有 33 条命令需要单证或照片，它们全部可以通过 lg、HTTP 和 MCP 使用（参见“需要文件的命令”）。

管理工作同样被覆盖，只是需要更高级别的密钥：表中有 62 条命令——团队成员和角色、公司设置、银行账户、已保存的银行卡、集成密钥——需要 manager 级集成密钥。employee 级密钥是默认级别，负责日常运营，调用这些命令时会以 INSUFFICIENT_KEY_LEVEL 被拒绝。

联盟推广（推荐合作方）账户拥有自己的目录：20 个域中的 55 条命令——推荐、潜在客户、CRM 备注与任务、销售演示文稿、收益与提现，外加每个角色都有的账户和团队命令。仅限联盟推广账户的命令不在下方的公开表格中，该表格列出的是三个面板角色；联盟推广账户可以在 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. 用命令读取结果 — 这一步完成后，其结果会再次对命令可见：套餐和点数余额、已保存的银行卡（已掩码，仅显示后四位）、密钥列表中的新密钥。智能体永远不会在聊天中接收卡号、支付或同意。
• 支付与 3D Secure — 购买或升级套餐以及添加银行卡，都需要在浏览器中完成 3D Secure。命令可以列出套餐和价格、读取余额及其历史、列出已保存的银行卡（已掩码）、设置默认银行卡以及删除银行卡；购买本身则通过交接链接完成。
• 法律同意 — 批准法律文本由本人在浏览器中完成。lg users get 会告诉您有一项批准正在等待处理；没有任何命令能够代为批准。
• 账户注销、登录与密码 — 注销自己的账户、登录以及修改密码都属于身份步骤，保留在浏览器中。lg user-accounts preview 会展示注销账户意味着什么，但不会实际执行。
• 集成密钥、webhook 与沙箱 — 管理它们会返回必须只在您的终端中显示一次的机密，因此它们是基于各自 HTTP 端点的 lg 内置命令（lg keys、lg webhooks、lg sandbox），而不是目录命令。目录中只包含两条不涉及机密的密钥命令：integration-keys list 和 integration-keys revoke。
• 面板助手聊天 — 集成密钥无法驱动面板内的 AI 助手聊天；用密钥启动或继续一次运行会返回 403。智能体应改为通过命令端点、lg 或 MCP 通道连接——在那里，每条命令都以密钥的访问级别运行，其写入会被记录为集成写入。
• 司机 App — 司机账户没有命令目录，司机 App 保留其自身的端点。办公室用户通过命令管理司机及其单证、费用和行程。

安装与身份

lg 是一个单文件、无依赖的 Node 脚本（Node 18+），以 @lgstv/lg 的名称发布在 npm 上。该软件包会安装两个完全相同的命令：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（设置 › 集成密钥 › AI 与 CLI 连接）下将其移除。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 打印单条命令的完整参数列表，包括类型以及哪些参数为必填。这些文本没有一处存在于客户端内部——全部来自目录。请记住，列表取决于您的角色：同一个域的动词对承运商和货主并不相同（例如 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 选项对单条命令起同样的作用。
• LOGISTIVO_HOME — 存放配置文件和目录缓存的目录。默认为 ~/.logistivo。如果您在一台机器上使用两个账户，请将它们分开。
• LOGISTIVO_PROFILE — 以哪个配置档（profile）运行。`lg profile use` 是持久性的选择；此变量只作用于单次运行，是在 CI 中切换线上配置档与沙箱配置档的最简便方式。未知的配置档名称不会被静默忽略——会直接报错。
• NO_COLOR — 设置后不输出任何 ANSI 颜色（相当于永久启用 `--no-color` 选项）。如果桥接程序会写入日志文件或 CI 输出，请开启它；颜色转义序列会破坏之后读取这些日志的工具。

客户端易用性

这些功能让日常使用 `lg` 客户端更加轻松。它们都不会改变 HTTP 契约——如果您直接通过 HTTP 集成，可以跳过本节。

• 多环境与多密钥 — 将预发布环境和生产环境，或者您的客户桥接与承运商桥接，分别保存在不同的配置档中。配置档列表从不打印令牌；每一行显示的是令牌的 sha256 指纹。命令目录按配置档、主机和令牌分别缓存，因此两个角色永远看不到彼此的命令列表。
• 增量同步：lg sync — 用一条命令运行实践手册中的同步循环：按实体记录的水位线、带游标的 updated_since、JSONL 输出以及五分钟的安全余量。首次回填请使用 --full。该命令是只读的；没有 --write 选项。lg sync --list 会根据目录推导出您的角色可同步的实体。
• 错误体验与 shell 补全 — 遇到 422 时，客户端会以您输入的选项形式指出被拒绝的字段，并给出稳定的 error_key 以及目录对它的解释。遇到 409 时，它会打印出现成的 --yes 命令行；遇到 429 时，它会等待 Retry-After 指定的时间。Shell 补全覆盖域、动词、选项和枚举值，并且可以离线使用。
• 机密参数永远不出现在命令行上 — 少数命令需要机密信息——例如，连接 Paraşüt 会计集成时，需要该系统的客户端凭据和密码。lg 从不接受以选项形式传入此类值，因为它会留在您的 shell 历史和 ps 输出中：lg 会以不回显的方式询问，或者从 ---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 nightly sync”），选择作用域和访问级别，还可以缩短有效期。密钥只显示一次，并且只在那个界面上显示；服务器不会存储它。如果丢失，Rotate（轮换）会签发一个新密钥——旧密钥立即失效。

2. 从终端连接 — lg login --api-key 会验证密钥，打印身份和作用域，并下载命令目录。lg whoami 会向服务器询问您当前以哪个用户、公司、角色和作用域运行。lg logout 也会在服务器上吊销该密钥，就像它会在服务器上结束批准码会话一样（只有密码会话的 lg logout 做不到这一点）。

3. 或者直接使用 HTTP — 密钥是一个通过 Authorization: Bearer 头携带的访问令牌，可直接用于三个命令端点。在服务器或 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。有两个有意设置的例外，两者都由更细粒度的关卡把守：命令执行端点（决定取自命令自身的 read_only 标志，因为不写入的命令也通过 POST 调用），以及密钥吊销自身（lg logout，只读密钥也允许）。作用域、域授权和访问级别是三条相互独立的轴，必须全部通过：读取密钥即使是 manager 级也无法写入，employee 写入密钥无法管理团队，loads:write 域授权也不会开放管理工作。请代表能满足您需求的、权限最小的成员签发密钥：角色决定了您究竟能看到哪些记录。

• read — 命令目录以及不写入的命令（list、search、preview）。写入命令会返回 403 forbidden——在确认关卡之前；只读密钥甚至永远看不到 409。适用于夜间同步和报表。
• write — 所有命令。需要确认的命令仍会以 409 请求确认；confirm: true（CLI 中为 --yes）的作用与以前完全相同。作用域永远不会放宽确认关卡。
• employee — 每个新密钥的默认级别。日常运营：运单、询价、报价、行程、车队与车队单证、单证、联系人——所有不需要管理权限的命令，外加车队相关权限。需要更高级别的命令会返回 422，并带有 error_key INSUFFICIENT_KEY_LEVEL 和 required_key_level: manager；对应的 REST 端点则以相同的键返回 403。这是 ERP 夜间同步、车载信息（telematics）桥接或运营脚本的合适级别。
• manager — 密钥所代表的人可以做的一切，包括管理工作：团队成员和角色、公司设置、集成密钥、银行账户及其验证、已保存的银行卡、公司间关系、联盟推广提现。manager 密钥永远不会增加此人本身不具备的权限——没有团队管理权限，它依然无法管理团队。在引入访问级别之前就已存在的密钥都是 manager 密钥，因此它们的行为与以前完全相同。
• 一个集成一个密钥 — 如果 CRM 和 ERP 共用一个密钥，切断其中一个就意味着切断另一个。请为每个桥接程序配备独立的密钥；反正列表会按名称显示它们。
• 轮换 — 签发新令牌并立即吊销旧令牌；剩余有效期保持不变。在怀疑泄露时以及定期使用它。在用新令牌更新之前，集成会收到 401。
• 吊销 — 密钥被永久关闭；此操作无法撤销，如有需要请签发新密钥。如果密钥所代表的成员被移出团队或被停用，密钥会自动失效。
• 有效期与数量上限 — 默认有效期为 180 天；您可以在创建时缩短它，但永远不能延长。一名用户最多可持有 10 个有效密钥。列表中可以看到最近使用时间；从未使用过的密钥会明确标示这一点。
• 谁来管理 — 签发、轮换、转移和吊销向拥有团队管理权限的管理者开放——与添加或移除团队成员是同一道关卡——并且，当通过集成密钥执行这些操作时，该密钥必须是 manager 级。管理者可以代表其他成员签发密钥；对于桥接程序，建议使用一名专用的、权限范围很窄的成员。

最初的十分钟：从面板到您的第一次调用

集成中最昂贵的几分钟，就是最初的十分钟。下面四个步骤按顺序铺开了这条路径；面板中也以向导的形式提供了同样的顺序（Settings › Integration › Setup wizard，即“设置 › 集成 › 设置向导”），而且该向导调用的正是这里描述的端点。无法使用向导的开发者，阅读本节也能到达同一个地方。

这四个步骤没有一个以“我已经发出去了”作为结束。密钥是否真的可用，由请求台账来回答；webhook 是否真的送达，由投递台账来回答。两者在面板和 lg 中都可以查看。一套从未被测量过的配置，只是一套被“相信”能工作的配置。

• 1. 决定要做什么——先设定作用域 — 不存在事后再决定密钥能看到什么的情况：您在签发密钥时就要选择作用域。作用域有两条轴。粗粒度作用域（read / write）只回答“能否写入”。细粒度作用域（域授权：loads:read、invoices:write）说明它可以触及哪些域，一旦设定，密钥就变为默认拒绝（fail-closed）——您未选择的每个域，以及每个不对应任何域的端点，都会返回 403。面板中的域列表不是手写的；它由您角色的实时命令目录推导而来，并显示每个域开放了多少条命令和 REST 端点。命令目录、“我是谁”（current）和“退出登录”端点始终不受作用域限制：密钥必须始终能够描述并关闭自身。第三条轴是访问级别：employee（默认）执行日常运营，manager 还可以处理团队、设置、密钥和资金相关的工作。除非桥接程序要做管理工作，否则请选择 employee。
• 2. 签发密钥——令牌只显示一次 — Settings › Integration › New key（设置 › 集成 › 新建密钥）。为它起个名字（“ERP nightly sync”），选择它所代表的用户和访问级别，如果需要还可以缩短有效期。原始令牌只在那一次响应中返回；服务器不会存储它，面板中也没有“再次显示”。如果丢失，请轮换以获取新令牌，旧令牌会立即失效。切勿将令牌放入版本控制、CI 日志或聊天窗口；请把它放进目标系统的机密存储中。
• 3. 发起第一次调用——并确认它“真的”到达了 — 两个请求就足够了。第一个请求证明您的身份（它不受作用域限制，任何密钥都能使用）：作用域是否符合预期，状态是否为 active，expires_at 是否临近。第二个请求从您选择的域中读取真实数据。如果通过，说明身份、作用域、邮箱关卡和网络路径都是正确的。如果没有通过，不要靠猜：密钥自己的请求台账会逐行显示哪个端点以哪个状态码、哪个稳定错误键（INSUFFICIENT_SCOPE、IP_NOT_ALLOWED、KEY_ACTOR_BLOCKED …）被拒绝。在面板中，这份台账就是 “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. 开通沙箱 — 每家公司一个沙箱。该端点需要团队管理权限（team.manage），因此由贵公司的管理员来执行这一步。如果沙箱已经存在，同一个端点通过 GET 会返回其状态：公司 id、剩余点数、有效密钥数量、订阅、生成历史以及各项上限。
• 2. 签发沙箱密钥，并将其保存为第二个配置档 — 该密钥代表沙箱自己的桥接用户签发，返回时带有 environment: sandbox 标记；原始令牌只出现在那一次响应中。在 lg 一侧，不要替换您的线上密钥——请将“两者”分别保存为独立的配置档；--sandbox 和 --live 是单次运行的选择器。
• 3. 真正地写入 — 这里不用 --dry-run；写入才是重点。把同一个幂等键发送两次，看第二次响应以 status: replayed 返回——这就是在沙箱中测得的结果。故意在未确认的情况下调用受关卡保护的命令，读一读 409 响应体；尝试调用一条超出作用域的命令，读一读拒绝信息。这一切都不会在您的线上台账中留下痕迹：在同一次运行中，您的线上余额保持不变。
• 4. 上线前阅读检查清单 — 上线（go-live）端点根据您在沙箱中“实际”做过的事情作答：您是否写入过，是否见过错误分支，是否有 webhook 被投递，是否已把接收端从演练地址移走，是否为密钥设置了到期时间。每一项都会以 pass / todo / unknown 返回。同一响应还带有一份根据您实际调用过的命令推导出的“作用域建议”——用它来签发您的线上密钥，使其范围不超出您的需要。
• 点数与开票 — 沙箱有自己的点数台账，您的线上余额不会变动。这是结构上的保证，而不是一项检查：点数按公司计算，而沙箱是一家独立的公司。它以免费档位开通，没有支付方式，并且处于月度收款窗口之外——无论通过哪条路径，它都不可能产生发票。
• 交易市场 — 您在沙箱中创建的询价“不会”出现在真实承运商的屏幕上，也“不会”进入他们的电子邮件或推送收件箱；您也看不到真实的询价。这种隔离是对称的，并在两个独立的查询中强制执行：一条询价对谁“可见”和发送“给”谁，是两个不同的问题。
• Webhook — 订阅同样带有环境标记。沙箱事件永远不会投递到线上订阅，线上事件也永远不会到达沙箱订阅；对于标记发生偏移的订阅，根本不会创建任何投递。由于订阅上限按公司计算，您的演练订阅不会占用您的线上配额。
• 种子数据 — 沙箱中的样例记录是“生成”的，绝不是从真实租户复制而来。生成种子数据是幂等的：第二次调用不会在您自己的记录上再铺一层种子数据。
• 同一份目录 — 您的角色在沙箱中依然是您的角色，命令列表完全相同——经过测量，两边都是 448 条命令。沙箱不是一个缩水的演示；它是您公司的孪生体。
• 当前的限制：无法用沙箱密钥管理 webhook 订阅 — 订阅端点需要团队管理权限（team.manage），而沙箱的桥接用户没有任何团队角色，因此 `lg --sandbox webhooks …` 目前会返回 403。整个命令接口面都可以正常工作——限制仅在于订阅台账。如果您想在沙箱中演练 webhook，请联系支持团队；这一点已经过测量，并作为一个未解决的缺口记录在案。
• GET /api/common/integration-sandbox — 状态：是否存在、属于哪家公司、剩余点数、有效密钥数量和订阅数量、生成历史、各项上限，以及一份触发指南，说明哪条命令会引发哪个事件。
• POST /api/common/integration-sandbox — 开通沙箱（每家公司一个，幂等）。需要 team.manage 权限。
• POST /api/common/integration-sandbox/keys — 201 + 密钥和原始令牌（仅在此处出现，仅出现一次）。environment: sandbox 标记由公司推导得出；调用方无法指定。
• GET /api/common/integration-sandbox/go-live — 上线检查清单和作用域建议——根据您在沙箱中的真实流量计算得出。
• POST /api/common/integration-sandbox/renew — 开启一个新的沙箱“代”，并让上一代退役。

命令模型

语法只有一种，而且没有例外。要知道如何调用一条命令，您只需要知道目录对它的描述。

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

选项名称就是 schema 的参数名，并且 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 中的参数名完全一致，其值必须符合 schema 中的类型。枚举字段上的无效值永远不会到达服务器。
• --limit=20 — 列表命令返回的行数。上限写在每条命令的参数描述中——普通列表调用通常为 20，同步模式（带 cursor 或 updated_since）下最多为 100。
• --json — 原始 JSON 输出。
• --json — 输出原始 JSON。这是脚本唯一正确的使用形式：默认的对齐表格是给人看的，它会根据数据挑选列，并可能在不另行通知的情况下改变布局。切勿编写解析表格输出的脚本。
• --yes, -y — 通过确认关卡（HTTP 中为 confirm: true）。只在清楚知道自己将要做什么的脚本中使用；对于不可撤销的命令，这个选项就等于“无法撤销”。
• --idempotency-key= — 让重试写入命令变得安全。使用相同键的第二次调用不会重新执行命令，而是返回第一次的结果。如果您要构建重试循环，请由您自己生成这个键，并在每次尝试时发送同一个键。
• --dry-run — 执行预检而不是命令本身：校验、各道关卡和点数计算照常运行，但不写入任何内容（参见预检一节）。对每条命令以及 lg batch 均有效。
• --refresh — 强制刷新目录。lg 会将目录缓存一小时；如果您知道服务器上刚刚新增了一条命令，请使用此选项，而不必等待。
• --help, -h — 打印该命令在目录中的描述、每个参数、参数类型、枚举值以及是否必填。客户端内部没有帮助文件。
• --profile=, --sandbox, --live — 本次调用以哪个配置档运行。--sandbox 和 --live 会选取持有沙箱密钥或线上密钥的配置档；环境在服务器端由密钥推导得出，因此不匹配时会以 403 ENVIRONMENT_MISMATCH 中止，而不会写入错误的地方。
• --base-url, --timeout, --verbose, --no-color, --version — 依次为：将单条命令指向另一台服务器、以秒为单位的超时、请求/响应详情、禁用 ANSI 颜色，以及客户端版本。

真实示例

以下每条命令目前都存在于目录中；这里没有任何名称或参数是编造的。输出已作删节。输出展示的是 `data.result` 层级；通过 HTTP 调用时，同一个对象位于 `{success, data:{…}}` 信封之内（参见 HTTP 命令 API）。

• 当前在途的运单 — lg loads list --status=in_transport --limit=20
• 单条运单的完整内容，原始 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 只是一种便利，而不是唯一的入口。目录和执行都通过三个 HTTP 端点完成（文件还有第四个端点，即上传端点——参见“需要文件的命令”）；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、您的目录角色、附件（上传）契约，以及您调用时所用密钥的访问级别。会发送 ETag；If-None-Match 会得到 304。?domain= 也能匹配旧的（别名）域。请据此生成您的客户端；不要硬编码命令列表。
• GET /api/common/commands/{name} — 单条命令的完整信息。name 是目录中冻结的命令名称（list_loads），而不是 CLI 身份。已弃用的命令会返回 X-Deprecated 头。
• POST /api/common/commands/{name} — 执行。请求体：{ args, confirm?, idempotency_key? }。响应的 HTTP 状态本身就是结果——任何非 200 的状态都是信息，而不是噪音。错误带有 error_code（传输层），对于业务拒绝还带有 error_key。

需要文件的命令

表中有 33 条命令需要单证或照片：为运单附加 CMR、从发票中读取 HS 编码、根据车辆登记证创建车辆、根据照片估算托盘、上传公司单证、将发票与装箱单进行交叉核对。在浏览器中，您只需把文件拖进表单；在其他任何地方，都需要两个步骤——先上传文件，再把它的 id 传给命令。

当参数名以 attachment_uuid 或 attachment_uuids 结尾时，该参数接受文件——列表中的 photos[].attachment_uuid，支票上的 front_attachment_uuid。您不必记住这些：每个目录行都带有 file_params，其中给出确切的路径；schema 会标记这些字段（format: uuid, x-logistivo-file: true）；目录响应中还带有一个 attachments 块，包含上传地址、接受的类型、大小限制和存活时间。lg help 也会显示它们。

上传是一种写入，因此只读作用域的密钥无法上传；任何写入作用域的密钥都可以上传，无论访问级别如何。上传的文件属于用户，而不属于密钥：同一用户的两个密钥看到的是相同的上传文件，任何人都无法使用别人的文件。未知、已过期或不属于您的 id 只会被视为找不到，原因不会被透露。

面板聊天附件和命令上传是两个独立的空间：在助手聊天中附加的文件无法通过 id 传给命令，命令上传的文件也永远不会出现在聊天线程中。

上传不是命令，本身也没有任何业务效果：在某条命令使用这个 id 之前，您的数据不会发生任何变化。这也是上传从不请求确认的原因——由消费该文件的命令来承担关卡。

• 1. lg：在本地路径前加上 @ — lg 会先上传文件，然后用返回的 id 运行命令；不带 @ 的值是您之前上传过的某个文件的 id。列表接受以逗号分隔的路径或重复的选项，嵌套字段接受 JSON，而当命令恰好只有一个顶层文件字段时，--file 是一种简便写法。在发送任何内容之前，lg 会在本地验证每个文件（是否存在、大小、类型），而 lg batch 会在批处理运行之前把每个不同的文件上传一次。
• 2. HTTP：先上传，再传入 attachment_uuid — 以 multipart/form-data 形式发送文件，字段名为 file。新的上传返回 201；同一用户再次上传同一文件时返回 200，状态为 replayed，id 相同，并且不会写入任何内容。与本页其他地方一样，示例展示的是信封内的 data 对象。
• 3. MCP：upload_attachment 工具 — MCP 客户端无法发送 multipart，因此该通道额外提供了一个不在目录中的工具：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 — 再次上传同一文件（相同的名称、大小和内容）时，只要原上传至少还剩一小时的有效期，就会返回现有的 id，而不会写入新的文件，并且不会占用您的每日上限。
• 每日上限 — 每名用户每天 300 次上传（TOO_MANY_FILES），每家公司每天 2 GB（DAILY_LIMIT_REACHED）；两者都会返回 429 并附带 retry_after。
• POST /api/common/commands:upload — 在字段 file 中进行 multipart 上传。新的上传返回 201，同一文件返回 200 且状态为 replayed。返回 data.attachment：attachment_uuid、filename、mime_type、size_bytes、sha256、extraction_status、expires_at 和 reused。

确认关卡与不可撤销的命令

目录中的每条命令都带有两个标志：confirmation_needed（执行前是否需要明确批准）和 irreversible（其效果能否撤销）。这是两个独立的问题，而且两者都在服务器端强制执行，而不是寄望于客户端的自觉。

这道关卡关乎责任，而不是业务规则。提交报价是迈向运输合同的第一步；开具发票会产生一笔会计分录；库存变动会改变一本台账。这些操作都不应该因为意外而被执行两次。

关卡读取的是“实际生效”的命令。当一条命令包装另一条命令时——比如聊天中的通用执行器——关卡取自真正将要运行的那条命令的标志，而不是包装器的标志。如果使用固定的标志，两种失败中必有一种无法避免：要么开票命令在未经确认的情况下运行，要么每一次国家查询都会弹出一张确认卡片。

read_only 与不受关卡限制并不是一回事。共有三种不同的状态：invoices preview 不受关卡限制，也不写入任何内容；loads create 受关卡保护，并且会写入；invoices create 不受关卡限制，但会写入——会生成一份草稿。只需一个测试就能判定：命令返回时，数据库中是否有某一行发生了变化？

有些操作不在这道关卡之后，因为它们根本就不是命令：购买套餐、通过 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）重复同一次调用。不可撤销的命令带有相应的标记，确保它们最多只运行一次。

预检：在不执行的情况下查看写入命令会做什么

搭建 ERP 桥接程序时最昂贵的一步，是通过“真正”执行命令来确认请求体是否正确：线上台账里多出一张草稿发票、白白消耗的点数、手动清理。dry_run 终结了这一切——您在请求中加一个字段，命令不会运行，而您可以读到将会发生什么。

注册表目前有 519 条命令；其中 233 条只读取、不写入任何内容。在其余 286 条写入命令中，有 251 条受关卡保护：不带 confirm 调用时，它们本来就会返回 409 并描述将要做什么。缺口在于另外 35 条——发票草稿、出口单证草稿、明细行：恰恰是桥接程序最先接入的那条链路。对于这些命令，调用即执行。

即使对于受关卡保护的命令，也存在第二个缺口：schema 校验是在关卡之后才运行的。因此，缺少参数的调用会先收到确认卡片，确认之后才被告知“缺少这个字段”。一次预检就能在一个往返中回答这两个问题。

而最常见——也是最晚才被发现的——桥接错误是这样的：您发送了一个 schema 中不存在的字段（本应是 recipient_contact_id 的地方写成了 customer_id），服务器悄悄丢弃了它，命令返回 200，记录却落到了错误的地方。预检响应会在 arguments.ignored 下按名称列出这些字段；任何错误消息都不会告诉您这些。

预检不写入任何内容，这首先是由结构保证的，其次才是测量结果：预检路径从不进入命令的处理程序，因此这一点对每条命令都成立，包括以后新增的命令。该功能上线时也进行了测量：对当时目录中的每条写入命令进行预检（两组参数、两个角色、共 178 次预检）期间发出的每一条 SQL 语句都被捕获了下来。没有一条 INSERT/UPDATE/DELETE，没有一个排队的任务，没有一封邮件；31 张表的行数和点数余额都没有变化。

退出码与真实调用会产生的退出码相同——可以运行时为 0，停在确认关卡时为 4，幂等冲突时为 2，其他情况为 1——因此 “lg … --dry-run || exit” 在 CI 步骤中是一道有意义的关卡。

• 1. 带上 dry_run 调用 — 在请求体中加入 "dry_run": true。校验、角色和作用域关卡、目标解析以及点数计算都会运行；命令本身不会运行。
• 2. 读取 would_execute — 这是唯一需要据以分支的标志。当它为 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 表示速率限制。
• 只读作用域的密钥无法对写入命令进行预检 — 它会收到 403。预检回答的是“如果我现在用这个密钥调用它，会发生什么”；如果给读密钥亮绿灯，而真实调用却返回 403，那恰恰就是预检要防止的意外。
• 幂等键不会被占用 — 预检期间发送的键不会在台账中创建任何行，已过期的锁也不会被释放。所以请发送您准备在真实调用中使用的那个键：预检会告诉您它是否仍然空闲、是否会重放之前的某次运行，或者是否与另一条命令冲突。
• 可与 confirm 组合使用 — 同时发送 dry_run 和 confirm，问题就变成了“如果我确认，会发生什么？”。依然不会运行任何东西。
• 批量预检按批次进行 — commands:batch 也接受 dry_run，但该标志属于批次，而不属于单个条目（在条目上发送会得到 422）。您会得到逐条目的报告以及该批次的总点数消耗；余额不足会被报告，而不是被拒绝。
• 预检并非免费 — 每次预检都会执行真实的查询（预览、余额），并计入速率限制。不要在每次部署时预检整个目录；只预检您改动过的命令。

幂等性：为什么重试不会产生重复

ERP 不会阅读您的错误消息，看不到您的屏幕，并且会在超时后重新发送同一个请求。本节正是为应对这种行为而存在的。

携带 idempotency_key 的调用最多只运行一次。第二次调用不会重新执行命令，而是返回已记录的结果，状态为 replayed。当网络中断、请求超时，或者队列把同一个任务取了两次时，您得到的是第一次的结果，而不是一张重复的发票。

每条写入命令都应使用一个键。目录中的 read_only 字段免费为您提供了这种区分：每一条 read_only: false 的命令都应该带上幂等键（idempotency key）。

您的重试策略应使用指数退避，并在每次尝试时携带同一个键。每次尝试都生成一个新键，等同于根本没有使用幂等性。不要并行发送同一个键：“最多一次”的保证针对的是顺序重试，而不是两个相互竞争的请求。

• 陷阱 1——失败也会被锁定 — 如果第一次执行被业务规则拒绝（failed），使用同一个键的第二次调用会返回相同的错误和相同的 error_key，而不会重试。修正参数后再次尝试需要一个新的键。一个键代表的是一次尝试，而不是一个意图。
• 陷阱 2——较大的结果在重放时没有响应体 — 台账只保存小于 64 KB 的结果。更大的结果在重放时状态为 replayed，但响应体为空。您的集成应依赖 “replayed” 这一信号而不是响应体，并用对应的 get 命令获取数据。
• 陷阱 3——一个键只属于一条命令 — 用不同的命令发送同一个键会返回 409 idempotency_conflict 以及 conflicting_command；不会运行任何内容，也不会重放任何内容。在两个动词之间共用一个键的客户端是有缺陷的，它会从一个错误中得知这一点，而不是从一次静默的重放中。
• 陷阱 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——都接受两个共用参数，并返回一个共用字段。

为什么没有 offset：在一张实时变化的表上，offset 会发生漂移。在两页之间插入的一行，会让您悄无声息地跳过或重复统计一条记录。游标只能向前移动，因此在遍历过程中插入或更新的记录会落到列表末尾：不会丢失任何内容，也不会重复任何内容。

完整的初始加载也使用同一机制：从 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。时间戳精度为一秒，因此恰好位于边界上的记录可能会到达两次——只要您在自己一侧按 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 中的业务键；它们是不透明的，并且仅属于您的公司。运单、询价、联系人、发票、商品和仓库可以携带您自己的键。

• 写入时设置 — 以下写入命令都接受可选的 external_ref（最多 120 个字符），并会原样返回它：loads create、demands create、contacts create 和 contacts update，以及 invoices create。
• 读取时使用 — loads get --external_ref=ORD-2026-0917, invoices get --external_ref=..., contacts get --external_ref=..., demands get --external_ref=... 都可以使用；在 list 和 search 命令上，--external_ref= 是精确匹配的筛选条件。
• 每家公司内唯一 — 具有相同键的第二条记录会以 422 被拒绝，且 result.error_key = DUPLICATE_EXTERNAL_REF；其他公司的键对您来说会返回“未找到”。匹配不区分大小写（ord-1 = ORD-1）。已归档的记录会保留其键；如需重新使用该键，请先恢复该记录。
• 同时发送 idempotency_key — 网络超时后的重试会返回第一次的结果，而不是创建重复记录。两者不能互相替代：external_ref 是您的业务键，idempotency_key 标识的是一次尝试。

外发 webhook：事件发生时由我们向您发送 POST

到此为止的一切都是拉取：您提问，我们回答。过去，ERP 桥接程序必须每分钟询问一次，才能得知某个运单的状态发生了变化、某张发票已经开具，或者收到了一份报价。现在不必了：注册一个 https 地址，选择您关心的事件，事件发生时就会收到一个签名的 POST。

推送是在拉取“旁边”新增的，而不是取而代之。增量同步（updated_since + cursor）原封未动，依然是合适的工具：首次完整加载、回填历史数据以及回答“我有没有漏掉什么”，都在那里完成。webhook 将延迟从分钟级缩短到秒级。健康的桥接程序两者并用——webhook 作为触发器，同步作为安全网。

payload 是一个“信号”，而不是记录的副本。它携带标识信息（id、您自己的 external_ref、状态、时间）；您用自己的密钥通过 GET 获取详情，而这个调用本身就会经过您自己的授权关卡。因此，暴露面始终停留在标识符层面。有两个字段被有意省略：提交报价的公司身份（盲报价在面板中以化名显示；把身份放进 webhook，会通过第二条通道打破这种隐私）以及预订的联系人信息（没有必要让个人数据多走一条通道）。

事件名称是冻结的。如果某个名称的含义发生变化，就会启用一个新名称，旧名称则会在弃用窗口期内继续存在。向 payload 添加新字段不会提升契约版本——消费方必须忽略它不认识的字段。

• 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 — 重新发送单次投递：event_id 被“保留”，投递 id 是新的，payload 原样复制。

事件目录

下面 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 前缀使该方案可以进行版本演进：如果将来出现第二种方案，头中会携带 t=…,v1=…,v2=…，您选择自己认识的那一个即可。

我们发布了两个无依赖的参考接收端，一个用于 Node，一个用于纯 PHP。两者都应用了上述四条规则，并可通过 --selftest 自测：有效签名、被篡改的请求体、错误的签名密钥、超出窗口的时间戳、格式错误的头、重新序列化陷阱，以及两种重复（同一次投递 / 同一个事实）。验证器与我们自己使用的代码完全对应——我们自己也在消费我们发布的契约。

• 验证原始（RAW）请求体 — 签名是基于字节计算的。对请求体进行解码再重新序列化（JSON.stringify(req.body)、json_encode($request->all())），会把相同的“数据”变成不同的“字节”，签名就不再匹配。在 Node 中，陷阱在于数字格式（线路上的 1.50 会变成 1.5；大整数会丢失精度）；在 PHP 中，陷阱在于字符转义（/ 会变成 \/，İ 会变成 \u0130）。在 Express 中请使用 express.raw，在 Laravel 中请使用 $request->getContent()。这是编写接收端时最常见的错误。
• 检查时间戳 — t 位于签名“之内”。只验证签名的话，任何截获了有效请求的人都可以在几小时后重放它，而接收端会把它当作一个经过验证的事件。即使签名正确，也请丢弃任何 |now − t| > 容差的请求。建议的窗口为 300 秒。
• 以恒定时间比较 — hash_equals / timingSafeEqual。使用 == 比较会让攻击者逐字节猜出签名。
• 按 event_id 去重，而不是按 id — event_id 标识的是“事实”：两个订阅者收到同一事件时它是相同的，并且在重放时会被“保留”。id（= X-Logistivo-Delivery）标识的是“投递”，在重放时会改变。请用 event_id 回答“我是否已经处理过这个”；若用 id 来回答，重放就会让同一项工作执行两次。

投递、重试与静默

您的接收端并不总是在线。这条通道考虑到了这一点：暂时性的失败会进入重试时间表，永久性的失败会使订阅被静默——而静默的“原因”始终会被记录。

静默原因是机器可读且稳定的（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 等内部后缀会被拒绝——在查看解析结果之前就拒绝这种意图，因此分离视图（split-horizon）DNS 无法突破这道关卡；
• IP 字面量以及 DNS 解析的“所有”记录都必须是公网地址。如果一个名称同时解析到公网地址和私网地址，没有人会问我们该选哪一个 → 该名称直接被拒绝；
• 在投递时，地址只解析一次，连接被固定到经过验证的地址上：DNS 重绑定的窗口因此被关闭；
• 接收端的响应“正文”永远不会存储在任何地方（只保存状态码、耗时和简短的错误标签）——因此，地址关卡漏洞真正的价值所在，即“读取”路径，始终是关闭的。
• 我们有意不提供“允许私网地址”的配置开关：这样的开关总有一天会被意外地开着。
• 只返回“一次”，仅在创建订阅时以及执行 rotate-secret 时返回。它在服务器上加密存储，永远无法读回；没有“再次显示”。
• lg 会把它打印到屏幕上并就此留在那里——不会把它写入任何配置文件或缓存文件。
• 如果丢失，请轮换它；旧值会“在那一刻”失效。为了实现无缝切换，您的接收端应在过渡期间同时尝试新旧两个密钥。
• 更改地址“不会”影响签名密钥：像“URL 搬家了”这样的日常维护，不应破坏接收端的验证。

健康与状态：桥接程序悄然停摆，不应由别人先于您发现

集成桥接程序很少会轰轰烈烈地宕掉。它通常是在凌晨悄无声息地停下来：令牌过期了，密钥所代表的那个人离开了团队，作用域被收窄了，或者接收端点开始返回 403。最先察觉的几乎总是客户。lg status 的存在，就是为了扭转这个顺序。

一条命令同时回答两个问题，因为在故障期间这两个问题会在同一时刻被提出：平台是否正常运行，以及我的桥接程序是否健康。平台状态这一行无需令牌即可使用——故障期间，令牌本身就是首要怀疑对象，如果把状态查询与令牌绑定，恰恰会在您最需要答案的时候得不到答案。

健康摘要不维护新的台账；它把三个现有来源汇总成一句话：每日使用计数器（您调用了多少次、失败了多少次）、请求台账（哪个请求、何时、因何被拒绝）以及外发 webhook 投递台账（事件是否到达了接收端）。错误率始终从每日计数器读取；明细台账设有上限，达到上限时会明确说明。

同样的摘要也会出现在面板中：在 Settings › Integration › Keys（设置 › 集成 › 密钥）下，每一行都带有一个徽章，下方注明原因。阈值不在客户端计算；服务器判定的级别是什么，面板和 lg status 就显示什么，因此两个界面对同一个密钥永远不会给出不同的说法。

您的监控程序不需要令牌。该端点只返回状态词；不包含版本、主机名、队列名称、任务数量、错误文本或客户数据——也不可能包含。

健康摘要每次请求只执行固定数量的查询；查询次数不会随密钥数量的增加而增长。如需详情，请用 lg logs 查看该密钥最近的请求，用 lg webhooks list 查看外发桥接。

• 健康 — 没有测得任何故障，并且我们掌握成功的证据：台账中有一次成功的调用，或者计数器中的流量始终没有错误。
• 需要关注 — 某些东西开始出问题了：错误率或连续失败次数越过了阈值，请求在关卡处被拒绝，密钥即将过期，或者一个原本定期通信的桥接程序沉默了。
• 故障 — 桥接程序此刻无法正常工作：令牌被意外吊销，已关闭的密钥仍在被调用，连续五次失败，错误率超过百分之五十，或者某个 webhook 订阅被静默。
• 已关闭 — 密钥是被有意关闭的，并且没有人在调用它。这是一个决定，而不是故障——所以不会显示为红色。
• 无数据 — 没有任何测量数据：该密钥从未被调用过，或者测量本身失败了。这两种情况都不是绿色。
• 不出现虚假的绿色。健康徽章需要经过测量的成功证据；一个从未被调用过的密钥永远不会变绿，因为没有任何一次测量能证明它可以工作。
• 不出现虚假的红色。您有意关闭的密钥显示为“已关闭”。把一切都涂成红色会让红色失去意义；已关闭的密钥只有在关闭后仍被调用时才会变红——而那时，确实有一个桥接程序坏了。
• “无法测量”与“没有数据”不是一回事。如果服务器端的查询失败，该行不会悄悄显示为零；它会说明测量无法进行。
• 沉默总会被报告，但从不会被盲目地变成警告。一个只在月末运行的桥接程序沉默三十个小时是正常的；而一个在过去七天中至少有五天都在通信的桥接程序沉默下来，就是故障。节奏是测量出来的，而不是假定的。
• 状态查询本身不会污染健康数据。lg status 发出的调用会出现在请求台账中，但不计入健康统计——否则，您自己那次成功的状态查询就会重置连续失败计数，掩盖掉这个界面本应展示的故障。
• 每一行都是测量出来的：对数据库执行一次真实查询，真正构建一次命令目录，真正读取队列工作进程的实时记录。没有任何东西是假定的。
• 响应本身也是一次测量：如果您能读到响应体，就说明 Web 层在运行。
• 顶层状态只由必需组件推导。队列停止时，答案是 degraded（性能下降），而不是 down（宕机）——同步的 API 调用并不需要队列，宣布平台宕机会是一次误报。
• 当队列状态无法测量时，顶层状态保持不变：不知道，并不等于测得某样东西坏了。
• 如果平台宕机，该端点返回 HTTP 503。响应体不使用信封，以便监控工具无需解析即可告警，并且该响应永远不会被存入任何缓存。

错误与退出码

机器据以分支的是稳定的字符串。error 字段中的文本面向人类，经过本地化，并且会在不另行通知的情况下变化——基于消息文本做分支的集成不受支持，它因此出现故障也不算缺陷。

两套分类，两个字段。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 · 不可以——被角色关卡拦截，或者用只读作用域的密钥调用了写入命令。
• not_found — HTTP 404 · error_code not_found · CLI 2 · 不可以——命令名称错误或已被移除。
• （schema 校验） — HTTP 422 · error_code invalid_request · CLI 2 · 不可以——请求体或某个参数未通过 schema 校验（errors{}）；这不是业务规则问题。
• server_error — HTTP 500 · error_code server_error · CLI 6 · 可以——使用同一个幂等键进行指数退避重试；该键没有被锁定。
• 401 unauthenticated — 令牌已过期或已被吊销。重试无济于事；必须更换令牌。
• 429 rate_limited — 该令牌受到速率限制。响应始终带有 Retry-After，以及包含 retry_after、limit 和 bucket 的响应体；请遵守它，而不要自己设定固定的延迟。lg 会等待并最多重试三次，然后以退出码 5 退出。
• 5xx server_error / 网络错误 — 使用指数退避和同一个幂等键重试。更换键会重新执行服务器可能已经完成的工作。lg 会重试三次（1 s、2 s、4 s），然后以退出码 6 退出，error_code 为 network_error 或 server_error。

稳定性承诺

集成契约中最昂贵的问题是：“我今天写的代码明天还能运行吗？”一个数字就能回答它：目录中的 contract_version，以及每个响应中的 X-Contract-Version 头。它只回答一个问题——之前写的代码能否原封不动地继续运行？如果这个数字没有增加，答案是能。如果增加了，答案是不能：您所依赖的某样东西被移除或收窄了。

因为公告并不移除任何东西：在公告发布后的第二天，您现有的代码依然与之前完全一样地运行。如果在公告时就提升版本，同一次变更就会发出两个信号，并训练您忽略第一个——从而削弱真正重要的那个信号。公告已经随您正在进行的调用一起送达：目录行上的 deprecated_at 和 replaced_by，该命令响应中的 X-Deprecated 头以及 deprecated 块，如果您使用 lg，还会有一行 stderr 警告。您无需做任何事就能得知某样东西即将移除；它已经在您的日志里了。

从公告到移除之间至少相隔两个日历季度。在整个窗口期内，旧命令依然会响应，并在每次调用时发出警告。当一个 CLI 名称被停用时，它的继任者会以别名的形式接管该名称：在窗口期内，旧名称调用的是旧命令；而在它被移除的那一天，同样的调用会落到新命令上——无需您发布任何客户端版本。

preview_invoice → get_invoice（2026 年 9 月 3 日公告）。get_invoice 返回相同的预览块，并增加了明细行、税额明细、已记录的付款、剩余余额，以及通过您自己的 ERP 键（external_ref）进行寻址。preview_invoice 依然有效，lg invoices preview 也是如此——两者都会发出警告。

• 不变 — 新命令 · 新的可选参数 · 新的响应字段 · 新的错误键 · 新的端点 — 什么都不用做。您必须忽略不认识的字段；遇到未知字段就失败的解析器不符合规范。
• 不变 — 弃用“公告”：通知某条命令即将移除 — 您的代码继续运行。请在日历中记下一项任务——窗口期至少为 6 个月。
• 增加 — 移除命令 · 停用旧的 CLI 名称 · 删除响应字段 · 将可选参数改为必填 · 收窄枚举 — 这意味着您错过了窗口期；通知曾通过三个不同的地方送达您。
• 命令的 API 名称（例如 list_loads）永久冻结；HTTP 调用中使用的就是这个名称。
• error_code（传输层）和 error_key（业务规则）是稳定的字符串。可能会出现新的值——请将字典中找不到的键视为一般性失败，而不是破坏性变更。
• HTTP 状态与响应体中 status 字段之间的对应关系是固定的。
• 版本号永远不会减小，并且在每个响应中都可读取——包括没有响应体的 304 和 429。
• 错误和描述的“文本”。它经过本地化，并会在不另行通知的情况下变化；不支持根据消息文本做分支。
• “响应中不会出现您不认识的字段”这一假设。添加字段并不会提升版本。
• 把自增 id 当作业务键。请用 external_ref 携带您自己的键。
• 由类名派生的动态错误键；它们不属于契约的一部分。

命令身份表

下表并非手写：每次提供本页时，都会从实时命令注册表生成。服务器上新增的命令会自动出现在这里。“关卡”列告诉您一条命令是否请求确认，以及其效果能否撤销；“角色”列告诉您哪些账户类型会在其目录中找到它。徽章标出了需要 manager 级密钥的命令、需要文件的命令，以及只能从 lg 运行的命令。

API 名称（list_loads）是冻结的，永远不会改变；HTTP 调用中使用的就是这个名称。CLI 身份（loads list）受版本管理策略约束：一旦公告，只能随着版本提升和迁移窗口而改变，在此期间目录会以别名形式继续提供旧的组合。这里的描述来自每条命令自身的记录，并经过缩短——如需完整文本、参数类型和枚举值，请读取目录端点或运行 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，持有一个从面板签发的个人访问令牌。我们绝不会创建合成的服务账户——不属于任何公司、不受作用域约束、无人对其负责。

这是架构问题，而不是偏好问题。多租户隔离完全建立在用户所属的公司之上；对于没有公司的身份，隔离作用域就会失效，而该令牌上的一次错误查询就会读取到不属于它的数据。第二个原因是审计：台账中的用户列把“谁执行了这个”与一个人联系起来；服务账户会让这一列失去意义，并让一个负责开票的集成无人负责。第三个原因是吊销：如果令牌属于某个人，那么当这个人离开时，集成也会随之沉默。没有主人的桥接程序，正是那种会悄无声息地持续写入多年的桥接程序。

• 实践中：公司在面板中创建一个普通用户（例如由一名具名员工负责的 “ERP Bridge”），为其分配一个范围很窄的角色，从该用户的会话中签发令牌，并将其放入 ERP。
• 该用户在权限系统中可见，其权限可以被裁减，其令牌也可以单独吊销。被禁止的不是创建账户——而是创建一个不绑定到租户的账户。
• 一个令牌只用于一个集成。如果两个系统共用一个令牌，吊销的粒度就不复存在：切断 CRM 就意味着同时切断 ERP。

ERP 与 CRM 集成 — 版本管理与弃用

目录响应带有一个整数 contract_version；命令条目带有 since、deprecated_at 和 replaced_by。契约版本只会因破坏性变更而提升。

• 以下情况版本“不会”提升：新命令、新的可选参数、响应中的新字段。消费方必须忽略它不认识的字段；遇到未知字段就报错的客户端不符合规范。
• 以下情况版本“会”提升：移除或重命名命令、删除响应字段、将可选参数改为必填、收窄枚举。旧的形式会借助 deprecated_at 和 replaced_by 继续存在至少两个日历季度（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 的命令，也会返回租户自己的业务键（SKU、代码、税号），以便 ERP 在自己一侧进行匹配。

ERP 与 CRM 集成 — 分页、筛选与增量同步

列表命令接受 limit 并返回 count。对于夜间同步，契约承诺以下内容；已采用该契约的列表命令会在其 JSON Schema 中声明 cursor 和 updated_since，在此之前，请把它视为一个小窗口（上限 20 行，没有游标）。

• 请求：limit（1 到该命令的上限）加上 cursor（不透明、只能向前、由服务器签名）。“不”使用 offset——在实时变化的表中，offset 会发生偏移；在两页之间插入的记录会让 ERP 跳过一行或重复统计一行，而且是悄无声息的。
• 响应：{ count, total?, next_cursor|null }。count 是本次响应中的行数；当 next_cursor 为 null 时，列表已完整。请将 next_cursor 原样传回——它不是页码，也不该由您来构造。
• 被篡改或来自他处的游标会以 422 invalid_request 被拒绝；游标绑定到接收它的公司，无法用于翻阅其他租户的数据。
• 筛选：使用 JSON Schema 中的具名参数，以 AND 组合。没有自由的查询语言——DSL 会成为我们必须防御的第二个查询面。
• 增量同步：updated_since（ISO-8601，UTC）加上游标。保存您见过的最新 updated_at，并在下一次运行时传回；否则，每个 ERP 每小时都会重新获取全部内容。
• 外部引用：写入命令接受 external_ref（您自己的单据键），在每家公司内唯一；使用相同 external_ref 的第二次创建会被拒绝，而不是生成重复记录，list/get 也会返回它，以便您在自己一侧匹配记录。

ERP 与 CRM 集成 — 速率限制

限制的键是令牌，而不是 IP：ERP 是从单一 NAT 后面访问的，基于 IP 的限制会把整个公司算作一个用户。两个集成使用两个密钥，就永远不会互相消耗对方的配额——这是“一个集成一个密钥”的第二个理由。

• 无需认证的发现（public/cli/catalog）：每分钟 30 次。它是一本字典，而不是数据源；在编写桥接程序时读取一次即可，切勿在生产循环中读取。
• 目录端点（GET common/commands、GET common/commands/{name}）：每个令牌每分钟 120 次。目录很少变化，对 If-None-Match 会返回 304；不要在每条命令之前都重新获取它——lg 会将其缓存一小时。
• 读取命令（read_only: true 的 POST common/commands/{name}）：每个令牌每分钟 120 次。
• 写入命令（read_only: false 的 POST common/commands/{name}；未知名称也计入此类）：每个令牌每分钟 30 次。写入有副作用；失控的循环会被计费。
• 消耗点数的命令（目录行中的 credit_cost 不为零——例如 tariffs inquiry 和 export-documents generate）：真正的限制是“点数”，而不是请求次数。一个 200 响应可能已经消耗了点数。
• 每家公司的每日上限，与面板共享：向公司外部人员发送电子邮件或推送的命令共用每天 300 条外发通知的额度，启动付费集装箱或船舶追踪的命令共用每天 100 次的额度。超过上限时，命令会返回 DAILY_LIMIT_REACHED 以及 retry_after；文件上传有自己的上限（参见“需要文件的命令”）。
• 429 始终带有 Retry-After 以及响应体 { error_code: "rate_limited", retry_after, limit, bucket }；请遵守它，而不要自己设定固定的延迟。目录在 rate_limits 下公布当前的数值。

ERP 与 CRM 集成 — 我们不会做的事

这往往是契约中最有用的部分：知道什么永远不会到来，您就可以围绕它进行设计。

• 没有服务账户，也没有任何不绑定到租户的主体。
• 不通过 API 或聊天处理支付、卡号或法律同意。这些步骤保留在本人的浏览器中；命令会把链接交给您。
• 没有第二条路径：没有直接的数据库访问，没有 shell 访问，也没有绕过唯一强制执行点的批量端点。角色关卡、确认关卡、幂等性和审计台账只在那里强制执行。
• 不支持根据错误消息文本做分支；文本经过本地化，并会在不另行通知的情况下变化。
• 没有 offset 分页。
• 不支持在您的 ERP 中把表层 id 用作业务键。
• 外发 webhook 不会被硬塞进这份契约——但它们现在已经“存在”，并在本页中有文档说明（见上文的 webhook 一节）。目录是一个“拉取”接口，而事件流是一份“独立”的契约：事件名称和 payload schema 按各自的规则进行版本管理，与命令目录的契约版本无关。

机器可读的目录

本页是为人编写的。对于 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 助手以进行注册和货运询价，是一个独立的通道，有自己的页面：

• 目录无需认证；执行则需要认证。不存在代表智能体运行命令的途径——运行时使用的始终是用户自己的身份。
• Logistivo 的密码、验证码或访问令牌永远不会经过聊天。请勿构建任何索要、生成或转交它们的流程。
• 一条命令是否不可撤销，写在目录中。对于 irreversible: true 的命令，切勿建议“我们试试看”。
• credit_cost 不为零的命令（例如 tariffs inquiry 和 export-documents generate）会产生金钱上的结果；请勿在自动化循环中调用它们。
• 支付、卡号和法律同意永远不经过聊天或智能体。请改为提供 handoff-links generate 返回的链接；由本人在自己的浏览器中完成这一步。
• 使用用户密钥行事的智能体应首先调用 users get：它会返回角色、密钥的访问级别、实际生效的权限，以及是否有待处理的同意或手机验证正在阻止写入——提前预判拒绝，而不是一次次去碰壁。
• 本页的纯文本副本发布在 /cli.md 上；如果您解析 markdown 比解析 HTML 更可靠，请使用它。

机器可读的定义：OpenAPI 3.1 与 Postman

上面的目录是 Logistivo 自有的格式。同样的信息还以两种您的工具早已熟悉的行业标准格式发布：OpenAPI 3.1 定义和 Postman 集合。两者都不是手写的——都在每次请求时从实时命令注册表生成，因此不会过时。

这份定义“就是”目录，而不是第二个现实。每条命令都以一个 POST /api/common/commands/ 操作出现；请求体 schema 就是该命令自身的 JSON Schema（与助手看到的逐字节一致），响应 schema 是共用的信封，关卡标志（read_only、confirmation_needed、irreversible 以及点数徽章）位于 x-logistivo 扩展中，业务错误键位于 x-error-keys 之下。已停用的命令会被标记为 deprecated: true，并在其六个月的窗口期内仍可调用。

除命令接口之外，承载集成契约的 REST 端点也包含在定义中：10 个支持增量同步（updated_since + cursor + limit）的列表端点，以及 7 个接受您自己的键（external_ref）的写入端点。Logistivo 的 REST 接口面远不止这些；其余部分是“有意”排除的。那些 payload 是产品自身的契约，凭猜测写出的 schema 会让您生成的客户端在第一次调用时就出错——而您会在自己的代码里寻找缺陷，而不是在我们的代码里。

定义是按请求者的“角色”生成的：其他角色的命令永远不会进入文档，因为定义是一份契约而不是一本字典，其中的一切都必须能用该令牌调用。无需认证的版本是三个角色的并集，其中每个操作都会在 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 — 无需认证的版本——三个角色的并集。用于在拿到令牌之前设计桥接程序并估算成本。
• GET /api/public/cli/postman.json — 无需认证的 Postman 集合：一个可以直接交给团队的文件。
• 559 个操作 — 519 条命令 + 36 个 REST 与控制平面操作 + 4 个目录与身份端点。本页上的数字不是手工输入的；它们在每次请求时从实时文档中统计得出，因此某条命令上线的当天，这里的数字也会随之增加——而且加起来是吻合的。
• 安全方案 — bearerAuth：为真实用户签发的 Passport 令牌。只读作用域的密钥只能调用标记为 x-logistivo.read_only: true 的操作；写入尝试会在确认关卡“之前”返回 403，因此只读密钥永远不会看到 409。
• 每个错误分支都写得清清楚楚 — 每个操作都分别描述 401/403/404/409/422/429/500。409 的两种含义（需要确认 / 幂等冲突）以及 422 的两种含义（schema 错误 / 业务拒绝）在文档中是分开的，因此您的生成器不会把它们合并成一个分支。
• 没有时间戳 — 文档不包含生成时间。相同的目录会产生相同的字节，这正是 ETag 真正起作用的原因，也是您提交到版本控制中的定义不会在每次下载后看起来都“有变化”的原因。
• 我们没有编造产品 payload — 在 REST 写入端点上，只描述了契约字段（external_ref）；请求体的其余部分以 additionalProperties: true 保持开放，并引导读者参阅产品文档。一份不完整但真实的定义，胜过一份完整但编造的定义。
• 每个操作的错误键列表“并不”详尽 — x-error-keys 只列出从命令自身记录中可以确定推出的键，并通过 x-error-keys-exhaustive: false 声明这一点。完整的字典位于文档根部；请将任何您不认识的键视为一般性失败。一份捏造的“完整列表”会诱使您永远不写 default 分支。
• 发现工具不在定义中 — search_commands、run_command 和 list_capabilities 只存在于聊天循环内部，无法通过 HTTP 调用。如果把它们包括进来，您的生成器就会写出三个永远无法工作的方法。

代码生成：从定义生成类型化客户端

您已经有了定义；现在用它生成可运行的代码。`lg codegen` 读取 OpenAPI 文档，并写出一个单文件、无依赖的客户端——TypeScript（类型声明加上一层轻量的调用封装）或 PHP（带有 PHPDoc 数组形状的客户端类）。无需 `npm install`，也无需 composer：TypeScript 一侧使用 `fetch`，PHP 一侧使用 `ext-curl`。

生成过程发生在“您的”机器上，而不是我们的服务器上。这不是偏好问题：只需在您的代码仓库中固定一次定义（`lg spec --out=...`），同一条命令就能在每次构建时运行，无需网络也无需令牌，因此您的 CI 永远不依赖我们的可用性。而且，由于生成的代码是要在您的 ERP 中“运行”的代码，把它保存在您的仓库中而不是从 API 拉取，意味着每一处变化都会出现在 `git diff` 中。

生成的客户端能正确处理 Logistivo 的全部三条通道，并且是从文档中得知哪条是哪条，而不是靠猜测：每个操作都在 `x-logistivo.surface` 中声明了自己所属的通道。命令通道会解开 `{success, data:{…}}` 信封；REST 同步列表“没有”信封，会按原样返回（解开它会丢掉 `next_cursor`）；REST 写入返回端点自身的产品响应体。通用的生成器不了解这种区别——我们的生成器了解。

类型不是猜出来的：每条命令的参数接口都由助手所看到的那份 JSON Schema 生成。必填的保持必填，枚举变为联合类型，嵌套对象变为嵌套类型。在实践中：如果服务器要求某个字段，遗漏它的调用不会在生产环境中以 422 失败——而是在编译时就失败。

文件中不会写入生成时间戳：相同的定义加上相同的选项，会产生相同的字节。因此，重新生成不会在 `git diff` 中制造噪音，而真正发生变化的那一件事——契约——始终清晰可见。

• 1. 固定定义 — 定义按您的角色生成；其中的每个操作都可以用该令牌调用。请提交该文件。 lg login --api-key= lg spec --out=logistivo-openapi.json
• 2. 生成客户端 — 输出一个文件，把您所固定的定义中的“每一个”操作都作为方法包含在内：您的角色可调用的命令、承载集成契约的 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
• 每个操作一个方法 — 文档中的每条命令、每个承载集成契约的 REST 端点，以及发现端点。从您角色的定义生成，您只会得到您可以调用的内容（货主为 448 条命令）；从公开定义生成，您会得到全部 559 个操作。服务器上新增命令的当天，重新生成即可将其纳入；无需等待客户端发布。
• 参数类型 — 每条命令的 `args` schema 都会变成一个接口（在 PHP 中为数组形状）。必填字段保持必填，枚举变为联合类型。在 TypeScript 中，遗漏必填字段会产生编译错误；在 PHP 中，您的 IDE 和 PHPStan 会看到相同的形状。
• 错误类 — 传输层分类（`error_code`）和业务分类（`error_key`）是两个独立的字段；确认关卡和速率限制是两种独立的错误类型。错误键联合类型对未知值保持开放——当服务器声明一个新键时，您的代码不会因此无法编译，而是落入 `default` 分支。
• 正确的重试策略 — 自动重试只适用于安全的调用：读取，以及携带幂等键的写入。一次没有键的写入超时，并不意味着“什么都没写入”，因此客户端永远不会盲目地重复它。遇到 429 时，它会等待服务器给出的 `Retry-After`，而不是自己编造一个延迟。
• 结果体没有类型 — 命令结果以 `unknown`（在 PHP 中为 `mixed`）返回，原因与定义本身相同：结果的形状是命令的业务输出，不属于契约的一部分。一个靠猜测得出的结果类型，在某个字段第一次移动时就会开始说谎。
• 生成的文件不应手工编辑 — 它是输出，而不是源代码。如果您需要额外的行为，请包装生成的类；您在其中写的任何内容都会在下一次生成时丢失。
• 不生成发现工具 — `search_commands`、`run_command` 和 `list_capabilities` 只存在于聊天循环内部，无法通过 HTTP 调用；它们不在定义中，因此也不在客户端中。如果把它们包括进来，就意味着要写出三个永远无法工作的方法。

诚实的范围说明

我们宁愿让这一节变长，也不愿让它变短。一份集成契约的价值，与其说在于它承诺了什么，不如说在于它多么清楚地说明了自己不做什么。

• CLI 在租户用户的上下文中运行 — 每条命令都在所出示令牌对应用户的公司和角色下运行。平台运营者模式——一种跨公司读取的管理模式——不在这个接口面之内，也不会从这里开放。
• 您的命令列表取决于您的角色 — 货主账户可看到 448 条命令，承运商 452 条，报关行 312 条，联盟推广账户 55 条。如果您的目录中缺少某条命令，请先检查角色；如果命令已列出却被拒绝，请检查密钥的作用域和访问级别。司机账户完全无法访问这个接口面。
• 部分命令会消耗点数 — 税则查询、单证生成以及其他少数由 AI 支持的命令，会从您套餐的点数余额中扣除。每个目录行都带有 credit_cost {mode, credits}：fixed 表示每次调用的确切扣费，read_only 永不扣费，computed 表示扣费取决于具体调用——此时 credits 为 null，真实数字会显示在确认卡片上。预检（dry_run）会告诉您一次调用将扣除多少点数，以及您的余额是否足够。
• 集成密钥无法驱动面板聊天 — 面板内的 AI 助手是给人用的。用集成密钥启动或继续一次助手运行会以 403 被拒绝；智能体应使用命令端点、lg 或 MCP 通道，在那里每条命令都以密钥的访问级别运行，其写入会被记录为集成写入。
• 目录并不取代现有的 REST API — 支撑 Logistivo Web 和移动应用的 REST 接口面保持原样，并继续遵守向后兼容规则。命令目录不取代资源的 CRUD；它是“动词”层——完成一件事的唯一的、经过审计的途径。
• 列表命令目前返回小窗口 — 在某个列表命令于其 schema 中声明 cursor 和 updated_since 之前，它的上限是 20 行，且没有游标。它并非为提取您数据的完整副本而设计；增量同步正在逐条命令地推广。

常见问题

Logistivo CLI 有什么用途？

它可以从终端、脚本或您自己的 AI 智能体运行您 Logistivo 账户中的工作：运单与行程、询价、报价与招标、车队、司机及其费用、单证、联系人与往来账户、发票与会计、仓库与库存、团队成员、HS 税则以及反倾销税。面板中的每一项写操作都有对应的命令；支付、法律同意和账户注销有意保留在浏览器中。同样的命令也可以通过 HTTP 调用以实现 ERP/CRM 集成，或者通过 MCP 通道调用。

Logistivo CLI 中的命令是如何命名的？

所有命令都采用 lg --parameter=value 这一种形式。域是复数形式的实体（loads、demands、invoices、export-documents），动词取自一个封闭的词汇表，只有经过慎重决定才会扩充（list、get、create、update、search、set-status、generate 等）。同一实体的所有动词都位于同一个域中，(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 是单次运行的配置档选择器。

如何在脚本中读取 lg --json 的输出？

输出是完整的 HTTP 信封：{ "success": bool, "data": { "contract_version", "command", "status", "result" }, "code", "message" }。业务 payload 位于 .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 端点，其响应体有意不使用信封。

如果我把同一个请求发送两次，会产生重复记录吗？

只要您发送了 idempotency_key，就不会。使用同一个键的第二次调用不会重新执行命令，而是返回第一次的结果，状态为 replayed。该键应为 UUID，并且在多次重试之间必须保持“相同”——每次尝试都生成一个新键，等同于没有使用幂等性。

--yes 有什么作用？

它用于通过确认关卡。在不带 --yes 的情况下调用受关卡保护的命令时，什么都不会改变：服务器会用一句话概述它将要执行的操作，说明该操作是否不可撤销，然后停止（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 参数；请据此生成您的客户端，而不要硬编码命令列表。

新增命令时，我必须更新客户端吗？

不必。客户端从目录拉取命令列表，因此服务器上新增的命令无需发布新的客户端版本就会出现。只有在提升契约版本的破坏性变更时才需要更新，而在这种情况下，旧的形式会继续存在至少六个月。

CLI 会取代现有的 REST API 吗？

不会。支撑 Web 和移动应用的 REST 接口面保持不变。命令目录不取代资源的 CRUD；它是动词层——执行一项操作的唯一途径，并且经过角色关卡、确认关卡和审计。

如何获取 Logistivo API 密钥，它能做什么？

拥有团队管理权限的管理者可以在面板的 Settings › Integration keys（设置 › 集成密钥）下签发，也可以在终端中通过 lg keys create 签发。密钥代表一名真实的团队成员行事，并有三项相互独立的设置：作用域（read 开放目录和不写入的命令，write 开放所有命令——确认关卡保持不变）、可选的域授权，以及访问级别——employee 为默认级别，用于日常运营；manager 则用于团队、设置、密钥和资金相关的工作。密钥只显示一次，不在服务器上存储；它可以被轮换、转移和吊销。当它所代表的成员离开时，密钥也会随之关闭。不存在服务账户。

如果我把一个幂等键用于另一条命令，会发生什么？

服务器会返回 409 idempotency_conflict，并指出该键最初用于哪条命令；不会运行任何内容，也不会重放任何内容。键的作用范围限于您的公司，绑定到一条命令，并锁定 24 小时——此后，同一个键会开始一次新的执行。

速率限制如何应用于我的集成？

按令牌、按分钟计算，分为三个桶：目录读取 120 次，读取命令 120 次，写入命令 30 次。429 响应始终带有 Retry-After，以及包含 retry_after、limit 和 bucket 的响应体；请等待相应的时长后再重试。目录在 rate_limits 下公布当前的数值。

如何区分业务拒绝和传输错误？

首先根据 error_code 做分支：failed（422）是业务拒绝，并带有稳定的 error_key，例如 INSUFFICIENT_CREDITS 或 NOT_FOUND；server_error（5xx）和网络错误应使用同一个幂等键重试；rate_limited（429）则需等待。切勿根据错误文本做分支。

Logistivo 会发送 webhook 吗？针对哪些事件？

会。您注册一个 https 地址并选择您关心的事件；事件发生时会收到一个签名的 POST。目前可订阅 13 个事件：运单已创建/状态已变更/司机已指派，询价已创建和状态已变更，报价已提交/已修改/已接受，发票草稿/已开具/已取消，以及仓库预订已创建/状态已变更。每个名称都对应一个真正会被派发的事件类——不存在宣布了却从未触发的事件，因为这样的事件是一种无声的失败，集成方会永远等待下去。订阅可在 Settings › Integration › Webhooks（设置 › 集成 › Webhooks）下创建，也可以在终端中通过 lg webhooks create 创建。

如何验证 Logistivo webhook 签名？

每个请求都带有 X-Logistivo-Signature 头：t=,v1=。被签名的字符串是 "."，算法为 HMAC-SHA256，密钥是订阅的签名密钥。四条规则：(1) 验证原始字节——对请求体解码再重新序列化（JSON.stringify / json_encode）会把相同的数据变成不同的字节，签名就不再匹配；这是最常见的错误；(2) 检查时间戳，即使签名正确，也要丢弃任何 |now − t| > 300 秒的请求；(3) 使用 hash_equals / timingSafeEqual 以恒定时间进行比较；(4) 按 event_id 去重，而不是按投递 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 重新发送单次投递。增量同步（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 就会先上传该文件；当命令只有一个文件字段时，--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 更改级别。

联盟推广（affiliate，即推荐合作方）账户可以使用 CLI 吗？

可以。联盟推广账户拥有自己的目录——55 条命令，涵盖推荐、潜在客户、CRM 备注与任务、销售演示文稿、收益与提现——并像其他任何角色一样，通过 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.