Skip to main content
GET
Consultar un pedido y retirar el CAF

Authorizations

Authorization
string
header
required

API Key para autenticación. Debe proporcionarse en el header Authorization con el formato: 'Api-Key YOUR-API-KEY' (incluye el prefijo 'Api-Key ' seguido de tu API key)

Path Parameters

id
integer
required

ID del pedido de timbraje.

Response

Pedido encontrado

Pedido de timbraje de folios ante el SII.

id
string
Example:

"fir_8d4a2f7c1e9b5"

dte_type
integer

Tipo de documento timbrado.

Example:

33

status
enum<string>

authorized_without_caf significa que el SII autorizó el rango y no entregó el archivo: esos folios ya salieron de tu stock.

Available options:
pending,
processing,
completed,
failed,
authorized_without_caf
Example:

"completed"

requested_quantity
integer

Folios que pediste.

Example:

50

granted_quantity
integer | null

Folios que el SII autorizó. Puede ser menor al pedido: el tope por solicitud lo pone el SII y sube con el uso.

Example:

50

partially_granted
boolean

true cuando el SII entregó menos folios de los que pediste. Es un desenlace normal: el tope por solicitud lo fija el SII y sube con el uso de la empresa.

Example:

true

sii_max_per_request
integer | null

Tope por solicitud que el SII publicó al hacer este trámite: el motivo por el que se entregó menos de lo pedido.

Example:

9

folio_start
integer | null
Example:

539

folio_end
integer | null
Example:

588

caf_xml
string | null

CAF entregado por el SII. Contiene la llave privada con la que se firman tus DTE: trátalo como secreto. Es null hasta que el pedido queda completed.

Example:

"<AUTORIZACION><CAF version=\"1.0\">…</CAF></AUTORIZACION>"

idempotency_key
string

La clave que enviaste al crear el pedido.

Example:

"pedido-facturas-2026-08-27-01"

error
string

Motivo del SII cuando el pedido no terminó bien.

Example:

""

created_at
string<date-time>
Example:

"2026-08-27T14:30:00Z"

completed_at
string<date-time> | null
Example:

"2026-08-27T14:32:11Z"

sii_environment
enum<string>

Ambiente del SII en el que se hizo la operación. Un CAF de certification NO sirve para emitir.

Available options:
production,
certification
error_code
enum<string>

Vocabulario cerrado del desenlace fallido; vacío si no hubo error. Ver la página de códigos de error.

Available options:
,
certification_not_enabled,
missing_certificate,
no_folios_authorized,
sii_unavailable,
sii_unrecognized_page