{"ok":true,"commandType":"validate-ap-refund","module":"AP","mode":"read","summary":"Validate an AP refund without saving. Refund knocks off AP credit notes, not supplier invoices. Use docType PC or friendly CN alias; docKey is recommended.","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"}},"examples":[],"payloadEnums":{},"requiredPayloadFields":[],"conditionalPayloadRules":{},"notes":"Real AP refund knock-off save is proven against AP credit notes. CN/CreditNote aliases are normalized to PC. 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":"Refund date.","aliases":["docDate"]},{"name":"CreditorCode","type":"string","description":"Supplier/creditor code.","aliases":["creditorCode"]},{"name":"Description","type":"string","description":"Refund description.","aliases":["description"]},{"name":"ReferenceInvoiceNo","type":"string","description":"Reference invoice number.","aliases":["referenceInvoiceNo"]},{"name":"CurrencyCode","type":"string","description":"Currency code.","aliases":["currencyCode"]},{"name":"Note","type":"string","description":"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":"Refund payment amount.","aliases":["amount","paymentAmount","paymentAmt"]},{"name":"BankCharge","type":"number","description":"Bank charge amount.","aliases":["bankCharge"]},{"name":"PaymentBy","type":"string","description":"Payment by label.","aliases":["paymentBy"]}]},{"name":"KnockOffDetails","fields":[{"name":"DocType","type":"string","description":"Credit-note document type such as PC.","aliases":["docType"]},{"name":"DocKey","type":"number","description":"AutoCount credit note key.","aliases":["docKey"]},{"name":"DocNo","type":"string","description":"Credit note 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"]}]}]}}