API pública: ejemplos con curl (productos, pedidos y documentos)
Peticiones listas para copiar: listar productos y existencias, crear un cliente y un pedido, y leer facturas con su PDF.
En los ejemplos, cambia https://tu-erp.example.com por la dirección de tu ERP y bzk_TU_CLAVE por tu clave.
Productos y existencias
- Productos (50 por página):
curl -H "Authorization: Bearer bzk_TU_CLAVE" https://tu-erp.example.com/api/v1/public/v1/products - Solo los que cambiaron desde una fecha:
curl -H "Authorization: Bearer bzk_TU_CLAVE" "https://tu-erp.example.com/api/v1/public/v1/products?updatedSince=2026-11-14T00:00:00Z" - Existencias:
curl -H "Authorization: Bearer bzk_TU_CLAVE" https://tu-erp.example.com/api/v1/public/v1/stock
Cada producto trae price en el modo de precios de la tienda (priceIncludesTax), y además priceNet y priceGross calculados con su taxRate. En existencias, sellable es lo que se puede vender ahora (la misma cifra que el TPV y la tienda online).
Crear un cliente
curl -X POST -H "Authorization: Bearer bzk_TU_CLAVE" -H "Idempotency-Key: cliente-B12345674" -H "Content-Type: application/json" -d '{"name":"Ferretería López SL","taxId":"B12345674","email":"compras@ferreterialopez.es"}' https://tu-erp.example.com/api/v1/public/v1/customers
Hay un solo cliente por NIF: si ya existe, recibes 409 CUSTOMER_NIF_EXISTS. Búscalo con GET /customers?taxId=B12345674.
Crear un pedido
curl -X POST -H "Authorization: Bearer bzk_TU_CLAVE" -H "Idempotency-Key: web-10023" -H "Content-Type: application/json" -d '{"customerId":"ID_DEL_CLIENTE","reference":"WEB-10023","lines":[{"productId":"ID_DEL_PRODUCTO","quantity":2}]}' https://tu-erp.example.com/api/v1/public/v1/orders
No se envían precios: BizQ aplica los precios de la tienda para ese cliente (tarifas, tramos, promociones y su descuento) y el IVA de cada producto. El pedido aparece en la tienda como venta aparcada y reserva el stock; la tienda lo confirma, lo cobra y emite el ticket, la factura o el albarán como siempre. Si el producto tiene variantes, indica variantId.
Documentos
- Facturas y tickets:
curl -H "Authorization: Bearer bzk_TU_CLAVE" https://tu-erp.example.com/api/v1/public/v1/invoices - PDF de una factura:
curl -H "Authorization: Bearer bzk_TU_CLAVE" -o factura.pdf https://tu-erp.example.com/api/v1/public/v1/invoices/ID_DE_LA_FACTURA/pdf - Albaranes:
curl -H "Authorization: Bearer bzk_TU_CLAVE" https://tu-erp.example.com/api/v1/public/v1/albaranes
Lo cobrado y lo pendiente salen de los documentos: usa pendingAmount de cada factura, ticket o albarán. El total de un pedido es el dato del negocio, no lo que se ha cobrado.