Skip to main content
POST
Register or update an assignment fund

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Cuerpo

application/json
administratorName
string
requerido

Fund administrator name.

Required string length: 1 - 256
administratorTaxId
string
requerido

Fund administrator registration identifier (opaque; no jurisdiction format is assumed).

Required string length: 1 - 64
assignmentRate
string
requerido

Monthly effective cession rate as a decimal fraction string in [0, 1] with at most 8 decimals (0.0175 = 1.75% per month). Zero means assignment at par.

Ejemplo:

"0.0175"

assignorConcentrationLimit
string
requerido

Regulation concentration limit per assignor as a decimal fraction string in (0, 1] with at most 8 decimals.

Ejemplo:

"0.30"

eligibilityMode
enum<string>
requerido

Whether our eligibility verification is authoritative (full) or runs as a pre-filter before the administrator's own (prefilter).

Opciones disponibles:
full,
prefilter
fundName
string
requerido

Fund name.

Required string length: 1 - 256
fundTaxId
string
requerido

Fund registration identifier. Re-posting the same value REPLACES that fund's configuration and keeps its identifier. Bounded at 32 bytes because this is the one value carried into the fixed-width offer file, which refuses rather than truncates.

Required string length: 1 - 32
offerFileLayoutRef
string
requerido

Versioned reference to the custodian export layout. Letters, digits and -_.: only.

Required string length: 1 - 128
Ejemplo:

"custodian-cnab240.v1"

paidToTransferredWindowSeconds
integer<int64>
requerido

Orphan-detector window for "paid without transferred", in whole seconds.

Rango requerido: 1 <= x <= 31536000
Ejemplo:

172800

paymentSourceConcentrationLimit
string
requerido

Regulation concentration limit per payment source as a decimal fraction string in (0, 1] with at most 8 decimals (e.g. "0.15").

Ejemplo:

"0.15"

registryProvider
string
requerido

Which registry governs this fund's cession. REQUIRED, and none must be stated rather than omitted: this call REPLACES the stored registration, so a save that stayed silent would turn a fund whose acceptance is fenced by a confirmed title movement into one that is not. none means registration at a registry is dispensable for this fund and its absence never blocks a cession. Any other value must be a registry one of this deployment's jurisdictions declares — deliberately NOT an enum here, because the set is open per jurisdiction and a fixed list would pin the contract to one country. A value nobody declared is refused, and the refusal names what is declared.

Ejemplo:

"none"

riskRetention
string
requerido

Whether assigning to this fund leaves substantial risk with the assignor (Res. CMN 4.966). REQUIRED, and the only accepted value is none — assignment transferring substantially all risks and rewards, which is what this service books: the receivable is derecognized and the gain or loss recognized on the sale date. Assignment WITH retained risk keeps the asset on the balance sheet, turns the price into a liability and appropriates the result over the remaining term; that treatment does not exist yet and any other value is refused rather than approximated. Deliberately NOT an enum here, so the refusal can say what is missing instead of reading as a malformed field.

Ejemplo:

"none"

termMode
enum<string>
requerido

Who generates the endorsement term.

Opciones disponibles:
lender_emitted,
administrator_generated
transferredToAcceptedWindowSeconds
integer<int64>
requerido

Orphan-detector window for "transferred without accepted", in whole seconds.

Rango requerido: 1 <= x <= 31536000
Ejemplo:

86400

repeatedCutLimit
integer<int64>

How many times this fund may cut the same receivable in its remessa before the receivable stops returning to the pool automatically. Omit to take the default of 2.

Rango requerido: x >= 1

Respuesta

OK

administratorName
string
requerido

Fund administrator name.

administratorTaxId
string
requerido

Fund administrator registration identifier.

assignmentRate
string
requerido

Monthly effective cession rate as a decimal fraction string, scale 8 (e.g. "0.01750000").

assignorConcentrationLimit
string
requerido

Regulation concentration limit per assignor, as a decimal fraction string, scale 8.

createdAt
string
requerido

Creation timestamp (RFC3339, UTC).

eligibilityMode
string
requerido

full (our verification is authoritative) or prefilter (the administrator verifies; the same engine runs ahead of the offer file).

fundName
string
requerido

Fund name.

fundTaxId
string
requerido

Fund registration identifier; the natural key of the registration within a tenant.

id
string
requerido

Fund registration identifier (uuid). Stable across configuration changes.

offerFileLayoutRef
string
requerido

Versioned reference to the custodian export layout.

paidToTransferredWindowSeconds
integer<int64>
requerido

Orphan-detector window for "paid without transferred", in seconds.

paymentSourceConcentrationLimit
string
requerido

Regulation concentration limit per payment source, as a decimal fraction string, scale 8 (e.g. "0.15000000").

registryProvider
string
requerido

Which registry governs this fund's cession. none means no registry governs it; any other value is a registry declared by one of this deployment's jurisdictions.

repeatedCutLimit
integer<int64>
requerido

How many times this fund may cut the same receivable before it stops returning to the pool automatically.

riskRetention
string
requerido

Whether assigning to this fund leaves substantial risk with the assignor (Res. CMN 4.966). Always none today: the receivable is derecognized and the result recognized on the sale date.

termMode
string
requerido

Who generates the endorsement term: lender_emitted or administrator_generated.

transferredToAcceptedWindowSeconds
integer<int64>
requerido

Orphan-detector window for "transferred without accepted", in seconds.

updatedAt
string
requerido

Last-update timestamp (RFC3339, UTC).