Přejít na hlavní obsah
POST
/
document-mails
Odoslať doklad emailom
curl --request POST \
  --url https://app.fintoro.sk/api/public/v1/document-mails \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "documentType": "invoice",
  "documentId": 301,
  "to": [
    "billing@example.test",
    "owner@example.test"
  ],
  "type": "reminder",
  "body": "V prílohe nájdete doklad."
}
'
{
  "message": "Unauthenticated."
}

Autorizace

​
Authorization
string
header
povinné

Bearer token vytvorený pre konkrétnu firmu v Integrácie → API.

Hlavičky

​
Idempotency-Key
string

Voliteľný identifikátor requestu pre bezpečné retry. Použite unikátnu hodnotu pre každé create volanie, ktoré chcete vedieť bezpečne zopakovať.

Příklad:

"invoice-create-2026-03-03-001"

Tělo

application/json

Payload pre odoslanie podporovaného dokladu emailom. Cieľový doklad sa určuje cez kombináciu documentType + documentId a musí byť dostupný pre token.

​
documentType
enum<string>
povinné

Typ dokladu, ktorý chcete odoslať emailom.

Dostupné možnosti:
invoice,
proforma,
order,
credit-note,
quotation
Příklad:

"invoice"

​
documentId
integer
povinné

ID podporovaného dokladu patriaceho.

Příklad:

301

​
to
string<email>[]
povinné

Pole jednej alebo viacerých cieľových e-mailových adries.

Minimum array length: 1
Příklad:
[
  "billing@example.test",
  "owner@example.test"
]
​
type
enum<string>
povinné

Typ odosielaného mailu. Pri invoice a proforma ovplyvňuje predmet a typ šablóny; pri order, credit-note a quotation sa momentálne správa rovnako ako regular.

Dostupné možnosti:
regular,
reminder,
overdue_reminder,
confirmation
Příklad:

"reminder"

​
body
string | null

Voliteľný vlastný text vložený do tela emailu.

Maximum string length: 1000
Příklad:

"V prílohe nájdete doklad."

Odpověď

Požiadavka na odoslanie dokladu bola prijatá.