Crear acción de conciliación

curl --request POST \
  --url https://spb.sandbox.lerian.net/v1/str/reconciliations/{reconciliationId}/actions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "action": "<string>",
  "reason": "<string>",
  "metadata": {}
}
'

import requests

url = "https://spb.sandbox.lerian.net/v1/str/reconciliations/{reconciliationId}/actions"

payload = {
    "action": "<string>",
    "reason": "<string>",
    "metadata": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({action: '<string>', reason: '<string>', metadata: {}})
};

fetch('https://spb.sandbox.lerian.net/v1/str/reconciliations/{reconciliationId}/actions', 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://spb.sandbox.lerian.net/v1/str/reconciliations/{reconciliationId}/actions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'action' => '<string>',
    'reason' => '<string>',
    'metadata' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://spb.sandbox.lerian.net/v1/str/reconciliations/{reconciliationId}/actions"

	payload := strings.NewReader("{\n  \"action\": \"<string>\",\n  \"reason\": \"<string>\",\n  \"metadata\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://spb.sandbox.lerian.net/v1/str/reconciliations/{reconciliationId}/actions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"action\": \"<string>\",\n  \"reason\": \"<string>\",\n  \"metadata\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://spb.sandbox.lerian.net/v1/str/reconciliations/{reconciliationId}/actions")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"action\": \"<string>\",\n  \"reason\": \"<string>\",\n  \"metadata\": {}\n}"

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

{
  "actionId": "<string>",
  "auditId": "<string>",
  "case": {
    "createdAt": "<string>",
    "openedAt": "<string>",
    "operationFamily": "<string>",
    "reasonCode": "<string>",
    "reconciliationId": "<string>",
    "status": "<string>",
    "summary": "<string>",
    "updatedAt": "<string>",
    "nuOp": "<string>",
    "operationId": "<string>",
    "protocolControlNumber": "<string>",
    "protocolMessageType": "<string>",
    "recommendedAction": "<string>",
    "resolvedAt": "<string>"
  },
  "correlationId": "<string>",
  "status": "<string>"
}

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

POST

str

reconciliations

{reconciliationId}

actions

Crear acción de conciliación

curl --request POST \
  --url https://spb.sandbox.lerian.net/v1/str/reconciliations/{reconciliationId}/actions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "action": "<string>",
  "reason": "<string>",
  "metadata": {}
}
'

import requests

url = "https://spb.sandbox.lerian.net/v1/str/reconciliations/{reconciliationId}/actions"

payload = {
    "action": "<string>",
    "reason": "<string>",
    "metadata": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({action: '<string>', reason: '<string>', metadata: {}})
};

fetch('https://spb.sandbox.lerian.net/v1/str/reconciliations/{reconciliationId}/actions', 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://spb.sandbox.lerian.net/v1/str/reconciliations/{reconciliationId}/actions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'action' => '<string>',
    'reason' => '<string>',
    'metadata' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://spb.sandbox.lerian.net/v1/str/reconciliations/{reconciliationId}/actions"

	payload := strings.NewReader("{\n  \"action\": \"<string>\",\n  \"reason\": \"<string>\",\n  \"metadata\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://spb.sandbox.lerian.net/v1/str/reconciliations/{reconciliationId}/actions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"action\": \"<string>\",\n  \"reason\": \"<string>\",\n  \"metadata\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://spb.sandbox.lerian.net/v1/str/reconciliations/{reconciliationId}/actions")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"action\": \"<string>\",\n  \"reason\": \"<string>\",\n  \"metadata\": {}\n}"

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

{
  "actionId": "<string>",
  "auditId": "<string>",
  "case": {
    "createdAt": "<string>",
    "openedAt": "<string>",
    "operationFamily": "<string>",
    "reasonCode": "<string>",
    "reconciliationId": "<string>",
    "status": "<string>",
    "summary": "<string>",
    "updatedAt": "<string>",
    "nuOp": "<string>",
    "operationId": "<string>",
    "protocolControlNumber": "<string>",
    "protocolMessageType": "<string>",
    "recommendedAction": "<string>",
    "resolvedAt": "<string>"
  },
  "correlationId": "<string>",
  "status": "<string>"
}

{
  "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.

Encabezados

X-Idempotency

string

Idempotency key (canonical).

X-Idempotency-Key

string

Idempotency key (legacy alias).

X-TTL

string

Idempotency key TTL in seconds (overrides the configured default).

Parámetros de ruta

reconciliationId

string

requerido

Reconciliation case UUID.

Cuerpo

application/json

action

string

requerido

Recovery action to record: ACKNOWLEDGE, RESOLVE, DISMISS, or INVESTIGATE.

Ejemplo:

"ACKNOWLEDGE"

reason

string

requerido

Operator-supplied human-readable rationale for the action (max 512 chars).

Ejemplo:

"investigating with bank"

metadata

object

Optional sanitized JSON object with additional action context (no PII).

Show child attributes

Respuesta

actionId

string

requerido

UUID of the newly recorded reconciliation action.

Ejemplo:

"b4e8f1a2-6c3d-4f57-9a10-1e1234567893"

auditId

string

requerido

UUID of the audit record linked to the action; empty when audit emission was disabled or failed (best-effort).

Ejemplo:

"c5f9a2b3-7d4e-4068-ab21-1e1234567894"

case

object

requerido

The reconciliation case after the action transition was applied.

Show child attributes

correlationId

string

requerido

Request-scoped correlation identifier echoing X-Request-ID, for pivoting from response to trace.

status

string

requerido

Resulting case status after the action: OPEN, IN_PROGRESS, RESOLVED, or DISMISSED.

Ejemplo:

"IN_PROGRESS"

⌘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)

Crear acción de conciliación

Autorizaciones

Encabezados

Parámetros de ruta

Cuerpo

Respuesta