Reconcile an operation against the counterpart's settlement status

curl --request POST \
  --url https://slc.sandbox.lerian.net/v1/operations/{operationId}/reconcile \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "participantIspb": "12345678",
  "reason": "operation stuck at FORWARDED after the ASLC023 window closed"
}
'

package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"participantIspb\": \"12345678\",\n  \"reason\": \"operation stuck at FORWARDED after the ASLC023 window closed\"\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))

}

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    participantIspb: '12345678',
    reason: 'operation stuck at FORWARDED after the ASLC023 window closed'
  })
};

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

import requests

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

payload = {
    "participantIspb": "12345678",
    "reason": "operation stuck at FORWARDED after the ASLC023 window closed"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "action": "SYNCHRONIZED",
  "counterpartStatus": "CONFIRMED",
  "localState": "CONFIRMED",
  "operationId": "018f8a3e-4b2c-7c1a-9e5d-2f6a1b3c4d5e",
  "previousState": "FORWARDED",
  "reconciledBy": "ops@acquirer.com",
  "controlNumber": "CTRL-0042",
  "trigger": "NUCLEA_RECONCILED"
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

Reconcile an operation against the counterpart's settlement status

Consults Núclea for the AUTHORITATIVE SLC0908 settlement status of one operation and synchronises the local record under NUCLEA_RECONCILED, leaving an operation_state_log row whose trigger separates a machine synchronisation from an operator’s override. Admin-only (operations:admin). The reason is mandatory and enforced by the domain (400 MISSING_OVERRIDE_JUSTIFICATION); the reconciling subject is taken from the validated request identity, never from the payload. WHY THIS PATH EXISTS ALONGSIDE THE DRAINS: the /v1/connectivity/* recovery verbs (dispatch, forward, repoll, status-relay, reprocess, unpark) re-drive OUR OWN internal transport and never consult the counterpart, so they cannot report what Núclea believes — this operation asks Núclea and records the answer. Disjoint capabilities, not substitutes. Only FORWARDED->CONFIRMED and CONFIRMED->SETTLED are driveable: a counterpart state further away is refused rather than walked (409 INVALID_STATE_TRANSITION), because walking it would fabricate an intermediate transition nobody observed. An operation carrying no NUliquid has no key to run the consulta with and answers 409 SLC-0119 with the state-specific remediation. A counterpart status outside the mapped vocabulary answers 409 SLC-0121 and writes nothing.

POST

operations

{operationId}

reconcile

Reconcile an operation against the counterpart's settlement status

curl --request POST \
  --url https://slc.sandbox.lerian.net/v1/operations/{operationId}/reconcile \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "participantIspb": "12345678",
  "reason": "operation stuck at FORWARDED after the ASLC023 window closed"
}
'

package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"participantIspb\": \"12345678\",\n  \"reason\": \"operation stuck at FORWARDED after the ASLC023 window closed\"\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))

}

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    participantIspb: '12345678',
    reason: 'operation stuck at FORWARDED after the ASLC023 window closed'
  })
};

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

import requests

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

payload = {
    "participantIspb": "12345678",
    "reason": "operation stuck at FORWARDED after the ASLC023 window closed"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "action": "SYNCHRONIZED",
  "counterpartStatus": "CONFIRMED",
  "localState": "CONFIRMED",
  "operationId": "018f8a3e-4b2c-7c1a-9e5d-2f6a1b3c4d5e",
  "previousState": "FORWARDED",
  "reconciledBy": "ops@acquirer.com",
  "controlNumber": "CTRL-0042",
  "trigger": "NUCLEA_RECONCILED"
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

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

participantIspb

string

ISPB (8 characters) the SLC0908 consulta is run on behalf of. A resource selector for the counterpart node, not an identity claim.

Example:

"12345678"

reason

string

Audit justification (mandatory; enforced by the domain). At most 1024 characters. This verb takes no evidence — the counterpart's answer is the evidence.

Maximum string length: 1024

Example:

"operation stuck at FORWARDED after the ASLC023 window closed"

Response

action

enum<string>

required

Outcome class: IN_SYNC (the two ledgers already agreed, nothing written) or SYNCHRONIZED (the local record was advanced).

Available options:

IN_SYNC,

SYNCHRONIZED

Example:

"SYNCHRONIZED"

counterpartStatus

string

required

The counterpart's RAW SLC0908 settlement status, echoed verbatim rather than re-rendered through this service's vocabulary.

Example:

"CONFIRMED"

localState

string

required

Local state after the reconcile.

Example:

"CONFIRMED"

operationId

string

required

Operation id (UUID) that was reconciled.

Example:

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

previousState

string

required

Local state before the reconcile. Equal to localState on an IN_SYNC run.

Example:

"FORWARDED"

reconciledBy

string

required

Authenticated subject who requested the reconcile, taken from the validated request identity and never from the payload.

Example:

"ops@acquirer.com"

controlNumber

string

Counterpart control number correlating the operation, when the answer carried one.

Example:

"CTRL-0042"

trigger

string

Transition trigger (always NUCLEA_RECONCILED). Absent on an IN_SYNC run, where no transition was persisted.

Example:

"NUCLEA_RECONCILED"

Administration

Clearing

Settlement schedule

Funding

LBTR

Connectivity

Operations

Files

Participants

Arrangements

Reports

Signing keys

XSD schemas

Webhooks

Error handling

Reconcile an operation against the counterpart's settlement status

Authorizations

Path Parameters

Body

Response