Subject: | Xero / LinkSOFT Integration for VMS and LinkPOS Integration using LinkSOFT Inventory |
Summary: | Objective: Build LinkSOFT Integration to Xero
Agreed on the following: - Setup the API on Link development environment so Link can build the POS Integration
- Standard LinkSOFT Licencing will apply to the Integration. The current licence price is estimated at $2500 per site We will review the cost of integration once we know the effort required to build and maintain the integration
- The Integration needs to work similarly to the current JIWA POS integration
- Link will use the Standard WEB API to push and pull data
|
Audit Notes: | Edited by sanjay on 16/04/20 10:05. Edited by sanjay on 18/03/20 13:28. Edited by sanjay on 27/02/20 17:04. Edited by sanjay on 27/02/20 17:04. Edited by sanjay on 27/02/20 17:04. |
06 Mar 2020 | 04:27PM Comment 1 by Sanjay (Link Technologies) Assigned To: Rashna (Edge Business Solutions) Followup Date: 10-03-2020 04:26 PM Time Taken: 48.00 |
| Development work for this case has been completed. The change will be available in version:11.5.0306 1. The following changes were made(Include Database object names, Program classes and any other relevant information): - Built LinkSOFT integration to Xero in the following areas:
- POS Sales, Returns and Payments
- Payroll Journals
- ?Customer is synchronised both ways
- Supplier synced both ways
- AP Invoices are created when LinkSOFT Purchase orders are posted and from Payroll Creditor Payments
- LinkSOFT Adjustment (Void Payment, refund etc)
2. Affected Areas: - This integration allows LINKSOFT Inventory Mode only
3. The issue was caused by: - New Feature
4. Notes: This integration is similar to LinkSOFT / JIWA Integration 5. Next Step: UAT |
|
18 Mar 2020 | 01:28PM Comment 2 by Sanjay (Link Technologies) ETC was changed from 13/03/2020 to 10/03/2020 |
20 Mar 2020 | 11:04AM Comment 3 by Rashna (Edge Business Solutions) Assigned To: Alvis (Link Technologies) Followup Date: 24-03-2020 11:00 AM Time Taken: 1.00 |
| Hi Alvis, There are errors with Xero Integration. - Sales Order Fail. Notes is not updated with the cause of error. Refer to Figure 1.
- LT_SYS_Integration_WEBAPI_Error. There are issues with AR Master and AP Master files.
Figure 1: AR Sales Order View. Thanks Rashna |
|
25 Mar 2020 | 04:09PM Comment 4 by Sanjay (Link Technologies) Assigned To: Development Followup Date: 26-03-2020 04:08 PM Time Taken: 4.00 |
| Development work for this case has been completed. The change will be available in version:11.5.0325 1. The following changes were made(Include Database object names, Program classes and any other relevant information): - Corrected issue with XERO API for sales order
2. Affected Areas: - XERO integration
3. The issue was caused by:
4. Notes: 5. Next Step: UAT |
|
07 Apr 2020 | 03:21PM Comment 5 by Rashna (Edge Business Solutions) Assigned To: Alvis (Link Technologies) Followup Date: 08-04-2020 10:08 AM Time Taken: 5.00 |
| Hi Alvis, The case has been tested. The test plan has been updated with test results. Concerns - Payment Adjustments - Processing a refund from POS.
- Process a refund in POS. This does not sign VMS. This is the correct behaviour.
- The refund is integrated into Xero and creates an invoice. This is the correct behaviour.
- The invoice from xero is sent to LinkSOFT and AR Master is updated - Here VMS is signed for the refund as a Normal Sale. Please review and advise for documentation. Review document number PJ000005-15 for customer LC0256
- Transaction Date for "Payroll Journals".
- The transaction date under "GL Journal View" and "AP Invoice View" is updated with the "Banking Date".
- A user can update a pay without updating "Banking Date". This causes below issues:
- Invoice under "AP Invoice" is created with a blank "Transaction Date" - Review Invoice No "PAY010120-CASH"
- Journals under "GL Journal View" also has the transaction date as blank, once the journal is integrated to Xero it disappears from "GL Journal View" - Review Journal no #1932 in Xero , Unable to locate this in LinkSOFT even by filtering records from year 2000.
- AP Invoice for Payroll Fails to Integrate
- The invoice fails to integrate with Error: "The underlying connection was closed: An unexpected error occurred on a receive. Integration: XERO.API Rule: AccountsPayableInvoice Flag: Invoices.URL.POST". I am unable to identify the cause.Review Invoice No "PAY280220-CASH"
Setup
Thanks Rashna
|
|
08 Apr 2020 | 02:20PM Comment 6 by Sanjay (Link Technologies) Assigned To: Development Followup Date: 09-04-2020 12:58 PM Time Taken: 2.00 |
| Development work for this case has been completed. The change will be available in version:11.5.0408 1. The following changes were made(Include Database object names, Program classes and any other relevant information): - We have removed Accounts Receivable Adjustment from all WEB API integrations as we expect these to be done directly in the ERP system.
- These adjustments are from POS ~> Credit Notes, Payment Refund and Payment Void. - Transaction Date for "Payroll Journals" - We validate banking date before allowing users to close the pay.
- AP Invoice for Payroll Fails to Integrate - I have checked this on QA6, the creditor number is not a valid creditor in XERO.
Follow these steps when creating creditors:- Create the creditor in XERO
- When the Creditor is integration to LinkSOFT, identify the creditor number that is assigned in the menu "AP Master view"
- Use the creditor number identified to configure in Payroll.
2. Notes: SQL API integration (JIWA6, JIWA7 ) will still post AR Adjustments as the ERP systems have a separate menu for these adjustments. JIWA6, JIWA7 adjustments are created in JIWA ~> Debtors ~> Adjustments. Jiwa Adjustments are not used for VMS signing. 3. Next Step: UAT |
|
27 Apr 2020 | 10:48AM Comment 7 by Sanjay (Link Technologies) Assigned To: Rashna (Edge Business Solutions) Followup Date: 28-04-2020 08:05 AM Time Taken: 9.00 |
| Xero Integration Failed for the following reasons: - Account payment in LinkSOFT flows into Xero as a Prepayment. The payment is not allocated to the appropriate invoice. Users have to allocate payment in Xero and can allocate to a different invoice
- Account Allocation in LinkSOFT does not allocate the sales order in Xero
- Account Payment in Xero does not reflect in LinkSOFT - therefore account statements in Xero and LinkSOFT do not match
- Invoices created in XERO does not flow into POS making the Statements mismatch
- The current integration is complex and difficult to maintain. This will create a lot of support issues requiring technical resources to explain and resolve. This is not sustainable.
Discussion with Development Team (Rashna, Alvis Sanjay). Agreed to make the following changes: - Customers buying LinkSOFT will use LinkSOFT as the primary application for Sales and Debtor Management
- Inventory management (Requisition, PO and Receipts) will be done in LinkSOFT
- Integration of all Debtors, Sales will be direct to GL
- When a Purchase Order is Posted, it will create an AP Invoice
AP integration Failure details documented below this line ----------------------------------- The following two statements are incorrect. A REFUND IN POS MUST BE VMS SIGNED. Please refer to this as a "Payment Adjustment (Refund or Credit)". - Process a refund in POS. This does not sign VMS. This is the correct behaviour.
- The refund is integrated into Xero and creates an invoice. This is the correct behaviour. [Sanjay] - This must be VMS Signed
System Test - Create a NEW customer in Xero
- Create a POS Credit sale for $25 - Signed Correctly. Transaction transferred to XERO correctly. POS Receipt was compared with Xero Transaction. (Refer to Figure 1)
- Received Payment IN POS for $8 - This flowed into Zero correctly as a Prepayment which needs to be allocated to the invoice.
- Payment Adjustment $5 - THis does not flow into Xero
Import Notes for documentation. When Xero Is integrated, the following must be clearly stated in the documentation: - Cash Sales from LinkPOS flows in Zero
- Account Payments is created in Xero as a "Pre-payment" and must be allocated in Xero
- Transactions created in Xero will not flow into LinkPOS, therefore you should always use Xero Customer Statements as LinkPOS statement will only show transactions created in LinkPOS
- Users should use Xero to take account Payments, Payment Adjustments and all other debtor related functions
Figure 1 - POS Receipt with Xero Transaction
|
|
28 Apr 2020 | 03:27PM Comment 8 by Sanjay (Link Technologies) Assigned To: Rashna (Edge Business Solutions) Followup Date: 29-04-2020 03:13 PM Time Taken: 16.00 |
| Development work for this case has been completed. The change will be available in version:11.5.0428 1. The following changes were made(Include Database object names, Program classes and any other relevant information): - Removed integration from LinkSOFT directly to AR
- All accounts except Bank and Debtors comes from Inventory Posting Account.
- For GL Journals, where account code values sum to zero, the journal line cancels out and is not created in GL.
- Added LinkSOFT integration to GL. This requires all LinkSOFT functionality to be used and a GL Journal is created for each LinkSOFT transaction.
- Sales (DR: Debtors (Customer Type), COGS CR: Bank (payment Method), Sales, Tax, Stock.
- Returns - journal is opposite of 1.2.1
- Account Payment - (DR: Bank, CR: Debtors)
- Payment Refund and Payment Void (DR: Debtors CR: Bank)
- Stock Adjustment In: (DR: Stock CR: Write ON)
- Stock Adjustment OUT: (DR: Write OFF CR: Stock)
- Purchase Receive:
- AP Invoice is created for each purchase receive
- Journal: (DR: Stock, CR: COGP)
- Zero value purchase receive do not flow to AP.
- The account code used in the integration needs to be a posting account in the ERP system. E.g in XERO the Accounts Receivable GL account is a non-posting account, therefore, this account cannot be used as a debtors control account. In this case, you need to create a posting debtor control GL account for POS.
2. Affected Areas: - Integration from LinkSOFT to ERP where the integration type is WEB.API
3. The issue was caused by: - Improvement
4. Notes: EPICOR and JIWA integration uses direct SQL and has not been changed. When we move to WEB API, this will be redesigned. 5. Next Step: UAT and Documentation |
|
26 May 2020 | 12:39PM Comment 9 by Rashna (Edge Business Solutions) Assigned To: Rashna (Edge Business Solutions) Followup Date: 27-05-2020 12:30 PM Time Taken: 1.00 |
| QA Results Tests carried out according to requirements specified on the case header Test Results Summary Table 1 - Summarised list of issues No | Test Description | Pass/Fail | 1 | Removed integration from LinkSOFT directly to AR
| Pass | 2 | All accounts except Bank and Debtors comes from Inventory Posting Account
| Pass. - Configure Bank Account in Payment Methods.
- Configure Payment Adjustment Account for Refund and Credit Note.
- Configure COGS account for return reason where return to stock is applicable.
- Configure Debtor Account in Customer Type.
| 3 | For GL Journals, where account code values sum to zero, the journal line cancels out and is not created in GL.
| Pass | 4 | dded LinkSOFT integration to GL. This requires all LinkSOFT functionality to be used and a GL Journal is created for each LinkSOFT transaction.
- Sales (DR: Debtors (Customer Type), COGS CR: Bank (payment Method), Sales, Tax, Stock.
- Returns - journal is opposite of 1.2.1
- Account Payment - (DR: Bank, CR: Debtors)
- Payment Refund and Payment Void (DR: Debtors CR: Bank)
- Stock Adjustment In: (DR: Stock CR: Write ON)
- Stock Adjustment OUT: (DR: Write OFF CR: Stock)
- Purchase Receive:
- AP Invoice is created for each purchase receive
- Journal: (DR: Stock, CR: COGP)
- Zero value purchase receive do not flow to AP.
| Pass Test Plan |
Environment Details - OS version: Windows Server 2012
- Application version: 11.5.0521
- Setup: Demo
- Server : 10.0.0.16
- Database: LINKSOFT-XERO
Next Step: - Documentation
|
|
09 Jun 2020 | 11:00AM Comment 10 by Rashna (Edge Business Solutions) Assigned To: Rashna (Edge Business Solutions) Followup Date: 10-06-2020 09:16 AM Time Taken: 3.00 |
| Hi Sanjay, Documentation has been updated at - Framework\Integration\XERO_Integration.htm
- Framework\Integration\LinkSOFT_Inventory_and_Xero_Integration.htm
- Framework\Integration\LinkSOFT_Payroll_Integration_to_Xero.htm
- Framework\Integration\XERO_and_Tax_ Invoice_Integration.htm
Thanks Rashna |
|