AGENTE DE COBRO Y PAGOS
>
Transferencias salientes
Realizar Transferencia
Realizar una transferencia saliente a un CBU, CVU o alias.
Endpoint
POST
/cvucollectentidad-financial/v1/v1.201/banks/322/accounts/owner/transaction-request-types/TRANSFER/transaction-requests
Request
origin_id string
— REQUIRED
Identificador unívoco de la transacción definido por el usuario.. Si se envía un identificador existente devuelve la información de dicha transacción.
Máximo 15 caracteres.
to object
— REQUIRED
Objeto con información del destinatario.
to.cbu string
— OPTIONAL
CBU o CVU del destinatario. Requerido si no se envía alias.
to.alias string
— OPTIONAL
Alias del destinatario. Requerido si no se envía cbu.
value object
— REQUIRED
Objeto con información del importe de la transferencia.
to.currency string
— REQUIRED
Moneda de la transacción.
Valores permitidos:
"ARS" = Pesos argentinos
"USD" = Dolares estadounidenses
to.amount double
— REQUIRED
Importe de la transferencia.
description string
— OPTIONAL
Descripción de la transacción (Máximo 100 caracteres). Valor por defecto: "Varios"
concepto string
— REQUIRED
Concepto.
Valores permitidos:
"ALQ" (Alquiler)
"CUO" (Cuota)
"EXP" (Expensas)
"FAC" (Factura)
"PRE" (Préstamo)
"SEG" (Seguro)
"HON" (Honorarios)
"HAB" (Haberes)
"VAR" (Varios)
Valor por defecto: "VAR"
emails array
— OPTIONAL
Array de strings con la lista de emails de los destnatarios a enviar un comprobante de la transferencia. Este comprobante tiene un template fijo del Banco Industrial.
curl request
Response
id string
Identificador de la transacción.
type string
Tipo de operación.
Valor por defecto: "TRANSFER"
from object
Objeto con información de la cuenta origen.
from.bank_id string
Código identificador del banco.
from.account_id string
Identificador de la cuenta en el banco.
counterparty object
Objeto con información del destinatario.
counterparty.id string
Identificador del tercero. Si no está disponible, no se envía.
counterparty.name string
Nombre del tercero. Si no está disponible, no se envía.
counterparty.type string
Tipo. Normalmente "CUIT_CUIL" Si no está disponible, se envía "UNAVAILABLE".
counterparty.bank_routing object
Objeto con información del banco de la cuenta destino.
counterparty.bank_routing.scheme string
Tipo de dato, valor default "NAME" Si no está disponible, se envía "UNAVAILABLE".
counterparty.bank_routing.address string
Nombre del banco de la cuenta destino.
counterparty.bank_routing.code string
Código del banco de la cuenta destino.
counterparty.account_routing object
Objeto con información de la cuenta destino.
counterparty.account_routing.scheme string
Tipo de dato. Valores posibles: "LABEL" y "CBU". Si no está disponible, se envía "UNAVAILABLE".
counterparty.account_routing.address string
CBU, CVU o alias de la cuenta destino.
details object
Objeto con información adicional de la transferencia.
details.origin_id string
Identificador unívoco de la transacción definido por el usuario.
transaction_ids array
Array de strings con la lista de ids de procesamiento de la transferencia. Entre ellos está el id del banco y el id de Coelsa.
status string
Estado de la transferencia.
El estado UNKNOWN se produce cuando hubo un error de comunicación con algún sistema externo, el mismo tratará de actualizarse durante el día. En el caso de una transferencia a un CVU, inicialmente quedan en estado IN_PROGRESS, este estado se intentará resolver durante el día o al final del mismo cuando se concilien todas las operaciones. El estado UNKNOWN_FOREVER indica que la operación no pudo resolver el estado, y no se va a reintentar actualizar en forma automática. Los estados COMPLETED o FAILED son estado finales que indican que la operación se completó o falló.
Valores posibles:
"COMPLETED" (Completada)
"PENDING" (Pendiente de firma)
"IN_PROGRESS" (En curso)
"UNKNOWN" (Desconocido)
"FAILED" (Con error)
"UNKNOWN_FOREVER" (Desconocido y no se va a reintentar actualizar)
start_date datetime
Fecha y hora de comienzo de transacción.
end_date datetime
Fecha y hora de finalización de transacción.
charge object
Objeto con información de los cargos de la transferencia.
charge.summary string
Resumen de la descripción de la transferencia.
charge.value object
Objeto con información del importe de la transferencia.
charge.value.currency string
Moneda de la transacción.
Valores posibles:
"ARS" = Pesos argentinos
"USD" = Dolares estadounidenses
charge.value.amount double
Importe de la transferencia.
Changelog
20/04/2025 - Se agregan valores de currency permitidos para realizar transferencias en dolares.
