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 Parameter

Type

Description

SupplierCode

integer

The supplier code you need to associate the invoice with.

TransferAmount

number

The amount that will be transferred to or from the supplier.

TransferType

string

pull
The balance transfers from supplier to vendor.
push
the balance transfers from vendor to supplier.

InternalNotes

string, optional

Extra 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 Field

Type

Description

InvoiceId

integer

Date

string

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"
   }
}

Did this page help you?