跳到正文

公共 API:curl 示例(商品、订单和票据)

可直接复制的请求:列出商品和库存、新建客户和订单、读取发票及其 PDF。

示例中,把 https://your-erp.example.com 换成你的 ERP 地址,把 bzk_你的密钥 换成你的密钥。

商品和库存

  • 商品(每页 50 个):curl -H "Authorization: Bearer bzk_你的密钥" https://your-erp.example.com/api/v1/public/v1/products
  • 只取某个时间之后有变化的:curl -H "Authorization: Bearer bzk_你的密钥" "https://your-erp.example.com/api/v1/public/v1/products?updatedSince=2026-11-14T00:00:00Z"
  • 库存:curl -H "Authorization: Bearer bzk_你的密钥" https://your-erp.example.com/api/v1/public/v1/stock

每个商品的 price 按店铺的价格模式(priceIncludesTax),另外按其 taxRate 给出 priceNet 和 priceGross。库存里的 sellable 是现在可以卖的数量(和收银台、网店用的是同一个数)。

新建客户

  • curl -X POST -H "Authorization: Bearer bzk_你的密钥" -H "Idempotency-Key: customer-B12345674" -H "Content-Type: application/json" -d '{"name":"Ferretería López SL","taxId":"B12345674","email":"compras@ferreterialopez.es"}' https://your-erp.example.com/api/v1/public/v1/customers

每个税号只有一个客户:已存在时返回 409 CUSTOMER_NIF_EXISTS。用 GET /customers?taxId=B12345674 查找。

新建订单

  • curl -X POST -H "Authorization: Bearer bzk_你的密钥" -H "Idempotency-Key: web-10023" -H "Content-Type: application/json" -d '{"customerId":"客户ID","reference":"WEB-10023","lines":[{"productId":"商品ID","quantity":2}]}' https://your-erp.example.com/api/v1/public/v1/orders

不需要发送价格:BizQ 按店铺给该客户的价格(价目表、阶梯价、促销和客户折扣)以及每个商品的增值税计算。订单在店里显示为挂单并锁定库存;店铺确认、收款并照常开小票、发票或 Albarán。商品有变体时请指定 variantId。

票据

  • 发票和小票:curl -H "Authorization: Bearer bzk_你的密钥" https://your-erp.example.com/api/v1/public/v1/invoices
  • 发票 PDF:curl -H "Authorization: Bearer bzk_你的密钥" -o invoice.pdf https://your-erp.example.com/api/v1/public/v1/invoices/发票ID/pdf
  • Albarán:curl -H "Authorization: Bearer bzk_你的密钥" https://your-erp.example.com/api/v1/public/v1/albaranes

已收和待收的金额来自票据:请用每张发票、小票或 Albarán 的 pendingAmount。订单总额是业务记录,不是已收到的钱。

返回帮助中心