1. Prepare an Immenzo API key
Use an active API key supplied by Immenzo, beginning with imz_….
Keep these two key types separate:
| Key | Purpose |
|---|---|
| Immenzo API key | Accesses the Immenzo document-processing service |
| ERP receiver secret | Protects the ERP endpoint when delivery uses a backend API |
For the widget installation below, use the Immenzo API key.
2. Install the widget on the ERP page
Ask your IT team to paste the following code into the ERP page template, before the closing </body> tag:
<script>
window.Immenzo = window.Immenzo || function () {
(window.Immenzo.q = window.Immenzo.q || []).push(arguments);
};
Immenzo('init', {
apiKey: 'GANTI_DENGAN_API_KEY_IMMENZO',
position: 'right-bottom',
width: 520,
height: 720,
autoOpen: false
});
</script>
<script
async
src="https://widget.immenzo.com/widget/loader.js">
</script>Replace GANTI_DENGAN_API_KEY_IMMENZO with your active key. Save the change, then reload the ERP page.
The Immenzo button will appear in the bottom-right corner of the page.
3. Prepare the form to be filled
The widget uses the form fields on the ERP page that is currently open.
To help match extracted results, the IT team can add a data-imz-field attribute to existing fields. Match the attribute to the extracted field name.
Invoice example:
<label>
Nama supplier
<input name="supplier" data-imz-field="vendor_name">
</label>
<label>
Nomor invoice
<input name="invoice_no" data-imz-field="invoice_number">
</label>
<label>
Tanggal invoice
<input type="date" name="invoice_date" data-imz-field="invoice_date">
</label>
<label>
Total tagihan
<input type="number" step="0.01" name="total" data-imz-field="total_amount">
</label>Add attributes to the fields that already exist; there is no need to create a duplicate form. Test the matching with your own sample documents, especially dates, numbers, and selection fields.
4. Upload and review a document
- Open the destination form in the ERP.
- Click the Immenzo button in the bottom-right corner.
- Select Upload document.
- Upload the document, then click Process.
- Review the extracted results and correct them when needed.
According to this version of the documentation, supported formats are JPG, PNG, GIF, TIFF, and WEBP, with a maximum size of 10 MB per file. PDF is not listed as a supported upload format in this version.
5. Choose the next action
| Option | Result |
|---|---|
| Download CSV | Downloads the extracted results as a CSV file |
| Post to form | Fills the form fields on the ERP page that is currently open |
| Submit to system | Runs the approval and delivery process in the Immenzo service according to its configuration |
To fill the ERP form
Select Post to form, then review the result in the form.
Once the data is correct, use the ERP’s own Save button to save the transaction.
Post to form fills the form; it does not automatically save an ERP record.
To send directly through an API
Direct delivery to the ERP requires additional configuration by your IT team and Immenzo:
- ERP receiver endpoint URL.
- Authentication stored on the server.
- Field mapping and validation rules.
- Saving process and duplicate checks.
- Confirmation that the record was created successfully.
The widget installation code above does not configure a delivery destination in an external ERP. Submit to system must not be treated as proof that data has been saved in the ERP until the integration has been configured and tested.
Do not replace the apiUrl setting with your ERP URL. That setting identifies the Immenzo processing-service address.
6. Test before use
Use sample documents to confirm that:
- The widget appears and the API key is accepted.
- The document is processed successfully.
- Extracted results can be reviewed and corrected.
- Post to form fills the correct fields.
- The ERP Save button actually saves the data.
- The saved record can be opened again.
Quick help
| Issue | What to check |
|---|---|
| The widget does not appear | Installation code, loader address, and the ERP page security policy |
| The API key is rejected | Confirm that the key is active and the placeholder has been replaced |
| Fields are not filled | Open the destination form and check its name, id, or data-imz-field attributes |
| Dates or numbers do not match | Check the format accepted by the ERP field |
| The form is filled but data is not saved | Use the ERP Save button and check its validation messages |
| Submit completes but no ERP record is found | Check whether the backend-to-ERP integration has been configured |

