Vouchers

Manage payment receipts and vouchers.

Payment receipts/vouchers received from customers.

Dependency: Requires Customers to be uploaded first.

Endpoint

POST /full-csv-integration/upload-vouchers

Form Field: vouchersFile

Required Fields

Field	Type	Description	Validations
`erp_voucher_id`	String	Voucher ID in ERP	Cannot be empty
`voucher_date`	Date	Voucher date	If it carries a value it must be `YYYY-MM-DD`; other formats are rejected. An empty cell is accepted and the date is left empty
`erp_customer_id`	String	Customer ID in ERP	Cannot be empty. Must exist in Customers — see below

Optional Fields

Field	Type	Description	Default
`total_amount`	Float	Total voucher amount. If sent, it must be a number greater than 0	null
`erp_source_document_id`	String	Accounting document that groups one or more vouchers; used by the Voucher Breakdown. If you omit the column or leave the cell empty, the voucher’s own `erp_voucher_id` is stored, also when updating a voucher that had another document	`erp_voucher_id`

Repeated rows and dropped rows

If the same erp_voucher_id appears in several rows, the last one is kept.
Rows whose erp_customer_id does not exist in Customers are dropped while the file is processed, and this is not reflected in the response, which had already confirmed the upload. If no customer in the file exists, nothing is processed.

Example CSV

erp_voucher_id,voucher_date,erp_customer_id,total_amount,erp_source_document_id
VCH001,2024-02-10,CUST001,1000000.00,DOC001
VCH002,2024-02-12,CUST002,500000.00,
VCH003,2024-02-15,CUST001,,