Developer recipes for humans and AI

List advanced quotations.

Endpoint

POST /v1/commands
GET /v1/commands/{commandId}
POST /v1/sales-module/advanced-quotation/list

Full JSON Payload

{
  "commandId": "list-advanced-quotations-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "list-advanced-quotations",
  "payload": {}
}

Payload Fields

No payload fields required.

Full Transaction Field Reference

header

debtorCode

customer/debtor code

debtorName

customer display name

salesAgent

sales agent code

salesLocation

sales location

multiPricing

price category/multi-pricing value

displayTerm

credit term

docNo

optional document number; omit to let AutoCount numbering generate it where supported

docDate

YYYY-MM-DD document date

dueDate

YYYY-MM-DD due date where supported

description

document narration/description

ref

reference

ourRef

our reference

yourRef

customer/supplier reference

currencyCode

currency code, for example MYR

currencyRate

currency exchange rate

inclusiveTax

true when prices include tax

taxDate

YYYY-MM-DD tax date

branchCode

debtor/creditor branch code/name where account book uses branches

userDefinedFields

object of AutoCount user-defined fields

verifyAfterSave

optional boolean; false keeps save fast, true reloads the saved record and returns readBack checks/differences where the connector has a safe get path

contactAndAddress

attention

attention/contact person

contact

alias for attention/contact person

phone1

primary phone

phone

alias for phone1

phone2

secondary phone/mobile

fax1

fax

fax

alias for fax1

address1

address line 1

address2

address line 2

address3

address line 3

address4

address line 4

deliverAddress1

delivery address line 1

deliverAddress2

delivery address line 2

deliverAddress3

delivery address line 3

deliverAddress4

delivery address line 4

deliverContact

delivery contact

deliverPhone1

delivery phone

lines

itemCode

AutoCount item code

barCode

barcode shown/used by item line

description

line description

description2

line second description

furtherDescription

long/further line description

qty

quantity

uom

UOM

unitPrice

unit price

unitCost

unit cost where supported

discount

discount string/amount

taxType

tax type/code alias

taxCode

tax code alias

taxRate

tax rate

taxAmount

tax amount

amount

line amount

location

stock location

fromLocation

source location

toLocation

destination location

batchNo

batch number

serialNo

serial number

project

project code

projNo

project code alias

department

department code

deptNo

department code alias

classification

classification code

deliveryDate

YYYY-MM-DD delivery date

userDefinedFields

object of line user-defined fields

payments

paymentMethod

AutoCount Payment Method code

paymentBy

payment type such as Cash, Cheque, Bank Transfer, Credit Card

paymentAmount

payment amount

amount

payment amount alias where supported

chequeNo

cheque/reference number

bankCharge

bank charge amount

bankAccount

bank/cash GL account

paymentAccountNo

bank/cash GL account alias

bankChargeAccountNo

bank charge GL account

creditCardApprovalCode

card approval/reference code

userDefinedFields

object of payment user-defined fields

JavaScript Example

const apiBase = "https://api.autocount.cloud";
const apiKey = "YOUR_API_KEY";

async function queueCommand(command) {
  const response = await fetch(apiBase + "/v1/commands", {
    method: "POST",
    headers: {
      "Authorization": "Bearer " + apiKey,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(command)
  });
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

async function waitCommand(commandId) {
  for (let i = 0; i < 60; i++) {
    const response = await fetch(apiBase + "/v1/commands/" + encodeURIComponent(commandId), {
      headers: { "Authorization": "Bearer " + apiKey }
    });
    if (!response.ok) throw new Error(await response.text());
    const data = await response.json();
    if (data.command && (data.command.status === "done" || data.command.status === "failed")) return data;
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  throw new Error("Command timed out");
}

const command = {
  "commandId": "list-advanced-quotations-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "list-advanced-quotations",
  "payload": {}
};

await queueCommand(command);
console.log(await waitCommand(command.commandId));

AI Rules

• Use cloud API only: https://api.autocount.cloud.
• Never call the Local Connector API directly from Mac Soft AI, AI tools, customer apps, or external integrations.
• Use Authorization: Bearer YOUR_API_KEY.
• Use a unique commandId for every real operation.
• commandId must be URL-safe: letters, numbers, dot, underscore, and hyphen only; max 160 characters.
• Set type to list-advanced-quotations.
• Poll GET /v1/commands/{commandId} until status is done or failed.
• For write commands, validate first when a validate-* command exists for the same document.

Read advanced quotation detail lines only.

Endpoint

POST /v1/commands
GET /v1/commands/{commandId}
POST /v1/sales-module/advanced-quotation/list

Full JSON Payload

{
  "commandId": "read-advanced-quotation-lines-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "read-advanced-quotation-lines",
  "payload": {
    "itemCode": "ITEM001",
    "limit": 50
  }
}

Payload Fields

itemCode

optional

debtorCode

optional

docNo

optional

dateFrom

YYYY-MM-DD optional

dateTo

YYYY-MM-DD optional

limit

optional

Full Transaction Field Reference

header

debtorCode

customer/debtor code

debtorName

customer display name

salesAgent

sales agent code

salesLocation

sales location

multiPricing

price category/multi-pricing value

displayTerm

credit term

docNo

optional document number; omit to let AutoCount numbering generate it where supported

docDate

YYYY-MM-DD document date

dueDate

YYYY-MM-DD due date where supported

description

document narration/description

ref

reference

ourRef

our reference

yourRef

customer/supplier reference

currencyCode

currency code, for example MYR

currencyRate

currency exchange rate

inclusiveTax

true when prices include tax

taxDate

YYYY-MM-DD tax date

branchCode

debtor/creditor branch code/name where account book uses branches

userDefinedFields

object of AutoCount user-defined fields

verifyAfterSave

optional boolean; false keeps save fast, true reloads the saved record and returns readBack checks/differences where the connector has a safe get path

contactAndAddress

attention

attention/contact person

contact

alias for attention/contact person

phone1

primary phone

phone

alias for phone1

phone2

secondary phone/mobile

fax1

fax

fax

alias for fax1

address1

address line 1

address2

address line 2

address3

address line 3

address4

address line 4

deliverAddress1

delivery address line 1

deliverAddress2

delivery address line 2

deliverAddress3

delivery address line 3

deliverAddress4

delivery address line 4

deliverContact

delivery contact

deliverPhone1

delivery phone

lines

itemCode

AutoCount item code

barCode

barcode shown/used by item line

description

line description

description2

line second description

furtherDescription

long/further line description

qty

quantity

uom

UOM

unitPrice

unit price

unitCost

unit cost where supported

discount

discount string/amount

taxType

tax type/code alias

taxCode

tax code alias

taxRate

tax rate

taxAmount

tax amount

amount

line amount

location

stock location

fromLocation

source location

toLocation

destination location

batchNo

batch number

serialNo

serial number

project

project code

projNo

project code alias

department

department code

deptNo

department code alias

classification

classification code

deliveryDate

YYYY-MM-DD delivery date

userDefinedFields

object of line user-defined fields

payments

paymentMethod

AutoCount Payment Method code

paymentBy

payment type such as Cash, Cheque, Bank Transfer, Credit Card

paymentAmount

payment amount

amount

payment amount alias where supported

chequeNo

cheque/reference number

bankCharge

bank charge amount

bankAccount

bank/cash GL account

paymentAccountNo

bank/cash GL account alias

bankChargeAccountNo

bank charge GL account

creditCardApprovalCode

card approval/reference code

userDefinedFields

object of payment user-defined fields

JavaScript Example

const apiBase = "https://api.autocount.cloud";
const apiKey = "YOUR_API_KEY";

async function queueCommand(command) {
  const response = await fetch(apiBase + "/v1/commands", {
    method: "POST",
    headers: {
      "Authorization": "Bearer " + apiKey,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(command)
  });
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

async function waitCommand(commandId) {
  for (let i = 0; i < 60; i++) {
    const response = await fetch(apiBase + "/v1/commands/" + encodeURIComponent(commandId), {
      headers: { "Authorization": "Bearer " + apiKey }
    });
    if (!response.ok) throw new Error(await response.text());
    const data = await response.json();
    if (data.command && (data.command.status === "done" || data.command.status === "failed")) return data;
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  throw new Error("Command timed out");
}

const command = {
  "commandId": "read-advanced-quotation-lines-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "read-advanced-quotation-lines",
  "payload": {
    "itemCode": "ITEM001",
    "limit": 50
  }
};

await queueCommand(command);
console.log(await waitCommand(command.commandId));

AI Rules

• Use cloud API only: https://api.autocount.cloud.
• Never call the Local Connector API directly from Mac Soft AI, AI tools, customer apps, or external integrations.
• Use Authorization: Bearer YOUR_API_KEY.
• Use a unique commandId for every real operation.
• commandId must be URL-safe: letters, numbers, dot, underscore, and hyphen only; max 160 characters.
• Set type to read-advanced-quotation-lines.
• Poll GET /v1/commands/{commandId} until status is done or failed.
• For write commands, validate first when a validate-* command exists for the same document.

Get one advanced quotation by document number.

Endpoint

POST /v1/commands
GET /v1/commands/{commandId}
POST /v1/sales-module/advanced-quotation/get

Full JSON Payload

{
  "commandId": "get-advanced-quotation-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "get-advanced-quotation",
  "payload": {
    "docNo": "AQ-000001"
  }
}

Payload Fields

docNo

required advanced quotation document number

Full Transaction Field Reference

header

debtorCode

customer/debtor code

debtorName

customer display name

salesAgent

sales agent code

salesLocation

sales location

multiPricing

price category/multi-pricing value

displayTerm

credit term

docNo

optional document number; omit to let AutoCount numbering generate it where supported

docDate

YYYY-MM-DD document date

dueDate

YYYY-MM-DD due date where supported

description

document narration/description

ref

reference

ourRef

our reference

yourRef

customer/supplier reference

currencyCode

currency code, for example MYR

currencyRate

currency exchange rate

inclusiveTax

true when prices include tax

taxDate

YYYY-MM-DD tax date

branchCode

debtor/creditor branch code/name where account book uses branches

userDefinedFields

object of AutoCount user-defined fields

verifyAfterSave

optional boolean; false keeps save fast, true reloads the saved record and returns readBack checks/differences where the connector has a safe get path

contactAndAddress

attention

attention/contact person

contact

alias for attention/contact person

phone1

primary phone

phone

alias for phone1

phone2

secondary phone/mobile

fax1

fax

fax

alias for fax1

address1

address line 1

address2

address line 2

address3

address line 3

address4

address line 4

deliverAddress1

delivery address line 1

deliverAddress2

delivery address line 2

deliverAddress3

delivery address line 3

deliverAddress4

delivery address line 4

deliverContact

delivery contact

deliverPhone1

delivery phone

lines

itemCode

AutoCount item code

barCode

barcode shown/used by item line

description

line description

description2

line second description

furtherDescription

long/further line description

qty

quantity

uom

UOM

unitPrice

unit price

unitCost

unit cost where supported

discount

discount string/amount

taxType

tax type/code alias

taxCode

tax code alias

taxRate

tax rate

taxAmount

tax amount

amount

line amount

location

stock location

fromLocation

source location

toLocation

destination location

batchNo

batch number

serialNo

serial number

project

project code

projNo

project code alias

department

department code

deptNo

department code alias

classification

classification code

deliveryDate

YYYY-MM-DD delivery date

userDefinedFields

object of line user-defined fields

payments

paymentMethod

AutoCount Payment Method code

paymentBy

payment type such as Cash, Cheque, Bank Transfer, Credit Card

paymentAmount

payment amount

amount

payment amount alias where supported

chequeNo

cheque/reference number

bankCharge

bank charge amount

bankAccount

bank/cash GL account

paymentAccountNo

bank/cash GL account alias

bankChargeAccountNo

bank charge GL account

creditCardApprovalCode

card approval/reference code

userDefinedFields

object of payment user-defined fields

JavaScript Example

const apiBase = "https://api.autocount.cloud";
const apiKey = "YOUR_API_KEY";

async function queueCommand(command) {
  const response = await fetch(apiBase + "/v1/commands", {
    method: "POST",
    headers: {
      "Authorization": "Bearer " + apiKey,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(command)
  });
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

async function waitCommand(commandId) {
  for (let i = 0; i < 60; i++) {
    const response = await fetch(apiBase + "/v1/commands/" + encodeURIComponent(commandId), {
      headers: { "Authorization": "Bearer " + apiKey }
    });
    if (!response.ok) throw new Error(await response.text());
    const data = await response.json();
    if (data.command && (data.command.status === "done" || data.command.status === "failed")) return data;
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  throw new Error("Command timed out");
}

const command = {
  "commandId": "get-advanced-quotation-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "get-advanced-quotation",
  "payload": {
    "docNo": "AQ-000001"
  }
};

await queueCommand(command);
console.log(await waitCommand(command.commandId));

AI Rules

• Use cloud API only: https://api.autocount.cloud.
• Never call the Local Connector API directly from Mac Soft AI, AI tools, customer apps, or external integrations.
• Use Authorization: Bearer YOUR_API_KEY.
• Use a unique commandId for every real operation.
• commandId must be URL-safe: letters, numbers, dot, underscore, and hyphen only; max 160 characters.
• Set type to get-advanced-quotation.
• Poll GET /v1/commands/{commandId} until status is done or failed.
• For write commands, validate first when a validate-* command exists for the same document.

Validate a advanced quotation without saving.

Validation only; does not save. Full payload example is for human/Postman reference. For stock-item lines, send itemCode/uom/location and call read-locations for the exact active location code. If a sales account book requires a line posting account, the connector uses AutoCount's default sales account when lines[].accountNo is omitted; send accountNo / accNo / glAccount / postingAccountNo on a line to override it. For account/service lines, omit itemCode and send accountNo / accNo / glAccount / postingAccountNo; many account books still require lines[].location even without itemCode. salesLocation is copied to lines that omit location; lines[].location wins. The connector verifies AutoCount accepted the requested detail location before save instead of silently using a default.

Endpoint

POST /v1/commands
GET /v1/commands/{commandId}
POST /v1/sales-module/advanced-quotation/validate

Full JSON Payload

{
  "commandId": "validate-advanced-quotation-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "validate-advanced-quotation",
  "payload": {
    "debtorCode": "300-A001",
    "items": [
      {
        "itemCode": "ITEM001",
        "qty": 1,
        "unitPrice": 100
      }
    ],
    "docDate": "2026-06-24",
    "displayTerm": "30 DAYS",
    "branchCode": "MAIN",
    "salesLocation": "HQ",
    "multiPricing": "Price 1",
    "salesAgent": "SA01",
    "attention": "Purchasing Department",
    "contact": "Purchasing Department",
    "deliverContact": "Store Receiver",
    "deliverPhone1": "012-3456789",
    "phone": "03-11111111",
    "address1": "No. 1 Jalan API",
    "address2": "Taman Integration",
    "address3": "Kuala Lumpur",
    "address4": "Malaysia",
    "description": "Sales document created through API",
    "ref": "WEB-ORDER-1001",
    "currencyCode": "MYR",
    "inclusiveTax": false,
    "taxEntityID": 1,
    "project": "PRJAPI",
    "department": "HQ",
    "lines": [
      {
        "itemCode": "ITEM001",
        "description": "API item line 1",
        "description2": "Line second description",
        "furtherDescription": "Optional longer line note",
        "barCode": "9550000000011",
        "qty": 2,
        "uom": "UNIT",
        "unitPrice": 100,
        "discount": "5%",
        "taxType": "S-0",
        "taxRate": 0,
        "taxAmount": 0,
        "amount": 190,
        "accountNo": "500-0000",
        "location": "HQ",
        "batchNo": "BATCH-001",
        "serialNo": "SN-0001",
        "project": "PRJAPI",
        "projNo": "PRJAPI",
        "department": "HQ",
        "deptNo": "HQ",
        "classification": "022",
        "deliveryDate": "2026-06-30",
        "userDefinedFields": {
          "APITEST": "Blue"
        }
      },
      {
        "accountNo": "500-0000",
        "description": "Service/account line without itemCode",
        "qty": 1,
        "unitPrice": 50,
        "taxType": "S-0",
        "location": "HQ",
        "project": "PRJAPI",
        "department": "HQ"
      }
    ],
    "payments": [
      {
        "paymentMethod": "CASH",
        "paymentBy": "Cash",
        "paymentAmount": 130,
        "chequeNo": "",
        "bankCharge": 0,
        "paymentAccountNo": "110-0010",
        "bankChargeAccountNo": "810-0000",
        "creditCardApprovalCode": ""
      },
      {
        "paymentMethod": "CARD",
        "paymentBy": "Credit Card",
        "paymentAmount": 60,
        "chequeNo": "",
        "bankCharge": 0,
        "paymentAccountNo": "110-0010",
        "bankChargeAccountNo": "810-0000",
        "creditCardApprovalCode": "APPROVED-001"
      }
    ],
    "userDefinedFields": {
      "APITEST": "API"
    }
  }
}

Payload Fields

debtorCode

required AutoCount debtor/customer code

items

optional alias for lines

debtorName

optional customer display name; AutoCount debtor name is used when omitted

docNo

optional AutoCount document number; omit to let AutoCount numbering generate it

docDate

required or optional YYYY-MM-DD document date depending on account-book numbering rules

displayTerm

optional credit term such as C.O.D. or 30 DAYS

dueDate

optional YYYY-MM-DD due date

branchCode

optional debtor branch code/name where the customer uses branches

salesLocation

optional exact active AutoCount sales/stock location code such as HQ-RETAIL; call read-locations first. It fills only lines that omit lines[].location; an explicit line location always wins

multiPricing

optional price category/multi-pricing value such as Price 1

salesAgent

optional Sales Agent Maintenance code

attention

optional attention/contact person

contact

optional contact person alias for attention

deliverContact

optional delivery contact person

deliverPhone1

optional delivery phone number

phone1

optional phone number printed on document

phone

optional phone alias for phone1

phone2

optional secondary phone/mobile number

fax1

optional fax number printed on document

fax

optional fax alias for fax1

address1

optional billing address line 1

address2

optional billing address line 2

address3

optional billing address line 3

address4

optional billing address line 4

deliverAddress1

optional delivery address line 1

deliverAddress2

optional delivery address line 2

deliverAddress3

optional delivery address line 3

deliverAddress4

optional delivery address line 4

description

optional document description/narration

ref

optional reference

ourRef

optional our reference

yourRef

optional customer reference

currencyCode

optional currency code such as MYR

currencyRate

optional exchange rate

inclusiveTax

optional boolean; true when line prices include tax

taxDate

optional YYYY-MM-DD tax date

taxEntityID

optional numeric Tax Entity Maintenance ID for the document header/e-Invoice party

project

optional project code

department

optional department code

lines

required array of stock item rows or account/service rows; items is also accepted as a compatibility alias

accountNo

optional top-level GL posting account fallback; line-level accountNo / accNo / glAccount / postingAccountNo wins, otherwise the connector uses AutoCount's default sales account where needed

payments

optional array for cash sale style documents; send multiple payment rows for AutoCount Multi Payment

userDefinedFields

optional object of AutoCount user-defined fields; use the AutoCount UDF field name without the UDF_ column prefix, for example { APITEST: value }

Full Transaction Field Reference

header

debtorCode

customer/debtor code

debtorName

customer display name

salesAgent

sales agent code

salesLocation

sales location

multiPricing

price category/multi-pricing value

displayTerm

credit term

docNo

optional document number; omit to let AutoCount numbering generate it where supported

docDate

YYYY-MM-DD document date

dueDate

YYYY-MM-DD due date where supported

description

document narration/description

ref

reference

ourRef

our reference

yourRef

customer/supplier reference

currencyCode

currency code, for example MYR

currencyRate

currency exchange rate

inclusiveTax

true when prices include tax

taxDate

YYYY-MM-DD tax date

branchCode

debtor/creditor branch code/name where account book uses branches

userDefinedFields

object of AutoCount user-defined fields

verifyAfterSave

optional boolean; false keeps save fast, true reloads the saved record and returns readBack checks/differences where the connector has a safe get path

contactAndAddress

attention

attention/contact person

contact

alias for attention/contact person

phone1

primary phone

phone

alias for phone1

phone2

secondary phone/mobile

fax1

fax

fax

alias for fax1

address1

address line 1

address2

address line 2

address3

address line 3

address4

address line 4

deliverAddress1

delivery address line 1

deliverAddress2

delivery address line 2

deliverAddress3

delivery address line 3

deliverAddress4

delivery address line 4

deliverContact

delivery contact

deliverPhone1

delivery phone

lines

itemCode

AutoCount item code

barCode

barcode shown/used by item line

description

line description

description2

line second description

furtherDescription

long/further line description

qty

quantity

uom

UOM

unitPrice

unit price

unitCost

unit cost where supported

discount

discount string/amount

taxType

tax type/code alias

taxCode

tax code alias

taxRate

tax rate

taxAmount

tax amount

amount

line amount

location

stock location

fromLocation

source location

toLocation

destination location

batchNo

batch number

serialNo

serial number

project

project code

projNo

project code alias

department

department code

deptNo

department code alias

classification

classification code

deliveryDate

YYYY-MM-DD delivery date

userDefinedFields

object of line user-defined fields

payments

paymentMethod

AutoCount Payment Method code

paymentBy

payment type such as Cash, Cheque, Bank Transfer, Credit Card

paymentAmount

payment amount

amount

payment amount alias where supported

chequeNo

cheque/reference number

bankCharge

bank charge amount

bankAccount

bank/cash GL account

paymentAccountNo

bank/cash GL account alias

bankChargeAccountNo

bank charge GL account

creditCardApprovalCode

card approval/reference code

userDefinedFields

object of payment user-defined fields

JavaScript Example

const apiBase = "https://api.autocount.cloud";
const apiKey = "YOUR_API_KEY";

async function queueCommand(command) {
  const response = await fetch(apiBase + "/v1/commands", {
    method: "POST",
    headers: {
      "Authorization": "Bearer " + apiKey,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(command)
  });
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

async function waitCommand(commandId) {
  for (let i = 0; i < 60; i++) {
    const response = await fetch(apiBase + "/v1/commands/" + encodeURIComponent(commandId), {
      headers: { "Authorization": "Bearer " + apiKey }
    });
    if (!response.ok) throw new Error(await response.text());
    const data = await response.json();
    if (data.command && (data.command.status === "done" || data.command.status === "failed")) return data;
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  throw new Error("Command timed out");
}

const command = {
  "commandId": "validate-advanced-quotation-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "validate-advanced-quotation",
  "payload": {
    "debtorCode": "300-A001",
    "items": [
      {
        "itemCode": "ITEM001",
        "qty": 1,
        "unitPrice": 100
      }
    ],
    "docDate": "2026-06-24",
    "displayTerm": "30 DAYS",
    "branchCode": "MAIN",
    "salesLocation": "HQ",
    "multiPricing": "Price 1",
    "salesAgent": "SA01",
    "attention": "Purchasing Department",
    "contact": "Purchasing Department",
    "deliverContact": "Store Receiver",
    "deliverPhone1": "012-3456789",
    "phone": "03-11111111",
    "address1": "No. 1 Jalan API",
    "address2": "Taman Integration",
    "address3": "Kuala Lumpur",
    "address4": "Malaysia",
    "description": "Sales document created through API",
    "ref": "WEB-ORDER-1001",
    "currencyCode": "MYR",
    "inclusiveTax": false,
    "taxEntityID": 1,
    "project": "PRJAPI",
    "department": "HQ",
    "lines": [
      {
        "itemCode": "ITEM001",
        "description": "API item line 1",
        "description2": "Line second description",
        "furtherDescription": "Optional longer line note",
        "barCode": "9550000000011",
        "qty": 2,
        "uom": "UNIT",
        "unitPrice": 100,
        "discount": "5%",
        "taxType": "S-0",
        "taxRate": 0,
        "taxAmount": 0,
        "amount": 190,
        "accountNo": "500-0000",
        "location": "HQ",
        "batchNo": "BATCH-001",
        "serialNo": "SN-0001",
        "project": "PRJAPI",
        "projNo": "PRJAPI",
        "department": "HQ",
        "deptNo": "HQ",
        "classification": "022",
        "deliveryDate": "2026-06-30",
        "userDefinedFields": {
          "APITEST": "Blue"
        }
      },
      {
        "accountNo": "500-0000",
        "description": "Service/account line without itemCode",
        "qty": 1,
        "unitPrice": 50,
        "taxType": "S-0",
        "location": "HQ",
        "project": "PRJAPI",
        "department": "HQ"
      }
    ],
    "payments": [
      {
        "paymentMethod": "CASH",
        "paymentBy": "Cash",
        "paymentAmount": 130,
        "chequeNo": "",
        "bankCharge": 0,
        "paymentAccountNo": "110-0010",
        "bankChargeAccountNo": "810-0000",
        "creditCardApprovalCode": ""
      },
      {
        "paymentMethod": "CARD",
        "paymentBy": "Credit Card",
        "paymentAmount": 60,
        "chequeNo": "",
        "bankCharge": 0,
        "paymentAccountNo": "110-0010",
        "bankChargeAccountNo": "810-0000",
        "creditCardApprovalCode": "APPROVED-001"
      }
    ],
    "userDefinedFields": {
      "APITEST": "API"
    }
  }
};

await queueCommand(command);
console.log(await waitCommand(command.commandId));

AI Rules

• Use cloud API only: https://api.autocount.cloud.
• Never call the Local Connector API directly from Mac Soft AI, AI tools, customer apps, or external integrations.
• Use Authorization: Bearer YOUR_API_KEY.
• Use a unique commandId for every real operation.
• commandId must be URL-safe: letters, numbers, dot, underscore, and hyphen only; max 160 characters.
• Set type to validate-advanced-quotation.
• Poll GET /v1/commands/{commandId} until status is done or failed.
• For write commands, validate first when a validate-* command exists for the same document.

Create an advanced quotation.

Creates advanced quotation through AutoCount SDK. Full payload example is for human/Postman reference. For stock-item lines, send itemCode/uom/location and call read-locations for the exact active location code. If a sales account book requires a line posting account, the connector uses AutoCount's default sales account when lines[].accountNo is omitted; send accountNo / accNo / glAccount / postingAccountNo on a line to override it. For account/service lines, omit itemCode and send accountNo / accNo / glAccount / postingAccountNo; many account books still require lines[].location even without itemCode. salesLocation is copied to lines that omit location; lines[].location wins. The connector verifies AutoCount accepted the requested detail location before save instead of silently using a default.

Endpoint

POST /v1/commands
GET /v1/commands/{commandId}
POST /v1/sales-module/advanced-quotation/create

Full JSON Payload

{
  "commandId": "create-advanced-quotation-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "create-advanced-quotation",
  "payload": {
    "debtorCode": "300-A001",
    "docDate": "2026-06-24",
    "items": [
      {
        "itemCode": "ITEM001",
        "qty": 1,
        "unitPrice": 100
      }
    ],
    "displayTerm": "30 DAYS",
    "branchCode": "MAIN",
    "salesLocation": "HQ",
    "multiPricing": "Price 1",
    "salesAgent": "SA01",
    "attention": "Purchasing Department",
    "contact": "Purchasing Department",
    "deliverContact": "Store Receiver",
    "deliverPhone1": "012-3456789",
    "phone": "03-11111111",
    "address1": "No. 1 Jalan API",
    "address2": "Taman Integration",
    "address3": "Kuala Lumpur",
    "address4": "Malaysia",
    "description": "Sales document created through API",
    "ref": "WEB-ORDER-1001",
    "currencyCode": "MYR",
    "inclusiveTax": false,
    "taxEntityID": 1,
    "project": "PRJAPI",
    "department": "HQ",
    "lines": [
      {
        "itemCode": "ITEM001",
        "description": "API item line 1",
        "description2": "Line second description",
        "furtherDescription": "Optional longer line note",
        "barCode": "9550000000011",
        "qty": 2,
        "uom": "UNIT",
        "unitPrice": 100,
        "discount": "5%",
        "taxType": "S-0",
        "taxRate": 0,
        "taxAmount": 0,
        "amount": 190,
        "accountNo": "500-0000",
        "location": "HQ",
        "batchNo": "BATCH-001",
        "serialNo": "SN-0001",
        "project": "PRJAPI",
        "projNo": "PRJAPI",
        "department": "HQ",
        "deptNo": "HQ",
        "classification": "022",
        "deliveryDate": "2026-06-30",
        "userDefinedFields": {
          "APITEST": "Blue"
        }
      },
      {
        "accountNo": "500-0000",
        "description": "Service/account line without itemCode",
        "qty": 1,
        "unitPrice": 50,
        "taxType": "S-0",
        "location": "HQ",
        "project": "PRJAPI",
        "department": "HQ"
      }
    ],
    "payments": [
      {
        "paymentMethod": "CASH",
        "paymentBy": "Cash",
        "paymentAmount": 130,
        "chequeNo": "",
        "bankCharge": 0,
        "paymentAccountNo": "110-0010",
        "bankChargeAccountNo": "810-0000",
        "creditCardApprovalCode": ""
      },
      {
        "paymentMethod": "CARD",
        "paymentBy": "Credit Card",
        "paymentAmount": 60,
        "chequeNo": "",
        "bankCharge": 0,
        "paymentAccountNo": "110-0010",
        "bankChargeAccountNo": "810-0000",
        "creditCardApprovalCode": "APPROVED-001"
      }
    ],
    "userDefinedFields": {
      "APITEST": "API"
    }
  }
}

Payload Fields

debtorCode

required AutoCount debtor/customer code

docDate

required or optional YYYY-MM-DD document date depending on account-book numbering rules

items

optional alias for lines

debtorName

optional customer display name; AutoCount debtor name is used when omitted

docNo

optional AutoCount document number; omit to let AutoCount numbering generate it

displayTerm

optional credit term such as C.O.D. or 30 DAYS

dueDate

optional YYYY-MM-DD due date

branchCode

optional debtor branch code/name where the customer uses branches

salesLocation

optional exact active AutoCount sales/stock location code such as HQ-RETAIL; call read-locations first. It fills only lines that omit lines[].location; an explicit line location always wins

multiPricing

optional price category/multi-pricing value such as Price 1

salesAgent

optional Sales Agent Maintenance code

attention

optional attention/contact person

contact

optional contact person alias for attention

deliverContact

optional delivery contact person

deliverPhone1

optional delivery phone number

phone1

optional phone number printed on document

phone

optional phone alias for phone1

phone2

optional secondary phone/mobile number

fax1

optional fax number printed on document

fax

optional fax alias for fax1

address1

optional billing address line 1

address2

optional billing address line 2

address3

optional billing address line 3

address4

optional billing address line 4

deliverAddress1

optional delivery address line 1

deliverAddress2

optional delivery address line 2

deliverAddress3

optional delivery address line 3

deliverAddress4

optional delivery address line 4

description

optional document description/narration

ref

optional reference

ourRef

optional our reference

yourRef

optional customer reference

currencyCode

optional currency code such as MYR

currencyRate

optional exchange rate

inclusiveTax

optional boolean; true when line prices include tax

taxDate

optional YYYY-MM-DD tax date

taxEntityID

optional numeric Tax Entity Maintenance ID for the document header/e-Invoice party

project

optional project code

department

optional department code

lines

required array of stock item rows or account/service rows; items is also accepted as a compatibility alias

accountNo

optional top-level GL posting account fallback; line-level accountNo / accNo / glAccount / postingAccountNo wins, otherwise the connector uses AutoCount's default sales account where needed

payments

optional array for cash sale style documents; send multiple payment rows for AutoCount Multi Payment

userDefinedFields

optional object of AutoCount user-defined fields; use the AutoCount UDF field name without the UDF_ column prefix, for example { APITEST: value }

Full Transaction Field Reference

header

debtorCode

customer/debtor code

debtorName

customer display name

salesAgent

sales agent code

salesLocation

sales location

multiPricing

price category/multi-pricing value

displayTerm

credit term

docNo

optional document number; omit to let AutoCount numbering generate it where supported

docDate

YYYY-MM-DD document date

dueDate

YYYY-MM-DD due date where supported

description

document narration/description

ref

reference

ourRef

our reference

yourRef

customer/supplier reference

currencyCode

currency code, for example MYR

currencyRate

currency exchange rate

inclusiveTax

true when prices include tax

taxDate

YYYY-MM-DD tax date

branchCode

debtor/creditor branch code/name where account book uses branches

userDefinedFields

object of AutoCount user-defined fields

verifyAfterSave

optional boolean; false keeps save fast, true reloads the saved record and returns readBack checks/differences where the connector has a safe get path

contactAndAddress

attention

attention/contact person

contact

alias for attention/contact person

phone1

primary phone

phone

alias for phone1

phone2

secondary phone/mobile

fax1

fax

fax

alias for fax1

address1

address line 1

address2

address line 2

address3

address line 3

address4

address line 4

deliverAddress1

delivery address line 1

deliverAddress2

delivery address line 2

deliverAddress3

delivery address line 3

deliverAddress4

delivery address line 4

deliverContact

delivery contact

deliverPhone1

delivery phone

lines

itemCode

AutoCount item code

barCode

barcode shown/used by item line

description

line description

description2

line second description

furtherDescription

long/further line description

qty

quantity

uom

UOM

unitPrice

unit price

unitCost

unit cost where supported

discount

discount string/amount

taxType

tax type/code alias

taxCode

tax code alias

taxRate

tax rate

taxAmount

tax amount

amount

line amount

location

stock location

fromLocation

source location

toLocation

destination location

batchNo

batch number

serialNo

serial number

project

project code

projNo

project code alias

department

department code

deptNo

department code alias

classification

classification code

deliveryDate

YYYY-MM-DD delivery date

userDefinedFields

object of line user-defined fields

payments

paymentMethod

AutoCount Payment Method code

paymentBy

payment type such as Cash, Cheque, Bank Transfer, Credit Card

paymentAmount

payment amount

amount

payment amount alias where supported

chequeNo

cheque/reference number

bankCharge

bank charge amount

bankAccount

bank/cash GL account

paymentAccountNo

bank/cash GL account alias

bankChargeAccountNo

bank charge GL account

creditCardApprovalCode

card approval/reference code

userDefinedFields

object of payment user-defined fields

JavaScript Example

const apiBase = "https://api.autocount.cloud";
const apiKey = "YOUR_API_KEY";

async function queueCommand(command) {
  const response = await fetch(apiBase + "/v1/commands", {
    method: "POST",
    headers: {
      "Authorization": "Bearer " + apiKey,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(command)
  });
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

async function waitCommand(commandId) {
  for (let i = 0; i < 60; i++) {
    const response = await fetch(apiBase + "/v1/commands/" + encodeURIComponent(commandId), {
      headers: { "Authorization": "Bearer " + apiKey }
    });
    if (!response.ok) throw new Error(await response.text());
    const data = await response.json();
    if (data.command && (data.command.status === "done" || data.command.status === "failed")) return data;
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  throw new Error("Command timed out");
}

const command = {
  "commandId": "create-advanced-quotation-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "create-advanced-quotation",
  "payload": {
    "debtorCode": "300-A001",
    "docDate": "2026-06-24",
    "items": [
      {
        "itemCode": "ITEM001",
        "qty": 1,
        "unitPrice": 100
      }
    ],
    "displayTerm": "30 DAYS",
    "branchCode": "MAIN",
    "salesLocation": "HQ",
    "multiPricing": "Price 1",
    "salesAgent": "SA01",
    "attention": "Purchasing Department",
    "contact": "Purchasing Department",
    "deliverContact": "Store Receiver",
    "deliverPhone1": "012-3456789",
    "phone": "03-11111111",
    "address1": "No. 1 Jalan API",
    "address2": "Taman Integration",
    "address3": "Kuala Lumpur",
    "address4": "Malaysia",
    "description": "Sales document created through API",
    "ref": "WEB-ORDER-1001",
    "currencyCode": "MYR",
    "inclusiveTax": false,
    "taxEntityID": 1,
    "project": "PRJAPI",
    "department": "HQ",
    "lines": [
      {
        "itemCode": "ITEM001",
        "description": "API item line 1",
        "description2": "Line second description",
        "furtherDescription": "Optional longer line note",
        "barCode": "9550000000011",
        "qty": 2,
        "uom": "UNIT",
        "unitPrice": 100,
        "discount": "5%",
        "taxType": "S-0",
        "taxRate": 0,
        "taxAmount": 0,
        "amount": 190,
        "accountNo": "500-0000",
        "location": "HQ",
        "batchNo": "BATCH-001",
        "serialNo": "SN-0001",
        "project": "PRJAPI",
        "projNo": "PRJAPI",
        "department": "HQ",
        "deptNo": "HQ",
        "classification": "022",
        "deliveryDate": "2026-06-30",
        "userDefinedFields": {
          "APITEST": "Blue"
        }
      },
      {
        "accountNo": "500-0000",
        "description": "Service/account line without itemCode",
        "qty": 1,
        "unitPrice": 50,
        "taxType": "S-0",
        "location": "HQ",
        "project": "PRJAPI",
        "department": "HQ"
      }
    ],
    "payments": [
      {
        "paymentMethod": "CASH",
        "paymentBy": "Cash",
        "paymentAmount": 130,
        "chequeNo": "",
        "bankCharge": 0,
        "paymentAccountNo": "110-0010",
        "bankChargeAccountNo": "810-0000",
        "creditCardApprovalCode": ""
      },
      {
        "paymentMethod": "CARD",
        "paymentBy": "Credit Card",
        "paymentAmount": 60,
        "chequeNo": "",
        "bankCharge": 0,
        "paymentAccountNo": "110-0010",
        "bankChargeAccountNo": "810-0000",
        "creditCardApprovalCode": "APPROVED-001"
      }
    ],
    "userDefinedFields": {
      "APITEST": "API"
    }
  }
};

await queueCommand(command);
console.log(await waitCommand(command.commandId));

AI Rules

• Use cloud API only: https://api.autocount.cloud.
• Never call the Local Connector API directly from Mac Soft AI, AI tools, customer apps, or external integrations.
• Use Authorization: Bearer YOUR_API_KEY.
• Use a unique commandId for every real operation.
• commandId must be URL-safe: letters, numbers, dot, underscore, and hyphen only; max 160 characters.
• Set type to create-advanced-quotation.
• Poll GET /v1/commands/{commandId} until status is done or failed.
• For write commands, validate first when a validate-* command exists for the same document.

Update advanced quotation header/contact fields and supported detail rows.

Install local-mvp-2026.09.30.01 or later on the selected connector before using this update contract; cloud publication does not install or upgrade customer connectors. Check installed capabilities first; never trial writes against an older or unconfirmed build. Strict Sales update: editable SDK scalar fields via friendly fields, Master or nativeFields.Master; details via lines with explicit detailMode and existing dtlKey for update/delete. Omitted fields stay unchanged; explicit null/empty clears only optional fields. Unknown, unavailable, calculated, system and lifecycle fields are rejected before Save. Existing UDFs must be present in the SDK schema; no invented columns. validateOnly:true runs native preflight without Save and is not persistence certification. Save success requires a fresh SDK reload with writeVerification.matched=true, identity and linkage verification. saved:true with ok:false means a persisted mismatch or failed verification, not rollback; inspect the existing document and never recreate it automatically. Existing payment, transfer, package and eInvoice protections remain. Runtime get-document fields/fieldCapabilities expose SDK field discovery and fields.readErrors; availability varies by document and account book. Native acceptance covers reference/detail descriptions across eight Sales types and one final-build Sales Order price change, not all fields or SDK versions. Generic native UDF saves remain unproven. Cash Sale creation did not persist its fixture payment; this is a separate unresolved create-path issue. Update acceptance covers that existing unpaid Cash Sale only, not paid-CS support. See docs/document-update-fields.md.

Endpoint

POST /v1/commands
GET /v1/commands/{commandId}
POST /v1/sales-module/advanced-quotation/edit

Full JSON Payload

{
  "commandId": "update-advanced-quotation-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "update-advanced-quotation",
  "payload": {
    "docNo": "AQ-000001",
    "reason": "Correct customer reference",
    "ref": "Updated reference"
  }
}

Payload Fields

docNo

required existing document number (selector)

reason

required business reason

docDate

optional Document date. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

debtorCode

optional Customer/debtor code. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

debtorName

optional Customer display name. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

agent

optional Sales agent code. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

salesAgent

optional Sales agent code. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

salesAgentCode

optional Sales agent code. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

deliverAddress1

optional Delivery address line 1. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

ref

optional Reference. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

description

optional Header description. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

displayTerm

optional Credit term. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

term

optional Credit term. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

phone1

optional Phone. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

phone

optional Phone. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

attention

optional Attention/contact. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

contact

optional Attention/contact. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

branchCode

optional Branch code. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

currencyCode

optional Currency code. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

currencyRate

optional Currency rate. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

withholdingTaxVersion

optional Optional native enum only when this document exposes the field. Omission preserves the existing value. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

note

optional Note. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

remark1

optional Remark 1. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

remark2

optional Remark 2. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

remark3

optional Remark 3. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

remark4

optional Remark 4. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

refDocNo

optional Reference document number. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

shipVia

optional Shipping method. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

shipInfo

optional Shipping info. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

salesLocation

optional Sales location where supported. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

location

optional Sales location where supported. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

userDefinedFields

optional Existing SDK-materialized UDF fields; exact reload verification required. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

Master

optional header object of public SDK scalar fields

nativeFields

optional native header container: { Master: { SDKField: value } }

validateOnly

optional boolean; true runs native preflight without Save, returning saved:false; no persistence proof

detailMode

explicit update | append | replace | delete when editing lines; omit lines and detailMode for header-only updates

lines

optional detail array; update/delete select existing rows by dtlKey; append adds rows; replace replaces the detail set

Full Transaction Field Reference

header

debtorCode

customer/debtor code

debtorName

customer display name

salesAgent

sales agent code

salesLocation

sales location

multiPricing

price category/multi-pricing value

displayTerm

credit term

docNo

optional document number; omit to let AutoCount numbering generate it where supported

docDate

YYYY-MM-DD document date

dueDate

YYYY-MM-DD due date where supported

description

document narration/description

ref

reference

ourRef

our reference

yourRef

customer/supplier reference

currencyCode

currency code, for example MYR

currencyRate

currency exchange rate

inclusiveTax

true when prices include tax

taxDate

YYYY-MM-DD tax date

branchCode

debtor/creditor branch code/name where account book uses branches

userDefinedFields

object of AutoCount user-defined fields

verifyAfterSave

optional boolean; false keeps save fast, true reloads the saved record and returns readBack checks/differences where the connector has a safe get path

contactAndAddress

attention

attention/contact person

contact

alias for attention/contact person

phone1

primary phone

phone

alias for phone1

phone2

secondary phone/mobile

fax1

fax

fax

alias for fax1

address1

address line 1

address2

address line 2

address3

address line 3

address4

address line 4

deliverAddress1

delivery address line 1

deliverAddress2

delivery address line 2

deliverAddress3

delivery address line 3

deliverAddress4

delivery address line 4

deliverContact

delivery contact

deliverPhone1

delivery phone

lines

itemCode

AutoCount item code

barCode

barcode shown/used by item line

description

line description

description2

line second description

furtherDescription

long/further line description

qty

quantity

uom

UOM

unitPrice

unit price

unitCost

unit cost where supported

discount

discount string/amount

taxType

tax type/code alias

taxCode

tax code alias

taxRate

tax rate

taxAmount

tax amount

amount

line amount

location

stock location

fromLocation

source location

toLocation

destination location

batchNo

batch number

serialNo

serial number

project

project code

projNo

project code alias

department

department code

deptNo

department code alias

classification

classification code

deliveryDate

YYYY-MM-DD delivery date

userDefinedFields

object of line user-defined fields

payments

paymentMethod

AutoCount Payment Method code

paymentBy

payment type such as Cash, Cheque, Bank Transfer, Credit Card

paymentAmount

payment amount

amount

payment amount alias where supported

chequeNo

cheque/reference number

bankCharge

bank charge amount

bankAccount

bank/cash GL account

paymentAccountNo

bank/cash GL account alias

bankChargeAccountNo

bank charge GL account

creditCardApprovalCode

card approval/reference code

userDefinedFields

object of payment user-defined fields

JavaScript Example

const apiBase = "https://api.autocount.cloud";
const apiKey = "YOUR_API_KEY";

async function queueCommand(command) {
  const response = await fetch(apiBase + "/v1/commands", {
    method: "POST",
    headers: {
      "Authorization": "Bearer " + apiKey,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(command)
  });
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

async function waitCommand(commandId) {
  for (let i = 0; i < 60; i++) {
    const response = await fetch(apiBase + "/v1/commands/" + encodeURIComponent(commandId), {
      headers: { "Authorization": "Bearer " + apiKey }
    });
    if (!response.ok) throw new Error(await response.text());
    const data = await response.json();
    if (data.command && (data.command.status === "done" || data.command.status === "failed")) return data;
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  throw new Error("Command timed out");
}

const command = {
  "commandId": "update-advanced-quotation-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "update-advanced-quotation",
  "payload": {
    "docNo": "AQ-000001",
    "reason": "Correct customer reference",
    "ref": "Updated reference"
  }
};

await queueCommand(command);
console.log(await waitCommand(command.commandId));

AI Rules

• Use cloud API only: https://api.autocount.cloud.
• Never call the Local Connector API directly from Mac Soft AI, AI tools, customer apps, or external integrations.
• Use Authorization: Bearer YOUR_API_KEY.
• Use a unique commandId for every real operation.
• commandId must be URL-safe: letters, numbers, dot, underscore, and hyphen only; max 160 characters.
• Set type to update-advanced-quotation.
• Poll GET /v1/commands/{commandId} until status is done or failed.
• For write commands, validate first when a validate-* command exists for the same document.
• Install local-mvp-2026.09.30.01 or later on the selected connector before using this update contract; cloud publication does not install or upgrade customer connectors. Check installed capabilities first; never trial writes against an older or unconfirmed build. Strict Sales update: editable SDK scalar fields via friendly fields, Master or nativeFields.Master; details via lines with explicit detailMode and existing dtlKey for update/delete. Omitted fields stay unchanged; explicit null/empty clears only optional fields. Unknown, unavailable, calculated, system and lifecycle fields are rejected before Save. Existing UDFs must be present in the SDK schema; no invented columns. validateOnly:true runs native preflight without Save and is not persistence certification. Save success requires a fresh SDK reload with writeVerification.matched=true, identity and linkage verification. saved:true with ok:false means a persisted mismatch or failed verification, not rollback; inspect the existing document and never recreate it automatically. Existing payment, transfer, package and eInvoice protections remain. Runtime get-document fields/fieldCapabilities expose SDK field discovery and fields.readErrors; availability varies by document and account book. Native acceptance covers reference/detail descriptions across eight Sales types and one final-build Sales Order price change, not all fields or SDK versions. Generic native UDF saves remain unproven. Cash Sale creation did not persist its fixture payment; this is a separate unresolved create-path issue. Update acceptance covers that existing unpaid Cash Sale only, not paid-CS support. See docs/document-update-fields.md.

Cancel a advanced quotation when AutoCount allows it.

Cancellation depends on AutoCount posting/link status and account-book permissions.

Endpoint

POST /v1/commands
GET /v1/commands/{commandId}
POST /v1/sales-module/advanced-quotation/cancel

Full JSON Payload

{
  "commandId": "cancel-advanced-quotation-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "cancel-advanced-quotation",
  "payload": {
    "docNo": "AQ-000001",
    "reason": "cancelled by API request"
  }
}

Payload Fields

docNo

required document number

reason

optional cancellation reason

Full Transaction Field Reference

header

debtorCode

customer/debtor code

debtorName

customer display name

salesAgent

sales agent code

salesLocation

sales location

multiPricing

price category/multi-pricing value

displayTerm

credit term

docNo

optional document number; omit to let AutoCount numbering generate it where supported

docDate

YYYY-MM-DD document date

dueDate

YYYY-MM-DD due date where supported

description

document narration/description

ref

reference

ourRef

our reference

yourRef

customer/supplier reference

currencyCode

currency code, for example MYR

currencyRate

currency exchange rate

inclusiveTax

true when prices include tax

taxDate

YYYY-MM-DD tax date

branchCode

debtor/creditor branch code/name where account book uses branches

userDefinedFields

object of AutoCount user-defined fields

verifyAfterSave

optional boolean; false keeps save fast, true reloads the saved record and returns readBack checks/differences where the connector has a safe get path

contactAndAddress

attention

attention/contact person

contact

alias for attention/contact person

phone1

primary phone

phone

alias for phone1

phone2

secondary phone/mobile

fax1

fax

fax

alias for fax1

address1

address line 1

address2

address line 2

address3

address line 3

address4

address line 4

deliverAddress1

delivery address line 1

deliverAddress2

delivery address line 2

deliverAddress3

delivery address line 3

deliverAddress4

delivery address line 4

deliverContact

delivery contact

deliverPhone1

delivery phone

lines

itemCode

AutoCount item code

barCode

barcode shown/used by item line

description

line description

description2

line second description

furtherDescription

long/further line description

qty

quantity

uom

UOM

unitPrice

unit price

unitCost

unit cost where supported

discount

discount string/amount

taxType

tax type/code alias

taxCode

tax code alias

taxRate

tax rate

taxAmount

tax amount

amount

line amount

location

stock location

fromLocation

source location

toLocation

destination location

batchNo

batch number

serialNo

serial number

project

project code

projNo

project code alias

department

department code

deptNo

department code alias

classification

classification code

deliveryDate

YYYY-MM-DD delivery date

userDefinedFields

object of line user-defined fields

payments

paymentMethod

AutoCount Payment Method code

paymentBy

payment type such as Cash, Cheque, Bank Transfer, Credit Card

paymentAmount

payment amount

amount

payment amount alias where supported

chequeNo

cheque/reference number

bankCharge

bank charge amount

bankAccount

bank/cash GL account

paymentAccountNo

bank/cash GL account alias

bankChargeAccountNo

bank charge GL account

creditCardApprovalCode

card approval/reference code

userDefinedFields

object of payment user-defined fields

JavaScript Example

const apiBase = "https://api.autocount.cloud";
const apiKey = "YOUR_API_KEY";

async function queueCommand(command) {
  const response = await fetch(apiBase + "/v1/commands", {
    method: "POST",
    headers: {
      "Authorization": "Bearer " + apiKey,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(command)
  });
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

async function waitCommand(commandId) {
  for (let i = 0; i < 60; i++) {
    const response = await fetch(apiBase + "/v1/commands/" + encodeURIComponent(commandId), {
      headers: { "Authorization": "Bearer " + apiKey }
    });
    if (!response.ok) throw new Error(await response.text());
    const data = await response.json();
    if (data.command && (data.command.status === "done" || data.command.status === "failed")) return data;
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  throw new Error("Command timed out");
}

const command = {
  "commandId": "cancel-advanced-quotation-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "cancel-advanced-quotation",
  "payload": {
    "docNo": "AQ-000001",
    "reason": "cancelled by API request"
  }
};

await queueCommand(command);
console.log(await waitCommand(command.commandId));

AI Rules

• Use cloud API only: https://api.autocount.cloud.
• Never call the Local Connector API directly from Mac Soft AI, AI tools, customer apps, or external integrations.
• Use Authorization: Bearer YOUR_API_KEY.
• Use a unique commandId for every real operation.
• commandId must be URL-safe: letters, numbers, dot, underscore, and hyphen only; max 160 characters.
• Set type to cancel-advanced-quotation.
• Poll GET /v1/commands/{commandId} until status is done or failed.
• For write commands, validate first when a validate-* command exists for the same document.

Void a advanced quotation while keeping audit trail.

Uses AutoCount CancelDocument and returns operationUsed: CancelDocument. AutoCount may reject if the document is posted, linked, transferred, or blocked by permissions.

Endpoint

POST /v1/commands
GET /v1/commands/{commandId}
POST /v1/sales-module/advanced-quotation/void

Full JSON Payload

{
  "commandId": "void-advanced-quotation-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "void-advanced-quotation",
  "payload": {
    "docNo": "AQ-000001",
    "reason": "voided by API request"
  }
}

Payload Fields

docNo

required document number

reason

optional void reason

Full Transaction Field Reference

header

debtorCode

customer/debtor code

debtorName

customer display name

salesAgent

sales agent code

salesLocation

sales location

multiPricing

price category/multi-pricing value

displayTerm

credit term

docNo

optional document number; omit to let AutoCount numbering generate it where supported

docDate

YYYY-MM-DD document date

dueDate

YYYY-MM-DD due date where supported

description

document narration/description

ref

reference

ourRef

our reference

yourRef

customer/supplier reference

currencyCode

currency code, for example MYR

currencyRate

currency exchange rate

inclusiveTax

true when prices include tax

taxDate

YYYY-MM-DD tax date

branchCode

debtor/creditor branch code/name where account book uses branches

userDefinedFields

object of AutoCount user-defined fields

verifyAfterSave

optional boolean; false keeps save fast, true reloads the saved record and returns readBack checks/differences where the connector has a safe get path

contactAndAddress

attention

attention/contact person

contact

alias for attention/contact person

phone1

primary phone

phone

alias for phone1

phone2

secondary phone/mobile

fax1

fax

fax

alias for fax1

address1

address line 1

address2

address line 2

address3

address line 3

address4

address line 4

deliverAddress1

delivery address line 1

deliverAddress2

delivery address line 2

deliverAddress3

delivery address line 3

deliverAddress4

delivery address line 4

deliverContact

delivery contact

deliverPhone1

delivery phone

lines

itemCode

AutoCount item code

barCode

barcode shown/used by item line

description

line description

description2

line second description

furtherDescription

long/further line description

qty

quantity

uom

UOM

unitPrice

unit price

unitCost

unit cost where supported

discount

discount string/amount

taxType

tax type/code alias

taxCode

tax code alias

taxRate

tax rate

taxAmount

tax amount

amount

line amount

location

stock location

fromLocation

source location

toLocation

destination location

batchNo

batch number

serialNo

serial number

project

project code

projNo

project code alias

department

department code

deptNo

department code alias

classification

classification code

deliveryDate

YYYY-MM-DD delivery date

userDefinedFields

object of line user-defined fields

payments

paymentMethod

AutoCount Payment Method code

paymentBy

payment type such as Cash, Cheque, Bank Transfer, Credit Card

paymentAmount

payment amount

amount

payment amount alias where supported

chequeNo

cheque/reference number

bankCharge

bank charge amount

bankAccount

bank/cash GL account

paymentAccountNo

bank/cash GL account alias

bankChargeAccountNo

bank charge GL account

creditCardApprovalCode

card approval/reference code

userDefinedFields

object of payment user-defined fields

JavaScript Example

const apiBase = "https://api.autocount.cloud";
const apiKey = "YOUR_API_KEY";

async function queueCommand(command) {
  const response = await fetch(apiBase + "/v1/commands", {
    method: "POST",
    headers: {
      "Authorization": "Bearer " + apiKey,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(command)
  });
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

async function waitCommand(commandId) {
  for (let i = 0; i < 60; i++) {
    const response = await fetch(apiBase + "/v1/commands/" + encodeURIComponent(commandId), {
      headers: { "Authorization": "Bearer " + apiKey }
    });
    if (!response.ok) throw new Error(await response.text());
    const data = await response.json();
    if (data.command && (data.command.status === "done" || data.command.status === "failed")) return data;
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  throw new Error("Command timed out");
}

const command = {
  "commandId": "void-advanced-quotation-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "void-advanced-quotation",
  "payload": {
    "docNo": "AQ-000001",
    "reason": "voided by API request"
  }
};

await queueCommand(command);
console.log(await waitCommand(command.commandId));

AI Rules

• Use cloud API only: https://api.autocount.cloud.
• Never call the Local Connector API directly from Mac Soft AI, AI tools, customer apps, or external integrations.
• Use Authorization: Bearer YOUR_API_KEY.
• Use a unique commandId for every real operation.
• commandId must be URL-safe: letters, numbers, dot, underscore, and hyphen only; max 160 characters.
• Set type to void-advanced-quotation.
• Poll GET /v1/commands/{commandId} until status is done or failed.
• For write commands, validate first when a validate-* command exists for the same document.

Delete/void request for a advanced quotation.

Safely maps to AutoCount cancellation/void behavior. AutoCount may reject if the document is posted, linked, transferred, or blocked by permissions.

Endpoint

POST /v1/commands
GET /v1/commands/{commandId}
POST /v1/sales-module/advanced-quotation/delete

Full JSON Payload

{
  "commandId": "delete-advanced-quotation-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "delete-advanced-quotation",
  "payload": {
    "docNo": "AQ-000001",
    "reason": "deleted by API request"
  }
}

Payload Fields

docNo

required document number

reason

optional delete reason

Full Transaction Field Reference

header

debtorCode

customer/debtor code

debtorName

customer display name

salesAgent

sales agent code

salesLocation

sales location

multiPricing

price category/multi-pricing value

displayTerm

credit term

docNo

optional document number; omit to let AutoCount numbering generate it where supported

docDate

YYYY-MM-DD document date

dueDate

YYYY-MM-DD due date where supported

description

document narration/description

ref

reference

ourRef

our reference

yourRef

customer/supplier reference

currencyCode

currency code, for example MYR

currencyRate

currency exchange rate

inclusiveTax

true when prices include tax

taxDate

YYYY-MM-DD tax date

branchCode

debtor/creditor branch code/name where account book uses branches

userDefinedFields

object of AutoCount user-defined fields

verifyAfterSave

optional boolean; false keeps save fast, true reloads the saved record and returns readBack checks/differences where the connector has a safe get path

contactAndAddress

attention

attention/contact person

contact

alias for attention/contact person

phone1

primary phone

phone

alias for phone1

phone2

secondary phone/mobile

fax1

fax

fax

alias for fax1

address1

address line 1

address2

address line 2

address3

address line 3

address4

address line 4

deliverAddress1

delivery address line 1

deliverAddress2

delivery address line 2

deliverAddress3

delivery address line 3

deliverAddress4

delivery address line 4

deliverContact

delivery contact

deliverPhone1

delivery phone

lines

itemCode

AutoCount item code

barCode

barcode shown/used by item line

description

line description

description2

line second description

furtherDescription

long/further line description

qty

quantity

uom

UOM

unitPrice

unit price

unitCost

unit cost where supported

discount

discount string/amount

taxType

tax type/code alias

taxCode

tax code alias

taxRate

tax rate

taxAmount

tax amount

amount

line amount

location

stock location

fromLocation

source location

toLocation

destination location

batchNo

batch number

serialNo

serial number

project

project code

projNo

project code alias

department

department code

deptNo

department code alias

classification

classification code

deliveryDate

YYYY-MM-DD delivery date

userDefinedFields

object of line user-defined fields

payments

paymentMethod

AutoCount Payment Method code

paymentBy

payment type such as Cash, Cheque, Bank Transfer, Credit Card

paymentAmount

payment amount

amount

payment amount alias where supported

chequeNo

cheque/reference number

bankCharge

bank charge amount

bankAccount

bank/cash GL account

paymentAccountNo

bank/cash GL account alias

bankChargeAccountNo

bank charge GL account

creditCardApprovalCode

card approval/reference code

userDefinedFields

object of payment user-defined fields

JavaScript Example

const apiBase = "https://api.autocount.cloud";
const apiKey = "YOUR_API_KEY";

async function queueCommand(command) {
  const response = await fetch(apiBase + "/v1/commands", {
    method: "POST",
    headers: {
      "Authorization": "Bearer " + apiKey,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(command)
  });
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

async function waitCommand(commandId) {
  for (let i = 0; i < 60; i++) {
    const response = await fetch(apiBase + "/v1/commands/" + encodeURIComponent(commandId), {
      headers: { "Authorization": "Bearer " + apiKey }
    });
    if (!response.ok) throw new Error(await response.text());
    const data = await response.json();
    if (data.command && (data.command.status === "done" || data.command.status === "failed")) return data;
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  throw new Error("Command timed out");
}

const command = {
  "commandId": "delete-advanced-quotation-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "delete-advanced-quotation",
  "payload": {
    "docNo": "AQ-000001",
    "reason": "deleted by API request"
  }
};

await queueCommand(command);
console.log(await waitCommand(command.commandId));

AI Rules

• Use cloud API only: https://api.autocount.cloud.
• Never call the Local Connector API directly from Mac Soft AI, AI tools, customer apps, or external integrations.
• Use Authorization: Bearer YOUR_API_KEY.
• Use a unique commandId for every real operation.
• commandId must be URL-safe: letters, numbers, dot, underscore, and hyphen only; max 160 characters.
• Set type to delete-advanced-quotation.
• Poll GET /v1/commands/{commandId} until status is done or failed.
• For write commands, validate first when a validate-* command exists for the same document.

List quotations.

Endpoint

POST /v1/commands
GET /v1/commands/{commandId}
POST /v1/sales-module/quotation/list

Full JSON Payload

{
  "commandId": "list-quotations-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "list-quotations",
  "payload": {}
}

Payload Fields

No payload fields required.

Full Transaction Field Reference

header

debtorCode

customer/debtor code

debtorName

customer display name

salesAgent

sales agent code

salesLocation

sales location

multiPricing

price category/multi-pricing value

displayTerm

credit term

docNo

optional document number; omit to let AutoCount numbering generate it where supported

docDate

YYYY-MM-DD document date

dueDate

YYYY-MM-DD due date where supported

description

document narration/description

ref

reference

ourRef

our reference

yourRef

customer/supplier reference

currencyCode

currency code, for example MYR

currencyRate

currency exchange rate

inclusiveTax

true when prices include tax

taxDate

YYYY-MM-DD tax date

branchCode

debtor/creditor branch code/name where account book uses branches

userDefinedFields

object of AutoCount user-defined fields

verifyAfterSave

optional boolean; false keeps save fast, true reloads the saved record and returns readBack checks/differences where the connector has a safe get path

contactAndAddress

attention

attention/contact person

contact

alias for attention/contact person

phone1

primary phone

phone

alias for phone1

phone2

secondary phone/mobile

fax1

fax

fax

alias for fax1

address1

address line 1

address2

address line 2

address3

address line 3

address4

address line 4

deliverAddress1

delivery address line 1

deliverAddress2

delivery address line 2

deliverAddress3

delivery address line 3

deliverAddress4

delivery address line 4

deliverContact

delivery contact

deliverPhone1

delivery phone

lines

itemCode

AutoCount item code

barCode

barcode shown/used by item line

description

line description

description2

line second description

furtherDescription

long/further line description

qty

quantity

uom

UOM

unitPrice

unit price

unitCost

unit cost where supported

discount

discount string/amount

taxType

tax type/code alias

taxCode

tax code alias

taxRate

tax rate

taxAmount

tax amount

amount

line amount

location

stock location

fromLocation

source location

toLocation

destination location

batchNo

batch number

serialNo

serial number

project

project code

projNo

project code alias

department

department code

deptNo

department code alias

classification

classification code

deliveryDate

YYYY-MM-DD delivery date

userDefinedFields

object of line user-defined fields

payments

paymentMethod

AutoCount Payment Method code

paymentBy

payment type such as Cash, Cheque, Bank Transfer, Credit Card

paymentAmount

payment amount

amount

payment amount alias where supported

chequeNo

cheque/reference number

bankCharge

bank charge amount

bankAccount

bank/cash GL account

paymentAccountNo

bank/cash GL account alias

bankChargeAccountNo

bank charge GL account

creditCardApprovalCode

card approval/reference code

userDefinedFields

object of payment user-defined fields

JavaScript Example

const apiBase = "https://api.autocount.cloud";
const apiKey = "YOUR_API_KEY";

async function queueCommand(command) {
  const response = await fetch(apiBase + "/v1/commands", {
    method: "POST",
    headers: {
      "Authorization": "Bearer " + apiKey,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(command)
  });
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

async function waitCommand(commandId) {
  for (let i = 0; i < 60; i++) {
    const response = await fetch(apiBase + "/v1/commands/" + encodeURIComponent(commandId), {
      headers: { "Authorization": "Bearer " + apiKey }
    });
    if (!response.ok) throw new Error(await response.text());
    const data = await response.json();
    if (data.command && (data.command.status === "done" || data.command.status === "failed")) return data;
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  throw new Error("Command timed out");
}

const command = {
  "commandId": "list-quotations-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "list-quotations",
  "payload": {}
};

await queueCommand(command);
console.log(await waitCommand(command.commandId));

AI Rules

• Use cloud API only: https://api.autocount.cloud.
• Never call the Local Connector API directly from Mac Soft AI, AI tools, customer apps, or external integrations.
• Use Authorization: Bearer YOUR_API_KEY.
• Use a unique commandId for every real operation.
• commandId must be URL-safe: letters, numbers, dot, underscore, and hyphen only; max 160 characters.
• Set type to list-quotations.
• Poll GET /v1/commands/{commandId} until status is done or failed.
• For write commands, validate first when a validate-* command exists for the same document.

Read quotation detail lines only.

Endpoint

POST /v1/commands
GET /v1/commands/{commandId}
POST /v1/sales-module/quotation/list

Full JSON Payload

{
  "commandId": "read-quotation-lines-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "read-quotation-lines",
  "payload": {
    "itemCode": "ITEM001",
    "limit": 50
  }
}

Payload Fields

itemCode

optional

debtorCode

optional

docNo

optional

dateFrom

YYYY-MM-DD optional

dateTo

YYYY-MM-DD optional

limit

optional

Full Transaction Field Reference

header

debtorCode

customer/debtor code

debtorName

customer display name

salesAgent

sales agent code

salesLocation

sales location

multiPricing

price category/multi-pricing value

displayTerm

credit term

docNo

optional document number; omit to let AutoCount numbering generate it where supported

docDate

YYYY-MM-DD document date

dueDate

YYYY-MM-DD due date where supported

description

document narration/description

ref

reference

ourRef

our reference

yourRef

customer/supplier reference

currencyCode

currency code, for example MYR

currencyRate

currency exchange rate

inclusiveTax

true when prices include tax

taxDate

YYYY-MM-DD tax date

branchCode

debtor/creditor branch code/name where account book uses branches

userDefinedFields

object of AutoCount user-defined fields

verifyAfterSave

optional boolean; false keeps save fast, true reloads the saved record and returns readBack checks/differences where the connector has a safe get path

contactAndAddress

attention

attention/contact person

contact

alias for attention/contact person

phone1

primary phone

phone

alias for phone1

phone2

secondary phone/mobile

fax1

fax

fax

alias for fax1

address1

address line 1

address2

address line 2

address3

address line 3

address4

address line 4

deliverAddress1

delivery address line 1

deliverAddress2

delivery address line 2

deliverAddress3

delivery address line 3

deliverAddress4

delivery address line 4

deliverContact

delivery contact

deliverPhone1

delivery phone

lines

itemCode

AutoCount item code

barCode

barcode shown/used by item line

description

line description

description2

line second description

furtherDescription

long/further line description

qty

quantity

uom

UOM

unitPrice

unit price

unitCost

unit cost where supported

discount

discount string/amount

taxType

tax type/code alias

taxCode

tax code alias

taxRate

tax rate

taxAmount

tax amount

amount

line amount

location

stock location

fromLocation

source location

toLocation

destination location

batchNo

batch number

serialNo

serial number

project

project code

projNo

project code alias

department

department code

deptNo

department code alias

classification

classification code

deliveryDate

YYYY-MM-DD delivery date

userDefinedFields

object of line user-defined fields

payments

paymentMethod

AutoCount Payment Method code

paymentBy

payment type such as Cash, Cheque, Bank Transfer, Credit Card

paymentAmount

payment amount

amount

payment amount alias where supported

chequeNo

cheque/reference number

bankCharge

bank charge amount

bankAccount

bank/cash GL account

paymentAccountNo

bank/cash GL account alias

bankChargeAccountNo

bank charge GL account

creditCardApprovalCode

card approval/reference code

userDefinedFields

object of payment user-defined fields

JavaScript Example

const apiBase = "https://api.autocount.cloud";
const apiKey = "YOUR_API_KEY";

async function queueCommand(command) {
  const response = await fetch(apiBase + "/v1/commands", {
    method: "POST",
    headers: {
      "Authorization": "Bearer " + apiKey,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(command)
  });
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

async function waitCommand(commandId) {
  for (let i = 0; i < 60; i++) {
    const response = await fetch(apiBase + "/v1/commands/" + encodeURIComponent(commandId), {
      headers: { "Authorization": "Bearer " + apiKey }
    });
    if (!response.ok) throw new Error(await response.text());
    const data = await response.json();
    if (data.command && (data.command.status === "done" || data.command.status === "failed")) return data;
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  throw new Error("Command timed out");
}

const command = {
  "commandId": "read-quotation-lines-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "read-quotation-lines",
  "payload": {
    "itemCode": "ITEM001",
    "limit": 50
  }
};

await queueCommand(command);
console.log(await waitCommand(command.commandId));

AI Rules

• Use cloud API only: https://api.autocount.cloud.
• Never call the Local Connector API directly from Mac Soft AI, AI tools, customer apps, or external integrations.
• Use Authorization: Bearer YOUR_API_KEY.
• Use a unique commandId for every real operation.
• commandId must be URL-safe: letters, numbers, dot, underscore, and hyphen only; max 160 characters.
• Set type to read-quotation-lines.
• Poll GET /v1/commands/{commandId} until status is done or failed.
• For write commands, validate first when a validate-* command exists for the same document.

Get one quotation by document number.

Endpoint

POST /v1/commands
GET /v1/commands/{commandId}
POST /v1/sales-module/quotation/get

Full JSON Payload

{
  "commandId": "get-quotation-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "get-quotation",
  "payload": {
    "docNo": "QT-000001"
  }
}

Payload Fields

docNo

required quotation document number

Full Transaction Field Reference

header

debtorCode

customer/debtor code

debtorName

customer display name

salesAgent

sales agent code

salesLocation

sales location

multiPricing

price category/multi-pricing value

displayTerm

credit term

docNo

optional document number; omit to let AutoCount numbering generate it where supported

docDate

YYYY-MM-DD document date

dueDate

YYYY-MM-DD due date where supported

description

document narration/description

ref

reference

ourRef

our reference

yourRef

customer/supplier reference

currencyCode

currency code, for example MYR

currencyRate

currency exchange rate

inclusiveTax

true when prices include tax

taxDate

YYYY-MM-DD tax date

branchCode

debtor/creditor branch code/name where account book uses branches

userDefinedFields

object of AutoCount user-defined fields

verifyAfterSave

optional boolean; false keeps save fast, true reloads the saved record and returns readBack checks/differences where the connector has a safe get path

contactAndAddress

attention

attention/contact person

contact

alias for attention/contact person

phone1

primary phone

phone

alias for phone1

phone2

secondary phone/mobile

fax1

fax

fax

alias for fax1

address1

address line 1

address2

address line 2

address3

address line 3

address4

address line 4

deliverAddress1

delivery address line 1

deliverAddress2

delivery address line 2

deliverAddress3

delivery address line 3

deliverAddress4

delivery address line 4

deliverContact

delivery contact

deliverPhone1

delivery phone

lines

itemCode

AutoCount item code

barCode

barcode shown/used by item line

description

line description

description2

line second description

furtherDescription

long/further line description

qty

quantity

uom

UOM

unitPrice

unit price

unitCost

unit cost where supported

discount

discount string/amount

taxType

tax type/code alias

taxCode

tax code alias

taxRate

tax rate

taxAmount

tax amount

amount

line amount

location

stock location

fromLocation

source location

toLocation

destination location

batchNo

batch number

serialNo

serial number

project

project code

projNo

project code alias

department

department code

deptNo

department code alias

classification

classification code

deliveryDate

YYYY-MM-DD delivery date

userDefinedFields

object of line user-defined fields

payments

paymentMethod

AutoCount Payment Method code

paymentBy

payment type such as Cash, Cheque, Bank Transfer, Credit Card

paymentAmount

payment amount

amount

payment amount alias where supported

chequeNo

cheque/reference number

bankCharge

bank charge amount

bankAccount

bank/cash GL account

paymentAccountNo

bank/cash GL account alias

bankChargeAccountNo

bank charge GL account

creditCardApprovalCode

card approval/reference code

userDefinedFields

object of payment user-defined fields

JavaScript Example

const apiBase = "https://api.autocount.cloud";
const apiKey = "YOUR_API_KEY";

async function queueCommand(command) {
  const response = await fetch(apiBase + "/v1/commands", {
    method: "POST",
    headers: {
      "Authorization": "Bearer " + apiKey,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(command)
  });
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

async function waitCommand(commandId) {
  for (let i = 0; i < 60; i++) {
    const response = await fetch(apiBase + "/v1/commands/" + encodeURIComponent(commandId), {
      headers: { "Authorization": "Bearer " + apiKey }
    });
    if (!response.ok) throw new Error(await response.text());
    const data = await response.json();
    if (data.command && (data.command.status === "done" || data.command.status === "failed")) return data;
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  throw new Error("Command timed out");
}

const command = {
  "commandId": "get-quotation-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "get-quotation",
  "payload": {
    "docNo": "QT-000001"
  }
};

await queueCommand(command);
console.log(await waitCommand(command.commandId));

AI Rules

• Use cloud API only: https://api.autocount.cloud.
• Never call the Local Connector API directly from Mac Soft AI, AI tools, customer apps, or external integrations.
• Use Authorization: Bearer YOUR_API_KEY.
• Use a unique commandId for every real operation.
• commandId must be URL-safe: letters, numbers, dot, underscore, and hyphen only; max 160 characters.
• Set type to get-quotation.
• Poll GET /v1/commands/{commandId} until status is done or failed.
• For write commands, validate first when a validate-* command exists for the same document.

Validate a quotation without saving.

Validation only; does not save. Full payload example is for human/Postman reference. For stock-item lines, send itemCode/uom/location and call read-locations for the exact active location code. If a sales account book requires a line posting account, the connector uses AutoCount's default sales account when lines[].accountNo is omitted; send accountNo / accNo / glAccount / postingAccountNo on a line to override it. For account/service lines, omit itemCode and send accountNo / accNo / glAccount / postingAccountNo; many account books still require lines[].location even without itemCode. salesLocation is copied to lines that omit location; lines[].location wins. The connector verifies AutoCount accepted the requested detail location before save instead of silently using a default.

Endpoint

POST /v1/commands
GET /v1/commands/{commandId}
POST /v1/sales-module/quotation/validate

Full JSON Payload

{
  "commandId": "validate-quotation-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "validate-quotation",
  "payload": {
    "debtorCode": "300-A001",
    "items": [
      {
        "itemCode": "ITEM001",
        "qty": 1,
        "unitPrice": 100
      }
    ],
    "docDate": "2026-06-24",
    "displayTerm": "30 DAYS",
    "branchCode": "MAIN",
    "salesLocation": "HQ",
    "multiPricing": "Price 1",
    "salesAgent": "SA01",
    "attention": "Purchasing Department",
    "contact": "Purchasing Department",
    "deliverContact": "Store Receiver",
    "deliverPhone1": "012-3456789",
    "phone": "03-11111111",
    "address1": "No. 1 Jalan API",
    "address2": "Taman Integration",
    "address3": "Kuala Lumpur",
    "address4": "Malaysia",
    "description": "Sales document created through API",
    "ref": "WEB-ORDER-1001",
    "currencyCode": "MYR",
    "inclusiveTax": false,
    "taxEntityID": 1,
    "project": "PRJAPI",
    "department": "HQ",
    "lines": [
      {
        "itemCode": "ITEM001",
        "description": "API item line 1",
        "description2": "Line second description",
        "furtherDescription": "Optional longer line note",
        "barCode": "9550000000011",
        "qty": 2,
        "uom": "UNIT",
        "unitPrice": 100,
        "discount": "5%",
        "taxType": "S-0",
        "taxRate": 0,
        "taxAmount": 0,
        "amount": 190,
        "accountNo": "500-0000",
        "location": "HQ",
        "batchNo": "BATCH-001",
        "serialNo": "SN-0001",
        "project": "PRJAPI",
        "projNo": "PRJAPI",
        "department": "HQ",
        "deptNo": "HQ",
        "classification": "022",
        "deliveryDate": "2026-06-30",
        "userDefinedFields": {
          "APITEST": "Blue"
        }
      },
      {
        "accountNo": "500-0000",
        "description": "Service/account line without itemCode",
        "qty": 1,
        "unitPrice": 50,
        "taxType": "S-0",
        "location": "HQ",
        "project": "PRJAPI",
        "department": "HQ"
      }
    ],
    "payments": [
      {
        "paymentMethod": "CASH",
        "paymentBy": "Cash",
        "paymentAmount": 130,
        "chequeNo": "",
        "bankCharge": 0,
        "paymentAccountNo": "110-0010",
        "bankChargeAccountNo": "810-0000",
        "creditCardApprovalCode": ""
      },
      {
        "paymentMethod": "CARD",
        "paymentBy": "Credit Card",
        "paymentAmount": 60,
        "chequeNo": "",
        "bankCharge": 0,
        "paymentAccountNo": "110-0010",
        "bankChargeAccountNo": "810-0000",
        "creditCardApprovalCode": "APPROVED-001"
      }
    ],
    "userDefinedFields": {
      "APITEST": "API"
    }
  }
}

Payload Fields

debtorCode

required AutoCount debtor/customer code

items

optional alias for lines

debtorName

optional customer display name; AutoCount debtor name is used when omitted

docNo

optional AutoCount document number; omit to let AutoCount numbering generate it

docDate

required or optional YYYY-MM-DD document date depending on account-book numbering rules

displayTerm

optional credit term such as C.O.D. or 30 DAYS

dueDate

optional YYYY-MM-DD due date

branchCode

optional debtor branch code/name where the customer uses branches

salesLocation

optional exact active AutoCount sales/stock location code such as HQ-RETAIL; call read-locations first. It fills only lines that omit lines[].location; an explicit line location always wins

multiPricing

optional price category/multi-pricing value such as Price 1

salesAgent

optional Sales Agent Maintenance code

attention

optional attention/contact person

contact

optional contact person alias for attention

deliverContact

optional delivery contact person

deliverPhone1

optional delivery phone number

phone1

optional phone number printed on document

phone

optional phone alias for phone1

phone2

optional secondary phone/mobile number

fax1

optional fax number printed on document

fax

optional fax alias for fax1

address1

optional billing address line 1

address2

optional billing address line 2

address3

optional billing address line 3

address4

optional billing address line 4

deliverAddress1

optional delivery address line 1

deliverAddress2

optional delivery address line 2

deliverAddress3

optional delivery address line 3

deliverAddress4

optional delivery address line 4

description

optional document description/narration

ref

optional reference

ourRef

optional our reference

yourRef

optional customer reference

currencyCode

optional currency code such as MYR

currencyRate

optional exchange rate

inclusiveTax

optional boolean; true when line prices include tax

taxDate

optional YYYY-MM-DD tax date

taxEntityID

optional numeric Tax Entity Maintenance ID for the document header/e-Invoice party

project

optional project code

department

optional department code

lines

required array of stock item rows or account/service rows; items is also accepted as a compatibility alias

accountNo

optional top-level GL posting account fallback; line-level accountNo / accNo / glAccount / postingAccountNo wins, otherwise the connector uses AutoCount's default sales account where needed

payments

optional array for cash sale style documents; send multiple payment rows for AutoCount Multi Payment

userDefinedFields

optional object of AutoCount user-defined fields; use the AutoCount UDF field name without the UDF_ column prefix, for example { APITEST: value }

Full Transaction Field Reference

header

debtorCode

customer/debtor code

debtorName

customer display name

salesAgent

sales agent code

salesLocation

sales location

multiPricing

price category/multi-pricing value

displayTerm

credit term

docNo

optional document number; omit to let AutoCount numbering generate it where supported

docDate

YYYY-MM-DD document date

dueDate

YYYY-MM-DD due date where supported

description

document narration/description

ref

reference

ourRef

our reference

yourRef

customer/supplier reference

currencyCode

currency code, for example MYR

currencyRate

currency exchange rate

inclusiveTax

true when prices include tax

taxDate

YYYY-MM-DD tax date

branchCode

debtor/creditor branch code/name where account book uses branches

userDefinedFields

object of AutoCount user-defined fields

verifyAfterSave

optional boolean; false keeps save fast, true reloads the saved record and returns readBack checks/differences where the connector has a safe get path

contactAndAddress

attention

attention/contact person

contact

alias for attention/contact person

phone1

primary phone

phone

alias for phone1

phone2

secondary phone/mobile

fax1

fax

fax

alias for fax1

address1

address line 1

address2

address line 2

address3

address line 3

address4

address line 4

deliverAddress1

delivery address line 1

deliverAddress2

delivery address line 2

deliverAddress3

delivery address line 3

deliverAddress4

delivery address line 4

deliverContact

delivery contact

deliverPhone1

delivery phone

lines

itemCode

AutoCount item code

barCode

barcode shown/used by item line

description

line description

description2

line second description

furtherDescription

long/further line description

qty

quantity

uom

UOM

unitPrice

unit price

unitCost

unit cost where supported

discount

discount string/amount

taxType

tax type/code alias

taxCode

tax code alias

taxRate

tax rate

taxAmount

tax amount

amount

line amount

location

stock location

fromLocation

source location

toLocation

destination location

batchNo

batch number

serialNo

serial number

project

project code

projNo

project code alias

department

department code

deptNo

department code alias

classification

classification code

deliveryDate

YYYY-MM-DD delivery date

userDefinedFields

object of line user-defined fields

payments

paymentMethod

AutoCount Payment Method code

paymentBy

payment type such as Cash, Cheque, Bank Transfer, Credit Card

paymentAmount

payment amount

amount

payment amount alias where supported

chequeNo

cheque/reference number

bankCharge

bank charge amount

bankAccount

bank/cash GL account

paymentAccountNo

bank/cash GL account alias

bankChargeAccountNo

bank charge GL account

creditCardApprovalCode

card approval/reference code

userDefinedFields

object of payment user-defined fields

JavaScript Example

const apiBase = "https://api.autocount.cloud";
const apiKey = "YOUR_API_KEY";

async function queueCommand(command) {
  const response = await fetch(apiBase + "/v1/commands", {
    method: "POST",
    headers: {
      "Authorization": "Bearer " + apiKey,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(command)
  });
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

async function waitCommand(commandId) {
  for (let i = 0; i < 60; i++) {
    const response = await fetch(apiBase + "/v1/commands/" + encodeURIComponent(commandId), {
      headers: { "Authorization": "Bearer " + apiKey }
    });
    if (!response.ok) throw new Error(await response.text());
    const data = await response.json();
    if (data.command && (data.command.status === "done" || data.command.status === "failed")) return data;
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  throw new Error("Command timed out");
}

const command = {
  "commandId": "validate-quotation-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "validate-quotation",
  "payload": {
    "debtorCode": "300-A001",
    "items": [
      {
        "itemCode": "ITEM001",
        "qty": 1,
        "unitPrice": 100
      }
    ],
    "docDate": "2026-06-24",
    "displayTerm": "30 DAYS",
    "branchCode": "MAIN",
    "salesLocation": "HQ",
    "multiPricing": "Price 1",
    "salesAgent": "SA01",
    "attention": "Purchasing Department",
    "contact": "Purchasing Department",
    "deliverContact": "Store Receiver",
    "deliverPhone1": "012-3456789",
    "phone": "03-11111111",
    "address1": "No. 1 Jalan API",
    "address2": "Taman Integration",
    "address3": "Kuala Lumpur",
    "address4": "Malaysia",
    "description": "Sales document created through API",
    "ref": "WEB-ORDER-1001",
    "currencyCode": "MYR",
    "inclusiveTax": false,
    "taxEntityID": 1,
    "project": "PRJAPI",
    "department": "HQ",
    "lines": [
      {
        "itemCode": "ITEM001",
        "description": "API item line 1",
        "description2": "Line second description",
        "furtherDescription": "Optional longer line note",
        "barCode": "9550000000011",
        "qty": 2,
        "uom": "UNIT",
        "unitPrice": 100,
        "discount": "5%",
        "taxType": "S-0",
        "taxRate": 0,
        "taxAmount": 0,
        "amount": 190,
        "accountNo": "500-0000",
        "location": "HQ",
        "batchNo": "BATCH-001",
        "serialNo": "SN-0001",
        "project": "PRJAPI",
        "projNo": "PRJAPI",
        "department": "HQ",
        "deptNo": "HQ",
        "classification": "022",
        "deliveryDate": "2026-06-30",
        "userDefinedFields": {
          "APITEST": "Blue"
        }
      },
      {
        "accountNo": "500-0000",
        "description": "Service/account line without itemCode",
        "qty": 1,
        "unitPrice": 50,
        "taxType": "S-0",
        "location": "HQ",
        "project": "PRJAPI",
        "department": "HQ"
      }
    ],
    "payments": [
      {
        "paymentMethod": "CASH",
        "paymentBy": "Cash",
        "paymentAmount": 130,
        "chequeNo": "",
        "bankCharge": 0,
        "paymentAccountNo": "110-0010",
        "bankChargeAccountNo": "810-0000",
        "creditCardApprovalCode": ""
      },
      {
        "paymentMethod": "CARD",
        "paymentBy": "Credit Card",
        "paymentAmount": 60,
        "chequeNo": "",
        "bankCharge": 0,
        "paymentAccountNo": "110-0010",
        "bankChargeAccountNo": "810-0000",
        "creditCardApprovalCode": "APPROVED-001"
      }
    ],
    "userDefinedFields": {
      "APITEST": "API"
    }
  }
};

await queueCommand(command);
console.log(await waitCommand(command.commandId));

AI Rules

• Use cloud API only: https://api.autocount.cloud.
• Never call the Local Connector API directly from Mac Soft AI, AI tools, customer apps, or external integrations.
• Use Authorization: Bearer YOUR_API_KEY.
• Use a unique commandId for every real operation.
• commandId must be URL-safe: letters, numbers, dot, underscore, and hyphen only; max 160 characters.
• Set type to validate-quotation.
• Poll GET /v1/commands/{commandId} until status is done or failed.
• For write commands, validate first when a validate-* command exists for the same document.

Create a quotation.

Creates quotation through AutoCount SDK. Full payload example is for human/Postman reference. For stock-item lines, send itemCode/uom/location and call read-locations for the exact active location code. If a sales account book requires a line posting account, the connector uses AutoCount's default sales account when lines[].accountNo is omitted; send accountNo / accNo / glAccount / postingAccountNo on a line to override it. For account/service lines, omit itemCode and send accountNo / accNo / glAccount / postingAccountNo; many account books still require lines[].location even without itemCode. salesLocation is copied to lines that omit location; lines[].location wins. The connector verifies AutoCount accepted the requested detail location before save instead of silently using a default.

Endpoint

POST /v1/commands
GET /v1/commands/{commandId}
POST /v1/sales-module/quotation/create

Full JSON Payload

{
  "commandId": "create-quotation-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "create-quotation",
  "payload": {
    "debtorCode": "300-A001",
    "docDate": "2026-06-24",
    "items": [
      {
        "itemCode": "ITEM001",
        "qty": 1,
        "unitPrice": 100
      }
    ],
    "displayTerm": "30 DAYS",
    "branchCode": "MAIN",
    "salesLocation": "HQ",
    "multiPricing": "Price 1",
    "salesAgent": "SA01",
    "attention": "Purchasing Department",
    "contact": "Purchasing Department",
    "deliverContact": "Store Receiver",
    "deliverPhone1": "012-3456789",
    "phone": "03-11111111",
    "address1": "No. 1 Jalan API",
    "address2": "Taman Integration",
    "address3": "Kuala Lumpur",
    "address4": "Malaysia",
    "description": "Sales document created through API",
    "ref": "WEB-ORDER-1001",
    "currencyCode": "MYR",
    "inclusiveTax": false,
    "taxEntityID": 1,
    "project": "PRJAPI",
    "department": "HQ",
    "lines": [
      {
        "itemCode": "ITEM001",
        "description": "API item line 1",
        "description2": "Line second description",
        "furtherDescription": "Optional longer line note",
        "barCode": "9550000000011",
        "qty": 2,
        "uom": "UNIT",
        "unitPrice": 100,
        "discount": "5%",
        "taxType": "S-0",
        "taxRate": 0,
        "taxAmount": 0,
        "amount": 190,
        "accountNo": "500-0000",
        "location": "HQ",
        "batchNo": "BATCH-001",
        "serialNo": "SN-0001",
        "project": "PRJAPI",
        "projNo": "PRJAPI",
        "department": "HQ",
        "deptNo": "HQ",
        "classification": "022",
        "deliveryDate": "2026-06-30",
        "userDefinedFields": {
          "APITEST": "Blue"
        }
      },
      {
        "accountNo": "500-0000",
        "description": "Service/account line without itemCode",
        "qty": 1,
        "unitPrice": 50,
        "taxType": "S-0",
        "location": "HQ",
        "project": "PRJAPI",
        "department": "HQ"
      }
    ],
    "payments": [
      {
        "paymentMethod": "CASH",
        "paymentBy": "Cash",
        "paymentAmount": 130,
        "chequeNo": "",
        "bankCharge": 0,
        "paymentAccountNo": "110-0010",
        "bankChargeAccountNo": "810-0000",
        "creditCardApprovalCode": ""
      },
      {
        "paymentMethod": "CARD",
        "paymentBy": "Credit Card",
        "paymentAmount": 60,
        "chequeNo": "",
        "bankCharge": 0,
        "paymentAccountNo": "110-0010",
        "bankChargeAccountNo": "810-0000",
        "creditCardApprovalCode": "APPROVED-001"
      }
    ],
    "userDefinedFields": {
      "APITEST": "API"
    }
  }
}

Payload Fields

debtorCode

required AutoCount debtor/customer code

docDate

required or optional YYYY-MM-DD document date depending on account-book numbering rules

items

optional alias for lines

debtorName

optional customer display name; AutoCount debtor name is used when omitted

docNo

optional AutoCount document number; omit to let AutoCount numbering generate it

displayTerm

optional credit term such as C.O.D. or 30 DAYS

dueDate

optional YYYY-MM-DD due date

branchCode

optional debtor branch code/name where the customer uses branches

salesLocation

optional exact active AutoCount sales/stock location code such as HQ-RETAIL; call read-locations first. It fills only lines that omit lines[].location; an explicit line location always wins

multiPricing

optional price category/multi-pricing value such as Price 1

salesAgent

optional Sales Agent Maintenance code

attention

optional attention/contact person

contact

optional contact person alias for attention

deliverContact

optional delivery contact person

deliverPhone1

optional delivery phone number

phone1

optional phone number printed on document

phone

optional phone alias for phone1

phone2

optional secondary phone/mobile number

fax1

optional fax number printed on document

fax

optional fax alias for fax1

address1

optional billing address line 1

address2

optional billing address line 2

address3

optional billing address line 3

address4

optional billing address line 4

deliverAddress1

optional delivery address line 1

deliverAddress2

optional delivery address line 2

deliverAddress3

optional delivery address line 3

deliverAddress4

optional delivery address line 4

description

optional document description/narration

ref

optional reference

ourRef

optional our reference

yourRef

optional customer reference

currencyCode

optional currency code such as MYR

currencyRate

optional exchange rate

inclusiveTax

optional boolean; true when line prices include tax

taxDate

optional YYYY-MM-DD tax date

taxEntityID

optional numeric Tax Entity Maintenance ID for the document header/e-Invoice party

project

optional project code

department

optional department code

lines

required array of stock item rows or account/service rows; items is also accepted as a compatibility alias

accountNo

optional top-level GL posting account fallback; line-level accountNo / accNo / glAccount / postingAccountNo wins, otherwise the connector uses AutoCount's default sales account where needed

payments

optional array for cash sale style documents; send multiple payment rows for AutoCount Multi Payment

userDefinedFields

optional object of AutoCount user-defined fields; use the AutoCount UDF field name without the UDF_ column prefix, for example { APITEST: value }

Full Transaction Field Reference

header

debtorCode

customer/debtor code

debtorName

customer display name

salesAgent

sales agent code

salesLocation

sales location

multiPricing

price category/multi-pricing value

displayTerm

credit term

docNo

optional document number; omit to let AutoCount numbering generate it where supported

docDate

YYYY-MM-DD document date

dueDate

YYYY-MM-DD due date where supported

description

document narration/description

ref

reference

ourRef

our reference

yourRef

customer/supplier reference

currencyCode

currency code, for example MYR

currencyRate

currency exchange rate

inclusiveTax

true when prices include tax

taxDate

YYYY-MM-DD tax date

branchCode

debtor/creditor branch code/name where account book uses branches

userDefinedFields

object of AutoCount user-defined fields

verifyAfterSave

optional boolean; false keeps save fast, true reloads the saved record and returns readBack checks/differences where the connector has a safe get path

contactAndAddress

attention

attention/contact person

contact

alias for attention/contact person

phone1

primary phone

phone

alias for phone1

phone2

secondary phone/mobile

fax1

fax

fax

alias for fax1

address1

address line 1

address2

address line 2

address3

address line 3

address4

address line 4

deliverAddress1

delivery address line 1

deliverAddress2

delivery address line 2

deliverAddress3

delivery address line 3

deliverAddress4

delivery address line 4

deliverContact

delivery contact

deliverPhone1

delivery phone

lines

itemCode

AutoCount item code

barCode

barcode shown/used by item line

description

line description

description2

line second description

furtherDescription

long/further line description

qty

quantity

uom

UOM

unitPrice

unit price

unitCost

unit cost where supported

discount

discount string/amount

taxType

tax type/code alias

taxCode

tax code alias

taxRate

tax rate

taxAmount

tax amount

amount

line amount

location

stock location

fromLocation

source location

toLocation

destination location

batchNo

batch number

serialNo

serial number

project

project code

projNo

project code alias

department

department code

deptNo

department code alias

classification

classification code

deliveryDate

YYYY-MM-DD delivery date

userDefinedFields

object of line user-defined fields

payments

paymentMethod

AutoCount Payment Method code

paymentBy

payment type such as Cash, Cheque, Bank Transfer, Credit Card

paymentAmount

payment amount

amount

payment amount alias where supported

chequeNo

cheque/reference number

bankCharge

bank charge amount

bankAccount

bank/cash GL account

paymentAccountNo

bank/cash GL account alias

bankChargeAccountNo

bank charge GL account

creditCardApprovalCode

card approval/reference code

userDefinedFields

object of payment user-defined fields

JavaScript Example

const apiBase = "https://api.autocount.cloud";
const apiKey = "YOUR_API_KEY";

async function queueCommand(command) {
  const response = await fetch(apiBase + "/v1/commands", {
    method: "POST",
    headers: {
      "Authorization": "Bearer " + apiKey,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(command)
  });
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

async function waitCommand(commandId) {
  for (let i = 0; i < 60; i++) {
    const response = await fetch(apiBase + "/v1/commands/" + encodeURIComponent(commandId), {
      headers: { "Authorization": "Bearer " + apiKey }
    });
    if (!response.ok) throw new Error(await response.text());
    const data = await response.json();
    if (data.command && (data.command.status === "done" || data.command.status === "failed")) return data;
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  throw new Error("Command timed out");
}

const command = {
  "commandId": "create-quotation-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "create-quotation",
  "payload": {
    "debtorCode": "300-A001",
    "docDate": "2026-06-24",
    "items": [
      {
        "itemCode": "ITEM001",
        "qty": 1,
        "unitPrice": 100
      }
    ],
    "displayTerm": "30 DAYS",
    "branchCode": "MAIN",
    "salesLocation": "HQ",
    "multiPricing": "Price 1",
    "salesAgent": "SA01",
    "attention": "Purchasing Department",
    "contact": "Purchasing Department",
    "deliverContact": "Store Receiver",
    "deliverPhone1": "012-3456789",
    "phone": "03-11111111",
    "address1": "No. 1 Jalan API",
    "address2": "Taman Integration",
    "address3": "Kuala Lumpur",
    "address4": "Malaysia",
    "description": "Sales document created through API",
    "ref": "WEB-ORDER-1001",
    "currencyCode": "MYR",
    "inclusiveTax": false,
    "taxEntityID": 1,
    "project": "PRJAPI",
    "department": "HQ",
    "lines": [
      {
        "itemCode": "ITEM001",
        "description": "API item line 1",
        "description2": "Line second description",
        "furtherDescription": "Optional longer line note",
        "barCode": "9550000000011",
        "qty": 2,
        "uom": "UNIT",
        "unitPrice": 100,
        "discount": "5%",
        "taxType": "S-0",
        "taxRate": 0,
        "taxAmount": 0,
        "amount": 190,
        "accountNo": "500-0000",
        "location": "HQ",
        "batchNo": "BATCH-001",
        "serialNo": "SN-0001",
        "project": "PRJAPI",
        "projNo": "PRJAPI",
        "department": "HQ",
        "deptNo": "HQ",
        "classification": "022",
        "deliveryDate": "2026-06-30",
        "userDefinedFields": {
          "APITEST": "Blue"
        }
      },
      {
        "accountNo": "500-0000",
        "description": "Service/account line without itemCode",
        "qty": 1,
        "unitPrice": 50,
        "taxType": "S-0",
        "location": "HQ",
        "project": "PRJAPI",
        "department": "HQ"
      }
    ],
    "payments": [
      {
        "paymentMethod": "CASH",
        "paymentBy": "Cash",
        "paymentAmount": 130,
        "chequeNo": "",
        "bankCharge": 0,
        "paymentAccountNo": "110-0010",
        "bankChargeAccountNo": "810-0000",
        "creditCardApprovalCode": ""
      },
      {
        "paymentMethod": "CARD",
        "paymentBy": "Credit Card",
        "paymentAmount": 60,
        "chequeNo": "",
        "bankCharge": 0,
        "paymentAccountNo": "110-0010",
        "bankChargeAccountNo": "810-0000",
        "creditCardApprovalCode": "APPROVED-001"
      }
    ],
    "userDefinedFields": {
      "APITEST": "API"
    }
  }
};

await queueCommand(command);
console.log(await waitCommand(command.commandId));

AI Rules

• Use cloud API only: https://api.autocount.cloud.
• Never call the Local Connector API directly from Mac Soft AI, AI tools, customer apps, or external integrations.
• Use Authorization: Bearer YOUR_API_KEY.
• Use a unique commandId for every real operation.
• commandId must be URL-safe: letters, numbers, dot, underscore, and hyphen only; max 160 characters.
• Set type to create-quotation.
• Poll GET /v1/commands/{commandId} until status is done or failed.
• For write commands, validate first when a validate-* command exists for the same document.

Update quotation header/contact fields and supported detail rows.

Install local-mvp-2026.09.30.01 or later on the selected connector before using this update contract; cloud publication does not install or upgrade customer connectors. Check installed capabilities first; never trial writes against an older or unconfirmed build. Strict Sales update: editable SDK scalar fields via friendly fields, Master or nativeFields.Master; details via lines with explicit detailMode and existing dtlKey for update/delete. Omitted fields stay unchanged; explicit null/empty clears only optional fields. Unknown, unavailable, calculated, system and lifecycle fields are rejected before Save. Existing UDFs must be present in the SDK schema; no invented columns. validateOnly:true runs native preflight without Save and is not persistence certification. Save success requires a fresh SDK reload with writeVerification.matched=true, identity and linkage verification. saved:true with ok:false means a persisted mismatch or failed verification, not rollback; inspect the existing document and never recreate it automatically. Existing payment, transfer, package and eInvoice protections remain. Runtime get-document fields/fieldCapabilities expose SDK field discovery and fields.readErrors; availability varies by document and account book. Native acceptance covers reference/detail descriptions across eight Sales types and one final-build Sales Order price change, not all fields or SDK versions. Generic native UDF saves remain unproven. Cash Sale creation did not persist its fixture payment; this is a separate unresolved create-path issue. Update acceptance covers that existing unpaid Cash Sale only, not paid-CS support. See docs/document-update-fields.md.

Endpoint

POST /v1/commands
GET /v1/commands/{commandId}
POST /v1/sales-module/quotation/edit

Full JSON Payload

{
  "commandId": "update-quotation-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "update-quotation",
  "payload": {
    "docNo": "QT-000001",
    "reason": "Correct customer reference",
    "ref": "Updated reference"
  }
}

Payload Fields

docNo

required existing document number (selector)

reason

required business reason

docDate

optional Document date. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

debtorCode

optional Customer/debtor code. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

debtorName

optional Customer display name. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

agent

optional Sales agent code. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

salesAgent

optional Sales agent code. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

salesAgentCode

optional Sales agent code. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

deliverAddress1

optional Delivery address line 1. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

ref

optional Reference. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

description

optional Header description. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

displayTerm

optional Credit term. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

term

optional Credit term. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

phone1

optional Phone. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

phone

optional Phone. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

attention

optional Attention/contact. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

contact

optional Attention/contact. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

branchCode

optional Branch code. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

currencyCode

optional Currency code. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

currencyRate

optional Currency rate. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

withholdingTaxVersion

optional Optional native enum only when this document exposes the field. Omission preserves the existing value. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

note

optional Note. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

remark1

optional Remark 1. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

remark2

optional Remark 2. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

remark3

optional Remark 3. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

remark4

optional Remark 4. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

refDocNo

optional Reference document number. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

shipVia

optional Shipping method. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

shipInfo

optional Shipping info. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

salesLocation

optional Sales location where supported. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

location

optional Sales location where supported. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

userDefinedFields

optional Existing SDK-materialized UDF fields; exact reload verification required. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

Master

optional header object of public SDK scalar fields

nativeFields

optional native header container: { Master: { SDKField: value } }

validateOnly

optional boolean; true runs native preflight without Save, returning saved:false; no persistence proof

detailMode

explicit update | append | replace | delete when editing lines; omit lines and detailMode for header-only updates

lines

optional detail array; update/delete select existing rows by dtlKey; append adds rows; replace replaces the detail set

Full Transaction Field Reference

header

debtorCode

customer/debtor code

debtorName

customer display name

salesAgent

sales agent code

salesLocation

sales location

multiPricing

price category/multi-pricing value

displayTerm

credit term

docNo

optional document number; omit to let AutoCount numbering generate it where supported

docDate

YYYY-MM-DD document date

dueDate

YYYY-MM-DD due date where supported

description

document narration/description

ref

reference

ourRef

our reference

yourRef

customer/supplier reference

currencyCode

currency code, for example MYR

currencyRate

currency exchange rate

inclusiveTax

true when prices include tax

taxDate

YYYY-MM-DD tax date

branchCode

debtor/creditor branch code/name where account book uses branches

userDefinedFields

object of AutoCount user-defined fields

verifyAfterSave

optional boolean; false keeps save fast, true reloads the saved record and returns readBack checks/differences where the connector has a safe get path

contactAndAddress

attention

attention/contact person

contact

alias for attention/contact person

phone1

primary phone

phone

alias for phone1

phone2

secondary phone/mobile

fax1

fax

fax

alias for fax1

address1

address line 1

address2

address line 2

address3

address line 3

address4

address line 4

deliverAddress1

delivery address line 1

deliverAddress2

delivery address line 2

deliverAddress3

delivery address line 3

deliverAddress4

delivery address line 4

deliverContact

delivery contact

deliverPhone1

delivery phone

lines

itemCode

AutoCount item code

barCode

barcode shown/used by item line

description

line description

description2

line second description

furtherDescription

long/further line description

qty

quantity

uom

UOM

unitPrice

unit price

unitCost

unit cost where supported

discount

discount string/amount

taxType

tax type/code alias

taxCode

tax code alias

taxRate

tax rate

taxAmount

tax amount

amount

line amount

location

stock location

fromLocation

source location

toLocation

destination location

batchNo

batch number

serialNo

serial number

project

project code

projNo

project code alias

department

department code

deptNo

department code alias

classification

classification code

deliveryDate

YYYY-MM-DD delivery date

userDefinedFields

object of line user-defined fields

payments

paymentMethod

AutoCount Payment Method code

paymentBy

payment type such as Cash, Cheque, Bank Transfer, Credit Card

paymentAmount

payment amount

amount

payment amount alias where supported

chequeNo

cheque/reference number

bankCharge

bank charge amount

bankAccount

bank/cash GL account

paymentAccountNo

bank/cash GL account alias

bankChargeAccountNo

bank charge GL account

creditCardApprovalCode

card approval/reference code

userDefinedFields

object of payment user-defined fields

JavaScript Example

const apiBase = "https://api.autocount.cloud";
const apiKey = "YOUR_API_KEY";

async function queueCommand(command) {
  const response = await fetch(apiBase + "/v1/commands", {
    method: "POST",
    headers: {
      "Authorization": "Bearer " + apiKey,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(command)
  });
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

async function waitCommand(commandId) {
  for (let i = 0; i < 60; i++) {
    const response = await fetch(apiBase + "/v1/commands/" + encodeURIComponent(commandId), {
      headers: { "Authorization": "Bearer " + apiKey }
    });
    if (!response.ok) throw new Error(await response.text());
    const data = await response.json();
    if (data.command && (data.command.status === "done" || data.command.status === "failed")) return data;
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  throw new Error("Command timed out");
}

const command = {
  "commandId": "update-quotation-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "update-quotation",
  "payload": {
    "docNo": "QT-000001",
    "reason": "Correct customer reference",
    "ref": "Updated reference"
  }
};

await queueCommand(command);
console.log(await waitCommand(command.commandId));

AI Rules

• Use cloud API only: https://api.autocount.cloud.
• Never call the Local Connector API directly from Mac Soft AI, AI tools, customer apps, or external integrations.
• Use Authorization: Bearer YOUR_API_KEY.
• Use a unique commandId for every real operation.
• commandId must be URL-safe: letters, numbers, dot, underscore, and hyphen only; max 160 characters.
• Set type to update-quotation.
• Poll GET /v1/commands/{commandId} until status is done or failed.
• For write commands, validate first when a validate-* command exists for the same document.
• Install local-mvp-2026.09.30.01 or later on the selected connector before using this update contract; cloud publication does not install or upgrade customer connectors. Check installed capabilities first; never trial writes against an older or unconfirmed build. Strict Sales update: editable SDK scalar fields via friendly fields, Master or nativeFields.Master; details via lines with explicit detailMode and existing dtlKey for update/delete. Omitted fields stay unchanged; explicit null/empty clears only optional fields. Unknown, unavailable, calculated, system and lifecycle fields are rejected before Save. Existing UDFs must be present in the SDK schema; no invented columns. validateOnly:true runs native preflight without Save and is not persistence certification. Save success requires a fresh SDK reload with writeVerification.matched=true, identity and linkage verification. saved:true with ok:false means a persisted mismatch or failed verification, not rollback; inspect the existing document and never recreate it automatically. Existing payment, transfer, package and eInvoice protections remain. Runtime get-document fields/fieldCapabilities expose SDK field discovery and fields.readErrors; availability varies by document and account book. Native acceptance covers reference/detail descriptions across eight Sales types and one final-build Sales Order price change, not all fields or SDK versions. Generic native UDF saves remain unproven. Cash Sale creation did not persist its fixture payment; this is a separate unresolved create-path issue. Update acceptance covers that existing unpaid Cash Sale only, not paid-CS support. See docs/document-update-fields.md.

Cancel a quotation when AutoCount allows it.

Cancellation depends on AutoCount posting/link status and account-book permissions.

Endpoint

POST /v1/commands
GET /v1/commands/{commandId}
POST /v1/sales-module/quotation/cancel

Full JSON Payload

{
  "commandId": "cancel-quotation-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "cancel-quotation",
  "payload": {
    "docNo": "QT-000001",
    "reason": "cancelled by API request"
  }
}

Payload Fields

docNo

required document number

reason

optional cancellation reason

Full Transaction Field Reference

header

debtorCode

customer/debtor code

debtorName

customer display name

salesAgent

sales agent code

salesLocation

sales location

multiPricing

price category/multi-pricing value

displayTerm

credit term

docNo

optional document number; omit to let AutoCount numbering generate it where supported

docDate

YYYY-MM-DD document date

dueDate

YYYY-MM-DD due date where supported

description

document narration/description

ref

reference

ourRef

our reference

yourRef

customer/supplier reference

currencyCode

currency code, for example MYR

currencyRate

currency exchange rate

inclusiveTax

true when prices include tax

taxDate

YYYY-MM-DD tax date

branchCode

debtor/creditor branch code/name where account book uses branches

userDefinedFields

object of AutoCount user-defined fields

verifyAfterSave

optional boolean; false keeps save fast, true reloads the saved record and returns readBack checks/differences where the connector has a safe get path

contactAndAddress

attention

attention/contact person

contact

alias for attention/contact person

phone1

primary phone

phone

alias for phone1

phone2

secondary phone/mobile

fax1

fax

fax

alias for fax1

address1

address line 1

address2

address line 2

address3

address line 3

address4

address line 4

deliverAddress1

delivery address line 1

deliverAddress2

delivery address line 2

deliverAddress3

delivery address line 3

deliverAddress4

delivery address line 4

deliverContact

delivery contact

deliverPhone1

delivery phone

lines

itemCode

AutoCount item code

barCode

barcode shown/used by item line

description

line description

description2

line second description

furtherDescription

long/further line description

qty

quantity

uom

UOM

unitPrice

unit price

unitCost

unit cost where supported

discount

discount string/amount

taxType

tax type/code alias

taxCode

tax code alias

taxRate

tax rate

taxAmount

tax amount

amount

line amount

location

stock location

fromLocation

source location

toLocation

destination location

batchNo

batch number

serialNo

serial number

project

project code

projNo

project code alias

department

department code

deptNo

department code alias

classification

classification code

deliveryDate

YYYY-MM-DD delivery date

userDefinedFields

object of line user-defined fields

payments

paymentMethod

AutoCount Payment Method code

paymentBy

payment type such as Cash, Cheque, Bank Transfer, Credit Card

paymentAmount

payment amount

amount

payment amount alias where supported

chequeNo

cheque/reference number

bankCharge

bank charge amount

bankAccount

bank/cash GL account

paymentAccountNo

bank/cash GL account alias

bankChargeAccountNo

bank charge GL account

creditCardApprovalCode

card approval/reference code

userDefinedFields

object of payment user-defined fields

JavaScript Example

const apiBase = "https://api.autocount.cloud";
const apiKey = "YOUR_API_KEY";

async function queueCommand(command) {
  const response = await fetch(apiBase + "/v1/commands", {
    method: "POST",
    headers: {
      "Authorization": "Bearer " + apiKey,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(command)
  });
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

async function waitCommand(commandId) {
  for (let i = 0; i < 60; i++) {
    const response = await fetch(apiBase + "/v1/commands/" + encodeURIComponent(commandId), {
      headers: { "Authorization": "Bearer " + apiKey }
    });
    if (!response.ok) throw new Error(await response.text());
    const data = await response.json();
    if (data.command && (data.command.status === "done" || data.command.status === "failed")) return data;
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  throw new Error("Command timed out");
}

const command = {
  "commandId": "cancel-quotation-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "cancel-quotation",
  "payload": {
    "docNo": "QT-000001",
    "reason": "cancelled by API request"
  }
};

await queueCommand(command);
console.log(await waitCommand(command.commandId));

AI Rules

• Use cloud API only: https://api.autocount.cloud.
• Never call the Local Connector API directly from Mac Soft AI, AI tools, customer apps, or external integrations.
• Use Authorization: Bearer YOUR_API_KEY.
• Use a unique commandId for every real operation.
• commandId must be URL-safe: letters, numbers, dot, underscore, and hyphen only; max 160 characters.
• Set type to cancel-quotation.
• Poll GET /v1/commands/{commandId} until status is done or failed.
• For write commands, validate first when a validate-* command exists for the same document.

Void a quotation while keeping audit trail.

Uses AutoCount CancelDocument and returns operationUsed: CancelDocument. AutoCount may reject if the document is posted, linked, transferred, or blocked by permissions.

Endpoint

POST /v1/commands
GET /v1/commands/{commandId}
POST /v1/sales-module/quotation/void

Full JSON Payload

{
  "commandId": "void-quotation-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "void-quotation",
  "payload": {
    "docNo": "QT-000001",
    "reason": "voided by API request"
  }
}

Payload Fields

docNo

required document number

reason

optional void reason

Full Transaction Field Reference

header

debtorCode

customer/debtor code

debtorName

customer display name

salesAgent

sales agent code

salesLocation

sales location

multiPricing

price category/multi-pricing value

displayTerm

credit term

docNo

optional document number; omit to let AutoCount numbering generate it where supported

docDate

YYYY-MM-DD document date

dueDate

YYYY-MM-DD due date where supported

description

document narration/description

ref

reference

ourRef

our reference

yourRef

customer/supplier reference

currencyCode

currency code, for example MYR

currencyRate

currency exchange rate

inclusiveTax

true when prices include tax

taxDate

YYYY-MM-DD tax date

branchCode

debtor/creditor branch code/name where account book uses branches

userDefinedFields

object of AutoCount user-defined fields

verifyAfterSave

optional boolean; false keeps save fast, true reloads the saved record and returns readBack checks/differences where the connector has a safe get path

contactAndAddress

attention

attention/contact person

contact

alias for attention/contact person

phone1

primary phone

phone

alias for phone1

phone2

secondary phone/mobile

fax1

fax

fax

alias for fax1

address1

address line 1

address2

address line 2

address3

address line 3

address4

address line 4

deliverAddress1

delivery address line 1

deliverAddress2

delivery address line 2

deliverAddress3

delivery address line 3

deliverAddress4

delivery address line 4

deliverContact

delivery contact

deliverPhone1

delivery phone

lines

itemCode

AutoCount item code

barCode

barcode shown/used by item line

description

line description

description2

line second description

furtherDescription

long/further line description

qty

quantity

uom

UOM

unitPrice

unit price

unitCost

unit cost where supported

discount

discount string/amount

taxType

tax type/code alias

taxCode

tax code alias

taxRate

tax rate

taxAmount

tax amount

amount

line amount

location

stock location

fromLocation

source location

toLocation

destination location

batchNo

batch number

serialNo

serial number

project

project code

projNo

project code alias

department

department code

deptNo

department code alias

classification

classification code

deliveryDate

YYYY-MM-DD delivery date

userDefinedFields

object of line user-defined fields

payments

paymentMethod

AutoCount Payment Method code

paymentBy

payment type such as Cash, Cheque, Bank Transfer, Credit Card

paymentAmount

payment amount

amount

payment amount alias where supported

chequeNo

cheque/reference number

bankCharge

bank charge amount

bankAccount

bank/cash GL account

paymentAccountNo

bank/cash GL account alias

bankChargeAccountNo

bank charge GL account

creditCardApprovalCode

card approval/reference code

userDefinedFields

object of payment user-defined fields

JavaScript Example

const apiBase = "https://api.autocount.cloud";
const apiKey = "YOUR_API_KEY";

async function queueCommand(command) {
  const response = await fetch(apiBase + "/v1/commands", {
    method: "POST",
    headers: {
      "Authorization": "Bearer " + apiKey,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(command)
  });
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

async function waitCommand(commandId) {
  for (let i = 0; i < 60; i++) {
    const response = await fetch(apiBase + "/v1/commands/" + encodeURIComponent(commandId), {
      headers: { "Authorization": "Bearer " + apiKey }
    });
    if (!response.ok) throw new Error(await response.text());
    const data = await response.json();
    if (data.command && (data.command.status === "done" || data.command.status === "failed")) return data;
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  throw new Error("Command timed out");
}

const command = {
  "commandId": "void-quotation-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "void-quotation",
  "payload": {
    "docNo": "QT-000001",
    "reason": "voided by API request"
  }
};

await queueCommand(command);
console.log(await waitCommand(command.commandId));

AI Rules

• Use cloud API only: https://api.autocount.cloud.
• Never call the Local Connector API directly from Mac Soft AI, AI tools, customer apps, or external integrations.
• Use Authorization: Bearer YOUR_API_KEY.
• Use a unique commandId for every real operation.
• commandId must be URL-safe: letters, numbers, dot, underscore, and hyphen only; max 160 characters.
• Set type to void-quotation.
• Poll GET /v1/commands/{commandId} until status is done or failed.
• For write commands, validate first when a validate-* command exists for the same document.

Delete/void request for a quotation.

Safely maps to AutoCount cancellation/void behavior. AutoCount may reject if the document is posted, linked, transferred, or blocked by permissions.

Endpoint

POST /v1/commands
GET /v1/commands/{commandId}
POST /v1/sales-module/quotation/delete

Full JSON Payload

{
  "commandId": "delete-quotation-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "delete-quotation",
  "payload": {
    "docNo": "QT-000001",
    "reason": "deleted by API request"
  }
}

Payload Fields

docNo

required document number

reason

optional delete reason

Full Transaction Field Reference

header

debtorCode

customer/debtor code

debtorName

customer display name

salesAgent

sales agent code

salesLocation

sales location

multiPricing

price category/multi-pricing value

displayTerm

credit term

docNo

optional document number; omit to let AutoCount numbering generate it where supported

docDate

YYYY-MM-DD document date

dueDate

YYYY-MM-DD due date where supported

description

document narration/description

ref

reference

ourRef

our reference

yourRef

customer/supplier reference

currencyCode

currency code, for example MYR

currencyRate

currency exchange rate

inclusiveTax

true when prices include tax

taxDate

YYYY-MM-DD tax date

branchCode

debtor/creditor branch code/name where account book uses branches

userDefinedFields

object of AutoCount user-defined fields

verifyAfterSave

optional boolean; false keeps save fast, true reloads the saved record and returns readBack checks/differences where the connector has a safe get path

contactAndAddress

attention

attention/contact person

contact

alias for attention/contact person

phone1

primary phone

phone

alias for phone1

phone2

secondary phone/mobile

fax1

fax

fax

alias for fax1

address1

address line 1

address2

address line 2

address3

address line 3

address4

address line 4

deliverAddress1

delivery address line 1

deliverAddress2

delivery address line 2

deliverAddress3

delivery address line 3

deliverAddress4

delivery address line 4

deliverContact

delivery contact

deliverPhone1

delivery phone

lines

itemCode

AutoCount item code

barCode

barcode shown/used by item line

description

line description

description2

line second description

furtherDescription

long/further line description

qty

quantity

uom

UOM

unitPrice

unit price

unitCost

unit cost where supported

discount

discount string/amount

taxType

tax type/code alias

taxCode

tax code alias

taxRate

tax rate

taxAmount

tax amount

amount

line amount

location

stock location

fromLocation

source location

toLocation

destination location

batchNo

batch number

serialNo

serial number

project

project code

projNo

project code alias

department

department code

deptNo

department code alias

classification

classification code

deliveryDate

YYYY-MM-DD delivery date

userDefinedFields

object of line user-defined fields

payments

paymentMethod

AutoCount Payment Method code

paymentBy

payment type such as Cash, Cheque, Bank Transfer, Credit Card

paymentAmount

payment amount

amount

payment amount alias where supported

chequeNo

cheque/reference number

bankCharge

bank charge amount

bankAccount

bank/cash GL account

paymentAccountNo

bank/cash GL account alias

bankChargeAccountNo

bank charge GL account

creditCardApprovalCode

card approval/reference code

userDefinedFields

object of payment user-defined fields

JavaScript Example

const apiBase = "https://api.autocount.cloud";
const apiKey = "YOUR_API_KEY";

async function queueCommand(command) {
  const response = await fetch(apiBase + "/v1/commands", {
    method: "POST",
    headers: {
      "Authorization": "Bearer " + apiKey,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(command)
  });
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

async function waitCommand(commandId) {
  for (let i = 0; i < 60; i++) {
    const response = await fetch(apiBase + "/v1/commands/" + encodeURIComponent(commandId), {
      headers: { "Authorization": "Bearer " + apiKey }
    });
    if (!response.ok) throw new Error(await response.text());
    const data = await response.json();
    if (data.command && (data.command.status === "done" || data.command.status === "failed")) return data;
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  throw new Error("Command timed out");
}

const command = {
  "commandId": "delete-quotation-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "delete-quotation",
  "payload": {
    "docNo": "QT-000001",
    "reason": "deleted by API request"
  }
};

await queueCommand(command);
console.log(await waitCommand(command.commandId));

AI Rules

• Use cloud API only: https://api.autocount.cloud.
• Never call the Local Connector API directly from Mac Soft AI, AI tools, customer apps, or external integrations.
• Use Authorization: Bearer YOUR_API_KEY.
• Use a unique commandId for every real operation.
• commandId must be URL-safe: letters, numbers, dot, underscore, and hyphen only; max 160 characters.
• Set type to delete-quotation.
• Poll GET /v1/commands/{commandId} until status is done or failed.
• For write commands, validate first when a validate-* command exists for the same document.

List sales orders.

Endpoint

POST /v1/commands
GET /v1/commands/{commandId}
POST /v1/sales-module/sales-order/list

Full JSON Payload

{
  "commandId": "list-sales-orders-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "list-sales-orders",
  "payload": {}
}

Payload Fields

No payload fields required.

Full Transaction Field Reference

header

debtorCode

customer/debtor code

debtorName

customer display name

salesAgent

sales agent code

salesLocation

sales location

multiPricing

price category/multi-pricing value

displayTerm

credit term

docNo

optional document number; omit to let AutoCount numbering generate it where supported

docDate

YYYY-MM-DD document date

dueDate

YYYY-MM-DD due date where supported

description

document narration/description

ref

reference

ourRef

our reference

yourRef

customer/supplier reference

currencyCode

currency code, for example MYR

currencyRate

currency exchange rate

inclusiveTax

true when prices include tax

taxDate

YYYY-MM-DD tax date

branchCode

debtor/creditor branch code/name where account book uses branches

userDefinedFields

object of AutoCount user-defined fields

verifyAfterSave

optional boolean; false keeps save fast, true reloads the saved record and returns readBack checks/differences where the connector has a safe get path

contactAndAddress

attention

attention/contact person

contact

alias for attention/contact person

phone1

primary phone

phone

alias for phone1

phone2

secondary phone/mobile

fax1

fax

fax

alias for fax1

address1

address line 1

address2

address line 2

address3

address line 3

address4

address line 4

deliverAddress1

delivery address line 1

deliverAddress2

delivery address line 2

deliverAddress3

delivery address line 3

deliverAddress4

delivery address line 4

deliverContact

delivery contact

deliverPhone1

delivery phone

lines

itemCode

AutoCount item code

barCode

barcode shown/used by item line

description

line description

description2

line second description

furtherDescription

long/further line description

qty

quantity

uom

UOM

unitPrice

unit price

unitCost

unit cost where supported

discount

discount string/amount

taxType

tax type/code alias

taxCode

tax code alias

taxRate

tax rate

taxAmount

tax amount

amount

line amount

location

stock location

fromLocation

source location

toLocation

destination location

batchNo

batch number

serialNo

serial number

project

project code

projNo

project code alias

department

department code

deptNo

department code alias

classification

classification code

deliveryDate

YYYY-MM-DD delivery date

userDefinedFields

object of line user-defined fields

payments

paymentMethod

AutoCount Payment Method code

paymentBy

payment type such as Cash, Cheque, Bank Transfer, Credit Card

paymentAmount

payment amount

amount

payment amount alias where supported

chequeNo

cheque/reference number

bankCharge

bank charge amount

bankAccount

bank/cash GL account

paymentAccountNo

bank/cash GL account alias

bankChargeAccountNo

bank charge GL account

creditCardApprovalCode

card approval/reference code

userDefinedFields

object of payment user-defined fields

JavaScript Example

const apiBase = "https://api.autocount.cloud";
const apiKey = "YOUR_API_KEY";

async function queueCommand(command) {
  const response = await fetch(apiBase + "/v1/commands", {
    method: "POST",
    headers: {
      "Authorization": "Bearer " + apiKey,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(command)
  });
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

async function waitCommand(commandId) {
  for (let i = 0; i < 60; i++) {
    const response = await fetch(apiBase + "/v1/commands/" + encodeURIComponent(commandId), {
      headers: { "Authorization": "Bearer " + apiKey }
    });
    if (!response.ok) throw new Error(await response.text());
    const data = await response.json();
    if (data.command && (data.command.status === "done" || data.command.status === "failed")) return data;
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  throw new Error("Command timed out");
}

const command = {
  "commandId": "list-sales-orders-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "list-sales-orders",
  "payload": {}
};

await queueCommand(command);
console.log(await waitCommand(command.commandId));

AI Rules

• Use cloud API only: https://api.autocount.cloud.
• Never call the Local Connector API directly from Mac Soft AI, AI tools, customer apps, or external integrations.
• Use Authorization: Bearer YOUR_API_KEY.
• Use a unique commandId for every real operation.
• commandId must be URL-safe: letters, numbers, dot, underscore, and hyphen only; max 160 characters.
• Set type to list-sales-orders.
• Poll GET /v1/commands/{commandId} until status is done or failed.
• For write commands, validate first when a validate-* command exists for the same document.

Read sales order detail lines only.

Endpoint

POST /v1/commands
GET /v1/commands/{commandId}
POST /v1/sales-module/sales-order/list

Full JSON Payload

{
  "commandId": "read-sales-order-lines-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "read-sales-order-lines",
  "payload": {
    "debtorCode": "300-A001",
    "limit": 50
  }
}

Payload Fields

itemCode

optional

debtorCode

optional

docNo

optional

dateFrom

YYYY-MM-DD optional

dateTo

YYYY-MM-DD optional

limit

optional

Full Transaction Field Reference

header

debtorCode

customer/debtor code

debtorName

customer display name

salesAgent

sales agent code

salesLocation

sales location

multiPricing

price category/multi-pricing value

displayTerm

credit term

docNo

optional document number; omit to let AutoCount numbering generate it where supported

docDate

YYYY-MM-DD document date

dueDate

YYYY-MM-DD due date where supported

description

document narration/description

ref

reference

ourRef

our reference

yourRef

customer/supplier reference

currencyCode

currency code, for example MYR

currencyRate

currency exchange rate

inclusiveTax

true when prices include tax

taxDate

YYYY-MM-DD tax date

branchCode

debtor/creditor branch code/name where account book uses branches

userDefinedFields

object of AutoCount user-defined fields

verifyAfterSave

optional boolean; false keeps save fast, true reloads the saved record and returns readBack checks/differences where the connector has a safe get path

contactAndAddress

attention

attention/contact person

contact

alias for attention/contact person

phone1

primary phone

phone

alias for phone1

phone2

secondary phone/mobile

fax1

fax

fax

alias for fax1

address1

address line 1

address2

address line 2

address3

address line 3

address4

address line 4

deliverAddress1

delivery address line 1

deliverAddress2

delivery address line 2

deliverAddress3

delivery address line 3

deliverAddress4

delivery address line 4

deliverContact

delivery contact

deliverPhone1

delivery phone

lines

itemCode

AutoCount item code

barCode

barcode shown/used by item line

description

line description

description2

line second description

furtherDescription

long/further line description

qty

quantity

uom

UOM

unitPrice

unit price

unitCost

unit cost where supported

discount

discount string/amount

taxType

tax type/code alias

taxCode

tax code alias

taxRate

tax rate

taxAmount

tax amount

amount

line amount

location

stock location

fromLocation

source location

toLocation

destination location

batchNo

batch number

serialNo

serial number

project

project code

projNo

project code alias

department

department code

deptNo

department code alias

classification

classification code

deliveryDate

YYYY-MM-DD delivery date

userDefinedFields

object of line user-defined fields

payments

paymentMethod

AutoCount Payment Method code

paymentBy

payment type such as Cash, Cheque, Bank Transfer, Credit Card

paymentAmount

payment amount

amount

payment amount alias where supported

chequeNo

cheque/reference number

bankCharge

bank charge amount

bankAccount

bank/cash GL account

paymentAccountNo

bank/cash GL account alias

bankChargeAccountNo

bank charge GL account

creditCardApprovalCode

card approval/reference code

userDefinedFields

object of payment user-defined fields

JavaScript Example

const apiBase = "https://api.autocount.cloud";
const apiKey = "YOUR_API_KEY";

async function queueCommand(command) {
  const response = await fetch(apiBase + "/v1/commands", {
    method: "POST",
    headers: {
      "Authorization": "Bearer " + apiKey,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(command)
  });
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

async function waitCommand(commandId) {
  for (let i = 0; i < 60; i++) {
    const response = await fetch(apiBase + "/v1/commands/" + encodeURIComponent(commandId), {
      headers: { "Authorization": "Bearer " + apiKey }
    });
    if (!response.ok) throw new Error(await response.text());
    const data = await response.json();
    if (data.command && (data.command.status === "done" || data.command.status === "failed")) return data;
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  throw new Error("Command timed out");
}

const command = {
  "commandId": "read-sales-order-lines-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "read-sales-order-lines",
  "payload": {
    "debtorCode": "300-A001",
    "limit": 50
  }
};

await queueCommand(command);
console.log(await waitCommand(command.commandId));

AI Rules

• Use cloud API only: https://api.autocount.cloud.
• Never call the Local Connector API directly from Mac Soft AI, AI tools, customer apps, or external integrations.
• Use Authorization: Bearer YOUR_API_KEY.
• Use a unique commandId for every real operation.
• commandId must be URL-safe: letters, numbers, dot, underscore, and hyphen only; max 160 characters.
• Set type to read-sales-order-lines.
• Poll GET /v1/commands/{commandId} until status is done or failed.
• For write commands, validate first when a validate-* command exists for the same document.

Get one sales order by document number.

Endpoint

POST /v1/commands
GET /v1/commands/{commandId}
POST /v1/sales-module/sales-order/get

Full JSON Payload

{
  "commandId": "get-sales-order-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "get-sales-order",
  "payload": {
    "docNo": "SO-000001"
  }
}

Payload Fields

docNo

required sales order document number

Full Transaction Field Reference

header

debtorCode

customer/debtor code

debtorName

customer display name

salesAgent

sales agent code

salesLocation

sales location

multiPricing

price category/multi-pricing value

displayTerm

credit term

docNo

optional document number; omit to let AutoCount numbering generate it where supported

docDate

YYYY-MM-DD document date

dueDate

YYYY-MM-DD due date where supported

description

document narration/description

ref

reference

ourRef

our reference

yourRef

customer/supplier reference

currencyCode

currency code, for example MYR

currencyRate

currency exchange rate

inclusiveTax

true when prices include tax

taxDate

YYYY-MM-DD tax date

branchCode

debtor/creditor branch code/name where account book uses branches

userDefinedFields

object of AutoCount user-defined fields

verifyAfterSave

optional boolean; false keeps save fast, true reloads the saved record and returns readBack checks/differences where the connector has a safe get path

contactAndAddress

attention

attention/contact person

contact

alias for attention/contact person

phone1

primary phone

phone

alias for phone1

phone2

secondary phone/mobile

fax1

fax

fax

alias for fax1

address1

address line 1

address2

address line 2

address3

address line 3

address4

address line 4

deliverAddress1

delivery address line 1

deliverAddress2

delivery address line 2

deliverAddress3

delivery address line 3

deliverAddress4

delivery address line 4

deliverContact

delivery contact

deliverPhone1

delivery phone

lines

itemCode

AutoCount item code

barCode

barcode shown/used by item line

description

line description

description2

line second description

furtherDescription

long/further line description

qty

quantity

uom

UOM

unitPrice

unit price

unitCost

unit cost where supported

discount

discount string/amount

taxType

tax type/code alias

taxCode

tax code alias

taxRate

tax rate

taxAmount

tax amount

amount

line amount

location

stock location

fromLocation

source location

toLocation

destination location

batchNo

batch number

serialNo

serial number

project

project code

projNo

project code alias

department

department code

deptNo

department code alias

classification

classification code

deliveryDate

YYYY-MM-DD delivery date

userDefinedFields

object of line user-defined fields

payments

paymentMethod

AutoCount Payment Method code

paymentBy

payment type such as Cash, Cheque, Bank Transfer, Credit Card

paymentAmount

payment amount

amount

payment amount alias where supported

chequeNo

cheque/reference number

bankCharge

bank charge amount

bankAccount

bank/cash GL account

paymentAccountNo

bank/cash GL account alias

bankChargeAccountNo

bank charge GL account

creditCardApprovalCode

card approval/reference code

userDefinedFields

object of payment user-defined fields

JavaScript Example

const apiBase = "https://api.autocount.cloud";
const apiKey = "YOUR_API_KEY";

async function queueCommand(command) {
  const response = await fetch(apiBase + "/v1/commands", {
    method: "POST",
    headers: {
      "Authorization": "Bearer " + apiKey,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(command)
  });
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

async function waitCommand(commandId) {
  for (let i = 0; i < 60; i++) {
    const response = await fetch(apiBase + "/v1/commands/" + encodeURIComponent(commandId), {
      headers: { "Authorization": "Bearer " + apiKey }
    });
    if (!response.ok) throw new Error(await response.text());
    const data = await response.json();
    if (data.command && (data.command.status === "done" || data.command.status === "failed")) return data;
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  throw new Error("Command timed out");
}

const command = {
  "commandId": "get-sales-order-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "get-sales-order",
  "payload": {
    "docNo": "SO-000001"
  }
};

await queueCommand(command);
console.log(await waitCommand(command.commandId));

AI Rules

• Use cloud API only: https://api.autocount.cloud.
• Never call the Local Connector API directly from Mac Soft AI, AI tools, customer apps, or external integrations.
• Use Authorization: Bearer YOUR_API_KEY.
• Use a unique commandId for every real operation.
• commandId must be URL-safe: letters, numbers, dot, underscore, and hyphen only; max 160 characters.
• Set type to get-sales-order.
• Poll GET /v1/commands/{commandId} until status is done or failed.
• For write commands, validate first when a validate-* command exists for the same document.

Validate a sales order without saving.

Validation only; does not save. Full payload example is for human/Postman reference. For stock-item lines, send itemCode/uom/location and call read-locations for the exact active location code. If a sales account book requires a line posting account, the connector uses AutoCount's default sales account when lines[].accountNo is omitted; send accountNo / accNo / glAccount / postingAccountNo on a line to override it. For account/service lines, omit itemCode and send accountNo / accNo / glAccount / postingAccountNo; many account books still require lines[].location even without itemCode. salesLocation is copied to lines that omit location; lines[].location wins. The connector verifies AutoCount accepted the requested detail location before save instead of silently using a default.

Endpoint

POST /v1/commands
GET /v1/commands/{commandId}
POST /v1/sales-module/sales-order/validate

Full JSON Payload

{
  "commandId": "validate-sales-order-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "validate-sales-order",
  "payload": {
    "debtorCode": "300-A001",
    "items": [
      {
        "itemCode": "ITEM001",
        "qty": 1,
        "unitPrice": 100
      }
    ],
    "docDate": "2026-06-24",
    "displayTerm": "30 DAYS",
    "branchCode": "MAIN",
    "salesLocation": "HQ",
    "multiPricing": "Price 1",
    "salesAgent": "SA01",
    "attention": "Purchasing Department",
    "contact": "Purchasing Department",
    "deliverContact": "Store Receiver",
    "deliverPhone1": "012-3456789",
    "phone": "03-11111111",
    "address1": "No. 1 Jalan API",
    "address2": "Taman Integration",
    "address3": "Kuala Lumpur",
    "address4": "Malaysia",
    "description": "Sales document created through API",
    "ref": "WEB-ORDER-1001",
    "currencyCode": "MYR",
    "inclusiveTax": false,
    "taxEntityID": 1,
    "project": "PRJAPI",
    "department": "HQ",
    "lines": [
      {
        "itemCode": "ITEM001",
        "description": "API item line 1",
        "description2": "Line second description",
        "furtherDescription": "Optional longer line note",
        "barCode": "9550000000011",
        "qty": 2,
        "uom": "UNIT",
        "unitPrice": 100,
        "discount": "5%",
        "taxType": "S-0",
        "taxRate": 0,
        "taxAmount": 0,
        "amount": 190,
        "accountNo": "500-0000",
        "location": "HQ",
        "batchNo": "BATCH-001",
        "serialNo": "SN-0001",
        "project": "PRJAPI",
        "projNo": "PRJAPI",
        "department": "HQ",
        "deptNo": "HQ",
        "classification": "022",
        "deliveryDate": "2026-06-30",
        "userDefinedFields": {
          "APITEST": "Blue"
        }
      },
      {
        "accountNo": "500-0000",
        "description": "Service/account line without itemCode",
        "qty": 1,
        "unitPrice": 50,
        "taxType": "S-0",
        "location": "HQ",
        "project": "PRJAPI",
        "department": "HQ"
      }
    ],
    "payments": [
      {
        "paymentMethod": "CASH",
        "paymentBy": "Cash",
        "paymentAmount": 130,
        "chequeNo": "",
        "bankCharge": 0,
        "paymentAccountNo": "110-0010",
        "bankChargeAccountNo": "810-0000",
        "creditCardApprovalCode": ""
      },
      {
        "paymentMethod": "CARD",
        "paymentBy": "Credit Card",
        "paymentAmount": 60,
        "chequeNo": "",
        "bankCharge": 0,
        "paymentAccountNo": "110-0010",
        "bankChargeAccountNo": "810-0000",
        "creditCardApprovalCode": "APPROVED-001"
      }
    ],
    "userDefinedFields": {
      "APITEST": "API"
    }
  }
}

Payload Fields

debtorCode

required AutoCount debtor/customer code

items

optional alias for lines

debtorName

optional customer display name; AutoCount debtor name is used when omitted

docNo

optional AutoCount document number; omit to let AutoCount numbering generate it

docDate

required or optional YYYY-MM-DD document date depending on account-book numbering rules

displayTerm

optional credit term such as C.O.D. or 30 DAYS

dueDate

optional YYYY-MM-DD due date

branchCode

optional debtor branch code/name where the customer uses branches

salesLocation

optional exact active AutoCount sales/stock location code such as HQ-RETAIL; call read-locations first. It fills only lines that omit lines[].location; an explicit line location always wins

multiPricing

optional price category/multi-pricing value such as Price 1

salesAgent

optional Sales Agent Maintenance code

attention

optional attention/contact person

contact

optional contact person alias for attention

deliverContact

optional delivery contact person

deliverPhone1

optional delivery phone number

phone1

optional phone number printed on document

phone

optional phone alias for phone1

phone2

optional secondary phone/mobile number

fax1

optional fax number printed on document

fax

optional fax alias for fax1

address1

optional billing address line 1

address2

optional billing address line 2

address3

optional billing address line 3

address4

optional billing address line 4

deliverAddress1

optional delivery address line 1

deliverAddress2

optional delivery address line 2

deliverAddress3

optional delivery address line 3

deliverAddress4

optional delivery address line 4

description

optional document description/narration

ref

optional reference

ourRef

optional our reference

yourRef

optional customer reference

currencyCode

optional currency code such as MYR

currencyRate

optional exchange rate

inclusiveTax

optional boolean; true when line prices include tax

taxDate

optional YYYY-MM-DD tax date

taxEntityID

optional numeric Tax Entity Maintenance ID for the document header/e-Invoice party

project

optional project code

department

optional department code

lines

required array of stock item rows or account/service rows; items is also accepted as a compatibility alias

accountNo

optional top-level GL posting account fallback; line-level accountNo / accNo / glAccount / postingAccountNo wins, otherwise the connector uses AutoCount's default sales account where needed

payments

optional array for cash sale style documents; send multiple payment rows for AutoCount Multi Payment

userDefinedFields

optional object of AutoCount user-defined fields; use the AutoCount UDF field name without the UDF_ column prefix, for example { APITEST: value }

Full Transaction Field Reference

header

debtorCode

customer/debtor code

debtorName

customer display name

salesAgent

sales agent code

salesLocation

sales location

multiPricing

price category/multi-pricing value

displayTerm

credit term

docNo

optional document number; omit to let AutoCount numbering generate it where supported

docDate

YYYY-MM-DD document date

dueDate

YYYY-MM-DD due date where supported

description

document narration/description

ref

reference

ourRef

our reference

yourRef

customer/supplier reference

currencyCode

currency code, for example MYR

currencyRate

currency exchange rate

inclusiveTax

true when prices include tax

taxDate

YYYY-MM-DD tax date

branchCode

debtor/creditor branch code/name where account book uses branches

userDefinedFields

object of AutoCount user-defined fields

verifyAfterSave

optional boolean; false keeps save fast, true reloads the saved record and returns readBack checks/differences where the connector has a safe get path

contactAndAddress

attention

attention/contact person

contact

alias for attention/contact person

phone1

primary phone

phone

alias for phone1

phone2

secondary phone/mobile

fax1

fax

fax

alias for fax1

address1

address line 1

address2

address line 2

address3

address line 3

address4

address line 4

deliverAddress1

delivery address line 1

deliverAddress2

delivery address line 2

deliverAddress3

delivery address line 3

deliverAddress4

delivery address line 4

deliverContact

delivery contact

deliverPhone1

delivery phone

lines

itemCode

AutoCount item code

barCode

barcode shown/used by item line

description

line description

description2

line second description

furtherDescription

long/further line description

qty

quantity

uom

UOM

unitPrice

unit price

unitCost

unit cost where supported

discount

discount string/amount

taxType

tax type/code alias

taxCode

tax code alias

taxRate

tax rate

taxAmount

tax amount

amount

line amount

location

stock location

fromLocation

source location

toLocation

destination location

batchNo

batch number

serialNo

serial number

project

project code

projNo

project code alias

department

department code

deptNo

department code alias

classification

classification code

deliveryDate

YYYY-MM-DD delivery date

userDefinedFields

object of line user-defined fields

payments

paymentMethod

AutoCount Payment Method code

paymentBy

payment type such as Cash, Cheque, Bank Transfer, Credit Card

paymentAmount

payment amount

amount

payment amount alias where supported

chequeNo

cheque/reference number

bankCharge

bank charge amount

bankAccount

bank/cash GL account

paymentAccountNo

bank/cash GL account alias

bankChargeAccountNo

bank charge GL account

creditCardApprovalCode

card approval/reference code

userDefinedFields

object of payment user-defined fields

JavaScript Example

const apiBase = "https://api.autocount.cloud";
const apiKey = "YOUR_API_KEY";

async function queueCommand(command) {
  const response = await fetch(apiBase + "/v1/commands", {
    method: "POST",
    headers: {
      "Authorization": "Bearer " + apiKey,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(command)
  });
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

async function waitCommand(commandId) {
  for (let i = 0; i < 60; i++) {
    const response = await fetch(apiBase + "/v1/commands/" + encodeURIComponent(commandId), {
      headers: { "Authorization": "Bearer " + apiKey }
    });
    if (!response.ok) throw new Error(await response.text());
    const data = await response.json();
    if (data.command && (data.command.status === "done" || data.command.status === "failed")) return data;
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  throw new Error("Command timed out");
}

const command = {
  "commandId": "validate-sales-order-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "validate-sales-order",
  "payload": {
    "debtorCode": "300-A001",
    "items": [
      {
        "itemCode": "ITEM001",
        "qty": 1,
        "unitPrice": 100
      }
    ],
    "docDate": "2026-06-24",
    "displayTerm": "30 DAYS",
    "branchCode": "MAIN",
    "salesLocation": "HQ",
    "multiPricing": "Price 1",
    "salesAgent": "SA01",
    "attention": "Purchasing Department",
    "contact": "Purchasing Department",
    "deliverContact": "Store Receiver",
    "deliverPhone1": "012-3456789",
    "phone": "03-11111111",
    "address1": "No. 1 Jalan API",
    "address2": "Taman Integration",
    "address3": "Kuala Lumpur",
    "address4": "Malaysia",
    "description": "Sales document created through API",
    "ref": "WEB-ORDER-1001",
    "currencyCode": "MYR",
    "inclusiveTax": false,
    "taxEntityID": 1,
    "project": "PRJAPI",
    "department": "HQ",
    "lines": [
      {
        "itemCode": "ITEM001",
        "description": "API item line 1",
        "description2": "Line second description",
        "furtherDescription": "Optional longer line note",
        "barCode": "9550000000011",
        "qty": 2,
        "uom": "UNIT",
        "unitPrice": 100,
        "discount": "5%",
        "taxType": "S-0",
        "taxRate": 0,
        "taxAmount": 0,
        "amount": 190,
        "accountNo": "500-0000",
        "location": "HQ",
        "batchNo": "BATCH-001",
        "serialNo": "SN-0001",
        "project": "PRJAPI",
        "projNo": "PRJAPI",
        "department": "HQ",
        "deptNo": "HQ",
        "classification": "022",
        "deliveryDate": "2026-06-30",
        "userDefinedFields": {
          "APITEST": "Blue"
        }
      },
      {
        "accountNo": "500-0000",
        "description": "Service/account line without itemCode",
        "qty": 1,
        "unitPrice": 50,
        "taxType": "S-0",
        "location": "HQ",
        "project": "PRJAPI",
        "department": "HQ"
      }
    ],
    "payments": [
      {
        "paymentMethod": "CASH",
        "paymentBy": "Cash",
        "paymentAmount": 130,
        "chequeNo": "",
        "bankCharge": 0,
        "paymentAccountNo": "110-0010",
        "bankChargeAccountNo": "810-0000",
        "creditCardApprovalCode": ""
      },
      {
        "paymentMethod": "CARD",
        "paymentBy": "Credit Card",
        "paymentAmount": 60,
        "chequeNo": "",
        "bankCharge": 0,
        "paymentAccountNo": "110-0010",
        "bankChargeAccountNo": "810-0000",
        "creditCardApprovalCode": "APPROVED-001"
      }
    ],
    "userDefinedFields": {
      "APITEST": "API"
    }
  }
};

await queueCommand(command);
console.log(await waitCommand(command.commandId));

AI Rules

• Use cloud API only: https://api.autocount.cloud.
• Never call the Local Connector API directly from Mac Soft AI, AI tools, customer apps, or external integrations.
• Use Authorization: Bearer YOUR_API_KEY.
• Use a unique commandId for every real operation.
• commandId must be URL-safe: letters, numbers, dot, underscore, and hyphen only; max 160 characters.
• Set type to validate-sales-order.
• Poll GET /v1/commands/{commandId} until status is done or failed.
• For write commands, validate first when a validate-* command exists for the same document.

Create a sales order.

Creates sales order through AutoCount SDK. If a stock line omits accountNo, connector uses AutoCount's default sales account where needed. Full payload example is for human/Postman reference. For stock-item lines, send itemCode/uom/location and call read-locations for the exact active location code. If a sales account book requires a line posting account, the connector uses AutoCount's default sales account when lines[].accountNo is omitted; send accountNo / accNo / glAccount / postingAccountNo on a line to override it. For account/service lines, omit itemCode and send accountNo / accNo / glAccount / postingAccountNo; many account books still require lines[].location even without itemCode. salesLocation is copied to lines that omit location; lines[].location wins. The connector verifies AutoCount accepted the requested detail location before save instead of silently using a default.

Endpoint

POST /v1/commands
GET /v1/commands/{commandId}
POST /v1/sales-module/sales-order/create

Full JSON Payload

{
  "commandId": "create-sales-order-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "create-sales-order",
  "payload": {
    "debtorCode": "300-A001",
    "docDate": "2026-06-24",
    "items": [
      {
        "itemCode": "ITEM001",
        "qty": 1,
        "unitPrice": 100,
        "accountNo": "500-0000"
      }
    ],
    "displayTerm": "30 DAYS",
    "branchCode": "MAIN",
    "salesLocation": "HQ",
    "multiPricing": "Price 1",
    "salesAgent": "SA01",
    "attention": "Purchasing Department",
    "contact": "Purchasing Department",
    "deliverContact": "Store Receiver",
    "deliverPhone1": "012-3456789",
    "phone": "03-11111111",
    "address1": "No. 1 Jalan API",
    "address2": "Taman Integration",
    "address3": "Kuala Lumpur",
    "address4": "Malaysia",
    "description": "Sales document created through API",
    "ref": "WEB-ORDER-1001",
    "currencyCode": "MYR",
    "inclusiveTax": false,
    "taxEntityID": 1,
    "project": "PRJAPI",
    "department": "HQ",
    "lines": [
      {
        "itemCode": "ITEM001",
        "description": "API item line 1",
        "description2": "Line second description",
        "furtherDescription": "Optional longer line note",
        "barCode": "9550000000011",
        "qty": 2,
        "uom": "UNIT",
        "unitPrice": 100,
        "discount": "5%",
        "taxType": "S-0",
        "taxRate": 0,
        "taxAmount": 0,
        "amount": 190,
        "accountNo": "500-0000",
        "location": "HQ",
        "batchNo": "BATCH-001",
        "serialNo": "SN-0001",
        "project": "PRJAPI",
        "projNo": "PRJAPI",
        "department": "HQ",
        "deptNo": "HQ",
        "classification": "022",
        "deliveryDate": "2026-06-30",
        "userDefinedFields": {
          "APITEST": "Blue"
        }
      },
      {
        "accountNo": "500-0000",
        "description": "Service/account line without itemCode",
        "qty": 1,
        "unitPrice": 50,
        "taxType": "S-0",
        "location": "HQ",
        "project": "PRJAPI",
        "department": "HQ"
      }
    ],
    "payments": [
      {
        "paymentMethod": "CASH",
        "paymentBy": "Cash",
        "paymentAmount": 130,
        "chequeNo": "",
        "bankCharge": 0,
        "paymentAccountNo": "110-0010",
        "bankChargeAccountNo": "810-0000",
        "creditCardApprovalCode": ""
      },
      {
        "paymentMethod": "CARD",
        "paymentBy": "Credit Card",
        "paymentAmount": 60,
        "chequeNo": "",
        "bankCharge": 0,
        "paymentAccountNo": "110-0010",
        "bankChargeAccountNo": "810-0000",
        "creditCardApprovalCode": "APPROVED-001"
      }
    ],
    "userDefinedFields": {
      "APITEST": "API"
    }
  }
}

Payload Fields

debtorCode

required AutoCount debtor/customer code

docDate

required or optional YYYY-MM-DD document date depending on account-book numbering rules

items

optional alias for lines

debtorName

optional customer display name; AutoCount debtor name is used when omitted

docNo

optional AutoCount document number; omit to let AutoCount numbering generate it

displayTerm

optional credit term such as C.O.D. or 30 DAYS

dueDate

optional YYYY-MM-DD due date

branchCode

optional debtor branch code/name where the customer uses branches

salesLocation

optional exact active AutoCount sales/stock location code such as HQ-RETAIL; call read-locations first. It fills only lines that omit lines[].location; an explicit line location always wins

multiPricing

optional price category/multi-pricing value such as Price 1

salesAgent

optional Sales Agent Maintenance code

attention

optional attention/contact person

contact

optional contact person alias for attention

deliverContact

optional delivery contact person

deliverPhone1

optional delivery phone number

phone1

optional phone number printed on document

phone

optional phone alias for phone1

phone2

optional secondary phone/mobile number

fax1

optional fax number printed on document

fax

optional fax alias for fax1

address1

optional billing address line 1

address2

optional billing address line 2

address3

optional billing address line 3

address4

optional billing address line 4

deliverAddress1

optional delivery address line 1

deliverAddress2

optional delivery address line 2

deliverAddress3

optional delivery address line 3

deliverAddress4

optional delivery address line 4

description

optional document description/narration

ref

optional reference

ourRef

optional our reference

yourRef

optional customer reference

currencyCode

optional currency code such as MYR

currencyRate

optional exchange rate

inclusiveTax

optional boolean; true when line prices include tax

taxDate

optional YYYY-MM-DD tax date

taxEntityID

optional numeric Tax Entity Maintenance ID for the document header/e-Invoice party

project

optional project code

department

optional department code

lines

required array of stock item rows or account/service rows; items is also accepted as a compatibility alias

accountNo

optional top-level GL posting account fallback; line-level accountNo / accNo / glAccount / postingAccountNo wins, otherwise the connector uses AutoCount's default sales account where needed

payments

optional array for cash sale style documents; send multiple payment rows for AutoCount Multi Payment

userDefinedFields

optional object of AutoCount user-defined fields; use the AutoCount UDF field name without the UDF_ column prefix, for example { APITEST: value }

Full Transaction Field Reference

header

debtorCode

customer/debtor code

debtorName

customer display name

salesAgent

sales agent code

salesLocation

sales location

multiPricing

price category/multi-pricing value

displayTerm

credit term

docNo

optional document number; omit to let AutoCount numbering generate it where supported

docDate

YYYY-MM-DD document date

dueDate

YYYY-MM-DD due date where supported

description

document narration/description

ref

reference

ourRef

our reference

yourRef

customer/supplier reference

currencyCode

currency code, for example MYR

currencyRate

currency exchange rate

inclusiveTax

true when prices include tax

taxDate

YYYY-MM-DD tax date

branchCode

debtor/creditor branch code/name where account book uses branches

userDefinedFields

object of AutoCount user-defined fields

verifyAfterSave

optional boolean; false keeps save fast, true reloads the saved record and returns readBack checks/differences where the connector has a safe get path

contactAndAddress

attention

attention/contact person

contact

alias for attention/contact person

phone1

primary phone

phone

alias for phone1

phone2

secondary phone/mobile

fax1

fax

fax

alias for fax1

address1

address line 1

address2

address line 2

address3

address line 3

address4

address line 4

deliverAddress1

delivery address line 1

deliverAddress2

delivery address line 2

deliverAddress3

delivery address line 3

deliverAddress4

delivery address line 4

deliverContact

delivery contact

deliverPhone1

delivery phone

lines

itemCode

AutoCount item code

barCode

barcode shown/used by item line

description

line description

description2

line second description

furtherDescription

long/further line description

qty

quantity

uom

UOM

unitPrice

unit price

unitCost

unit cost where supported

discount

discount string/amount

taxType

tax type/code alias

taxCode

tax code alias

taxRate

tax rate

taxAmount

tax amount

amount

line amount

location

stock location

fromLocation

source location

toLocation

destination location

batchNo

batch number

serialNo

serial number

project

project code

projNo

project code alias

department

department code

deptNo

department code alias

classification

classification code

deliveryDate

YYYY-MM-DD delivery date

userDefinedFields

object of line user-defined fields

payments

paymentMethod

AutoCount Payment Method code

paymentBy

payment type such as Cash, Cheque, Bank Transfer, Credit Card

paymentAmount

payment amount

amount

payment amount alias where supported

chequeNo

cheque/reference number

bankCharge

bank charge amount

bankAccount

bank/cash GL account

paymentAccountNo

bank/cash GL account alias

bankChargeAccountNo

bank charge GL account

creditCardApprovalCode

card approval/reference code

userDefinedFields

object of payment user-defined fields

JavaScript Example

const apiBase = "https://api.autocount.cloud";
const apiKey = "YOUR_API_KEY";

async function queueCommand(command) {
  const response = await fetch(apiBase + "/v1/commands", {
    method: "POST",
    headers: {
      "Authorization": "Bearer " + apiKey,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(command)
  });
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

async function waitCommand(commandId) {
  for (let i = 0; i < 60; i++) {
    const response = await fetch(apiBase + "/v1/commands/" + encodeURIComponent(commandId), {
      headers: { "Authorization": "Bearer " + apiKey }
    });
    if (!response.ok) throw new Error(await response.text());
    const data = await response.json();
    if (data.command && (data.command.status === "done" || data.command.status === "failed")) return data;
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  throw new Error("Command timed out");
}

const command = {
  "commandId": "create-sales-order-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "create-sales-order",
  "payload": {
    "debtorCode": "300-A001",
    "docDate": "2026-06-24",
    "items": [
      {
        "itemCode": "ITEM001",
        "qty": 1,
        "unitPrice": 100,
        "accountNo": "500-0000"
      }
    ],
    "displayTerm": "30 DAYS",
    "branchCode": "MAIN",
    "salesLocation": "HQ",
    "multiPricing": "Price 1",
    "salesAgent": "SA01",
    "attention": "Purchasing Department",
    "contact": "Purchasing Department",
    "deliverContact": "Store Receiver",
    "deliverPhone1": "012-3456789",
    "phone": "03-11111111",
    "address1": "No. 1 Jalan API",
    "address2": "Taman Integration",
    "address3": "Kuala Lumpur",
    "address4": "Malaysia",
    "description": "Sales document created through API",
    "ref": "WEB-ORDER-1001",
    "currencyCode": "MYR",
    "inclusiveTax": false,
    "taxEntityID": 1,
    "project": "PRJAPI",
    "department": "HQ",
    "lines": [
      {
        "itemCode": "ITEM001",
        "description": "API item line 1",
        "description2": "Line second description",
        "furtherDescription": "Optional longer line note",
        "barCode": "9550000000011",
        "qty": 2,
        "uom": "UNIT",
        "unitPrice": 100,
        "discount": "5%",
        "taxType": "S-0",
        "taxRate": 0,
        "taxAmount": 0,
        "amount": 190,
        "accountNo": "500-0000",
        "location": "HQ",
        "batchNo": "BATCH-001",
        "serialNo": "SN-0001",
        "project": "PRJAPI",
        "projNo": "PRJAPI",
        "department": "HQ",
        "deptNo": "HQ",
        "classification": "022",
        "deliveryDate": "2026-06-30",
        "userDefinedFields": {
          "APITEST": "Blue"
        }
      },
      {
        "accountNo": "500-0000",
        "description": "Service/account line without itemCode",
        "qty": 1,
        "unitPrice": 50,
        "taxType": "S-0",
        "location": "HQ",
        "project": "PRJAPI",
        "department": "HQ"
      }
    ],
    "payments": [
      {
        "paymentMethod": "CASH",
        "paymentBy": "Cash",
        "paymentAmount": 130,
        "chequeNo": "",
        "bankCharge": 0,
        "paymentAccountNo": "110-0010",
        "bankChargeAccountNo": "810-0000",
        "creditCardApprovalCode": ""
      },
      {
        "paymentMethod": "CARD",
        "paymentBy": "Credit Card",
        "paymentAmount": 60,
        "chequeNo": "",
        "bankCharge": 0,
        "paymentAccountNo": "110-0010",
        "bankChargeAccountNo": "810-0000",
        "creditCardApprovalCode": "APPROVED-001"
      }
    ],
    "userDefinedFields": {
      "APITEST": "API"
    }
  }
};

await queueCommand(command);
console.log(await waitCommand(command.commandId));

AI Rules

• Use cloud API only: https://api.autocount.cloud.
• Never call the Local Connector API directly from Mac Soft AI, AI tools, customer apps, or external integrations.
• Use Authorization: Bearer YOUR_API_KEY.
• Use a unique commandId for every real operation.
• commandId must be URL-safe: letters, numbers, dot, underscore, and hyphen only; max 160 characters.
• Set type to create-sales-order.
• Poll GET /v1/commands/{commandId} until status is done or failed.
• For write commands, validate first when a validate-* command exists for the same document.

Create stock-item-only Sales Order for MacSoft AI Agent.

Separate opt-in command. Uses AutoCount SalesOrder SDK Save path but does not resolve, apply, validate, or fall back to any default Sales Account / AccNo. Save failures return exceptionText. Create stock-item-only Sales Order for MacSoft AI Agent. This is a separate opt-in command and does not modify create-sales-order. Every line must include itemCode. Do not send accountNo, accNo, glAccount, or postingAccountNo; the connector will reject those fields and will not resolve or apply a default Sales Account / AccNo. If AutoCount Save fails, result.exceptionText includes the full SDK exception text for diagnosis.

Endpoint

POST /v1/commands
GET /v1/commands/{commandId}
POST /v1/sales-module/sales-order/create

Full JSON Payload

{
  "commandId": "create-stock-sales-order-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "create-stock-sales-order",
  "payload": {
    "debtorCode": "300-A001",
    "docDate": "2026-08-30",
    "salesLocation": "HQ",
    "lines": [
      {
        "itemCode": "ITEM001",
        "qty": 1,
        "uom": "UNIT",
        "location": "HQ",
        "unitPrice": 14,
        "description": "Stock item line"
      }
    ],
    "salesAgent": "SA01",
    "multiPricing": "P2",
    "inclusiveTax": false
  }
}

Payload Fields

debtorCode

required AutoCount debtor/customer code

docDate

required or optional YYYY-MM-DD document date depending on numbering rules

lines

required array of stock-item rows only. Every line must include itemCode. accountNo, accNo, glAccount, and postingAccountNo are rejected.

docNo

optional AutoCount Sales Order number; omit to let AutoCount numbering generate it

displayTerm

optional credit term

currencyCode

optional currency code such as MYR

salesLocation

optional exact active stock location; copied only to lines that omit location

salesAgent

optional Sales Agent Maintenance code

multiPricing

optional AutoCount multi-pricing code/category

inclusiveTax

optional boolean; true when line prices include tax

items

optional alias for lines

Full Transaction Field Reference

header

debtorCode

customer/debtor code

debtorName

customer display name

salesAgent

sales agent code

salesLocation

sales location

multiPricing

price category/multi-pricing value

displayTerm

credit term

docNo

optional document number; omit to let AutoCount numbering generate it where supported

docDate

YYYY-MM-DD document date

dueDate

YYYY-MM-DD due date where supported

description

document narration/description

ref

reference

ourRef

our reference

yourRef

customer/supplier reference

currencyCode

currency code, for example MYR

currencyRate

currency exchange rate

inclusiveTax

true when prices include tax

taxDate

YYYY-MM-DD tax date

branchCode

debtor/creditor branch code/name where account book uses branches

userDefinedFields

object of AutoCount user-defined fields

verifyAfterSave

optional boolean; false keeps save fast, true reloads the saved record and returns readBack checks/differences where the connector has a safe get path

contactAndAddress

attention

attention/contact person

contact

alias for attention/contact person

phone1

primary phone

phone

alias for phone1

phone2

secondary phone/mobile

fax1

fax

fax

alias for fax1

address1

address line 1

address2

address line 2

address3

address line 3

address4

address line 4

deliverAddress1

delivery address line 1

deliverAddress2

delivery address line 2

deliverAddress3

delivery address line 3

deliverAddress4

delivery address line 4

deliverContact

delivery contact

deliverPhone1

delivery phone

lines

itemCode

AutoCount item code

barCode

barcode shown/used by item line

description

line description

description2

line second description

furtherDescription

long/further line description

qty

quantity

uom

UOM

unitPrice

unit price

unitCost

unit cost where supported

discount

discount string/amount

taxType

tax type/code alias

taxCode

tax code alias

taxRate

tax rate

taxAmount

tax amount

amount

line amount

location

stock location

fromLocation

source location

toLocation

destination location

batchNo

batch number

serialNo

serial number

project

project code

projNo

project code alias

department

department code

deptNo

department code alias

classification

classification code

deliveryDate

YYYY-MM-DD delivery date

userDefinedFields

object of line user-defined fields

payments

paymentMethod

AutoCount Payment Method code

paymentBy

payment type such as Cash, Cheque, Bank Transfer, Credit Card

paymentAmount

payment amount

amount

payment amount alias where supported

chequeNo

cheque/reference number

bankCharge

bank charge amount

bankAccount

bank/cash GL account

paymentAccountNo

bank/cash GL account alias

bankChargeAccountNo

bank charge GL account

creditCardApprovalCode

card approval/reference code

userDefinedFields

object of payment user-defined fields

JavaScript Example

const apiBase = "https://api.autocount.cloud";
const apiKey = "YOUR_API_KEY";

async function queueCommand(command) {
  const response = await fetch(apiBase + "/v1/commands", {
    method: "POST",
    headers: {
      "Authorization": "Bearer " + apiKey,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(command)
  });
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

async function waitCommand(commandId) {
  for (let i = 0; i < 60; i++) {
    const response = await fetch(apiBase + "/v1/commands/" + encodeURIComponent(commandId), {
      headers: { "Authorization": "Bearer " + apiKey }
    });
    if (!response.ok) throw new Error(await response.text());
    const data = await response.json();
    if (data.command && (data.command.status === "done" || data.command.status === "failed")) return data;
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  throw new Error("Command timed out");
}

const command = {
  "commandId": "create-stock-sales-order-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "create-stock-sales-order",
  "payload": {
    "debtorCode": "300-A001",
    "docDate": "2026-08-30",
    "salesLocation": "HQ",
    "lines": [
      {
        "itemCode": "ITEM001",
        "qty": 1,
        "uom": "UNIT",
        "location": "HQ",
        "unitPrice": 14,
        "description": "Stock item line"
      }
    ],
    "salesAgent": "SA01",
    "multiPricing": "P2",
    "inclusiveTax": false
  }
};

await queueCommand(command);
console.log(await waitCommand(command.commandId));

AI Rules

• Use cloud API only: https://api.autocount.cloud.
• Never call the Local Connector API directly from Mac Soft AI, AI tools, customer apps, or external integrations.
• Use Authorization: Bearer YOUR_API_KEY.
• Use a unique commandId for every real operation.
• commandId must be URL-safe: letters, numbers, dot, underscore, and hyphen only; max 160 characters.
• Set type to create-stock-sales-order.
• Poll GET /v1/commands/{commandId} until status is done or failed.
• For write commands, validate first when a validate-* command exists for the same document.

Update sales order header/contact fields and supported detail rows.

Install local-mvp-2026.09.30.01 or later on the selected connector before using this update contract; cloud publication does not install or upgrade customer connectors. Check installed capabilities first; never trial writes against an older or unconfirmed build. Strict Sales update: editable SDK scalar fields via friendly fields, Master or nativeFields.Master; details via lines with explicit detailMode and existing dtlKey for update/delete. Omitted fields stay unchanged; explicit null/empty clears only optional fields. Unknown, unavailable, calculated, system and lifecycle fields are rejected before Save. Existing UDFs must be present in the SDK schema; no invented columns. validateOnly:true runs native preflight without Save and is not persistence certification. Save success requires a fresh SDK reload with writeVerification.matched=true, identity and linkage verification. saved:true with ok:false means a persisted mismatch or failed verification, not rollback; inspect the existing document and never recreate it automatically. Existing payment, transfer, package and eInvoice protections remain. Runtime get-document fields/fieldCapabilities expose SDK field discovery and fields.readErrors; availability varies by document and account book. Native acceptance covers reference/detail descriptions across eight Sales types and one final-build Sales Order price change, not all fields or SDK versions. Generic native UDF saves remain unproven. Cash Sale creation did not persist its fixture payment; this is a separate unresolved create-path issue. Update acceptance covers that existing unpaid Cash Sale only, not paid-CS support. See docs/document-update-fields.md.

Endpoint

POST /v1/commands
GET /v1/commands/{commandId}
POST /v1/sales-module/sales-order/edit

Full JSON Payload

{
  "commandId": "update-sales-order-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "update-sales-order",
  "payload": {
    "docNo": "SO-000001",
    "reason": "Correct customer reference",
    "ref": "Updated reference"
  }
}

Payload Fields

docNo

required existing document number (selector)

reason

required business reason

docDate

optional Document date. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

debtorCode

optional Customer/debtor code. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

debtorName

optional Customer display name. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

agent

optional Sales agent code. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

salesAgent

optional Sales agent code. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

salesAgentCode

optional Sales agent code. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

deliverAddress1

optional Delivery address line 1. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

ref

optional Reference. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

description

optional Header description. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

displayTerm

optional Credit term. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

term

optional Credit term. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

phone1

optional Phone. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

phone

optional Phone. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

attention

optional Attention/contact. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

contact

optional Attention/contact. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

branchCode

optional Branch code. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

currencyCode

optional Currency code. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

currencyRate

optional Currency rate. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

withholdingTaxVersion

optional Optional native enum only when this document exposes the field. Omission preserves the existing value. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

note

optional Note. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

remark1

optional Remark 1. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

remark2

optional Remark 2. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

remark3

optional Remark 3. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

remark4

optional Remark 4. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

refDocNo

optional Reference document number. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

shipVia

optional Shipping method. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

shipInfo

optional Shipping info. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

salesLocation

optional Sales location where supported. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

location

optional Sales location where supported. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

userDefinedFields

optional Existing SDK-materialized UDF fields; exact reload verification required. Omitted stays unchanged; null or empty clears only optional string/nullable fields.

Master

optional header object of public SDK scalar fields

nativeFields

optional native header container: { Master: { SDKField: value } }

validateOnly

optional boolean; true runs native preflight without Save, returning saved:false; no persistence proof

detailMode

explicit update | append | replace | delete when editing lines; omit lines and detailMode for header-only updates

lines

optional detail array; update/delete select existing rows by dtlKey; append adds rows; replace replaces the detail set

Full Transaction Field Reference

header

debtorCode

customer/debtor code

debtorName

customer display name

salesAgent

sales agent code

salesLocation

sales location

multiPricing

price category/multi-pricing value

displayTerm

credit term

docNo

optional document number; omit to let AutoCount numbering generate it where supported

docDate

YYYY-MM-DD document date

dueDate

YYYY-MM-DD due date where supported

description

document narration/description

ref

reference

ourRef

our reference

yourRef

customer/supplier reference

currencyCode

currency code, for example MYR

currencyRate

currency exchange rate

inclusiveTax

true when prices include tax

taxDate

YYYY-MM-DD tax date

branchCode

debtor/creditor branch code/name where account book uses branches

userDefinedFields

object of AutoCount user-defined fields

verifyAfterSave

optional boolean; false keeps save fast, true reloads the saved record and returns readBack checks/differences where the connector has a safe get path

contactAndAddress

attention

attention/contact person

contact

alias for attention/contact person

phone1

primary phone

phone

alias for phone1

phone2

secondary phone/mobile

fax1

fax

fax

alias for fax1

address1

address line 1

address2

address line 2

address3

address line 3

address4

address line 4

deliverAddress1

delivery address line 1

deliverAddress2

delivery address line 2

deliverAddress3

delivery address line 3

deliverAddress4

delivery address line 4

deliverContact

delivery contact

deliverPhone1

delivery phone

lines

itemCode

AutoCount item code

barCode

barcode shown/used by item line

description

line description

description2

line second description

furtherDescription

long/further line description

qty

quantity

uom

UOM

unitPrice

unit price

unitCost

unit cost where supported

discount

discount string/amount

taxType

tax type/code alias

taxCode

tax code alias

taxRate

tax rate

taxAmount

tax amount

amount

line amount

location

stock location

fromLocation

source location

toLocation

destination location

batchNo

batch number

serialNo

serial number

project

project code

projNo

project code alias

department

department code

deptNo

department code alias

classification

classification code

deliveryDate

YYYY-MM-DD delivery date

userDefinedFields

object of line user-defined fields

payments

paymentMethod

AutoCount Payment Method code

paymentBy

payment type such as Cash, Cheque, Bank Transfer, Credit Card

paymentAmount

payment amount

amount

payment amount alias where supported

chequeNo

cheque/reference number

bankCharge

bank charge amount

bankAccount

bank/cash GL account

paymentAccountNo

bank/cash GL account alias

bankChargeAccountNo

bank charge GL account

creditCardApprovalCode

card approval/reference code

userDefinedFields

object of payment user-defined fields

JavaScript Example

const apiBase = "https://api.autocount.cloud";
const apiKey = "YOUR_API_KEY";

async function queueCommand(command) {
  const response = await fetch(apiBase + "/v1/commands", {
    method: "POST",
    headers: {
      "Authorization": "Bearer " + apiKey,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(command)
  });
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

async function waitCommand(commandId) {
  for (let i = 0; i < 60; i++) {
    const response = await fetch(apiBase + "/v1/commands/" + encodeURIComponent(commandId), {
      headers: { "Authorization": "Bearer " + apiKey }
    });
    if (!response.ok) throw new Error(await response.text());
    const data = await response.json();
    if (data.command && (data.command.status === "done" || data.command.status === "failed")) return data;
    await new Promise(resolve => setTimeout(resolve, 2000));
  }
  throw new Error("Command timed out");
}

const command = {
  "commandId": "update-sales-order-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "update-sales-order",
  "payload": {
    "docNo": "SO-000001",
    "reason": "Correct customer reference",
    "ref": "Updated reference"
  }
};

await queueCommand(command);
console.log(await waitCommand(command.commandId));

AI Rules

• Use cloud API only: https://api.autocount.cloud.
• Never call the Local Connector API directly from Mac Soft AI, AI tools, customer apps, or external integrations.
• Use Authorization: Bearer YOUR_API_KEY.
• Use a unique commandId for every real operation.
• commandId must be URL-safe: letters, numbers, dot, underscore, and hyphen only; max 160 characters.
• Set type to update-sales-order.
• Poll GET /v1/commands/{commandId} until status is done or failed.
• For write commands, validate first when a validate-* command exists for the same document.
• Install local-mvp-2026.09.30.01 or later on the selected connector before using this update contract; cloud publication does not install or upgrade customer connectors. Check installed capabilities first; never trial writes against an older or unconfirmed build. Strict Sales update: editable SDK scalar fields via friendly fields, Master or nativeFields.Master; details via lines with explicit detailMode and existing dtlKey for update/delete. Omitted fields stay unchanged; explicit null/empty clears only optional fields. Unknown, unavailable, calculated, system and lifecycle fields are rejected before Save. Existing UDFs must be present in the SDK schema; no invented columns. validateOnly:true runs native preflight without Save and is not persistence certification. Save success requires a fresh SDK reload with writeVerification.matched=true, identity and linkage verification. saved:true with ok:false means a persisted mismatch or failed verification, not rollback; inspect the existing document and never recreate it automatically. Existing payment, transfer, package and eInvoice protections remain. Runtime get-document fields/fieldCapabilities expose SDK field discovery and fields.readErrors; availability varies by document and account book. Native acceptance covers reference/detail descriptions across eight Sales types and one final-build Sales Order price change, not all fields or SDK versions. Generic native UDF saves remain unproven. Cash Sale creation did not persist its fixture payment; this is a separate unresolved create-path issue. Update acceptance covers that existing unpaid Cash Sale only, not paid-CS support. See docs/document-update-fields.md.

Cancel a sales order when AutoCount allows it.

Cancellation depends on AutoCount posting/link status and account-book permissions.

Endpoint

POST /v1/commands
GET /v1/commands/{commandId}
POST /v1/sales-module/sales-order/cancel

Full JSON Payload

{
  "commandId": "cancel-sales-order-001",
  "connectorId": "customer-main",
  "companyId": "macsofttest",
  "type": "cancel-sales-order",
  "payload": {
    "docNo": "SO-000001",
    "reason": "cancelled by API request"
  }
}

Payload Fields

docNo

required document number

reason

optional cancellation reason

Full Transaction Field Reference

header

debtorCode

customer/debtor code

debtorName

customer display name

salesAgent

sales agent code

salesLocation

sales location

multiPricing

price category/multi-pricing value

displayTerm

credit term

docNo

optional document number; omit to let AutoCount numbering generate it where supported

docDate

YYYY-MM-DD document date

dueDate

YYYY-MM-DD due date where supported

description

document narration/description

ref

reference

ourRef

our reference

yourRef

customer/supplier reference

currencyCode

currency code, for example MYR

currencyRate

currency exchange rate

inclusiveTax

true when prices include tax

taxDate

YYYY-MM-DD tax date

branchCode

debtor/creditor branch code/name where account book uses branches

userDefinedFields

object of AutoCount user-defined fields

verifyAfterSave

optional boolean; false keeps save fast, true reloads the saved record and returns readBack checks/differences where the connector has a safe get path

contactAndAddress

attention

attention/contact person

contact

alias for attention/contact person

phone1

primary phone

phone

alias for phone1

phone2

secondary phone/mobile

fax1

fax

fax

alias for fax1

address1

address line 1

address2

address line 2

address3

address line 3

address4

address line 4

deliverAddress1

delivery address line 1

deliverAddress2

delivery address line 2

deliverAddress3

delivery address line 3

deliverAddress4

delivery address line 4

deliverContact

delivery contact

deliverPhone1

delivery phone

lines

itemCode

AutoCount item code

barCode

barcode shown/used by item line

description

line description

description2

line second description

furtherDescription

long/further line description

qty

quantity

uom

UOM

unitPrice

unit price

unitCost

unit cost where supported

discount

discount string/amount

taxType

tax type/code alias

taxCode

tax code alias

taxRate

tax rate

taxAmount

tax amount

amount

line amount

location

stock location

fromLocation

source location

toLocation

destination location

batchNo

batch number

serialNo

serial number

project

project code

projNo

project code alias

department

department code

deptNo

department code alias

classification

classification code

deliveryDate

YYYY-MM-DD delivery date

userDefinedFields

object of line user-defined fields