上午（GreenInvoice）

适用场景

当您需要与 Morning / GreenInvoice 进行交互时，请使用此技能，包括以下操作：

• 使用 API 密钥凭据获取认证令牌（JWT）
• 创建或更新 客户（clients）
• 创建或更新 商品（items）
• 创建 单据（documents）（如：发票 / 收据 / 报价单 / 订单 / 贷项凭证 / 借项凭证）
• 若工具支持，检索单据输出信息（例如：ID / 链接）

需向用户收集的信息

仅收集执行当前操作所必需的字段：

认证

• apiKeyId
• apiKeySecret

客户（若需创建或查询）

• name
• 可选：taxId、email、phone、address、city、country

商品（若需创建）

• name
• price
• 可选：description、currency

单据（若需创建）

• documentType（取值为：Invoice / Receipt / Quote / Order / CreditInvoice / DebitInvoice）
• clientId（或足以创建客户的必要信息）
• lines[]（每行包含：description 或 itemId、quantity、unitPrice）
• 可选：currency、language、description、discount

工具契约

请使用 morning 工具，并传入 action 字段。

支持的操作

• getToken
• createClient
• createItem
• createDocument
• （可选，若您的工具已实现）：findClient、findItem、getDocument、listDocuments

安全约束

• 严禁将 apiKeySecret 或 JWT 明文记录或回显给用户。
• 优先复用已存在的 clientId / itemId（如有）。
• 校验单据明细行（lines）：
  • quantity 必须大于 0
  • unitPrice 必须大于等于 0
• 币种（currency）：默认为 "ILS"，除非用户另行指定。
• 语言（language）：默认为 "Hebrew"，除非用户另行指定。

示例

1) 认证（获取 JWT）

{
  "action": "getToken",
  "apiKeyId": "YOUR_API_KEY_ID",
  "apiKeySecret": "YOUR_API_KEY_SECRET"
}

2) 创建客户

{
  "action": "createClient",
  "jwt": "JWT_FROM_getToken",
  "client": {
    "name": "Acme Ltd",
    "taxId": "515555555",
    "email": "billing@acme.com",
    "phone": "+972-50-000-0000",
    "address": "1 Rothschild Blvd",
    "city": "Tel Aviv",
    "country": "Israel"
  }
}

3) 创建商品

{
  "action": "createItem",
  "jwt": "JWT_FROM_getToken",
  "item": {
    "name": "Consulting hour",
    "description": "Senior engineering consulting",
    "price": 500,
    "currency": "ILS"
  }
}

4) 创建单据（Invoice）

{
  "action": "createDocument",
  "jwt": "JWT_FROM_getToken",
  "document": {
    "documentType": "Invoice",
    "language": "English",
    "currency": "ILS",
    "clientId": "CLIENT_ID",
    "description": "Invoice for January services",
    "lines": [
      {
        "description": "Consulting hour",
        "quantity": 10,
        "unitPrice": 500
      }
    ]
  }
}

5) 使用 itemId 创建单据（Receipt）

{
  "action": "createDocument",
  "jwt": "JWT_FROM_getToken",
  "document": {
    "documentType": "Receipt",
    "language": "Hebrew",
    "currency": "ILS",
    "clientId": "CLIENT_ID",
    "lines": [
      {
        "itemId": "ITEM_ID",
        "quantity": 1,
        "unitPrice": 1200
      }
    ]
  }
}

错误处理

• 若令牌被拒绝（HTTP 状态码 401/403）：重新调用 getToken，并重试一次原请求。
• 若客户或商品已存在：
  • 优先返回已有资源 ID（若工具支持查询）；
  • 否则明确提示：“客户已存在；请提供 clientId 或其他唯一标识符。”
• 若校验失败：仅要求用户提供缺失或无效的字段（例如：“quantity 必须大于 0”）。

输出预期

返回内容应尽可能精简，仅包括：

• 新创建资源的 ID（clientId、itemId、documentId）
• API 或工具提供的相关链接（如 PDF 下载链接、在线查看链接等）