--- title: "Listar las asignaciones de charge schedule strategies" method: GET path: "/{country_code}/public/charge-schedules/assignments" tags: ["Sin catalogar"] --- # Listar las asignaciones de charge schedule strategies `GET /{country_code}/public/charge-schedules/assignments` ## Request - Base URL: `https://api.trytoku.com` - URL: `https://api.trytoku.com/{country_code}/public/charge-schedules/assignments` - Auth: API key in header `x-api-key` Lista las asignaciones de charge schedule strategies de una Organization. ## Path parameters - `country_code` 'cl' | 'mx' | 'br', required: Códigos de país admitidos en el prefijo de ruta `/{country_code}`. ## Query parameters - `accounts` integer[] - `status` ChargeScheduleStrategyAssignmentStatus[] - `periodicity` RecurrencePeriodicity[] - `toku_product` union[] - union - 'pac_management' | 'pac_inscription' | 'direct_debit_cl' | 'direct_debit_mx' | 'transfer_cl' | 'transbank_oneclick' | 'transbank_webpay_plus' | 'klap_oneclick' | 'patpass' | 'cash' | 'cash_mx_one_time_psp' | 'cash_mx_one_time_pst' | 'cash_mx_psp' | 'cash_mx_pst' | 'toku_gateways' | 'payment_orchestration' | 'payment_orchestration_onetime' | 'multigateway_onetime' | 'toku_card_on_file' | 'toku_onetime' | 'domiciliation' | 'high_value_transfer' | 'codi' | 'wallet_mx' | 'cards_batch_mx_recurring_pst' | 'atoa_batch_mx_recurring_pst' | 'pix_onetime_pst_br' | 'boleto_br_onetime_pst' | 'boleto_br_recurring_pst' | 'pix_br_onetime_pst' | 'pix_br_onetime_psp' | 'pix_br_recurring_psp' | 'pix_bank_br_automatic_pst' | 'pix_bank_br_automatic_psp' | 'pix_bank_br_onetime_psp' | 'pix_openfinance_br_automatic_psp' | 'boleto_bank_br_onetime_psp' | 'cash_pst_cl' | 'transfer_mx_pst' | 'transfer_mx_psp' | 'transfer_cl_pst' | 'transfer_cl_psp' | 'direct_debit_onetime_cl_pst' | 'direct_debit_onetime_cl_psp' | 'bank_button_cl_pst' | 'bank_button_multiple_cl_pst' | 'bank_button_cl_psp' | 'bank_button_multiple_cl_psp' | 'digital_mandate_cl' | 'transfer_mx' | 'cards_br_recurring_pst' | 'cards_br_onetime_pst' | 'cards_br_recurring_psp' | 'cards_br_onetime_psp' | 'atoa_br_recurring_pst' | 'internal_balance' | 'cards_cl_onetime_pst' | 'cards_cl_recurring_pst' | 'cards_cl_pos_pst' | 'br_automatic_debit_pst' | 'external_collector_cl_pst' | 'referenced_payment_mx_psp' | 'in_app_payment_mx_psp' | 'external_payment' | 'collections_ai_agent' | 'bolepix_br_onetime_pst' | 'bolepix_bank_br_onetime_psp' | 'contacted_end_customers' | 'vcc' | 'atoa_batch_mx_recurring_psp' | 'international_transfer_mx_pst' | 'rat' | 'batch_reconciliations' | 'account_payouts' | 'account_payables' | 'transfer_cl_psp_wallet' | 'wallet_mx_psp': Producto de cobro de Toku: la combinación de método de pago, país y modalidad con que se ejecuta un cobro. El nombre codifica esas tres cosas — por ejemplo `pix_br_recurring_psp` es Pix recurrente en Brasil bajo el modelo PSP, y `cards_cl_onetime_pst` es tarjetas de un solo pago en Chile bajo el modelo PST. Es el valor que decide con qué integración se ejecuta el cobro, así que buena parte de la lógica que depende del país se resuelve a partir de él. Qué productos tiene habilitados una organización es parte de su configuración: este listado es el universo posible, no lo que una organización determinada puede cobrar hoy. `cash`, `cash_mx_one_time_psp`, `cash_mx_one_time_pst` y `transfer_mx` están deprecados y solo sobreviven por compatibilidad con registros históricos. - 'CARDS' | 'RENDITION_FILES' | 'PIX' | 'BOLETO': Canal de recaudación de una asignación: la familia de rieles por la que sale el cobro. `CARDS` cobra a tarjetas inscritas, `RENDITION_FILES` cobra por archivo de rendición —descuento automático, PAC y los archivos batch de tarjetas—, y `PIX` y `BOLETO` cobran por esos medios brasileños. Es la llave con que se enruta cada cobro, y cada canal exige su propia configuración: qué datos hay que completar antes de poder activar una asignación depende de este valor. El `toku_product` elige después el flujo exacto dentro del canal. - `strategy_type` StrategyType[] ## Headers - `x-account-key` string ## Response `200` Successful Response - OrganizationAssignmentListingItem[] - `assignment_status` 'DRAFT' | 'ACTIVE' | 'PAUSED' | 'DISABLED' | 'DELETED', required: Estado de la asignación entre una estrategia de calendario de cobro y una cuenta: es el interruptor con que se prende y se apaga el cobro recurrente. Solo una asignación `ACTIVE` genera fechas de cobro. `DRAFT` es el estado inicial, que permite dejar una asignación configurada sin cobrar todavía. Pasarla a `PAUSED` o a `DISABLED` cancela sus fechas pendientes; la diferencia es quién la apaga y qué pasa después: `PAUSED` es una pausa pedida por la organización y `DISABLED` es la que aplica Toku cuando la cuenta u organización deja de estar vigente, que además impide que se vuelva a crear una asignación por defecto. `DELETED` es terminal. Las transiciones válidas son `DRAFT` → `ACTIVE`, `ACTIVE` ⇄ `PAUSED`, `ACTIVE`/`PAUSED` → `DISABLED`, `DISABLED`/`PAUSED` → `ACTIVE`, y cualquiera → `DELETED`; el resto se rechaza. - `associated_accounts` integer[] - `charge_days_summary` ChargeDaysSummary, required: Resumen de cómo la estrategia programa sus cobros. ``count`` es la cantidad de entradas de ``charge_schedules`` definidas en la estrategia, y ``periodicity_key`` es el ``recurrence_rules.periodicity`` de la estrategia. - `count` integer, required - `periodicity_key` 'MONTH' | 'SEMI_MONTH' | 'WEEK' | 'EVENT_TRIGGERED', required: Patrón con que se repite un cobro y con el que se expande el offset configurado en fechas concretas. `MONTH` genera una fecha por mes, `WEEK` una por semana —donde el offset es el día de la semana, de `1` (lunes) a `7` (domingo)— y `SEMI_MONTH` dos por mes, una contada desde el inicio del mes y otra desde su mitad. `EVENT_TRIGGERED` no se calendariza: sus fechas de cobro no se generan por adelantado sino cuando ocurre el evento que las dispara, y por eso exige definir la ventana horaria en que el cobro puede ejecutarse y no admite configuración de reintentos. - `id_account` integer, required - `id_charge_schedule_strategy` string, required - `id_charge_schedule_strategy_assignment` string, required - `is_editable` boolean, required - `next_charge_date` string, date-time - `process_toku_product` string - `strategy_name` string, required - `strategy_status` 'DRAFT' | 'ACTIVE' | 'INACTIVE' | 'DEPRECATED' | 'DELETED', required: Estado de una estrategia de calendario de cobro, la definición reutilizable de cuándo cobrar (periodicidad, calendario, offsets, reintentos). Solo una estrategia `ACTIVE` genera fechas de cobro y solo una `ACTIVE` puede activarse en una cuenta. `DRAFT` es el estado con que nace una estrategia creada por API: se puede editar, pero ninguna asignación suya se puede activar mientras siga ahí. Pasar una estrategia a `INACTIVE` cancela las fechas de cobro que tenía pendientes y deja de generar nuevas. `DELETED` es terminal y solo lo aplica Toku cuando se borra la última asignación que apuntaba a una estrategia propia de la organización. `DEPRECATED` se acepta y se persiste, pero hoy no tiene comportamiento propio: se comporta como cualquier estado distinto de `ACTIVE`. - `type` 'TOKU' | 'CUSTOM': Si una asignación usa una estrategia mantenida por Toku (`TOKU`) o una creada por la propia organización (`CUSTOM`). ## Other responses - `401`: Faltan las credenciales o son inválidas. - `403`: No tienes acceso a este recurso. - `404`: El recurso solicitado no existe. - `422`: El cuerpo de la petición no pasó la validación. - `429`: Se superó el límite de peticiones permitidas. ## Changes - **2026-11-03** `a6ef070075b1`: 1 info - endpoint added [Operation history](https://skmtc.dev/trytoku/apis/toku-api/changes/:country_code/public/charge-schedules/assignments/get.md) --- [API](https://skmtc.dev/trytoku/apis/toku-api.md) - [All operations](https://skmtc.dev/trytoku/apis/toku-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trytoku/apis/toku-api/revisions/a6ef070075b1?raw)