GetbeelDocs
Riferimento APIBank reconciliation

Approve a match

Confirms the invoice found; for an unmatched payment, confirms that no invoice is needed. Live keys only (403 livemode_required with a test key): bank and connection data is real, there is no sandbox for it.

POST
/reconciliations/{id}/matches/{matchId}/approve

Confirms the invoice found; for an unmatched payment, confirms that no invoice is needed. Live keys only (403 livemode_required with a test key): bank and connection data is real, there is no sandbox for it.

Autorizzazione

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

id*string
matchId*string
Formatuuid
Getbeel-Company?string

Act on one of the account's client companies (its id from GET /companies) instead of the key's own account. 404 company_not_found when the key cannot act on it.

Formatuuid

Corpo della risposta

OK

application/json
  1. response
object*string
id*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
reconciliation_id*string
match_type*string

exact and fuzzy: found by the AI (fuzzy needs a closer look); manual: linked by a person; unmatched: no invoice found

Value in"exact""fuzzy""manual""unmatched"
state*string

to_confirm: an invoice was found, waiting for approval; reconciled: invoice confirmed; missing_invoice: no invoice found for the payment; no_invoice_needed: marked as not needing one; rejected: the suggested match was rejected

Value in"to_confirm""reconciled""missing_invoice""no_invoice_needed""rejected"
review_status*string
Value in"pending""approved""rejected""modified"
confidence*string

AI confidence from 0.00 to 1.00

reasons*array<string>
amount_difference*|null
transaction*
invoice*|

The received (supplier) invoice matched

reviewed_at*|null
Esempio di richiesta
curl -X POST 'https://www.getbeel.com/api/v1/reconciliations/string/matches/497f6eca-6276-4993-bfeb-53cbbbba6f08/approve'
Esempio di risposta
{  "object": "reconciliation_match",  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "reconciliation_id": "string",  "match_type": "exact",  "state": "to_confirm",  "review_status": "pending",  "confidence": "0.95",  "reasons": [    "string"  ],  "amount_difference": "122.00",  "transaction": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "date": "2026-10-29",    "description": "string",    "counterparty_name": "string",    "amount": "122.00",    "currency": "string"  },  "invoice": {    "id": "string",    "vendor_name": "string",    "invoice_number": "string",    "invoice_date": "2026-10-29",    "amount_total": "122.00",    "currency": "string"  },  "reviewed_at": "2019-08-24T14:15:22Z"}