Create a new or update existing Invoices entries. | Gappify

Create a new or update existing Invoices entries with the provided data.

Required Fields Summary

Field	Type	Description
`source_system_id`	string	Unique identifier of the invoice in the ERP system
`vendor_id`	string	Id of the Vendor/Supplier
`invoice_number`	string	Invoice number
`invoice_date`	date	Date the invoice was issued by the vendor. Format: yyyy-mm-dd
`currency_id`	string	Transactional currency id
`invoice_amount`	double	Invoice or Invoice line amount

Insights Module

If using the Insights Module, the following fields are also required:

po_id
period
subsidiary_debit_id
department_debit_id

⚠️ Important: The period field must follow the format yyyy-mm-01 (e.g., 2026-03-01).

Unapproved / Late Invoices

For unapproved or late invoices, the following fields are also required:

invoice_line_id
invoice_date_created

Create a new or update existing Invoices entries with the provided data. ## Required Fields Summary | Field | Type | Description | |-------|------|-------------| | `source_system_id` | string | Unique identifier of the invoice in the ERP system | | `vendor_id` | string | Id of the Vendor/Supplier | | `invoice_number` | string | Invoice number | | `invoice_date` | date | Date the invoice was issued by the vendor. Format: yyyy-mm-dd | | `currency_id` | string | Transactional currency id | | `invoice_amount` | double | Invoice or Invoice line amount | <Note title="Insights Module"> If using the **Insights Module**, the following fields are also required: - `po_id` - `period` - `subsidiary_debit_id` - `department_debit_id` ⚠️ **Important:** The `period` field must follow the format `yyyy-mm-01` (e.g., `2026-03-01`). </Note> <Note title="Unapproved / Late Invoices"> For **unapproved or late invoices**, the following fields are also required: - `invoice_line_id` - `invoice_date_created` </Note>

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects a list of objects.

source_system_idstringRequired

Unique identifier of the invoice in the ERP system. This value will be used to match source data and perform upserts.

vendor_idstringRequired

Id of the Vendor/Supplier. This value should match the source_vendors->g_source_system_id which will be used to send back as part of JE to ERP.

invoice_numberstringRequired

Invoice number.

invoice_datedateRequired

Date the invoice was issued by the vendor. Format: yyyy-mm-dd.

currency_idstringRequired

Transactional currency id of the invoice. This value should match the g_source_system_id in source_coas.

invoice_amountdoubleRequired

Invoice or Invoice line amount.

invoice_typestringOptional

Type of invoice.

invoice_line_idstringOptional

Id of the invoice line.

invoice_date_createddatetimeOptional

This is the date and time when the invoice is created in the source system.

po_idstringOptional

Id of the PO linked to the invoice.

memostringOptional

Invoice header memo.

created_bystringOptional

last_modified_bystringOptional

periodstringOptional

Period representation of the invoice.
Format: yyyy-mm-01 (e.g., 2026-03-01).’

subsidiary_debit_idstringOptional

Subsidiary id linked to the invoice. This value should match the g_source_system_id in source_coas.

itemstringOptional

item_idstringOptional

glaccount_debit_idstringOptional

GLAccount debit id linked to the invoice. This value should match the g_source_system_id in source_coas.

glaccount_credit_idstringOptional

GLAccount credit id linked to the invoice. This value should match the g_source_system_id in source_coas.

department_debit_idstringOptional

Department/Cost Center debit id linked to the invoice. This value should match the g_source_system_id in source_coas.

department_credit_idstringOptional

Department/Cost Center credit id linked to the invoice. This value should match the g_source_system_id in source_coas.

product_debit_idstringOptional

Product debit id linked to the invoice. This value should match the g_source_system_id in source_coas.

product_credit_idstringOptional

Product credit id linked to the invoice. This value should match the g_source_system_id in source_coas.

location_debit_idstringOptional

Location debit id linked to the invoice. This value should match the g_source_system_id in source_coas.

location_credit_idstringOptional

Location credit id linked to the invoice. This value should match the g_source_system_id in source_coas.

class_debit_idstringOptional

Class debit id linked to the invoice. This value should match the g_source_system_id in source_coas.

class_credit_idstringOptional

Class credit id linked to the invoice. This value should match the g_source_system_id in source_coas.

project_debit_idstringOptional

Project debit id linked to the invoice. This value should match the g_source_system_id in source_coas.

project_credit_idstringOptional

Project credit id linked to the invoice. This value should match the g_source_system_id in source_coas.

invoice_memostringOptional

Description of the invoice or invoice line where applicable.

statusstringOptional

Status of the invoice or invoice line.

start_datedateOptional

Start date of the invoice or invoice line if applicable.

end_datedateOptional

End date of the invoice or invoice line if applicable.

invoice_quantitydoubleOptional

Quantity based value of the invoice or invoice line if applicable.

exchange_ratedoubleOptional

channel_debit_idstringOptional

Channel debit id linked to the invoice. This value should match the g_source_system_id in source_coas.

channel_credit_idstringOptional

Channel credit id linked to the invoice. This value should match the g_source_system_id in source_coas.

region_debit_idstringOptional

Region debit id linked to the invoice. This value should match the g_source_system_id in source_coas.

region_credit_idstringOptional

Region credit id linked to the invoice. This value should match the g_source_system_id in source_coas.

company_debit_idstringOptional

Company debit id linked to the invoice. This value should match the g_source_system_id in source_coas.

company_credit_idstringOptional

Company credit id linked to the invoice. This value should match the g_source_system_id in source_coas.

intercompany_debit_idstringOptional

Intercompay debit id linked to the invoice. This value should match the g_source_system_id in source_coas.

intercompany_credit_idstringOptional

Intercompay credit id linked to the invoice. This value should match the g_source_system_id in source_coas.

po_numberstringOptional

PO number linked to the invoice.

po_line_idstringOptional

Line Id of the PO linked to the invoice.

custom_text_1stringOptional

User-defined custom text field

custom_text_2stringOptional

User-defined custom text field

custom_text_3stringOptional

User-defined custom text field

custom_text_4stringOptional

User-defined custom text field

custom_text_5stringOptional

User-defined custom text field

custom_date_1dateOptional

User-defined custom date field

custom_date_2dateOptional

User-defined custom date field

custom_date_3dateOptional

User-defined custom date field

custom_date_4dateOptional

User-defined custom date field

custom_date_5dateOptional

User-defined custom date field

custom_numeric_1doubleOptional