It allows you:
to insert new return orders (master&details in one json file)
to view return orders (master&details in one json file) - ordered descending by created date and document date
Prerequisites:
In order to use this API Method for PUT there must be accomplished the following requirements in SocrateCloud:
to have an Organization active
to have an Warehouse active
to have a Customer active with all the mandatory fields
to have a price list active
Columns that can be used as filters:
Organization
DocumentNo
BPartner
CreatedBy
Actions can be done:
list
create
update
Return Order fields (Master Document)
A Return Order in SocrateCloud has the following structure:
Master document which contains data about header document:
No. document
Return Order data
Customer
Sales Representative etc.
Document details (see 21.1 Return Order Details) which contains the products that are ordered with informations about:
Product
Quantity
Selling price
VAT
URL: https://api.socratecloud.com/webapi/rest/RMA/create/{version}?accessToken={access_token}&Order_DocumentNo={OrigOrderDocumentNo}&InOut_DocumentNo ={InOut_DocumentNo}
Method: POST
Return: document no for success or error message (start with "ERROR: ")
Data format:
{
"data": [
{
"Organization": "Fidelio Farm",
"Created": "2020-05-20 15:19:58+0300",
"CreatedBy": "Razvan Admin",
"Updated": "2020-05-20 15:20:45+0300",
"UpdatedBy": "Razvan Admin",
"DocumentNo": "DRT110442",
"OrderReference": null,
"Orig_Order_ID": 1177946,
"Orig_InOut_ID": 1068110,
"Description": null,
"DocType": "RMA Client Warehouse Order",
"DateOrdered": "2020-05-20 00:00:00+0300",
"BPartner": "Client Fidelio",
"BPartnerLocation": "Adresa livrare 1",
"BillBPartner": "Client Fidelio",
"BillLocation": "Adresa Facturare 1",
"BPartnerContact": "client Fidelio sediu",
"BillContact": "client Fidelio sediu",
"Warehouse": "Producție Fidelio",
"Currency": "RON",
"SalesRep": "Agent Vanzari Viacon 1",
"TotalLines": 2000,
"GrandTotal": 2380,
"DocumentStatus": "Completed",
"DocumentAction": "Close",
}
],
URL: https://api.socratecloud.com/webapi/rest/RMA/list/{version}?startRow={0}&endRow={100}&accessToken={access_token}
Method: GET
Return: JSON object with next format:
"data": [
{
"Organization": "TEST ALINA SRL",
"Created": "2025-04-22 08:18:05+0000",
"CreatedBy": "TESTALINA_Admin",
"Updated": "2025-04-22 12:56:09+0000",
"UpdatedBy": "TESTALINA_Admin",
"DocumentNo": "CF-RMA 1000027",
"OrderReference": null,
"Orig_Order_ID": 1625695,
"Orig_InOut_ID": 1216694,
"Description": null,
"DocType": "Vendor RMA",
"DateOrdered": "2025-04-22 00:00:00+0000",
"BPartner": "F1",
"BPartnerName": "FURNIZOR TEST 1",
"BPartnerLocation": "Punct de Lucru",
"BillBPartner": "F1",
"BillLocation": "Punct de Lucru",
"BPartnerContact": "Contact Furnizor Test",
"BillContact": "Contact Furnizor Test",
"Warehouse_ID": 1004908,
"Warehouse": "DEPOZIT BV",
"SalesRep": "ANGAJAT TEST 1",
"Currency": "RON",
"TotalLines": 200,
"GrandTotal": 238,
"DocumentStatus": "Completed",
"DocumentAction": "Close",
"TrxOrganization": null,
"Activity": null,
"Employee": null,
"Project": null,
"ProjectPhase": null
}
],
"totalRows": 1
}
Data format:
{
"Organization": "Fidelio Farm",
"Created": "2020-05-20 15:19:58+0300",
"CreatedBy": "Razvan Admin",
"Updated": "2020-05-20 15:20:45+0300",
"UpdatedBy": "Razvan Admin",
"DocumentNo": "DRT110442",
"OrderReference": null,
"Orig_Order_ID": 1177946,
"Orig_InOut_ID": 1068110,
"Description": null,
"DocType": "RMA Client Warehouse Order",
"DateOrdered": "2020-05-20 00:00:00+0300",
"BPartner": "Client Fidelio",
"BPartnerLocation": "Adresa livrare 1",
"BillBPartner": "Client Fidelio",
"BillLocation": "Adresa Facturare 1",
"BPartnerContact": "client Fidelio sediu",
"BillContact": "client Fidelio sediu",
"Warehouse": "Producție Fidelio",
"Currency": "RON",
"SalesRep": "Agent Vanzari Viacon 1",
"TotalLines": 2000,
"GrandTotal": 2380,
"DocumentStatus": "Completed",
"DocumentAction": "Close",
}
URL: https://api.socratecloud.com/webapi/rest/RMA/update/{version}?accessToken={access_token}&ReturnOrder_DocumentNo={ReturnOrder_DocumentNo}&Order_DocumentNo={Order_DocumentNo}
&InOut_DocumentNo={InOut_DocumentNo}
Method: POST
Return: document no for success or error message (start with "ERROR: ")