Kontakty

CRUD pre obchodných partnerov + endpointy pre dokumenty kontaktu a štatistiky.

Kontakty sú obchodní partneri – odberatelia aj dodávatelia. Sú immutable – PATCH vytvorí novú verziu a stará verzia ostane v histórii. Stabilný id sa nemení; field version s každou úpravou rastie.

Endpointy

POST/api/v1/contactscontacts:write

Vytvorí nový kontakt.

Request

curl -X POST "https://monivio.sk/api/v1/contacts" \
  -H "Authorization: Bearer mk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "company",
  "name": "ACME s.r.o.",
  "company_id": "12345678",
  "tax_id": "2023456789",
  "vat_id": "SK2023456789",
  "email": "info@acme.sk",
  "phone": "+421 901 234 567",
  "billing_street": "Hlavná 12",
  "billing_city": "Bratislava",
  "billing_postal_code": "81101",
  "billing_country": "SK"
}'

Response 201json

{
  "data": {
    "id": "con_2hf8pq3rxn4mlkzyt9abwvve",
    "version": 1,
    "type": "company",
    "name": "ACME s.r.o.",
    "company_id": "12345678",
    "tax_id": "2023456789",
    "vat_id": "SK2023456789",
    "email": "info@acme.sk",
    "phone": "+421 901 234 567",
    "web": null,
    "billing_street": "Hlavná 12",
    "billing_city": "Bratislava",
    "billing_postal_code": "81101",
    "billing_country": "SK",
    "shipping_street": null,
    "shipping_city": null,
    "shipping_postal_code": null,
    "shipping_country": null,
    "notes": null,
    "created_at": "2026-04-15T10:23:00.000Z",
    "updated_at": "2026-04-15T10:23:00.000Z"
  }
}

GET/api/v1/contactscontacts:read

Zoznam kontaktov so stránkovaním a filtrami.

Request

curl "https://monivio.sk/api/v1/contacts?search=ACME&type=company&limit=10" \
  -H "Authorization: Bearer mk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Response 200json

{
  "data": [
    {
      "id": "con_2hf8pq3rxn4mlkzyt9abwvve",
      "version": 1,
      "type": "company",
      "name": "ACME s.r.o.",
      "company_id": "12345678",
      "tax_id": "2023456789",
      "vat_id": "SK2023456789",
      "email": "info@acme.sk",
      "phone": "+421 901 234 567",
      "web": null,
      "billing_street": "Hlavná 12",
      "billing_city": "Bratislava",
      "billing_postal_code": "81101",
      "billing_country": "SK",
      "shipping_street": null,
      "shipping_city": null,
      "shipping_postal_code": null,
      "shipping_country": null,
      "notes": null,
      "created_at": "2026-04-15T10:23:00.000Z",
      "updated_at": "2026-04-15T10:23:00.000Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 10,
    "total": 1,
    "total_pages": 1
  }
}

GET/api/v1/contacts/{id}contacts:read

Detail jedného kontaktu.

Request

curl "https://monivio.sk/api/v1/contacts/con_2hf8pq3rxn4mlkzyt9abwvve" \
  -H "Authorization: Bearer mk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Response 200json

{
  "data": {
    "id": "con_2hf8pq3rxn4mlkzyt9abwvve",
    "version": 1,
    "type": "company",
    "name": "ACME s.r.o.",
    "company_id": "12345678",
    "tax_id": "2023456789",
    "vat_id": "SK2023456789",
    "email": "info@acme.sk",
    "phone": "+421 901 234 567",
    "web": null,
    "billing_street": "Hlavná 12",
    "billing_city": "Bratislava",
    "billing_postal_code": "81101",
    "billing_country": "SK",
    "shipping_street": null,
    "shipping_city": null,
    "shipping_postal_code": null,
    "shipping_country": null,
    "notes": null,
    "created_at": "2026-04-15T10:23:00.000Z",
    "updated_at": "2026-04-15T10:23:00.000Z"
  }
}

PATCH/api/v1/contacts/{id}contacts:write

Vytvorí novú verziu kontaktu (id zostáva, version+1). Stačí poslať polia, ktoré meníš.

Request

curl -X PATCH "https://monivio.sk/api/v1/contacts/con_2hf8pq3rxn4mlkzyt9abwvve" \
  -H "Authorization: Bearer mk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
  "email": "fakturacia@acme.sk",
  "phone": "+421 902 345 678"
}'

Response 200json

{
  "data": {
    "id": "con_2hf8pq3rxn4mlkzyt9abwvve",
    "version": 2,
    "type": "company",
    "name": "ACME s.r.o.",
    "company_id": "12345678",
    "tax_id": "2023456789",
    "vat_id": "SK2023456789",
    "email": "fakturacia@acme.sk",
    "phone": "+421 902 345 678",
    "web": null,
    "billing_street": "Hlavná 12",
    "billing_city": "Bratislava",
    "billing_postal_code": "81101",
    "billing_country": "SK",
    "shipping_street": null,
    "shipping_city": null,
    "shipping_postal_code": null,
    "shipping_country": null,
    "notes": null,
    "created_at": "2026-04-15T10:23:00.000Z",
    "updated_at": "2026-05-06T08:42:11.000Z"
  }
}

DELETE/api/v1/contacts/{id}contacts:write

Vymaže kontakt. Zmizne z výpisov, ale dokumenty s ním ostávajú zachované.

Request

curl -X DELETE "https://monivio.sk/api/v1/contacts/con_2hf8pq3rxn4mlkzyt9abwvve" \
  -H "Authorization: Bearer mk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Objekt Contact

idreadonly

string

Stabilný CUID2 identifikátor s prefixom con_.

Príklad: con_2hf8pq3rxn4mlkzyt9abwvve

versionreadonly

number

Číslo aktuálnej verzie. Pri každom PATCH-i sa zvýši o 1.

Príklad: 3

typerequired

"company" | "individual"

Typ subjektu. Company má company_id/vat_id, individual nie.

namerequired

string

Obchodné meno (pri company) alebo meno + priezvisko (pri individual).

Príklad: ACME s.r.o.

company_id

string/ null

IČO. Pre slovenské firmy 8-miestne číslo.

Príklad: 12345678

tax_id

string/ null

DIČ. Pre slovenské firmy 10-miestne číslo.

Príklad: 2023456789

vat_id

string/ null

IČ DPH. Formát SK + 10 číslic pre platcov DPH na SK.

Príklad: SK2023456789

email

string/ null

Hlavný kontaktný email. Použije sa pri odosielaní faktúr ak v send requeste neuvedieš to[].

phone

string/ null

Telefón v ľubovoľnom formáte. Odporúčame E.164 (+421 901 234 567).

web

string/ null

Webstránka kontaktu.

billing_street

string/ null

Fakturačná adresa – ulica a číslo.

billing_city

string/ null

Fakturačná adresa – mesto.

billing_postal_code

string/ null

Fakturačná adresa – PSČ.

billing_country

string/ null

ISO 3166-1 alpha-2 kód krajiny – pozri Reference → Krajiny.

Príklad: SK

shipping_street

string/ null

Dodacia adresa – ulica. Ak je null, použije sa fakturačná.

shipping_city

string/ null

Dodacia adresa – mesto.

shipping_postal_code

string/ null

Dodacia adresa – PSČ.

shipping_country

string/ null

Dodacia adresa – ISO 3166-1 alpha-2.

notes

string/ null

Interné poznámky (max 5000 znakov). Nezobrazujú sa kontaktu.

tag_ids

string[]

Iba pri zápise – voliteľné pole tagov pre kontakt (max 20). V odpovedi sa tagy nevracajú; pre prepojenia pozri /api/v1/tags.

created_atreadonly

string (ISO 8601)

Kedy bol kontakt prvýkrát vytvorený.

updated_atreadonly

string (ISO 8601)

Posledná zmena – pri PATCH-i sa updatne, pri pôvodnej verzii ostáva.