AGNUM integration: XML files, invoices and payments
The AGNUM integration exchanges XML files. This is a file transfer and import process: creating or moving a file does not mean the other system has processed it successfully.
When setting up the integration, we’ll agree which data to transfer and in which direction.
Data and transfer directions
| Data | Hanna → AGNUM | AGNUM → Hanna | Conditions and meaning |
|---|---|---|---|
| Invoices | XML export | XML import | Agree the exchange format and import location. |
| Customers during invoice import | — | With documents | Customers are identified from the imported invoice data. |
| Payments | — | XML import | Invoices must be processed first; payment import waits until no pending files remain in the invoice folder. |
| Purchase documents | — | Into Hanna expenses | This import does not create a stock goods receipt. |
Before launch
- Agree the XML format, exchange folders, file delivery method and responsibility for monitoring results. If FTP delivery is used, confirm its activation separately.
- Test one invoice and customer matching first, followed by its payment.
- Check purchase imports in Expenses. Check stock balances separately from this document.
Limitations and document changes
- Processed files move to the imported-files folder. Before retrying, check both pending and already imported locations.
- Submitting a file again can mean processing a document again. Do not copy an entire old batch back because of a single failed record.
- Agree the file transfer method and frequency with the Hanna team.
If data is not transferred
- If payments are missing, check for an unprocessed or failing file in the invoice folder.
- Look for imported purchase documents in Expenses.