Skip to main content
POST
Crear documento programado

Qué hace

  • Crea un nuevo documento programado que se ejecutará automáticamente según la frecuencia especificada
  • Permite definir la frecuencia de ejecución (diaria, semanal, mensual, trimestral)
  • Configura automáticamente la próxima ejecución según la frecuencia
  • Busca o crea automáticamente el receptor si no existe
  • Establece el estado inicial del documento programado (activo o inactivo)

Ejemplos de uso

  • Crear facturas recurrentes mensuales a clientes específicos
  • Programar servicios de suscripción que se facturen automáticamente
  • Automatizar facturación de servicios periódicos (consulta, mantenimiento, etc.)
  • Configurar facturas trimestrales para reportes o servicios continuos
  • Establecer documentos programados que se ejecuten diariamente

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)

Body

application/json

Datos del documento programado a crear

sender
integer
required

ID de la entidad maestra emisora (obligatorio)

Example:

123

dte_type
string
required

Código del tipo de DTE (ej: '33' para Factura Electrónica)

Example:

"33"

receiver_tax_id
string
required

RUT del receptor (formato: 12345678-9). El sistema buscará un cliente existente con este RUT. Si no existe, creará uno nuevo automáticamente. Campo requerido.

Example:

"12345678-9"

frequency
enum<string>
required

Frecuencia de ejecución del documento programado. Valores: 'daily' (diario), 'weekly' (semanal), 'monthly' (mensual), 'quarterly' (trimestral), 'semiannual' (semestral), 'yearly' (anual).

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

"monthly"

details
object[]
required

Detalles/productos del documento

Minimum array length: 1
day_of_month
integer

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.

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

15

day_of_week
integer

Día de la semana en que se ejecutará el documento (1=Lunes, 2=Martes, 3=Miércoles, 4=Jueves, 5=Viernes, 6=Sábado, 7=Domingo). Requerido para frecuencia semanal (weekly).

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

1

start_date
string<date>

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. Si la fecha calculada cae en fin de semana o feriado, se ajusta según esta opción: 'none' (sin ajuste, emite en la fecha calculada aunque sea fin de semana), 'next' (ajusta al próximo día hábil), 'previous' (ajusta al anterior día hábil). Por defecto: 'none'.

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>

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"

currency
enum<string>
default:CLP

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 (UF o USD). Si no se indica, se usa el día de emisión.

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

10

references
object[]

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

Maximum array length: 3
status
enum<string>
default:active

Estado inicial del documento programado

Available options:
active,
inactive
Example:

"active"

max_occurrences
integer

Número máximo de ejecuciones (opcional, null = infinito). Solo aplica si end_type es 'after_occurrences'.

Required range: x >= 1
Example:

12

Response

Documento programado creado 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"