Update Banking Transaction

Updates editable fields on a banking transaction, identified by transactionId.

Use this endpoint to enrich transactions in your reconciliation flow or ERP — for example, by recording operation context, reconciling the transaction, or classifying it by category and cost center.

Editable fields today:

notes — transaction notes (max 1000 characters). Send an empty string ("") to clear.
isConciled — marks the transaction as reconciled. Only true is accepted — reconciling is irreversible via the API.
categoryId — numeric category ID.
costCenterId — UUID of the cost center (use the id field from GET /cost-centers/v1/cost-centers).

Rules:

transactionId must be the transaction id from the statement (GET /statements/v1/banking).
At least one field must be provided in the body.
Sending isConciled: false returns 400 Bad Request.
A categoryId or costCenterId that doesn't exist for the company returns 400 Bad Request.
When the transaction can't be reconciled, the API returns 409 Conflict.
On success, the API returns 204 No Content (no body).

Example:

curl -X PATCH https://api-sandbox.contasimples.com/statements/v1/banking/106615 \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{"notes":"Supplier payment","isConciled":true,"categoryId":1146}'

curl -X PATCH "https://api-sandbox.contasimples.com/statements/v1/banking/106615" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
  "notes": "Supplier payment",
  "isConciled": true,
  "categoryId": 1146,
  "costCenterId": "a02f8f63-8b1b-4328-9d7d-0d2e351b8118"
}'

import requests
import json

url = "https://api-sandbox.contasimples.com/statements/v1/banking/106615"
headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_TOKEN"
}
data = {
  "notes": "Supplier payment",
  "isConciled": true,
  "categoryId": 1146,
  "costCenterId": "a02f8f63-8b1b-4328-9d7d-0d2e351b8118"
}

response = requests.patch(url, headers=headers, json=data)
print(response.json())

const response = await fetch("https://api-sandbox.contasimples.com/statements/v1/banking/106615", {
  method: "PATCH",
  headers: {
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_TOKEN"
},
  body: JSON.stringify({
  "notes": "Supplier payment",
  "isConciled": true,
  "categoryId": 1146,
  "costCenterId": "a02f8f63-8b1b-4328-9d7d-0d2e351b8118"
})
});

const data = await response.json();
console.log(data);

package main

import (
    "fmt"
    "net/http"
    "bytes"
    "encoding/json"
)

func main() {
    data := []byte(`{
  "notes": "Supplier payment",
  "isConciled": true,
  "categoryId": 1146,
  "costCenterId": "a02f8f63-8b1b-4328-9d7d-0d2e351b8118"
}`)

    req, err := http.NewRequest("PATCH", "https://api-sandbox.contasimples.com/statements/v1/banking/106615", bytes.NewBuffer(data))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    fmt.Println("Response Status:", resp.Status)
}

require 'net/http'
require 'json'

uri = URI('https://api-sandbox.contasimples.com/statements/v1/banking/106615')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN'
request.body = '{
  "notes": "Supplier payment",
  "isConciled": true,
  "categoryId": 1146,
  "costCenterId": "a02f8f63-8b1b-4328-9d7d-0d2e351b8118"
}'

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

{}

{
  "error": "Bad Request",
  "message": "The request contains invalid parameters or malformed data",
  "code": 400,
  "requestId": "123e4567-e89b-12d3-a456-426614174000",
  "details": [
    "isConciled only accepts true — unmarking a transaction as reconciled is no longer supported"
  ]
}