> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seminode.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 挂单

> 挂单传达关于某种物料的具体信息——供应或需求。

挂单表示提供某种物料的报价，或采购某种物料的请求。挂单会发布到公司的**网络节点**上，已连接的贸易伙伴可以在此发现并查询它们。

**Kind：** `31001`

<Note>
  Kind `31001` 是一种**可替换的可寻址事件**。这意味着挂单可以就地更新——当您使用相同的 `d` 标签重新发布时，节点会替换先前的版本而不是创建重复项。挂单的价格、数量和可用性正是通过这种方式保持最新的。
</Note>

**内容：**

```yaml theme={null}
{
  "material_no": "<string - Material Number (Required)>",
  "mfr": "<string - Manufacturer (Required)>",
  "qty": <int - Quantity (Required)>,
  "timing": {
    "lead_time": <string - Lead Time (Optional), supply listings>,
    "required_date": <int64 - Required Date as Unix timestamp (Optional), demand listings>
    "expiry": <int64 - Listing expiry as Unix timestamp (Optional)>
  },
  "unit_price": <float64 - Unit Price (Required)>,
  "internal_no": "<string - Internal Number (Optional)>",
  "type": "<string - 'supply' or 'demand' (Required)>",
  "company": "<string - Publish Company Name (Optional)>",
  "contact": {
    "methods": ["<string - Contact method>"],
    "reply_url": "<string - Contact reply URL>"
  },
  "image_url": "<string – Image URL (Optional)>",
  "attributes": {
    "coo": "<string - Country of Origin (Optional)>",
    "eccn": "<string - Export Control Classification Number (Optional)>",
    "moq": <int - Minimum Order Quantity (Optional)>,
    "mpq": <int - Minimum Pack Quantity (Optional)>,
    "currency": "<string - ISO 4217 Currency Code (Optional)>",
    "lot_no": "<string - Lot Number (Optional)>",
    "custom_attributes": {
      "<string>": "<any - User-defined attributes>"
    },
  },
  "encrypted": {
    "payload": {
      "ciphertext": "<string - Encrypted JSON object (type: object, Optional)>"
    }
  },
  "schema_version": "<string - listing schema version"
}
```

**关键字段：**

* **`type`** —— 值为 `"supply"`（您有库存出售）或 `"demand"`（您需要采购物料）。它决定了哪些时间字段是相关的：供应挂单使用 `lead_time`，需求挂单使用 `required_date`。
* **`contact.reply_url`** —— 您的收件节点的 WebSocket URL。贸易伙伴通过它得知应将针对该挂单的报价发送到何处。
* **`encrypted.payload`** —— 一个可选的加密对象，用于放置您希望仅对特定伙伴可见（而不对更广泛网络公开）的字段。

**挂单标签**

```json theme={null}
[
  ["n", "material_no"],
  ["m", "manufacturer name"],
  ["y", "'supply' or 'demand'"],
  ["c", "company_name"],
  ["b", "any"],
  ["i", "internal_no"],
  ["c", "any"],
  ["t", "any"],
  ["r", "inbox_node_url"]
]
```