Marcar facturas como cobradas o pagadas y rectificarlas
Funciones pagarFacturaCliente, pagarFacturaProveedor y crearFacturaRectificativaCliente.
En esta página5 secciones
Antes de empezar
- Una clave con permiso POST sobre la función que uses. Habilitar la API y gestionar sus claves de acceso
- El
idfacturade la factura, devuelto al crearla o sacado defacturaclientes.
Marcar una factura de venta como cobrada
POST/api/3/pagarFacturaCliente/{idfactura}
pagada=1 marca como pagados todos sus recibos; pagada=0 los deja pendientes. Si la factura ya está en ese estado responde «Sin cambios» y no modifica nada, así que repetir es seguro.
Para cobros parciales usa el programa: Registrar un cobro parcial.
Parámetros
-
pagadaboolean Obligatorio 1o0. Sin él:missing-pagada-parameter(HTTP 400).-
fechapagostring Opcional - Fecha del cobro,
dd-mm-aaaa. Por defecto, la del recibo. -
codpagostring Opcional - Forma de pago del cobro.
curl -s -X POST "$BEPLY_URL/api/3/pagarFacturaCliente/123" \
-H "X-Auth-Token: $BEPLY_TOKEN" \
--data-urlencode "pagada=1" \
--data-urlencode "fechapago=20-01-2026"{
"ok": "Registro actualizado correctamente.",
"data": { … }
}Marcar una factura de compra como pagada
POST/api/3/pagarFacturaProveedor/{idfactura}
Mismos parámetros que la de venta. Si no existe la factura responde invoice-not-found (HTTP 404).
Rectificar una factura de venta
POST/api/3/crearFacturaRectificativaCliente
idfactura y fecha son obligatorios; envía también hora. Sin más campos se devuelven todas las cantidades; para devolver parte de una línea envía refund_{idlinea}={cantidad}.
Una factura emitida no se borra para «deshacerla»: se rectifica. La API no tiene rectificativa de compra.
Parámetros
-
idfacturaentero Obligatorio - Factura que se rectifica.
-
fechastring Obligatorio dd-mm-aaaa. Sin ella:fecha field is required.-
horastring Opcional hh:mm:ss.-
refund_{idlinea}número Opcional - Cantidad a devolver de esa línea. Si no envías ninguna, se devuelve todo.
-
codserie · observacionesstring Opcional - Serie de la rectificativa (por defecto, la de la factura) y nota.
curl -s -X POST "$BEPLY_URL/api/3/crearFacturaRectificativaCliente" \
-H "X-Auth-Token: $BEPLY_TOKEN" \
--data-urlencode "idfactura=123" \
--data-urlencode "fecha=25-01-2026" \
--data-urlencode "hora=12:00:00"Comprueba el resultado
En el programa, la factura aparece pagada y su recibo con la fecha de cobro; la rectificativa queda enlazada a la factura original con importes en negativo.