{"ok":true,"commandType":"validate-ap-payment","module":"AP","mode":"read","summary":"Validate an AP payment without saving. Supports one or many real supplier invoice knock-offs.","payloadSchema":{"creditorCode":"required AutoCount creditor/supplier code","amount":"required total payment/refund amount","knockOffs":"optional array of documents to allocate this payment/refund against; docKey is recommended","_arApRule":"AP = supplier/creditor. Use creditorCode only for AP commands; do not send debtorCode for AP.","docNo":"optional AutoCount document number; omit to let AutoCount numbering generate it","docDate":"required or optional YYYY-MM-DD document date","paymentMethod":"required or optional AutoCount Payment Method code such as CASH or MAYBANK","paymentBy":"optional payment type such as Cash, Cheque, Bank Transfer, Credit Card","chequeNo":"optional cheque/reference number","bankCharge":"optional bank charge amount","paymentAccountNo":"optional GL bank/cash account number","bankChargeAccountNo":"optional GL bank charge account number","creditCardApprovalCode":"optional credit-card approval code/reference","description":"optional payment/refund narration","userDefinedFields":"optional object of AutoCount user-defined fields"},"examplePayload":{"creditorCode":"400-S001","amount":100,"knockOffs":[{"docType":"PB","docKey":"424508","docNo":"PI-000001","amount":100,"discountAmount":0,"taxAdjustment":0,"gainLossAmount":0,"withholdingTaxAmount":0}],"docDate":"2026-06-24","paymentMethod":"CASH","paymentBy":"Cash","chequeNo":"API-PAY-1001","bankCharge":0,"paymentAccountNo":"110-0010","bankChargeAccountNo":"810-0000","creditCardApprovalCode":"","description":"AP payment/refund created through API","userDefinedFields":{"APITEST":"API"}},"notes":"Real positive knock-off validation is proven for outstanding AP documents. The connector also accepts old PI aliases and normalizes them to PB. AP = supplier/creditor. Use creditorCode only for AP commands; do not send debtorCode for AP. For payment against invoices use RI for AR and PB for AP. For refund against credit notes use RC/ARCN for AR and PC/APCN for AP. Friendly aliases are normalized by the connector where supported.","nativePayload":{"supported":true,"sections":[{"name":"Master","fields":[{"name":"DocNo","type":"string","description":"Optional AutoCount document number.","aliases":["docNo"]},{"name":"DocDate","type":"date","description":"Payment document date.","aliases":["docDate"]},{"name":"CreditorCode","type":"string","description":"Supplier/creditor code.","aliases":["creditorCode"]},{"name":"ProjNo","type":"string","description":"Header project code.","aliases":["projNo","project"]},{"name":"DeptNo","type":"string","description":"Header department code.","aliases":["deptNo","department"]},{"name":"Description","type":"string","description":"Payment description.","aliases":["description"]},{"name":"CurrencyCode","type":"string","description":"Currency code.","aliases":["currencyCode"]},{"name":"Note","type":"string","description":"Payment note.","aliases":["note"]}]},{"name":"Details","fields":[{"name":"PaymentMethod","type":"string","description":"Exact AutoCount payment method code.","aliases":["paymentMethod"]},{"name":"ChequeNo","type":"string","description":"Cheque/reference number.","aliases":["chequeNo"]},{"name":"PaymentAmt","type":"number","description":"Payment amount.","aliases":["amount","paymentAmount"]},{"name":"BankCharge","type":"number","description":"Bank charge amount.","aliases":["bankCharge"]},{"name":"ToBankRate","type":"number","description":"Bank currency rate.","aliases":["toBankRate"]},{"name":"PaymentBy","type":"string","description":"Payment by label.","aliases":["paymentBy"]}]},{"name":"KnockOffDetails","fields":[{"name":"DocType","type":"string","description":"AutoCount knock-off document type such as PB.","aliases":["docType"]},{"name":"DocKey","type":"number","description":"AutoCount outstanding document key.","aliases":["docKey"]},{"name":"DocNo","type":"string","description":"Outstanding document number.","aliases":["docNo"]},{"name":"KnockOffDate","type":"date","description":"Knock-off date.","aliases":["knockOffDate"]},{"name":"KnockOffAmount","type":"number","description":"Allocated amount.","aliases":["amount","knockOffAmount"]}]},{"name":"TransferDetails","fields":[]},{"name":"PaymentDetails","fields":[]},{"name":"Options","fields":[{"name":"DocNoFormatName","type":"string","description":"Optional AutoCount numbering format.","aliases":["docNoFormatName"]},{"name":"SaveAsDraft","type":"boolean","description":"Draft/save behavior where AutoCount supports it.","aliases":["saveAsDraft"]}]}]}}