Marcar facturas como cobradas o pagadas y rectificarlas

Funciones pagarFacturaCliente, pagarFacturaProveedor y crearFacturaRectificativaCliente.

  • API versión 3
  • Plan Profesional, con la API activada
En esta página5 secciones
  1. Antes de empezar
  2. Marcar una factura de venta como cobrada
  3. Marcar una factura de compra como pagada
  4. Rectificar una factura de venta
  5. Comprueba el resultado

Antes de empezar

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

pagada boolean Obligatorio
1 o 0. Sin él: missing-pagada-parameter (HTTP 400).
fechapago string Opcional
Fecha del cobro, dd-mm-aaaa. Por defecto, la del recibo.
codpago string 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"

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

idfactura entero Obligatorio
Factura que se rectifica.
fecha string Obligatorio
dd-mm-aaaa. Sin ella: fecha field is required.
hora string 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 · observaciones string Opcional
Serie de la rectificativa (por defecto, la de la factura) y nota.
cURL
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.

Actualizado el 6 de noviembre de 2026

Captura ampliada

Abrir en otra pestaña

¿Te ha resultado útil esta página?

¿Aún tienes dudas?

Habla con nuestro equipo y te resolvemos cualquier duda al instante.