Skip to main content
GET
/
scheduled-documents
/
{id}
Obtener documento programado
curl --request GET \
  --url https://api.tupana.ai/v1/scheduled-documents/{id} \
  --header 'Authorization: <api-key>'
{
  "id": 789,
  "sender": {
    "id": 123,
    "name": "Empresa Ejemplo SpA",
    "rut": "76543210-1"
  },
  "receiver": {
    "id": 456,
    "name": "Cliente ABC Ltda",
    "rut": "12345678-9"
  },
  "dte_type": {
    "id": 1,
    "code": "33",
    "description": "Factura Electrónica"
  },
  "frequency": "monthly",
  "frequency_display": "Mensual",
  "day_of_month": 15,
  "day_of_week": null,
  "next_execution": "2024-02-15T10:00:00Z",
  "status": "active",
  "status_display": "Activo",
  "amount": 100000,
  "currency": "CLP",
  "currency_day": 10,
  "completed_occurrences": 5,
  "max_occurrences": null,
  "start_date": "2024-02-01",
  "emission_day_adjustment": "none",
  "end_type": "never",
  "end_date": "2024-12-31",
  "details": [
    {
      "id": 1,
      "item_name": "Servicio mensual de consultoría",
      "item_description": "Consultoría especializada en tecnología",
      "quantity": 1,
      "unit_price": 100000,
      "unit_of_measurement": "UN",
      "item_code": "PROD-001",
      "item_type_code": "1"
    }
  ],
  "references": [
    {
      "id": 1,
      "dte_type_code": "33",
      "reference_folio": "123",
      "reference_date": "2024-01-15",
      "reference_reason": "ANULA DOCUMENTO DE LA REFERENCIA"
    }
  ],
  "created_at": "2024-01-15T10:00:00Z",
  "updated_at": "2024-01-20T15:30:00Z"
}

​
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

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"