Lillo
開発者ドキュメントユーザーガイド
カスタムストアAPI / 注文オブジェクト（Order・Item・Shipment）

カスタムストアAPI  /  注文オブジェクト

注文オブジェクト（Order・Item・Shipment）

注文照会のレスポンスに含まれるオブジェクトです。名前はCafe24と同じで、Lillo独自のフィールドは説明に「拡張」と記載しています。

Order

order_idstring必須

注文番号

order_datestring必須

注文日時（ISO 8601）

itemsItem[]必須

注文商品

member_idstring任意

会員ID。非会員の注文では省略します

payment_datestring任意

決済日時

paidstring任意

決済済みかどうか"T"/"F"

payment_methodstring[]任意

決済手段（例：["card"]）

payment_amountstring任意

決済金額

actual_order_amountobject任意

shipping_fee（送料）、total_amount_due（支払予定額）。未決済でpayment_amountが0の場合はtotal_amount_dueで案内します

buyerobject任意

注文者。氏名・連絡先はマスキング

receiversobject[]任意

配送先name、cellphone、zipcode、address1、address2。氏名・連絡先はマスキング

shipmentsShipment[]任意

配送情報。含めれば配送照会エンドポイントを省略できます

currencystring任意

拡張。通貨（省略時はKRW）

status / status_labelstring任意

拡張。Lillo標準ステータスと表示名 — ステータス対応表を参照

order_urlstring任意

拡張。お客様が開ける注文詳細URL

customsobject任意

拡張・準備中。通関ステータス — 下記参照

Item

order_item_codestring必須

商品明細コード

product_namestring必須

商品名

quantitynumber必須

数量

order_statusstring必須

Cafe24ステータスコード（例：N30）

product_nostring任意

商品番号

option_valuestring任意

オプション（例：Color=Ivory, Size=M）

product_pricestring任意

商品価格。実際の単価はproduct_price + option_price

option_pricestring任意

オプション追加金額

claim_statusstring任意

クレームステータス

shipped_date / delivered_datestring任意

出荷・配送完了日時

imagestring任意

拡張。商品写真の絶対https URL。空文字は不可 — オプションの写真がなければ商品の代表画像

status / status_labelstring任意

拡張。商品ごとのLillo標準ステータスと表示名

よくある間違い — 商品写真が空

商品明細のimageには、商品写真の絶対https URLを入れてください。空文字（""）は不可です。注文されたオプションに専用の写真がなければ、その商品の代表画像を入れてください。オプションIDだけで写真を探すと、空になりがちです。

商品明細のimage — 良い例 / 悪い例
// Good — the option has no photo, so use the product's main image
"image": "https://cdn.mall.example.com/products/77/main.jpg"

// Bad — empty string or relative path
"image": ""
"image": "/products/77/main.jpg"

Shipment

tracking_nostring必須

送り状番号

shipping_company_namestring必須

配送業者名。ない場合はshipping_company_code（Cafe24コード）から名前を探します

shipping_codestring任意

配送コード

shipping_company_codestring任意

Cafe24の配送業者コード

statusstring任意

standby（待機）・shipping（配送中）・shipped（完了）

itemsobject[]任意

この配送に含まれる商品明細のorder_item_code

tracking_urlstring任意

拡張。配送追跡URL

shipped_datestring任意

拡張。出荷日時

通関ステータス（準備中）

海外配送の注文向けに、customs（拡張）で通関ステータスを渡せる形式を予約しています。Lilloが読み取りを始めたら、変更履歴でお知らせします。

customsの形式
"customs": {
  "status": "pending" | "in_progress" | "duty_required" | "cleared" | "failed",
  "label": "Customs clearance in progress",
  "note": "Duty notice sent by SMS"
}
前へ注文照会次へステータス対応表
注文オブジェクト（Order・Item・Shipment） · 開発者ドキュメント | Lillo