Desarrolladores: integrar tu software con la API de Beply

Otros documentos

Documentos relacionados con ventas y compras más allá de facturas.

Actualizado el 22 de octubre de 2026

Crear presupuestos, pedidos y albaranes con la API

Los presupuestos, pedidos y albaranes de cliente o proveedor se crean con funciones equivalentes a crearFacturaCliente: mismos campos y mismas reglas.

Aplicabilidad: API versión 3 · Plan Profesional, con la API activada en el servicio.

Funciones y recursos

DocumentoCrear (POST)Descargar (GET)Recurso de datos
Presupuesto de clientecrearPresupuestoClienteexportarPresupuestoCliente/<id>presupuestoclientes
Pedido de clientecrearPedidoClienteexportarPedidoCliente/<id>pedidoclientes
Albarán de clientecrearAlbaranClienteexportarAlbaranCliente/<id>albaranclientes
Presupuesto de proveedorcrearPresupuestoProveedorexportarPresupuestoProveedor/<id>presupuestoproveedores
Pedido a proveedorcrearPedidoProveedorexportarPedidoProveedor/<id>pedidoproveedores
Albarán de proveedorcrearAlbaranProveedorexportarAlbaranProveedor/<id>albaranproveedores

En venta el campo obligatorio es codcliente; en compra, codproveedor. El resto de campos (lineas, fecha, codalmacen…) es igual que en Crear la factura.

Ejemplo: pedido de cliente

curl -s -X POST "$BEPLY_URL/api/3/crearPedidoCliente" -H "Token: $BEPLY_TOKEN" \
  --data-urlencode "codcliente=<CODCLIENTE>" \
  --data-urlencode 'lineas=[{"referencia":"<REFERENCIA>","cantidad":3}]'

Respuesta: {"doc": {…}, "lines": [ … ]}. El efecto del documento en stock depende de su estado, igual que en pantalla: consulta Entender por qué cambian las existencias.

Cuándo usar el CRUD de documentos

  • Consultar documentos o cambiar campos de cabecera sin líneas: recurso de datos (PUT /api/3/pedidoclientes/<id>).
  • Crear un documento con líneas y totales: función crear…. Crear cabecera y líneas por separado con el CRUD no recalcula totales.
  • Convertir un documento en el siguiente (pedido → albarán → factura): hazlo en el programa (Generar el siguiente documento de una venta); la API v3 del programa no tiene una función de conversión.

Si algo falla

codproveedor field is required / supplier-not-found en compras; el resto de errores coincide con Facturas. Cada llamada a crear… crea un documento nuevo: comprueba si existe antes de repetir una petición cortada.

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.