Documents and PDFs
Document lifecycle
Section titled “Document lifecycle”Invoice issuance and PDF generation are separate. The Worker creates document records and content hashes; clients list documents and download content through the environment-scoped API after authorization.
- Check the document state before requesting content.
- Use the document ID associated with the target invoice and environment.
- Alternative presentation templates do not reissue the invoice or alter fiscal data.
- Archived canonical documents and regenerated presentations have different semantics; do not assume regeneration overwrites the original.
- The API does not provide public, unauthenticated document URLs.
Access control
Section titled “Access control”The public document API requires an authorized environment credential with a suitable invoice/document read scope. The server validates the invoice, document, and tenant relationship before streaming bytes.