Close an indeterminate send by hand

curl --request POST \
  --url https://api.example.com/v1/send-journal/{controlId}/resolve \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "evidenceReference": "<string>",
  "note": "<string>"
}
'

package main

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

func main() {

	url := "https://api.example.com/v1/send-journal/{controlId}/resolve"

	payload := strings.NewReader("{\n  \"evidenceReference\": \"<string>\",\n  \"note\": \"<string>\"\n}")

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

	req.Header.Add("X-Idempotency", "<x-idempotency>")
	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: {
    'X-Idempotency': '<x-idempotency>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({evidenceReference: '<string>', note: '<string>'})
};

fetch('https://api.example.com/v1/send-journal/{controlId}/resolve', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/v1/send-journal/{controlId}/resolve"

payload = {
    "evidenceReference": "<string>",
    "note": "<string>"
}
headers = {
    "X-Idempotency": "<x-idempotency>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "channelId": "spb",
  "closedByHand": {
    "closedAt": "2023-11-07T05:31:56Z",
    "closedBy": "<string>",
    "evidenceReference": "<string>",
    "note": "<string>"
  },
  "controlId": "<string>",
  "engineId": "<string>",
  "outcome": "DETERMINED",
  "queries": {
    "count": 2,
    "lastAnswer": "VENDOR",
    "lastQueriedAt": "2023-11-07T05:31:56Z"
  },
  "resolution": {
    "actualOutcome": "REACHED_VENDOR",
    "means": "<string>",
    "note": "<string>",
    "resolvedAt": "2023-11-07T05:31:56Z",
    "resolvedBy": "<string>"
  },
  "sentAt": "2023-11-07T05:31:56Z",
  "vendorCode": "<string>",
  "vendorSequence": "<string>",
  "ageSeconds": 123
}

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

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

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

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

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

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

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

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

Close an indeterminate send by hand

Records an operator’s finding on an INDETERMINATE send — the engine’s settle or revert, JD support’s written answer — with the evidence and a note, and changes nothing else. It is a record, never a routing decision: the outcome stays INDETERMINATE, a second send of the same control id is still refused, and the engine’s ConsultaNumCtrlIF is still forwarded to JD, whose answer may still resolve the row. It never resends and calls no vendor. The Courier offers no by-hand NOT_SENT: an operator wrong about “never sent” would release the control id for a second send, and two TEDs would reach BACEN. What the close changes is the alert: a closed send stops aging. 409 JDC-0303 when the send is not INDETERMINATE or was already closed; 404 JDC-0302 when the journal does not hold it. A body missing a field, carrying a non-string or an unexpected property is 400 JDC-0001; a present field whose value breaks a rule (blank evidence, a note outside 10-500 characters after trimming) is 422 JDC-0002.

POST

send-journal

{controlId}

resolve

Close an indeterminate send by hand

curl --request POST \
  --url https://api.example.com/v1/send-journal/{controlId}/resolve \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "evidenceReference": "<string>",
  "note": "<string>"
}
'

package main

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

func main() {

	url := "https://api.example.com/v1/send-journal/{controlId}/resolve"

	payload := strings.NewReader("{\n  \"evidenceReference\": \"<string>\",\n  \"note\": \"<string>\"\n}")

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

	req.Header.Add("X-Idempotency", "<x-idempotency>")
	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: {
    'X-Idempotency': '<x-idempotency>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({evidenceReference: '<string>', note: '<string>'})
};

fetch('https://api.example.com/v1/send-journal/{controlId}/resolve', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/v1/send-journal/{controlId}/resolve"

payload = {
    "evidenceReference": "<string>",
    "note": "<string>"
}
headers = {
    "X-Idempotency": "<x-idempotency>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "channelId": "spb",
  "closedByHand": {
    "closedAt": "2023-11-07T05:31:56Z",
    "closedBy": "<string>",
    "evidenceReference": "<string>",
    "note": "<string>"
  },
  "controlId": "<string>",
  "engineId": "<string>",
  "outcome": "DETERMINED",
  "queries": {
    "count": 2,
    "lastAnswer": "VENDOR",
    "lastQueriedAt": "2023-11-07T05:31:56Z"
  },
  "resolution": {
    "actualOutcome": "REACHED_VENDOR",
    "means": "<string>",
    "note": "<string>",
    "resolvedAt": "2023-11-07T05:31:56Z",
    "resolvedBy": "<string>"
  },
  "sentAt": "2023-11-07T05:31:56Z",
  "vendorCode": "<string>",
  "vendorSequence": "<string>",
  "ageSeconds": 123
}

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

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

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

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

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

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

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

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

Headers

X-Idempotency

string

required

Idempotency key; a retry with the same key and body replays the first answer.

Path Parameters

controlId

string

required

Maximum string length: 256

Body

application/json

evidenceReference

string

required

Where the finding can be checked: the engine's settle or revert, a JD support ticket. Non-blank, at most 512 characters after trimming, or 422 JDC-0002.

note

string

required

What the operator established. 10 to 500 characters after trimming, or 422 JDC-0002.

Response

channelId

enum<string>

required

Available options:

spb

closedByHand

object | null

required

An operator's by-hand close; null unless one was recorded. A record only: the outcome is unchanged.

Show child attributes

controlId

string

required

engineId

string

required

Originating engine; this field routes the SPB return leg.

outcome

enum<string>

required

Available options:

DETERMINED,

INDETERMINATE,

RESOLVED,

NOT_SENT

queries

object | null

required

The engine's ConsultaNumCtrlIF trail for this send; null until the first.

Show child attributes

resolution

object | null

required

How the vendor's own answer settled an indeterminate send; null until it did.

Show child attributes

sentAt

string<date-time>

required

vendorCode

string | null

required

vendorSequence

string | null

required

ageSeconds

integer<int64>

Present while the outcome is INDETERMINATE: seconds since the send left, growing, for an open send; frozen at closedAt minus sentAt once an operator closed it by hand, because a closed send no longer ages for the alert.

Engines

Ownership map

Engine API

Channels

Messages

Send journal

Reconciliation

Error handling

Close an indeterminate send by hand

Authorizations

Headers

Path Parameters

Body

Response