05 — Otros documentos comerciales

Albaranes, pedidos y presupuestos siguen el mismo patrón que las facturas. Lo que cambia es el nombre del endpoint y el campo de relación. Si ya manejas el capítulo de facturas, esto es directo.

Para todo el detalle de campos y líneas, ver 04 — Facturas.

Tabla de equivalencias

Documento	Listar	Crear con líneas	Exportar
Factura cliente	GET /api/3/facturaclientes	POST /api/3/crearFacturaCliente	GET /api/3/exportarFacturaCliente/<id>
Factura proveedor	GET /api/3/facturaproveedores	POST /api/3/crearFacturaProveedor	GET /api/3/exportarFacturaProveedor/<id>
Albarán cliente	GET /api/3/albaranclientes	POST /api/3/crearAlbaranCliente	GET /api/3/exportarAlbaranCliente/<id>
Albarán proveedor	GET /api/3/albaranproveedores	POST /api/3/crearAlbaranProveedor	GET /api/3/exportarAlbaranProveedor/<id>
Pedido cliente	GET /api/3/pedidoclientes	POST /api/3/crearPedidoCliente	GET /api/3/exportarPedidoCliente/<id>
Pedido proveedor	GET /api/3/pedidoproveedores	POST /api/3/crearPedidoProveedor	GET /api/3/exportarPedidoProveedor/<id>
Presupuesto cliente	GET /api/3/presupuestoclientes	POST /api/3/crearPresupuestoCliente	GET /api/3/exportarPresupuestoCliente/<id>
Presupuesto proveedor	GET /api/3/presupuestoproveedores	POST /api/3/crearPresupuestoProveedor	GET /api/3/exportarPresupuestoProveedor/<id>

Campos comunes en el body de creación

Mismos campos que en facturas:

• codcliente (en versiones cliente) o codproveedor (en versiones proveedor)
• lineas (JSON string con las líneas)
• fecha, hora, codpago, codserie, direccion, ciudad, provincia, codpostal

Ejemplo: crear un presupuesto

curl https://miempresa.beply.es/api/3/crearPresupuestoCliente -H "Token: a1b2c3d4..." -d "codcliente=1" -d 'lineas=[{"referencia":"PROD-001","cantidad":10},{"descripcion":"Instalación","cantidad":1,"pvpunitario":200,"codimpuesto":"IVA21"}]' -d "codserie=PR"

Respuesta de éxito (HTTP 200)

Misma estructura que crearFacturaCliente: { doc, lines } con el documento creado y sus líneas.

{
  "doc": {
    "idpresupuesto": "1",
    "codigo": "PRE2026PR1",
    "codcliente": "1",
    "codserie": "PR",
    "fecha": "20-05-2026",
    "neto": 450,
    "totaliva": 94.5,
    "total": 544.5,
    "editable": true
  },
  "lines": [
    { "idlinea": 1, "referencia": "PROD-001", "cantidad": 10, "pvpunitario": 25, "pvptotal": 250, "iva": 21 },
    { "idlinea": 2, "descripcion": "Instalación", "cantidad": 1, "pvpunitario": 200, "pvptotal": 200, "iva": 21 }
  ]
}

Ejemplo: crear un pedido a partir de un presupuesto

Una vez aceptado el presupuesto por el cliente, puedes crear el pedido vinculando explícitamente con el campo idpresupuesto:

curl https://miempresa.beply.es/api/3/crearPedidoCliente \
  -H "Token: a1b2c3d4..." \
  -d "codcliente=1" \
  -d "idpresupuesto=1" \
  -d 'lineas=[{"referencia":"PROD-001","cantidad":10}]'

ℹ️ El nombre exacto del campo de enlace varía por documento: idpresupuesto en pedidoclientes, idpedido en albaranclientes, idalbaran en facturaclientes. Para descubrir el campo exacto en tu instancia, consulta GET /api/3/<recurso>/schema (ver 03 — CRUD básico → schema). Si no enlazas explícitamente, cada documento queda independiente — la API no encadena solo presupuesto → pedido → albarán → factura.

Flujo típico de venta por API

1. Presupuesto — POST crearPresupuestoCliente
2. Pedido (cuando el cliente acepta) — POST crearPedidoCliente
3. Albarán (al servir la mercancía) — POST crearAlbaranCliente
4. Factura (al cerrar la venta) — POST crearFacturaCliente
5. Cobro — POST pagarFacturaCliente/<id>

Cada paso puede hacerse independientemente — no hay obligación de pasar por todos. La factura se puede emitir directamente sin presupuesto/pedido/albarán previos.

Próximos pasos

• 06 — Archivos adjuntos: adjuntar PDFs/imágenes a cualquiera de estos documentos
• 07 — Errores y validaciones