The invoice printed with another template, as PDF or PNG
A ticket for the counter, an A4 for the email: the same invoice with another of your templates (or a shared one), stored apart. Its main PDF never changes. Asking again for the same template and format gives the same render. Answers at once with the render pending; follow it with GET /v1/invoices/{id}/renders/{render_id} or the event invoice.render_ready. On the live face your template prints its promoted version; on the test face, its latest published one.
POST
https://api.invox.page/v1/invoices/{id}/rendersAuthorization
Path parameters
Header parameters
Request body JSON required
Returns
200
The render was asked before and is already ready (or failed): it as it is, with its download_url once ready. Nothing to wait for.
JSON
202
The render, still being printed (asked now, or asked before and not finished). Retry-After says when to look.
JSON
400
organization_required: This credential needs to say which organization it acts on · validation_failed: The request is not valid · malformed_request: The request body is not valid JSON · idempotency_key_required: This write needs an Idempotency-Key header
JSON
401
unauthenticated: No credential was sent · invalid_credential: The credential is not valid
JSON
403
missing_scope: The credential lacks the permission this operation requires · organization_mismatch: The X-Organization header names another organization than the key's · organization_archived: The organization is archived
JSON
404
not_found: The resource does not exist in this organization · template_not_found: The template does not exist in this organization
JSON
409
file_not_ready: The file is not stored yet · template_archived: The template is archived · template_not_published: The template has no published version yet · template_version_not_promoted: The template has no version promoted to production
JSON
422
idempotency_key_reused: This Idempotency-Key was already used with a different request · template_document_type_not_accepted: The template does not accept this type of document
JSON
429
rate_limited: Too many requests
JSON
500
internal_error: The service failed
JSON
503
service_unavailable: The service cannot answer right now
JSON