POST
/businesses/{bid}/documents/{id}/previewPreview a draft as PDF
POST /businesses/{bid}/documents/{id}/preview
Requires the documents scope.
The draft rendered as a "טיוטה"-watermarked PDF so your user sees exactly what they are about to issue. Nothing is recorded and no number is consumed. Drafts only. branding and contact stand in for what the page prints, for an editor that shows a look before it is saved.
Path parameters
| Name | Type | Description | |
|---|---|---|---|
bid | string | required | Business id, from POST /businesses. |
id | string | required | Document id. |
Body (optional)
| Field | Type | Description | |
|---|---|---|---|
branding | Branding | Appearance of the rendered PDF. Stored once per business; a logo is stored as a file and referenced by hash, never re-frozen into each document. | |
contact | object | The phone and email to print in this render; an empty value prints the business's own. | |
contact.phone | string | ||
contact.email | string |
Response
200: raw application/pdf bytes.
Errors: 400, 401, 403, 404, 409, 429. Every failure answers { "error", "reason", "hint", "param", "doc_url", "retryable", "request_id" }: branch on reason, and read hint for what to change (https://docs.billos.co.il/errors.md).