erp Centro de Ayuda

API Endpoint: Ventas Cobros

Listar Cobros

• URL: /ventasCobros.list.json
• Método: GET
• Descripción: Obtiene una lista de todos los cobros registrados para la empresa.
• Parámetros (opcional):
  • mes: Filtra los cobros por el mes de registro (1-12).
  • ano: Filtra los cobros por el año de registro (yyyy).
  • fecha_ingreso_desde: Filtra los pagos por fecha ingreso >= .
  • fecha_ingreso_hasta: Filtra los pagos por fecha ingreso <= .
  • origen: Filtra los pagos por el origen (cp_origen).
  • compra_id: Filtra los pagos para una compra en especifico.

Crear Cobro

• URL: /ventasCobros.create.json
• Método: POST
• Descripción: Registra un nuevo cobro para un documento de venta específico.
• Parámetros (JSON Body):
  • tipoDte: Tipo de documento electrónico al que se aplica el cobro.
  • folio: Folio del documento de venta.
  • pagado: Monto pagado.
  • formaPago: ID de la forma de pago (opcional si se proporciona formaPagoCodigo).
  • formaPagoCodigo: Código de la forma de pago (prioritario sobre formaPago).
  • referenciaFormaPago: Referencia asociada a la forma de pago (por ejemplo, número de cheque o transferencia).
  • fechaPago: Fecha en que se realizó el pago (formato yyyy-mm-dd).

Ejemplo JSON : 

{
"tipoDte" : 33,
"folio" : 10519,
"pagado" : 1000,

"formaPago" : 152,
"formaPagoCodigo" : "",

"referenciaFormaPago" : "prueba api",
"fechaPago" : "2022-02-07"

}

Por este metodo NO SE PUEDE registrar pagos con cheques.

Posibles retornos de error:

 
- Monto pagado<=0.
- Monto pagado>importe a pagar.

Salida resultado:
array(
'id_dte' => $id del dte,
'id_pago' => $id_pago,
'error' => $error
);

Si $id_pago > 0 ese es el pago registrado en OBUMA y se actualiza el campo venta_total_pagado y venta_total_por_pagar