# Invoice Watch our quick demo to see how you can easily set up your custom invoice model with Mindee: {% @supademo/embed url="" demoId="cmfci0aiy7nt739ozcvdq9hqa" %} ## Why use Mindee for Invoices? Invoices can vary widely by supplier, format, and layout. The Invoice model is designed to handle these differences, so you get consistent and reliable data extraction without custom development. Common use cases: * Accounts payable automation * Expense and cost tracking * Tax and compliance reporting ## Two Ways to Start Building your Invoice Model ### 1. Choose “Invoice” in the Catalog (Recommended) * Open the **Document Catalog** in your dashboard and select **“Invoice.”** * The model comes pre-configured with the standard financial fields listed above. * You can start using it right away, or adjust the schema in **Data Schema** if you need additional fields. * Once selected, you can immediately test the model with your own invoices. ### 2. Build a Custom Invoice Model with the AI Agent * If your workflow requires extra fields (e.g. purchase order number, IBAN, payment terms), you can describe them directly to the AI Agent. * Optionally upload a sample invoice for context. * The Agent will generate a tailored schema that extends beyond the built-in Invoice parser. You can use this invoice sample if you want to try and do a live test yourself:
a fake invoice from Turnpike Designs
## Document format support The Invoice model accepts PDFs and common image formats (JPG, PNG). It works reliably with scanned, photographed, and digital invoices. ## Invoice Fields Documentation for all fields present in the data schema. Field *accessors* are used as the keys for accessing the values in the returned data. On the data schema interface, this is the "Field Name". Field *value types* indicate how the value is returned by the API. On the data schema interface, this is the "Field Type".
Supplier Name The name of the supplier of the invoice. Accessor: `supplier_name`\ Value Type: `string` Has a single value.
Supplier Phone Number The phone number of the supplier of the invoice. Accessor: `supplier_phone_number`\ Value Type: `string` Has a single value.
Customer Company Registration A list of company registration details including type and number, for the customer of the invoice. Accessor: `customer_company_registration` **Subfields** * **Number**\ The company registration number.\ Accessor: `number`\ Value Type: `string` * **Type**\ The type of the company registration number.\ Accessor: `type`\ Possible Values: `VAT`, `SIRET`, `SIREN`, `NIF`, `CF`, `UID`, `STNR`, `HRA_HRB`, `TIN`, `RFC`, `BTW`, `ABN`, `UEN`, `CVR`, `ORGNRO`, `INN`, `DPH`, `NIP`, `GSTIN`, `CRN`, `KVK`, `DIC`, `TAX_ID`, `CIF`, `GST_HST_CA`, `COC` Can have multiple values (is a list/array).
Supplier Company Registration A list of company registration details including type and number, for the supplier of the invoice. Accessor: `supplier_company_registration` **Subfields** * **Number**\ The company registration number.\ Accessor: `number`\ Value Type: `string` * **Type**\ The type of the company registration number.\ Accessor: `type`\ Possible Values: `VAT`, `SIRET`, `SIREN`, `NIF`, `CF`, `UID`, `STNR`, `HRA_HRB`, `TIN`, `RFC`, `BTW`, `ABN`, `UEN`, `CVR`, `ORGNRO`, `INN`, `DPH`, `NIP`, `GSTIN`, `CRN`, `KVK`, `DIC`, `TAX_ID`, `CIF`, `GST_HST_CA`, `COC` Can have multiple values (is a list/array).
Invoice Number The number of the invoice. Accessor: `invoice_number`\ Value Type: `string` Has a single value.
Date The date the invoice was issued. Accessor: `date`\ Value Type: `date` Has a single value.
Total Amount The final total amount paid, including all taxes and discounts. Accessor: `total_amount`\ Value Type: `number` Has a single value.
Total Net The total amount before taxes. Accessor: `total_net`\ Value Type: `number` Has a single value.
Total Tax The total amount of all taxes. Accessor: `total_tax`\ Value Type: `number` Has a single value.
Taxes A list of individual taxes applied, each including rate, base and amount. Accessor: `taxes` **Subfields** * **Rate**\ The tax rate of this tax as a decimal.\ Accessor: `rate`\ Value Type: `number` * **Base**\ The base amount on which this tax is computed.\ Accessor: `base`\ Value Type: `number` * **Amount**\ The computed tax amount for this tax.\ Accessor: `amount`\ Value Type: `number` Can have multiple values (is a list/array).
Line Items A list of line items in the invoice. Accessor: `line_items` **Subfields** * **Description**\ A description of the item or service.\ Accessor: `description`\ Value Type: `string` * **Quantity**\ The quantity of the item or service.\ Accessor: `quantity`\ Value Type: `number` * **Unit Price**\ The price per unit of the item or service.\ Accessor: `unit_price`\ Value Type: `number` * **Total Price**\ The total price for the line item: quantity \* unit price.\ Accessor: `total_price`\ Value Type: `number` * **Product Code**\ The product code of the item.\ Accessor: `product_code`\ Value Type: `string` * **Tax Amount**\ The tax amount of the item.\ Accessor: `tax_amount`\ Value Type: `number` * **Tax Rate**\ The tax rate of the item.\ Accessor: `tax_rate`\ Value Type: `number` * **Unit Measure**\ The unit of measure of the item.\ Accessor: `unit_measure`\ Value Type: `string` Can have multiple values (is a list/array).
Document Type Document type of the financial document. Accessor: `document_type`\ Possible Values: `invoice`, `payslip`, `quote`, `purchase_order`, `statement`, `receipt`, `credit_note`, `other_financial` Has a single value.
Locale The locale contains the language, country and currency of the invoice. Accessor: `locale` **Subfields** * **Language**\ The language of the invoice, ISO 639-1 language code.\ Accessor: `language`\ Value Type: `string` * **Country**\ The country of the invoice, ISO 3166-1 alpha-2.\ Accessor: `country`\ Value Type: `string` * **Currency**\ The currency in which is issued the invoice, ISO 4217.\ Accessor: `currency`\ Value Type: `string` Has a single value.
Customer Name The name of the customer of the invoice. Accessor: `customer_name`\ Value Type: `string` Has a single value.
Customer Address The full address of the customer and the breakdown of the address in components. Accessor: `customer_address` **Subfields** * **Address**\ The full raw address of the customer as written in the document.\ Accessor: `address`\ Value Type: `string` * **Street number**\ The street number of the address.\ Accessor: `street_number`\ Value Type: `string` * **Street Name**\ The street name of the address.\ Accessor: `street_name`\ Value Type: `string` * **PO Box**\ PO Box number, if there is one in the address.\ Accessor: `po_box`\ Value Type: `string` * **Address Complement**\ Address complement: floor, building, suite, ...\ Accessor: `address_complement`\ Value Type: `string` * **City**\ The city of the address.\ Accessor: `city`\ Value Type: `string` * **Postal Code**\ The postal code of the address.\ Accessor: `postal_code`\ Value Type: `string` * **State**\ The state / region / land of the address, if there is any.\ Accessor: `state`\ Value Type: `string` * **Country**\ The country of the address.\ Accessor: `country`\ Value Type: `string` Has a single value.
Shipping Address The full shipping address and the breakdown of the address in components. Accessor: `shipping_address` **Subfields** * **Address**\ The full raw shipping address as written in the document.\ Accessor: `address`\ Value Type: `string` * **Street number**\ The street number of the address.\ Accessor: `street_number`\ Value Type: `string` * **Street Name**\ The street name of the address.\ Accessor: `street_name`\ Value Type: `string` * **PO Box**\ PO Box number, if there is one in the address.\ Accessor: `po_box`\ Value Type: `string` * **Address Complement**\ Address complement: floor, building, suite, ...\ Accessor: `address_complement`\ Value Type: `string` * **City**\ The city of the address.\ Accessor: `city`\ Value Type: `string` * **Postal Code**\ The postal code of the address.\ Accessor: `postal_code`\ Value Type: `string` * **State**\ The state / region / land of the address, if there is any.\ Accessor: `state`\ Value Type: `string` * **Country**\ The country of the address.\ Accessor: `country`\ Value Type: `string` Has a single value.
Billing Address The full billing address and the breakdown of the address in components. Accessor: `billing_address` **Subfields** * **Address**\ The full full raw billing address as written in the document.\ Accessor: `address`\ Value Type: `string` * **Street number**\ The street number of the address.\ Accessor: `street_number`\ Value Type: `string` * **Street Name**\ The street name of the address.\ Accessor: `street_name`\ Value Type: `string` * **PO Box**\ PO Box number, if there is one in the address.\ Accessor: `po_box`\ Value Type: `string` * **Address Complement**\ Address complement: floor, building, suite, ...\ Accessor: `address_complement`\ Value Type: `string` * **City**\ The city of the address.\ Accessor: `city`\ Value Type: `string` * **Postal Code**\ The postal code of the address.\ Accessor: `postal_code`\ Value Type: `string` * **State**\ The state / region / land of the address, if there is any.\ Accessor: `state`\ Value Type: `string` * **Country**\ The country of the address.\ Accessor: `country`\ Value Type: `string` Has a single value.
Supplier Address The full address of the supplier and the breakdown of the address in components. Accessor: `supplier_address` **Subfields** * **Address**\ The full raw supplier address as written in the document.\ Accessor: `address`\ Value Type: `string` * **Street number**\ The street number of the address.\ Accessor: `street_number`\ Value Type: `string` * **Street Name**\ The street name of the address.\ Accessor: `street_name`\ Value Type: `string` * **PO Box**\ PO Box number, if there is one in the address.\ Accessor: `po_box`\ Value Type: `string` * **Address Complement**\ Address complement: floor, building, suite, ...\ Accessor: `address_complement`\ Value Type: `string` * **City**\ The city of the address.\ Accessor: `city`\ Value Type: `string` * **Postal Code**\ The postal code of the address.\ Accessor: `postal_code`\ Value Type: `string` * **State**\ The state / region / land of the address, if there is any.\ Accessor: `state`\ Value Type: `string` * **Country**\ The country of the address.\ Accessor: `country`\ Value Type: `string` Has a single value.
Due Date The date on which the invoice is due. Accessor: `due_date`\ Value Type: `date` Has a single value.
PO Number The purchase order number. Accessor: `po_number`\ Value Type: `string` Has a single value.
Reference Numbers List of all reference numbers on the invoice, including the purchase order number. Accessor: `reference_numbers`\ Value Type: `string` Can have multiple values (is a list/array).
Payment Date The date on which the payment is due / was full-filled. Accessor: `payment_date`\ Value Type: `date` Has a single value.
Supplier Payment Details List of payment details associated to the supplier of the invoice. Accessor: `supplier_payment_details` **Subfields** * **IBAN**\ The International Bank Account Number (IBAN).\ Accessor: `iban`\ Value Type: `string` * **SWIFT**\ The bank s SWIFT Business Identifier Code (BIC).\ Accessor: `swift`\ Value Type: `string` * **Account Number**\ The account number.\ Accessor: `account_number`\ Value Type: `string` * **Routing Number**\ The routing number.\ Accessor: `routing_number`\ Value Type: `string` Can have multiple values (is a list/array).
Supplier Website The website URL of the supplier or merchant. Accessor: `supplier_website`\ Value Type: `string` Has a single value.
Supplier Email The email address of the supplier or merchant. Accessor: `supplier_email`\ Value Type: `string` Has a single value.
Customer ID The customer account number or identifier from the supplier. Accessor: `customer_id`\ Value Type: `string` Has a single value.