Transfer a whole series to another reseller

POST /api/v1/card-batches/{id}/transfer-whole prm_cards_change_owner

Moves every card in the series from one manager to another at an agreed unit price, posting the matching ledger entries on both sides.

unit_price is a required tri-state and omitting it is refused rather than read as zero. A bare 0 from a client that simply left the field out would mean "give the stock away", which is exactly the defect this check exists to stop. A negative price inverts the transfer.

نظرة سريعة

المصادقة: رمز موظّف أو جلسة
تتطلب صلاحية: prm_cards_change_owner Transfer / change card owner
حد المعدل: t_mutate
مفتاح عدم التكرار: request_id

المعاملات

المعامل	الوصف
`id`مطلوب path · integer	Series id.
`from_manager_id`مطلوب body · integer	The current holder.
`to_manager_id`مطلوب body · integer	The receiving reseller.
`unit_price`مطلوب body · number	Price per card, major units. Must be sent explicitly — omitting it is an error, not a zero.
`request_id`مطلوب body · string	Idempotency key.

الأخطاء

الرمز	متى تُرجَع
`ERR_VALIDATION`400	unit_price omitted, or a request_id that is missing, too long or reserved
`ERR_CONFLICT`409	the request_id is already bound to a different transfer

الطلب

curl -X POST "$BASE/api/v1/card-batches/{id}/transfer-whole" \
  -H "Authorization: Bearer $XR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "from_manager_id": 41,
  "to_manager_id": 57,
  "unit_price": 140.00,
  "request_id": "c8e1a4b9-7f30-4d62-b0a5-6e2c9d3f1074"
}'

‏BASE هو عنوان مؤسستك: نفس العنوان الذي تسجّل الدخول منه.

جرّبه على شبكتك.

50 مشترك لمدة 7 أيام، من غير ما تدفع حاجة.

جرّب ببلاش كلّمنا