Avanzar una operación mediante override administrativo auditado

curl --request POST \
  --url https://slc.sandbox.lerian.net/v1/operations/{operationId}/advance \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "evidence": "<string>",
  "reason": "<string>",
  "toState": "<string>"
}
'

import requests

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

payload = {
    "evidence": "<string>",
    "reason": "<string>",
    "toState": "<string>"
}
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({evidence: '<string>', reason: '<string>', toState: '<string>'})
};

fetch('https://slc.sandbox.lerian.net/v1/operations/{operationId}/advance', 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}/advance",
  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([
    'evidence' => '<string>',
    'reason' => '<string>',
    'toState' => '<string>'
  ]),
  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://slc.sandbox.lerian.net/v1/operations/{operationId}/advance"

	payload := strings.NewReader("{\n  \"evidence\": \"<string>\",\n  \"reason\": \"<string>\",\n  \"toState\": \"<string>\"\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://slc.sandbox.lerian.net/v1/operations/{operationId}/advance")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"evidence\": \"<string>\",\n  \"reason\": \"<string>\",\n  \"toState\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"evidence\": \"<string>\",\n  \"reason\": \"<string>\",\n  \"toState\": \"<string>\"\n}"

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

{
  "fromState": "<string>",
  "operationId": "<string>",
  "toState": "<string>",
  "trigger": "<string>",
  "advancedBy": "<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"
}

Avanzar una operación mediante override administrativo auditado

Impulsa una transición EXISTENTE de la máquina de estados mediante MANUAL_OVERRIDE y emite operation.manually_advanced con el motivo y la evidencia. Solo para administradores (operations:admin). La ausencia de motivo o evidencia devuelve 400 MISSING_OVERRIDE_JUSTIFICATION; una transición inexistente devuelve 409 INVALID_STATE_TRANSITION; cancelar una operación cuyo archivo ya está en Núclea (reserva de transmisión in_flight) devuelve 409 CONFLICT, pues borraría el único registro de la discrepancia — reconcilia y avanza hasta el estado que libera la reserva; POST /v1/connectivity/unpark rechaza las reservas in-flight.

POST

operations

{operationId}

advance

Avanzar una operación mediante override administrativo auditado

curl --request POST \
  --url https://slc.sandbox.lerian.net/v1/operations/{operationId}/advance \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "evidence": "<string>",
  "reason": "<string>",
  "toState": "<string>"
}
'

import requests

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

payload = {
    "evidence": "<string>",
    "reason": "<string>",
    "toState": "<string>"
}
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({evidence: '<string>', reason: '<string>', toState: '<string>'})
};

fetch('https://slc.sandbox.lerian.net/v1/operations/{operationId}/advance', 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}/advance",
  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([
    'evidence' => '<string>',
    'reason' => '<string>',
    'toState' => '<string>'
  ]),
  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://slc.sandbox.lerian.net/v1/operations/{operationId}/advance"

	payload := strings.NewReader("{\n  \"evidence\": \"<string>\",\n  \"reason\": \"<string>\",\n  \"toState\": \"<string>\"\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://slc.sandbox.lerian.net/v1/operations/{operationId}/advance")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"evidence\": \"<string>\",\n  \"reason\": \"<string>\",\n  \"toState\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"evidence\": \"<string>\",\n  \"reason\": \"<string>\",\n  \"toState\": \"<string>\"\n}"

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

{
  "fromState": "<string>",
  "operationId": "<string>",
  "toState": "<string>",
  "trigger": "<string>",
  "advancedBy": "<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

Operation id (UUID).

Ejemplo:

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

Cuerpo

application/json

evidence

string

Audit evidence (mandatory; enforced by the domain).

Ejemplo:

"ticket-4567"

reason

string

Audit justification (mandatory; enforced by the domain).

Ejemplo:

"Manual override after Núclea reconciliation"

toState

string

The existing state-machine edge the override drives to.

Ejemplo:

"QUEUED"

Respuesta

fromState

string

requerido

State before the override.

Ejemplo:

"REJECTED"

operationId

string

requerido

Operation id (UUID) that was advanced.

Ejemplo:

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

toState

string

requerido

State after the override.

Ejemplo:

"QUEUED"

trigger

string

requerido

Transition trigger (always MANUAL_OVERRIDE).

Ejemplo:

"MANUAL_OVERRIDE"

advancedBy

string

Authenticated subject who authorized the override.

Ejemplo:

"ops@acquirer.com"

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

Avanzar una operación mediante override administrativo auditado

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta