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
| Documento | Crear (POST) | Descargar (GET) | Recurso de datos |
|---|---|---|---|
| Presupuesto de cliente | crearPresupuestoCliente | exportarPresupuestoCliente/<id> | presupuestoclientes |
| Pedido de cliente | crearPedidoCliente | exportarPedidoCliente/<id> | pedidoclientes |
| Albarán de cliente | crearAlbaranCliente | exportarAlbaranCliente/<id> | albaranclientes |
| Presupuesto de proveedor | crearPresupuestoProveedor | exportarPresupuestoProveedor/<id> | presupuestoproveedores |
| Pedido a proveedor | crearPedidoProveedor | exportarPedidoProveedor/<id> | pedidoproveedores |
| Albarán de proveedor | crearAlbaranProveedor | exportarAlbaranProveedor/<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.