Захиалга

Суурь зам: /api/v1/merchant/orders

Танигч

Талбар	Утга
`id`	Chuchu захиалгын UUID. Авах, цуцлахад үүнийг ашигла
`orderNumber`	Хүнд уншигдах дугаар, жишээ нь `ORD-2026-001234`
`externalOrderId`	Таны системийн захиалгын id. Энэ API түлхүүр дээр давтагдахгүй

Chuchu харилцагчийн UUID хэрэггүй. customer.phone илгээ. customer.externalCustomerId нэмж болно.

Үүсгэх

POST /api/v1/merchant/orders

orders:write болон Idempotency-Key шаардлагатай.

Create захиалгыг ноорог үлдээлгүй хүргэлтэд оруулна. Хүргэлт үүссэн бол хариунд delivery байна. Үүсээгүй бол delivery нь null.

collectionMode, collectionAmount нь жолоочийн цуглуулалт. total-оос тусдаа.

Горим	Дүн	Утга
`NONE`	`0` эсвэл орхисон	Урьдчилж төлсөн, жолооч мөнгө авахгүй. Эерэг дүн `MERCHANT_API_INVALID_ORDER` буцаана
`COLLECT`	яг эерэг дүн	Жолооч энэ дүнг авна. `0` эсвэл орхисон бол татгалзана

Мөнгөн дүн аравтын мөр, жишээ нь "55000" эсвэл "55000.00". v1 валют MNT.

requestedDeliveryDate нь хуанлийн өдөр (YYYY-MM-DD). Chuchu түүнийг тэр UTC өдрөөр хадгалаад мөн YYYY-MM-DD буцаана. Өөр цагийн бүс рүү шилжүүлэхгүй.

Дэлгүүрээс очиж авах нь Chuchu хүргэлт биш. Pickup захиалгыг энд POST хийхгүй, хуурамч хаяг зохиохгүй.

SKU

items[].sku байвал Chuchu тухайн мерчантын каталогтой тулгана. Танихгүй эсвэл идэвхгүй SKU 422, код PRODUCT_SKU_NOT_FOUND эсвэл PRODUCT_SKU_INACTIVE. Танихгүй SKU-гаар бүтээгдэхүүн үүсгэхгүй.

sku-г зөвхөн нөөцгүй нэг удаагийн мөрөнд орхи.

Харилцагч

Энэ API клиент externalCustomerId-г өмнө ашигласан бол тэр харилцагчийг дахин авна.
Үгүй бол нормалчилсан утсаар энэ мерчант дотор нэг тааралт хайна.
Олдохгүй бол харилцагч үүснэ.
Утас олон харилцагчтай таарвал 422 CUSTOMER_PHONE_AMBIGUOUS. Харилцагч мерчантуудын хооронд хуваалцахгүй.

Унших

GET /api/v1/merchant/orders/:orderId — нэг захиалга, зөвхөн энэ мерчант.
GET /api/v1/merchant/orders — шүүлт: externalOrderId, orderNumber, status, customerPhone, createdFrom, createdTo, page, pageSize.

Цуцлах

POST /api/v1/merchant/orders/:orderId/cancel

json

{ "reason": "Cancelled in merchant ERP" }

Chuchu дээрх цуцлалтын дүрэмтэй адил. Төгсгөлийн эсвэл цуцлах боломжгүй төлөв алдаа буцаана. Холбоотой хүргэлт Chuchu-ийн ердийн цуцлалтаар явна.

bash

curl https://api.chuchu.mn/api/v1/merchant/orders \
  -H "Authorization: Bearer $CHUCHU_API_KEY"

curl https://api.chuchu.mn/api/v1/merchant/orders/ORDER_UUID \
  -H "Authorization: Bearer $CHUCHU_API_KEY"

curl -X POST https://api.chuchu.mn/api/v1/merchant/orders/ORDER_UUID/cancel \
  -H "Authorization: Bearer $CHUCHU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reason":"Cancelled in merchant ERP"}'

Захиалга ​

Танигч ​

Үүсгэх ​

SKU ​

Харилцагч ​

Унших ​