---
title: "Siūlyti įrašą / Propose record"
method: POST
path: "/api/agent/v1/tools/propose_record"
---

# Siūlyti įrašą / Propose record

`POST /api/agent/v1/tools/propose_record`

## Request

- Base URL: `https://app.taxmeter.lt`
- URL: `https://app.taxmeter.lt/api/agent/v1/tools/propose_record`
- Auth: OAuth 2 (authorization code, authorization URL `https://app.taxmeter.lt/oauth/authorize`, token URL `https://app.taxmeter.lt/oauth/token`, scopes: `prepare`)

Propose source facts and an explicit tax treatment. Values are integer minor units. No approval; unsupported cases remain blocked.

## Request body

- object
  - `segmentId` string, required
  - `periodId` string, required
  - `record` object, required
    - `kind` 'invoice' | 'credit_note' | 'receipt', required
    - `receiptRule` 'lt_fuel_retail_receipt' | 'foreign_reverse_charge_payment_document' | 'foreign_eservice_lt_vat_charged' | 'unknown'
    - `direction` 'purchase' | 'sale', required
    - `invoiceNumber` string, required
    - `date` string, date, required
    - `taxPointDate` string, date, required
    - `registrationDate` string, date, required
    - `periodBasis` string, required
    - `supplier` object, required
      - `name` string, required
      - `country` string, required
      - `vatId` string, nullable, required
      - `registrationId` string, nullable, required
    - `customer` object, required
      - `name` string, required
      - `country` string, required
      - `vatId` string, nullable, required
      - `registrationId` string, nullable, required
    - `currency` 'EUR' | 'USD' | 'GBP', required
    - `totalMinor` integer, required
    - `lines` object[], required
      - `netMinor` integer, required
      - `vatMinor` integer, nullable, required
      - `vatStatement` 'stated' | 'not_stated'
      - `statedRateBps` integer, nullable, required
      - `treatment` string, nullable, required
      - `deductionBps` integer, nullable, required
      - `deductionReason` string, required
    - `originalInvoice` object, nullable, required
      - `number` string, required
      - `date` string, date, required
      - `recordId` string, nullable, required
    - `evidence` string, required
    - `notes` string, required
  - `expectedRevision` integer, required

## Response `200`

Įrankio rezultatas / Tool result

- object

## Other responses

- `400`: Netinkami argumentai / Invalid arguments
- `401`: Reikalingas OAuth / OAuth required
- `403`: Prieiga nesuteikta / Permission or current legal acceptance required
- `404`: Nerasta / Tool or object not found
- `409`: Pasenusi versija / Stale revision or digest
- `413`: Per didelis turinys / Size limit
- `429`: Naudojimo riba / Quota or rate limit
- `503`: Priežiūra / Maintenance
- `507`: Trūksta vietos / Disk space low

---

[API](https://skmtc.dev/taxmeter/apis/taxmeter-agentu-http-api-taxmeter-agent-http-api.md) · [All operations](https://skmtc.dev/taxmeter/apis/taxmeter-agentu-http-api-taxmeter-agent-http-api/llms.txt) · [OpenAPI document](https://skmtc.dev/taxmeter/apis/taxmeter-agentu-http-api-taxmeter-agent-http-api/revisions/f61468f014c7?raw)