Advance an operation via audited admin override

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"
}

Advance an operation via audited admin override

Drives an EXISTING state-machine edge via MANUAL_OVERRIDE, emitting operation.manually_advanced with the reason/evidence. Admin-only (operations:admin). Missing reason/evidence returns 400 MISSING_OVERRIDE_JUSTIFICATION; a nonexistent edge returns 409 INVALID_STATE_TRANSITION; cancelling an operation whose file is already at Núclea (transmit hold in_flight) returns 409 CONFLICT, since it would erase the only record of the disagreement — reconcile and advance to the hold-resolving state; POST /v1/connectivity/unpark refuses in-flight claims.

POST

operations

{operationId}

advance

Advance an operation via audited admin override

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"
}

Authorizations

Authorization

string

header

required

JWT bearer token issued by the identity provider.

Path Parameters

operationId

string

required

Operation id (UUID).

Example:

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

Body

application/json

evidence

string

Audit evidence (mandatory; enforced by the domain).

Example:

"ticket-4567"

reason

string

Audit justification (mandatory; enforced by the domain).

Example:

"Manual override after Núclea reconciliation"

toState

string

The existing state-machine edge the override drives to.

Example:

"QUEUED"

Response

fromState

string

required

State before the override.

Example:

"REJECTED"

operationId

string

required

Operation id (UUID) that was advanced.

Example:

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

toState

string

required

State after the override.

Example:

"QUEUED"

trigger

string

required

Transition trigger (always MANUAL_OVERRIDE).

Example:

"MANUAL_OVERRIDE"

advancedBy

string

Authenticated subject who authorized the override.

Example:

"ops@acquirer.com"

⌘I

Pix — Lerian SPI (native messaging)

Pix — JD (interface, direct)

Pix — BTG (interface, indirect)

TED — Lerian SPB (native messaging)

TED — JD (interface)

Boletos — BTG (interface)

Lerian SILOC (native messaging)

Lerian SLC (native messaging)

Lerian STA (native messaging)

Lerian SISBAJUD (native messaging)

Lerian Consignado (native messaging)

Advance an operation via audited admin override

Authorizations

Path Parameters

Body

Response