TransferBalance

Endpoint

Overview

The "TransferBalance" endpoint is a POST request. It is used to transfer a balance from or to the available balance of a supplier. This request has been created specifically for the Multi-Vendors feature. It works with a single supplier at each request.

The endpoint on Swagger is Supplier_TransferBalance.

Now, we are going to declare the endpoint and its models along with each accepted parameter and possible value.

📘

Request Header

Add "Authorization": "Bearer {Token}" to request header. Token of demo configuration can be found here.


Request Model

The request is a POST request with the following parameters:

Input ParameterTypeDescription
SupplierCodeintegerThe supplier code you need to associate the invoice with.
TransferAmountnumberThe amount that will be transferred to or from the supplier.
TransferTypestringpull
The balance transfers from supplier to vendor.
push
the balance transfers from vendor to supplier.
InternalNotesstring, optionalExtra comments for your reference.

Response Model

After viewing the Response Model that you will get as a result of your request, here, you will find full details about the Data Model of this API endpoint. Let's check it and its contents.

Response FieldTypeDescription
InvoiceIdinteger
Datestring

Sample Message

Transferring the balance from supplier to vendor

{
   "SupplierCode":33,
   "TransferAmount":100,
   "TransferType":"pull",
   "InternalNotes":"withdraw from the supplier 33 to the vendor."
}
{
   "IsSuccess":true,
   "Message":"The balance transferred successfully",
   "FieldsErrors":null,
   "Data":{
      "InvoiceId":684994,
      "Date":"2021-06-29T12:46:55.7815943+03:00"
   }
}

Transferring the balance from vendor to supplier

{
   "SupplierCode":33,
   "TransferAmount":100,
   "TransferType":"push",
   "InternalNotes":"withdraw from the vendor to the supplier 33."
}
{
   "IsSuccess":true,
   "Message":"The balance transferred successfully",
   "FieldsErrors":null,
   "Data":{
      "InvoiceId":685852,
      "Date":"2021-06-30T11:43:13.2533227+03:00"
   }
}