{"ok":true,"commandType":"create-ar-credit-note","module":"AR","mode":"write","summary":"Create an AR credit note. Supports one or many real invoice knock-offs.","payloadSchema":{"debtorCode":"required AutoCount debtor/customer code","docDate":"required or optional YYYY-MM-DD document date","amount":"optional single-line amount; lines is preferred for multiple lines","lineDescription":"optional","knockOffs":"optional array for credit/debit note knock-off where AutoCount supports it","_arApRule":"AR = customer/debtor. Use debtorCode only for AR commands; do not send creditorCode for AR.","docNo":"optional AutoCount document number; omit to let AutoCount numbering generate it","dueDate":"optional YYYY-MM-DD due date","description":"optional document description/narration","ref":"optional reference","branchCode":"optional debtor/customer branch code/name where the customer uses branches","attention":"optional attention/contact person","contact":"optional contact person alias for attention","currencyCode":"optional currency code such as MYR","currencyRate":"optional exchange rate","inclusiveTax":"optional boolean","taxDate":"optional YYYY-MM-DD tax date","accountNo":"optional user-selected GL posting account for simple one-line payload; overrides the connector/default account","taxType":"optional tax type/code","lines":"optional array of GL/account rows for multi-line AR invoice, credit note, or debit note; each line can choose posting account with accountNo / accNo / glAccount","userDefinedFields":"optional object of AutoCount user-defined fields"},"examplePayload":{"debtorCode":"300-A001","docDate":"2026-06-24","amount":100,"lineDescription":"Credit adjustment","knockOffs":[{"docType":"RI","docKey":"424508","docNo":"IV-000001","amount":100,"discountAmount":0,"taxAdjustment":0}],"dueDate":"2026-07-24","description":"AR document created through API","ref":"API-REF-1001","branchCode":"MAIN","attention":"Accounts Department","contact":"Accounts Department","currencyCode":"MYR","inclusiveTax":false,"lines":[{"accountNo":"500-0000","description":"Service line 1","amount":100,"taxType":"S-0","taxCode":"S-0","taxAmount":0,"project":"PRJAPI","projNo":"PRJAPI","department":"HQ","deptNo":"HQ","classification":"022","userDefinedFields":{"APITEST":"API-LINE"}},{"accountNo":"501-0000","description":"Different posting account line","amount":50,"taxType":"S-0","taxCode":"S-0","project":"PRJAPI","projNo":"PRJAPI","department":"HQ","deptNo":"HQ","classification":"022"}],"userDefinedFields":{"APITEST":"API"}},"examples":[],"payloadEnums":{},"requiredPayloadFields":[],"conditionalPayloadRules":{},"notes":"Requires write access permission. Real knock-off validation is proven; saving should still be tested per account book. AR = customer/debtor. Use debtorCode only for AR commands; do not send creditorCode for AR. Use read-ar-outstanding-documents first when a knock-off needs docKey. For simple invoices, amount/accountNo still works. For multiple posting accounts, send lines and put accountNo on each line. AR/AP invoice/note posting account order is: lines[].accountNo/top-level accountNo, AutoCount default account only when needed, then safe recent same-party history where the connector has a proven read path.","nativePayload":{"supported":true,"sections":[{"name":"Master","fields":[{"name":"DocNo","type":"string","description":"Optional AutoCount document number.","aliases":["docNo"]},{"name":"DocDate","type":"date","description":"Document date.","aliases":["docDate"]},{"name":"DebtorCode","type":"string","description":"Customer/debtor code.","aliases":["debtorCode"]},{"name":"CNType","type":"string","description":"Credit note type.","aliases":["cnType","creditNoteType"]},{"name":"Reason","type":"string","description":"Credit/debit note reason.","aliases":["reason"]},{"name":"Ref","type":"string","description":"Reference.","aliases":["ref"]},{"name":"Description","type":"string","description":"Header description.","aliases":["description"]},{"name":"JournalType","type":"string","description":"Journal type.","aliases":["journalType"]},{"name":"TaxDocNo","type":"string","description":"Tax document number.","aliases":["taxDocNo"]},{"name":"OurInvoiceNo","type":"string","description":"Our invoice number.","aliases":["ourInvoiceNo"]}]},{"name":"Details","fields":[{"name":"DtlKey","type":"number","description":"Existing detail key for updates.","aliases":["dtlKey"]},{"name":"AccNo","type":"string","description":"Posting GL account.","aliases":["accNo","accountNo"]},{"name":"Description","type":"string","description":"Line description.","aliases":["description"]},{"name":"ProjNo","type":"string","description":"Project code.","aliases":["projNo","project"]},{"name":"DeptNo","type":"string","description":"Department code.","aliases":["deptNo","department"]},{"name":"Amount","type":"number","description":"Line amount.","aliases":["amount"]},{"name":"TaxCode","type":"string","description":"Tax code.","aliases":["taxCode"]}]},{"name":"KnockOffDetails","fields":[{"name":"DocType","type":"string","description":"AutoCount knock-off document type.","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"]}]}]}}