Durably request immutable PDF representations
Pins canonical and signed-XML sources plus explicit template/renderer versions. Generation is asynchronous and never changes fiscal document state. Admission is limited to factura 01 and boleta 03; a 07 or 08 note obtains its QR and representations from its own accepted or observed submission.
Pins canonical and signed-XML sources plus explicit template/renderer versions. Generation is asynchronous and never changes fiscal document state. Admission is limited to factura 01 and boleta 03; a 07 or 08 note obtains its QR and representations from its own accepted or observed submission.
Authorization
bearerAuth Tenant-bound, scoped and expiring Apifact credential. Migrated legacy credentials are accepted only on deprecated v1 writes and tenant-scoped v2 read, poll and download routes. Each operation names the single scope it requires in x-required-scope; the scope array of the security requirement itself is empty because OpenAPI 3.0 requires it to be for a non-oauth2 scheme.
In: header
Path Parameters
uuidHeader Parameters
1 <= length <= 200Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/v2/documents/497f6eca-6276-4993-bfeb-53cbbbba6f08/pdfs" \ -H "Idempotency-Key: b6a2f0e4-1c3d-4a5b-8e7f-9d0c1b2a3e4f" \ -H "Authorization: Bearer apf_v2_tu_credencial" \ -H "Content-Type: application/json" \ -d '{ "schemaVersion": "2.0", "outputs": [ { "kind": "pdf-a4", "templateVersion": "invoice-a4-v2" }, { "kind": "pdf-ticket", "templateVersion": "invoice-ticket-v1" } ] }'{ "schemaVersion": "2.0", "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6", "operationId": "3051932a-fdd2-48fa-b330-7e7d41535969", "resourceId": "026d60bb-63a8-407e-bf67-01dcfc6022e6", "state": "RECEIVED", "status": "PENDING", "replay": true, "representations": [ { "representationId": "a9b73a9c-9bfc-4552-8caa-c8f5de61ac57", "kind": "pdf-a4", "version": 1, "status": "PENDING", "templateVersion": "invoice-a4-v2", "rendererVersion": "browser-run-a4-v1", "mediaType": "application/pdf", "byteSize": 0, "sha256": "string", "readyAt": "2019-08-24T14:15:22Z", "downloadPath": "string" } ]}Accept the proposal and generate the registry POST POST
THE IRREVERSIBLE HALF. It accepts the proposal and registers the preliminary, which is a tax act on this taxpayer's period. There is no inverse operation, exactly as there is none for promoting a company to production. WHAT HAPPENS WHEN IT CANNOT BE ESTABLISHED WHETHER SUNAT APPLIED IT. The period lands AMBIGUOUS and stops. That is not a failure to retry past: retrying could generate the registry twice, and this API has no route that withdraws one. A subsequent call answers 409 SIRE_PERIOD_AMBIGUOUS and a person decides. A refusal WITH a SUNAT code is different — that is SUNAT saying no, the period lands FAILED with the code kept, and the next call may try again. NO Idempotency-Key, and it is not needed: the durable instance is keyed on the period's own operation id, so two callers asking to generate the same period get one run. SIRE HAS NO TEST ENVIRONMENT. There is no beta in which to rehearse this call. The first time it runs, it runs against a real taxpayer's real month.
List public artifacts for a tenant-owned document GET GET
Returns safe metadata only. Internal object keys, HTML render inputs and unsigned XML are never exposed.