Skip to main content
GET
Obtener documento programado

Qué hace

  • Obtiene los detalles completos de un documento programado específico
  • Muestra toda la información de configuración del documento programado
  • Incluye información del emisor, receptor, frecuencia, próxima ejecución
  • Proporciona el estado actual y el número de ejecuciones completadas
  • Muestra todos los detalles de productos/servicios del documento

Ejemplos de uso

  • Consultar los detalles de un documento programado específico
  • Verificar la próxima fecha de ejecución de un documento
  • Revisar la configuración de un documento programado antes de actualizarlo
  • Consultar cuántas veces se ha ejecutado un documento programado
  • Verificar el estado actual (activo, inactivo, completado)

Endpoints relacionados

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 documento programado

Example:

789

Query Parameters

master_entity_id
integer
required

ID de la entidad maestra

Example:

123

Response

Documento programado obtenido exitosamente

id
integer

ID único del documento programado

Example:

789

sender
object

Información de la entidad emisora

receiver
object | null

Información de la entidad receptora

dte_type
object

Tipo de documento tributario

frequency
enum<string>

Frecuencia de ejecución

Available options:
daily,
weekly,
monthly,
quarterly,
semiannual,
yearly
Example:

"monthly"

frequency_display
string

Frecuencia en formato legible

Example:

"Mensual"

day_of_month
integer | null

Día del mes en que se ejecutará el documento (1-31). Requerido para frecuencias: monthly, quarterly, semiannual, yearly. Si el día no existe en un mes (ej: 31 en febrero), se usará el último día del mes.

Example:

15

day_of_week
integer | null

Día de la semana para ejecución (1=Lunes, 7=Domingo)

Example:

null

next_execution
string<date-time>

Fecha y hora de la próxima ejecución

Example:

"2024-02-15T10:00:00Z"

status
enum<string>

Estado del documento programado

Available options:
active,
inactive,
completed
Example:

"active"

status_display
string

Estado en formato legible

Example:

"Activo"

amount
number

Monto del documento

Example:

100000

currency
enum<string>

Moneda del documento

Available options:
CLP,
UF,
USD,
EUR
Example:

"CLP"

currency_day
integer | null

Día del mes (1-31) para tomar el valor del tipo de cambio. Aplica cuando la moneda es UF o USD; si no se indica, se usa el día de emisión.

Required range: 1 <= x <= 31
Example:

10

completed_occurrences
integer

Número de veces que se ha ejecutado

Example:

5

max_occurrences
integer | null

Número máximo de ejecuciones

Example:

null

start_date
string<date> | null

Fecha de inicio de la programación (YYYY-MM-DD). Define desde cuándo comenzará a ejecutarse el documento programado. Si no se proporciona, se usa la fecha actual. La primera ejecución será calculada a partir de esta fecha según la frecuencia configurada.

Example:

"2024-02-01"

emission_day_adjustment
enum<string>
default:none

Ajuste de fecha de emisión a días hábiles: 'none' (sin ajuste), 'next' (próximo día hábil), 'previous' (anterior día hábil)

Available options:
none,
next,
previous
Example:

"none"

end_type
enum<string>
default:never

Tipo de finalización de la programación: 'never' (nunca finaliza, se ejecuta indefinidamente), 'on_date' (finaliza en una fecha específica, requiere end_date), 'after_occurrences' (finaliza después de un número máximo de ejecuciones, requiere max_occurrences). Por defecto: 'never'.

Available options:
never,
on_date,
after_occurrences
Example:

"never"

end_date
string<date> | null

Fecha de finalización de la programación (YYYY-MM-DD). Solo aplica y es requerido si end_type es 'on_date'. El documento programado dejará de ejecutarse después de esta fecha.

Example:

"2024-12-31"

details
object[]

Detalles/productos del documento

references
object[]

Referencias a documentos (ej. factura anulada por nota de crédito). Máximo 3 referencias.

Maximum array length: 3
created_at
string<date-time>

Fecha de creación

Example:

"2024-01-15T10:00:00Z"

updated_at
string<date-time>

Fecha de última actualización

Example:

"2024-01-20T15:30:00Z"