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

FieldTypeDescriptionValidations
erp_voucher_idStringVoucher ID in ERPCannot be empty
voucher_dateDateVoucher dateIf 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_idStringCustomer ID in ERPCannot be empty. Must exist in Customers — see below

Optional Fields

FieldTypeDescriptionDefault
total_amountFloatTotal voucher amount. If sent, it must be a number greater than 0null

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
VCH001,2024-02-10,CUST001,1000000.00
VCH002,2024-02-12,CUST002,500000.00
VCH003,2024-02-15,CUST001,