> For the complete documentation index, see [llms.txt](https://voyzu.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://voyzu.gitbook.io/docs/customising-and-extending-voyzu/financial-document-processing-engine-development.md).

# Add a Financial Document Processing Engine

Voyzu includes a number of Financial Document Processing [endpoints](broken://pages/Y5aSBTUlL30kKlV170oB). Developing a new financial document processing engine should follow the pattern established. Following existing conventions will help keep things consistent.

## Naming conventions

```jsonc
// financial document type. E..g AR_INVOICE, AP_BILL etc
document_type
// Voyzu company code
company_code
// Voyzu company external identifier
company_external_id
// Agreed document identifier. E..g INV-1001, RECEIPT-20261211 etc
document_ref
// Additional reference associated with the document
external_reference
// Date to enter into the Company Ledger
posting_date
// Information to print for example on Ledger on-screen reports
memo
```

### Use document-specific event dates:

```txt
AR_INVOICE      invoice_date
AR_RECEIPT      payment_date
AP_BILL         bill_date
AP_PAYMENT      payment_date
AR_REFUND       refund_date
WRITE_OFF       write_off_date
```

### Use document-specific amount fields:

```txt
AR_INVOICE      invoice_amount
AR_RECEIPT      receipt_amount
AP_PAYMENT      payment_amount
AR_REFUND       refund_amount
WRITE_OFF       write_off_amount
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://voyzu.gitbook.io/docs/customising-and-extending-voyzu/financial-document-processing-engine-development.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
