POST api/ESSystem/v1/GeneratorCycles/handovers/add

يسجّل عملية تسليم/استلام وردية داخل الدورة.

Request Information

URI Parameters

None.

Body Parameters

Name	Description	Type	Additional information
ID	معرّف عملية التسليم (فارغ عند الإضافة).	globally unique identifier	None.
CycleGuid	معرّف الدورة (مطلوب).	globally unique identifier	None.
HandoverTime	وقت التسليم (مطلوب).	date	None.
FromOperatorGuid	معرّف حساب المشغّل المسلِّم (اختياري).	globally unique identifier	None.
ToOperatorGuid	معرّف حساب المشغّل المستلِم (مطلوب).	globally unique identifier	None.
MeterReadAtHandover	مؤشر العداد لحظة التسليم.	decimal number	None.
Note	ملاحظات.	string	None.

Request Formats

application/json, text/json

Sample:

{
  "ID": "cc474fc0-2343-42c4-8b3a-b414c354a974",
  "CycleGuid": "67df5086-aa17-4071-9fcf-e55929f8bfeb",
  "HandoverTime": "2026-11-15T02:22:21.0510122+03:00",
  "FromOperatorGuid": "5e824ca6-5522-4979-acf3-56768b4d1691",
  "ToOperatorGuid": "3e5c5241-b8d6-4276-8596-eb2268ba6c70",
  "MeterReadAtHandover": 1.0,
  "Note": "sample string 2"
}

application/xml, text/xml

Sample:

<HandoverModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
  <CycleGuid>67df5086-aa17-4071-9fcf-e55929f8bfeb</CycleGuid>
  <FromOperatorGuid>5e824ca6-5522-4979-acf3-56768b4d1691</FromOperatorGuid>
  <HandoverTime>2026-11-15T02:22:21.0510122+03:00</HandoverTime>
  <ID>cc474fc0-2343-42c4-8b3a-b414c354a974</ID>
  <MeterReadAtHandover>1</MeterReadAtHandover>
  <Note>sample string 2</Note>
  <ToOperatorGuid>3e5c5241-b8d6-4276-8596-eb2268ba6c70</ToOperatorGuid>
</HandoverModel>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

ApiResult

Name	Type	Additional information
Error	integer	None.
Message	string	None.
Data	Object	None.

Response Formats

application/json, text/json

Sample:

{
  "Error": 1,
  "Message": "sample string 2",
  "Data": {}
}

application/xml, text/xml

Sample:

<ApiResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Core.Common">
  <Data />
  <Error>1</Error>
  <Message>sample string 2</Message>
</ApiResult>