Obtener una operación de liquidación

curl --request GET \
  --url https://slc.sandbox.lerian.net/v1/operations/{operationId} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://slc.sandbox.lerian.net/v1/operations/{operationId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://slc.sandbox.lerian.net/v1/operations/{operationId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://slc.sandbox.lerian.net/v1/operations/{operationId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://slc.sandbox.lerian.net/v1/operations/{operationId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "cancellationTargetOperationId": "<string>",
  "createdAt": "<string>",
  "currency": "<string>",
  "dueDate": "<string>",
  "eslcErrors": [
    "<string>"
  ],
  "externalId": "<string>",
  "id": "<string>",
  "installmentNumber": 123,
  "installments": 123,
  "intakeMode": "<string>",
  "lastError": "<string>",
  "nuliquid": "<string>",
  "operationType": "<string>",
  "participantId": "<string>",
  "participantRole": "<string>",
  "reasonCategory": "<string>",
  "settlementIfIspb": "<string>",
  "state": "<string>",
  "stuckSince": "<string>",
  "transactionDate": "<string>",
  "updatedAt": "<string>",
  "value": 123,
  "arrangementCode": "<string>",
  "aslcType": "<string>",
  "batchId": "<string>",
  "creditorIspb": "<string>",
  "domicileIfIspb": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "about:blank"
}

{
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "about:blank"
}

GET

operations

{operationId}

Obtener una operación de liquidación

curl --request GET \
  --url https://slc.sandbox.lerian.net/v1/operations/{operationId} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://slc.sandbox.lerian.net/v1/operations/{operationId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://slc.sandbox.lerian.net/v1/operations/{operationId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://slc.sandbox.lerian.net/v1/operations/{operationId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://slc.sandbox.lerian.net/v1/operations/{operationId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "cancellationTargetOperationId": "<string>",
  "createdAt": "<string>",
  "currency": "<string>",
  "dueDate": "<string>",
  "eslcErrors": [
    "<string>"
  ],
  "externalId": "<string>",
  "id": "<string>",
  "installmentNumber": 123,
  "installments": 123,
  "intakeMode": "<string>",
  "lastError": "<string>",
  "nuliquid": "<string>",
  "operationType": "<string>",
  "participantId": "<string>",
  "participantRole": "<string>",
  "reasonCategory": "<string>",
  "settlementIfIspb": "<string>",
  "state": "<string>",
  "stuckSince": "<string>",
  "transactionDate": "<string>",
  "updatedAt": "<string>",
  "value": 123,
  "arrangementCode": "<string>",
  "aslcType": "<string>",
  "batchId": "<string>",
  "creditorIspb": "<string>",
  "domicileIfIspb": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "about:blank"
}

{
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "about:blank"
}

Autorizaciones

Authorization

string

header

requerido

JWT bearer token issued by the identity provider.

Parámetros de ruta

operationId

string

requerido

Settlement operation id (UUID).

Ejemplo:

"018f8a3e-4b2c-7c1a-9e5d-2f6a1b3c4d5e"

Respuesta

cancellationTargetOperationId

string | null

requerido

Id (UUID) of the operation a CANCELLATION targets; null for every other type.

Ejemplo:

"018f8a3e-4b2c-7c1a-9e5d-2f6a1b3c4d5e"

createdAt

string

requerido

Creation timestamp (RFC3339).

Ejemplo:

"2026-06-15T10:50:00Z"

currency

string

requerido

ISO 4217 currency code.

Ejemplo:

"BRL"

dueDate

string | null

requerido

Settlement due date (RFC3339); null when not set.

Ejemplo:

"2026-06-15T00:00:00Z"

eslcErrors

string[] | null

requerido

Recorded Núclea business error codes (empty array when none).

externalId

string

requerido

Client-side external identifier.

Ejemplo:

"acq-ext-2026-06-0001"

string

requerido

Operation id (UUID).

Ejemplo:

"018f8a3e-4b2c-7c1a-9e5d-2f6a1b3c4d5e"

installmentNumber

integer<int32>

requerido

This installment's sequence number.

Ejemplo:

1

installments

integer<int32>

requerido

Total number of installments.

Ejemplo:

3

intakeMode

string

requerido

Intake mode the operation was received through.

Ejemplo:

"api_jsonl"

lastError

string | null

requerido

Most recent recorded Núclea business error code; null when none.

Ejemplo:

"ESLC0029"

nuliquid

string | null

requerido

Núclea-assigned NUliquid (21 positions); null until assigned.

Ejemplo:

"202606150000000000001"

operationType

string

requerido

Operation type.

Ejemplo:

"CREDIT"

participantId

string

requerido

Owning participant id (UUID).

Ejemplo:

"018f8a3e-4b2c-7c1a-9e5d-2f6a1b3c4d5e"

participantRole

string

requerido

Participant role in the settlement.

Ejemplo:

"ACQUIRER"

reasonCategory

string | null

requerido

Numeric MotvCanc cancellation reason ('1'..'4'); null unless a CANCELLATION.

Ejemplo:

"4"

settlementIfIspb

string | null

requerido

Settlement FI ISPB, 8 digits; null when not set.

Ejemplo:

"60746948"

state

string

requerido

Lifecycle state.

Ejemplo:

"SETTLED"

stuckSince

string | null

requerido

Timestamp since the operation has been internally stuck (RFC3339); null when not stuck.

Ejemplo:

"2026-06-15T11:00:00Z"

transactionDate

string

requerido

Business transaction date (RFC3339).

Ejemplo:

"2026-06-15T00:00:00Z"

updatedAt

string

requerido

Last-update timestamp (RFC3339).

Ejemplo:

"2026-06-15T13:10:00Z"

value

integer<int64>

requerido

Operation amount in minor units (centavos).

Ejemplo:

150000

waitingFor

enum<string> | null

requerido

What the operation is waiting on, and therefore which recovery verb applies. transport/nuclea_ack/if_confirmation are external waits (reconcile or wait). parked means an outbound transmit claim is held because the attempt budget was exhausted and nothing reached Núclea: recover with POST /v1/connectivity/unpark. in_flight means the file IS at Núclea and the local transition failed: reconcile with Núclea, then POST /v1/operations/{operationId}/advance, and NEVER un-park it. null names NO verb: it means no external dependency is named for this state — the operation is terminal, or the wait is internal (CREATED/ACCEPTED, where advance/requeue applies), or it awaits a counterpart this vocabulary does not name yet (CONFIRMED awaits the funding ack plus the Núclea cycle close; SETTLED awaits the D+1 return file). Pair a null with state before choosing an action.

Opciones disponibles:

transport,

nuclea_ack,

if_confirmation,

parked,

in_flight,

null

Ejemplo:

"nuclea_ack"

arrangementCode

string

Payment arrangement (arranjo) code.

Ejemplo:

"0245"

aslcType

string

ASLC message type materialized for this operation.

Ejemplo:

"ASLC027"

batchId

string

Batch id when created via the NDJSON batch endpoint.

Ejemplo:

"018f8a3e-4b2c-7c1a-9e5d-2f6a1b3c4d5e"

creditorIspb

string

Creditor (acquirer) ISPB, 8 digits.

Ejemplo:

"29011780"

domicileIfIspb

string

Domicile FI ISPB (bank where the merchant receives funds), 8 digits.

Ejemplo:

"60701190"

⌘I

Pix — Lerian SPI (mensajería nativa)

Pix — JD (interfaz, directo)

Pix — BTG (interfaz, indirecto)

TED — Lerian SPB (mensajería nativa)

TED — JD (interfaz)

Boletos — BTG (interfaz)

Lerian SILOC (mensajería nativa)

Lerian SLC (mensajería nativa)

Lerian STA (mensajería nativa)

Lerian SISBAJUD (mensajería nativa)

Lerian Consignado (mensajería nativa)

Obtener una operación de liquidación

Autorizaciones

Parámetros de ruta

Respuesta