Comprobantes
Administra recibos de pago y comprobantes.
Recibos de pago/comprobantes recibidos de los clientes.
Dependencia: Requiere cargar Clientes primero.
Endpoint
POST /full-csv-integration/upload-vouchers
- Campo de Formulario:
vouchersFile
Campos Requeridos
| Campo | Tipo | Descripción | Validaciones |
|---|---|---|---|
erp_voucher_id | String | ID del comprobante en ERP | No puede estar vacío |
voucher_date | Date | Fecha del comprobante | Si trae valor debe ser YYYY-MM-DD; otros formatos se rechazan. Una celda vacía se acepta y la fecha queda vacía |
erp_customer_id | String | ID del cliente en ERP | No puede estar vacío. Debe existir en Clientes — ver más abajo |
Campos Opcionales
| Campo | Tipo | Descripción | Por Defecto |
|---|---|---|---|
total_amount | Float | Monto total del comprobante. Si se envía, debe ser un número mayor a 0 | null |
erp_source_document_id | String | Documento contable que agrupa uno o varios comprobantes; lo usan los Renglones de los comprobantes. Si omites la columna o dejas la celda vacía, se guarda el propio erp_voucher_id, también al actualizar un comprobante que ya tenía otro documento | erp_voucher_id |
Filas repetidas y filas descartadas
- Si el mismo
erp_voucher_idaparece en varias filas, se conserva la última. - Las filas cuyo
erp_customer_idno exista en Clientes se descartan al procesar el archivo, y eso no se refleja en la respuesta, que ya confirmó la carga. Si ningún cliente del archivo existe, no se procesa nada.
Ejemplo 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,,