For the complete documentation index, see llms.txt. This page is also available as Markdown.

Get Party Master

Returns your customers and suppliers (parties) from Logic ERP: name, codes, addresses, contact details, GST details, account groups, agent and, if your setup allows it, the current ledger balance. Use it to keep the party list in your system in step with Logic ERP — normally by asking only for parties added or changed since your last call, or to look up a single party by its code.

Endpoint

Name
Detail

Address

https://your-server/api/GetPartyMaster

Method

POST

Authorization

Basic Auth

The response and the common request fields are explained in How Every API Call Works.

Request fields

Field
Type
Required
Default
Meaning

GlobalModifyCode

number

No

0

Your bookmark in the change log, as described in How Every API Call Works. 0 = from the start (or a period, with DateFrom/DateTo), a number = only changes after it, -1 = Logic ERP keeps the bookmark for you.

DateFrom, DateTo

date

No

empty

A period of changes, used when GlobalModifyCode is 0. Send both as null when you are not asking for a period: with GlobalModifyCode 0, leaving them out gives Invalid Date From... Write them as yyyy-MM-dd.

Doc_Codes

text

No

empty

Logic ERP's internal party numbers (ActCode in the response), separated by commas, for example "34,90". Returns exactly these parties; the bookmark and period are ignored. Numbers and commas only.

PartyUserCode

text

No

empty

One party code as shown in Logic ERP (User_Code in the response), for example "C1045". Returns that party whether or not it changed recently; the bookmark and period are ignored.

Branch_Codes_From and Doc_Num_Like are not useful here. Parties do not belong to a branch in the change log, so a period request with Branch_Codes_From filled returns nothing. Doc_Num_Like is matched against Logic ERP's internal party number (ActCode), not the party code. Leave both empty.

Rules Logic ERP applies

  • Only customers and suppliers are returned. Other accounts (bank, cash, expense and so on) are never returned, even when they appear in the change log.

  • Your Logic ERP team can limit this endpoint to certain account groups in the API site setup. Parties outside those groups are never returned, whatever you send.

  • Batches. With a bookmark, each call reads up to 150 change-log lines. A party edited several times in that range is returned once. Because the change log also contains other accounts, a batch can hold fewer parties than lines, or none at all — in that case you get "Party Not Found..." with Status: true and a higher LastGlobalModifyCode. Store it and call again. You have caught up when the message is "Party Master not found against Request...", GetData is null and LastGlobalModifyCode is the value you sent.

  • A party can come back in a later batch. Every save of a party adds a new line to the change log, so a party changed again after your bookmark is returned again in a later batch, with its current details. Update the party in your system; do not insert it a second time.

  • A period request (GlobalModifyCode 0 with DateFrom and DateTo) returns every party changed in the period in one call, with no 150-line limit, and LastGlobalModifyCode 0.

  • With PartyUserCode or Doc_Codes, LastGlobalModifyCode comes back as 0. Do not store it as your bookmark.

  • PartyUserCode must match the party code exactly. Do not add spaces.

  • Parties are returned in order of ActCode.

  • Parties that have been deleted in Logic ERP are not returned, so a deletion does not reach you through this endpoint. A party that is still present but flagged as deleted comes back with Deleted_: true.

  • LedgerBalance is filled only when your Logic ERP team has switched on "ledger balance" for your API site; otherwise it is 0. It is the party's balance in the current financial year, including the opening balance, across all branches. A positive amount means the party owes you (debit); a negative amount means you owe the party (credit).

  • Dates in the response (Create_Date, Modify_Date) are text written day/month/four-digit year, for example 31/01/2026.

  • A link that is not set is shown as (NIL) (city, state, country, stock-transfer branch, general account group, the party's branch) or NIL (agent). Unused account group levels (Group_Name1…Group_Name8) are empty.

Known issue – -1 together with PartyUserCode. If you send "GlobalModifyCode": -1 and a PartyUserCode while Logic ERP has parties waiting to be re-sent to you, the call returns at most the one party you asked for, but all the waiting parties are marked as sent and will not come again. To look up one party, always send "GlobalModifyCode": 0 with PartyUserCode.

Example request

Next batch after your stored bookmark:

One party by its code:

Test it

Send a request to the Logic ERP sandbox (a test company) from this page: open the block below, enter the sandbox user name and password (ask your Logic ERP support team), change the request if you like, and press Test it. The example asks for the first batch of the change log. Do not send "GlobalModifyCode": -1 here – it changes what the sandbox has marked as already sent.

Get Party Master

post

Returns your customers and suppliers (parties) from Logic ERP: name, codes, addresses, contact details, GST details, account groups, agent and, if your setup allows it, the current ledger balance. Use it to keep the party list in your system in step with Logic ERP — normally by asking only for parties added or changed since your last call, or to look up a single party by its code.

Authorizations
AuthorizationstringRequired

The user name and password of your API site.

Body
GlobalModifyCodeintegerOptional

Your bookmark in the change log, as described in How Every API Call Works. 0 = from the start (or a period, with DateFrom/DateTo), a number = only changes after it, -1 = Logic ERP keeps the bookmark for you.

DateFromstring · nullableOptional

A period of changes, used when GlobalModifyCode is 0. Send both as null when you are not asking for a period: with GlobalModifyCode 0, leaving them out gives Invalid Date From... Write them as yyyy-MM-dd.

DateTostring · nullableOptional

A period of changes, used when GlobalModifyCode is 0. Send both as null when you are not asking for a period: with GlobalModifyCode 0, leaving them out gives Invalid Date From... Write them as yyyy-MM-dd.

Doc_CodesstringOptional

Logic ERP's internal party numbers (ActCode in the response), separated by commas, for example "34,90". Returns exactly these parties; the bookmark and period are ignored. Numbers and commas only.

PartyUserCodestringOptional

One party code as shown in Logic ERP (User_Code in the response), for example "C1045". Returns that party whether or not it changed recently; the bookmark and period are ignored.

Responses
200

Always HTTP 200. Check Status, Message and GetData.

application/json
StatusbooleanOptional

See the Status rules on this page and on How Every API Call Works.

MessagestringOptional

Why the call failed, or a note. The reason may be followed by technical detail - read the first line.

LastGlobalModifyCodeintegerOptional

The change-log bookmark (see How Every API Call Works).

resultSizestringOptional

Size of the answer, for example "2 KB".

post/GetPartyMaster
POST /api/GetPartyMaster HTTP/1.1
Host: demo.logicerp.com
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 67

{
  "GlobalModifyCode": 0,
  "DateFrom": null,
  "DateTo": null,
  "Doc_Codes": ""
}
{
  "GetData": [
    {
      "Act_Name": "text",
      "Act_Type": "text",
      "Grp_Name": "text",
      "User_Code": "text",
      "ActCode": 1,
      "Stock_Transfer_Party": true,
      "Stock_Transfer_BranchCode": 1,
      "Stock_Transfer_BranchName": "text",
      "IsCUOrSUAlso": true,
      "AddlActUserCode": "text",
      "Party_Add_1": "text",
      "Party_Add_2": "text",
      "Party_Add_3": "text",
      "PinCode": "text",
      "City_Name": "text",
      "State_Name": "text",
      "Country_Name": "text",
      "Party_Sec_Add_1": "text",
      "Party_Sec_Add_2": "text",
      "Party_Sec_Add_3": "text",
      "Sec_PinCode": "text",
      "Sec_City_Name": "text",
      "Sec_State_Name": "text",
      "Sec_Country_Name": "text",
      "Telephone_off": "text",
      "Telephone_res": "text",
      "Fax_no": "text",
      "Mobile_no": "text",
      "Email_address": "text",
      "Contact_Name": "text",
      "GST_No": "text",
      "GST_State_Code": "text",
      "GST_Registration_Type": "text",
      "Is_Ecommerce_Party": true,
      "Ecommerce_GST_No": "text",
      "Group_Name1": "text",
      "Group_Name2": "text",
      "Group_Name3": "text",
      "Group_Name4": "text",
      "Group_Name5": "text",
      "Group_Name6": "text",
      "Group_Name7": "text",
      "Group_Name8": "text",
      "Deleted_": true,
      "Create_Date": "text",
      "Modify_Date": "text",
      "Action_Code": "text",
      "InActiveFor_SO": true,
      "Agent_Name": "text",
      "Agent_Short_Name": "text",
      "Stop_Billing": true,
      "BranchCode": 1,
      "BranchName": "text",
      "BranchShortName": "text",
      "Food_Lisc_No": "text",
      "LedgerBalance": 1,
      "ListCustomFields": [
        {
          "FieldName": "text",
          "FieldValue_1": "text",
          "FieldValue_2": "text",
          "FieldCode": 1
        }
      ]
    }
  ],
  "Status": true,
  "Message": "text",
  "LastGlobalModifyCode": 1,
  "resultSize": "text"
}

Response fields

Each item in GetData:

Field
Type
Meaning

Act_Name

text

Party name.

Act_Type

text

CU = customer, SU = supplier.

Grp_Name

text

The party's general account group, or (NIL).

User_Code

text

The party code shown in Logic ERP. Use it as PartyUserCode to fetch this party again.

ActCode

number

Logic ERP's internal party number. Use it in Doc_Codes.

Stock_Transfer_Party

true / false

true when the party is marked as a stock-transfer party in Logic ERP.

Stock_Transfer_BranchCode

number

The branch linked to this party for stock transfers; 0 when none. It can be filled even when Stock_Transfer_Party is false.

Stock_Transfer_BranchName

text

Name of that branch, or (NIL).

IsCUOrSUAlso

true / false

true when the party is also used as the other type (a customer that is also a supplier, or the reverse).

AddlActUserCode

text

An additional party code, if one is kept in Logic ERP.

Party_Add_1, Party_Add_2, Party_Add_3

text

First (main) address lines.

PinCode

text

PIN code of the first address.

City_Name, State_Name, Country_Name

text

City, state and country of the first address, or (NIL).

Party_Sec_Add_1, Party_Sec_Add_2, Party_Sec_Add_3

text

Second address lines (for example a delivery address).

Sec_PinCode

text

PIN code of the second address.

Sec_City_Name, Sec_State_Name, Sec_Country_Name

text

City, state and country of the second address, or (NIL).

Telephone_off, Telephone_res

text

Office and residence telephone numbers.

Fax_no

text

Fax number.

Mobile_no

text

Mobile number.

Email_address

text

E-mail address.

Contact_Name

text

Contact person.

GST_No

text

The party's GSTIN; empty or blank when unregistered.

GST_State_Code

text

GST state code of the party.

GST_Registration_Type

text

Registered, UnRegistered or Composite.

Is_Ecommerce_Party

true / false

true when the party is an e-commerce operator.

Ecommerce_GST_No

text

GSTIN of the e-commerce operator.

Group_Name1 … Group_Name8

text

The party's account groups at levels 1 to 8; empty when a level is not used.

Deleted_

true / false

true when the party is flagged as deleted.

Create_Date

date

When the party was created, dd/MM/yyyy; empty if not known.

Modify_Date

date

When the party was last changed, dd/MM/yyyy; empty if not known.

Action_Code

text

The latest change made to the party: N = added, M = modified, D = deleted. Empty when Logic ERP has no record of a change (possible with PartyUserCode or Doc_Codes).

InActiveFor_SO

true / false

true when the party may not be used on new sale orders.

Agent_Name

text

The party's agent or broker, or NIL.

Agent_Short_Name

text

Short name of that agent, or NIL.

Stop_Billing

true / false

true when billing to this party is blocked.

BranchCode

number

The branch the party is linked to; 0 when none.

BranchName

text

Name of that branch, or (NIL).

BranchShortName

text

Short name of that branch, or (NIL).

Food_Lisc_No

text

Food licence (FSSAI) number.

LedgerBalance

number

Current balance in ₹ — see the rules above. 0 when the ledger balance is not switched on.

ListCustomFields

list

Extra fields your company has defined for parties. See below.

When a party's address details are missing in Logic ERP, the address, contact, GST, city/state/country (both addresses) and Food_Lisc_No fields come back as null, and Is_Ecommerce_Party and InActiveFor_SO as false.

ListCustomFields — one entry for each visible extra field defined for parties, in the order set in Logic ERP, whether or not this party has a value:

Field
Type
Meaning

FieldName

text

Name of the extra field.

FieldValue_1

text

The value for this party; null when none is entered.

FieldValue_2

text

A second value, used by some field types; null when the party has no value for this field, empty when only FieldValue_1 is filled.

FieldCode

number

Internal number – ignore.

Example response

Messages you may see

Message
Meaning
What to do

Party Master not found against Request... (with Status: true)

Nothing has been added to the change log after your bookmark.

You are up to date. Call again later with the same bookmark.

Party Not Found... (with Status: true)

No customer or supplier you can see was found: only other accounts changed in this batch, the parties are outside your account groups, nothing changed in the period you asked for, or the code you sent does not exist.

With a bookmark: store the new LastGlobalModifyCode and call again. With a period: there is nothing to fetch. With PartyUserCode or Doc_Codes: check the code.

A database error (with Status: false), for example Invalid column name 'abc'.

Doc_Codes contained something other than numbers and commas, or PartyUserCode contained a '. The reason may be followed by technical detail – read the first line.

Send Doc_Codes as numbers separated by commas, and a party code without quotes.

Last updated