Intacct: API Create AR Payment response clarification.

[Simon Trigona]

Hi,

We're using the Create AR Payment API (https://developer.intacct.com/api/accounts-receivable/ar-payments/#create-ar-payment ) and depending on the state of data in Intacct we get different error messages. Some are clear and one is very ambiguous and I am looking for clarification on what it means/how to reproduce.

Given the following payment request,

        <create>
          <ARPYMT>
            <FINANCIALENTITY>100_CHK</FINANCIALENTITY>
            <PAYMENTMETHOD>Cash</PAYMENTMETHOD>
            <CUSTOMERID>10001</CUSTOMERID>
            <DOCNUMBER>test</DOCNUMBER>
            <RECEIPTDATE>8/1/2024</RECEIPTDATE>
            <PAYMENTDATE>8/1/2024</PAYMENTDATE>
            <ARPYMTDETAILS>
              <ARPYMTDETAIL>
                <RECORDKEY>167</RECORDKEY>
                <NEGATIVEINVOICEKEY>64</NEGATIVEINVOICEKEY>
                <TRX_NEGATIVEINVOICEAMOUNT>5</TRX_NEGATIVEINVOICEAMOUNT>
              </ARPYMTDETAIL>
            </ARPYMTDETAILS>
          </ARPYMT>
        </create>

We may get the follow errors which are very clear

• The credit amount selected for payment is bigger than the credit amount available.
• The amount received is greater than the amount to apply. Reduce the amount received, reduce the credit amount to apply, or add an overpayment. Then try again.
• There is no due on the invoice 167

However we see the following error (where 309789 is the invoice / RECORDKEY) in some of our other environments and I'm not sure what the cause is.

• Invalid transaction key 309789, No line items found

[Sterio, Louis]

Simon for this one its best if you open up a case and have your support team reproduce the issue and track it with the AR team to clean up the error message and provide you with an answer.

[Simon Trigona]

Thanks Louis, I did manage to reproduce it in my environment and have opened up a support ticket.