Kontakty
Operace ve skupině Kontakty.
- GET/v1/contact-groups
- POST/v1/contact-groups
- GET/v1/contacts
- POST/v1/contacts
- GET/v1/contacts/{id}
- PATCH/v1/contacts/{id}
- DEL/v1/contacts/{id}
- GET/v1/contacts/{id}/activity
- GET/v1/contacts/{id}/addresses
- POST/v1/contacts/{id}/addresses
- PATCH/v1/contacts/{id}/addresses/{addressId}
- DEL/v1/contacts/{id}/addresses/{addressId}
- GET/v1/contacts/{id}/bank-accounts
- POST/v1/contacts/{id}/bank-accounts
- PATCH/v1/contacts/{id}/bank-accounts/{accountId}
- DEL/v1/contacts/{id}/bank-accounts/{accountId}
- GET/v1/contacts/{id}/credit
- POST/v1/contacts/{id}/groups
- DEL/v1/contacts/{id}/groups/{groupId}
- POST/v1/contacts/{id}/insolvency-check
- POST/v1/contacts/{id}/insolvency-watch
- POST/v1/contacts/{id}/merge
- GET/v1/contacts/{id}/persons
- POST/v1/contacts/{id}/persons
- PATCH/v1/contacts/{id}/persons/{personId}
- DEL/v1/contacts/{id}/persons/{personId}
- POST/v1/contacts/{id}/vat-check
- POST/v1/contacts/{id}/vies
- GET/v1/contacts/export
- POST/v1/contacts/import
- POST/v1/contacts/insolvency-watch
- POST/v1/contacts/lookup/ares
Seznam: skupiny, kontakt
/v1/contact-groupsList contact groups
Nástroj MCP: list-contact-groups
Parametry dotazu
limitintegermin 1max 500offsetintegermin 0max 9007199254740991searchstringmax 200 charsOdpověď · 200
dataobject[]povinnéobject"contact_group"povinnéidstringpovinnénamestringpovinnétotalintegerhasMorebooleanpovinnéVytvoření: skupina, kontakt
/v1/contact-groupsCreate a contact group
Nástroj MCP: create-contact-group
Tělo požadavku
namestringpovinnémax 80 charsOdpověď · 201
idstringpovinnénamestringpovinnéSeznam: kontakty
/v1/contactsList contacts (customers and suppliers), with what each one owes
Nástroj MCP: list-contacts
Parametry dotazu
limitintegermin 1max 500offsetintegermin 0max 9007199254740991searchstringmax 200 charsqstringmax 200 charsrolesstringowing"true" | "false"restricted"true" | "false"groupIdstringcustomFieldKeystringcustomFieldValuestringmax 2000 charsOdpověď · 200
dataobject[]povinnécustomFieldsobjectoborstringoblaststringregionnull | stringslevaintegersmlouva_odstringdatepoznamka_obchodustringobject"contact"povinnéidstringpovinnékindstringrolesstringnamestringnameOnDocumentsstring | nulliconull | stringdicnull | stringvatPayerTypestringemailnull | stringphonenull | stringmobilenull | stringwwwnull | stringnotenull | stringdataBoxIdstring | nullexternalCodenull | stringusualDueDaysinteger | nullsupplierDueDaysinteger | nullpreferredPaymentMethodstring | nullinvoiceLanguagenull | stringdefaultCurrencystringcreditWarnHalerinteger | nullcreditBlockHalerinteger | nullreminderOnDuebooleanreminderWeekAfterbooleanreminder14DaysAfterbooleanreminderMonthAfterbooleanunreliableVatPayerboolean | nullvatCheckedAtstring | nullviesValidboolean | nullviesCheckedAtstring | nullinsolvencyStatusnull | stringinsolvencyCheckedAtnull | stringdate-timeinsolvencyProceedingsobject[]iconull | stringpovinnéurlstringpovinnénamestringpovinnéstatestringpovinnéactivebooleanpovinnésenatestringpovinnéendedOnanypovinnéstartedOnstringpovinnédatefileNumberstringpovinnégdprRestrictedbooleanmarketingOptOutbooleanowingHalerintegergroupIdsstring[]groupsobject[]object"contact_group"povinnéidstringpovinnénamestringpovinnécreatedAtnull | stringdate-timeupdatedAtnull | stringdate-timeinsolvencyWatchbooleaninsolvencyChangedAtnull | stringdate-timeaddressesobject[]object"address"povinnéidstringpovinnécontactIdnull | stringpovinnétypestringpovinnénamestring | nullpovinnéstreetnull | stringpovinnécitynull | stringpovinnépostalCodenull | stringpovinnécountrynull | stringpovinnéregionnull | stringpovinnéemailstring | nullpovinnéphonestring | nullpovinnéisDefaultbooleanpovinnébankAccountsobject[]object"bank_account"povinnéidstringpovinnécontactIdnull | stringlabelnull | stringaccountNumbernull | stringpovinnébankCodenull | stringpovinnéibannull | stringpovinnécurrencystringpovinnéisDefaultbooleanpovinnépublishedFromRegistrybooleanbicnull | stringbankNamenull | stringbankStreetstring | nullbankCitystring | nullnamestringswiftnull | stringledgerAccountstringisActivebooleanopeningBalanceHalerintegeropeningDatenull | stringdateopeningExchangeRatestring | nullopeningStatestringbankBalanceHalerinteger | nullbankBalanceOnnull | stringdatefioobjectconfiguredbooleanpovinnéenabledbooleanpovinnélastSyncedAtnull | stringpovinnédate-timelastSyncedOnnull | stringpovinnédatelastErrornull | stringpovinnécreatedAtstringdate-timebalanceHalerintegerunmatchedCountintegerbalanceDiffHalerinteger | nullsepaCreditorIdnull | stringpersonsobject[]object"contact_person"povinnéidstringpovinnécontactIdstringpovinnénamestringpovinnégreetingstring | nullpovinnétitlenull | stringpovinnéemailnull | stringpovinnéphonenull | stringpovinnémobilestring | nullpovinnénotestring | nullpovinnéduplicateIcoobjectexistingIdstringpovinnénamestringpovinnéattachmentsany[]documentsobject[]object"credit_note" | "delivery_note" | "invoice" | "proforma" | "received_invoice"povinnéidstringpovinnénumbernull | stringpovinnévariableSymbolnull | stringcontactIdnull | stringpovinnécontactNamenull | stringpovinnéissueDatenull | stringpovinnédatedueDatenull | stringdatecurrencynull | stringtotalHalerinteger | nullpaidHalerintegerstatusstringpovinnéoverduebooleanfileIdnull | stringpovinnésupplierDocumentNumbernull | stringkindstringoriginalInvoiceNumbernull | stringdeliveryDatestringdatecarrierIdstring | nullmergedFromstringtotalintegerhasMorebooleanpovinnéVytvoření: kontakt
/v1/contactsCreate a contact. Call lookup-ares first when you have an IČO, to fill in the official name, address, and DIČ
Nástroj MCP: create-contact
Tělo požadavku
kind"company" | "person"roles"customer" | "supplier" | "both"namestringpovinnémax 160 charsnameOnDocumentsstring | nullicostring | nulldicstring | nullvatPayerType"payer" | "non_payer"emailstring | nullphonestring | nullmobilestring | nullwwwstring | nullnotestring | nulldataBoxIdstring | nullexternalCodestring | nullusualDueDaysinteger | nullsupplierDueDaysinteger | nullpreferredPaymentMethod"transfer" | "cash" | "proforma" | "card" | "cod" | nullinvoiceLanguage"cs" | "en" | "sk" | "de" | "fr" | "pl" | nulldefaultCurrencystring3 charscreditWarnHalerinteger | nullcreditBlockHalerinteger | nullreminderOnDuebooleanreminderWeekAfterbooleanreminder14DaysAfterbooleanreminderMonthAfterbooleanallowDuplicateIcobooleanOdpověď · 201
customFieldsobjectoborstringoblaststringregionnull | stringslevaintegersmlouva_odstringdatepoznamka_obchodustringidstringpovinnékindstringrolesstringnamestringnameOnDocumentsstring | nulliconull | stringdicnull | stringvatPayerTypestringemailnull | stringphonenull | stringmobilenull | stringwwwnull | stringnotenull | stringdataBoxIdstring | nullexternalCodenull | stringusualDueDaysinteger | nullsupplierDueDaysinteger | nullpreferredPaymentMethodstring | nullinvoiceLanguagenull | stringdefaultCurrencystringcreditWarnHalerinteger | nullcreditBlockHalerinteger | nullreminderOnDuebooleanreminderWeekAfterbooleanreminder14DaysAfterbooleanreminderMonthAfterbooleanunreliableVatPayerboolean | nullvatCheckedAtstring | nullviesValidboolean | nullviesCheckedAtstring | nullinsolvencyStatusnull | stringinsolvencyCheckedAtnull | stringdate-timeinsolvencyProceedingsobject[]iconull | stringpovinnéurlstringpovinnénamestringpovinnéstatestringpovinnéactivebooleanpovinnésenatestringpovinnéendedOnanypovinnéstartedOnstringpovinnédatefileNumberstringpovinnégdprRestrictedbooleanmarketingOptOutbooleanowingHalerintegergroupIdsstring[]groupsobject[]object"contact_group"povinnéidstringpovinnénamestringpovinnécreatedAtnull | stringdate-timeupdatedAtnull | stringdate-timeinsolvencyWatchbooleaninsolvencyChangedAtnull | stringdate-timeaddressesobject[]object"address"povinnéidstringpovinnécontactIdnull | stringpovinnétypestringpovinnénamestring | nullpovinnéstreetnull | stringpovinnécitynull | stringpovinnépostalCodenull | stringpovinnécountrynull | stringpovinnéregionnull | stringpovinnéemailstring | nullpovinnéphonestring | nullpovinnéisDefaultbooleanpovinnébankAccountsobject[]object"bank_account"povinnéidstringpovinnécontactIdnull | stringlabelnull | stringaccountNumbernull | stringpovinnébankCodenull | stringpovinnéibannull | stringpovinnécurrencystringpovinnéisDefaultbooleanpovinnépublishedFromRegistrybooleanbicnull | stringbankNamenull | stringbankStreetstring | nullbankCitystring | nullnamestringswiftnull | stringledgerAccountstringisActivebooleanopeningBalanceHalerintegeropeningDatenull | stringdateopeningExchangeRatestring | nullopeningStatestringbankBalanceHalerinteger | nullbankBalanceOnnull | stringdatefioobjectconfiguredbooleanpovinnéenabledbooleanpovinnélastSyncedAtnull | stringpovinnédate-timelastSyncedOnnull | stringpovinnédatelastErrornull | stringpovinnécreatedAtstringdate-timebalanceHalerintegerunmatchedCountintegerbalanceDiffHalerinteger | nullsepaCreditorIdnull | stringpersonsobject[]object"contact_person"povinnéidstringpovinnécontactIdstringpovinnénamestringpovinnégreetingstring | nullpovinnétitlenull | stringpovinnéemailnull | stringpovinnéphonenull | stringpovinnémobilestring | nullpovinnénotestring | nullpovinnéduplicateIcoobjectexistingIdstringpovinnénamestringpovinnéattachmentsany[]documentsobject[]object"credit_note" | "delivery_note" | "invoice" | "proforma" | "received_invoice"povinnéidstringpovinnénumbernull | stringpovinnévariableSymbolnull | stringcontactIdnull | stringpovinnécontactNamenull | stringpovinnéissueDatenull | stringpovinnédatedueDatenull | stringdatecurrencynull | stringtotalHalerinteger | nullpaidHalerintegerstatusstringpovinnéoverduebooleanfileIdnull | stringpovinnésupplierDocumentNumbernull | stringkindstringoriginalInvoiceNumbernull | stringdeliveryDatestringdatecarrierIdstring | nullmergedFromstringDetail: kontakt
/v1/contacts/{id}Get a contact with its addresses, bank accounts, persons, and groups
Nástroj MCP: get-contact
Parametry v cestě
idstringpovinnéOdpověď · 200
customFieldsobjectoborstringoblaststringregionnull | stringslevaintegersmlouva_odstringdatepoznamka_obchodustringidstringpovinnékindstringrolesstringnamestringnameOnDocumentsstring | nulliconull | stringdicnull | stringvatPayerTypestringemailnull | stringphonenull | stringmobilenull | stringwwwnull | stringnotenull | stringdataBoxIdstring | nullexternalCodenull | stringusualDueDaysinteger | nullsupplierDueDaysinteger | nullpreferredPaymentMethodstring | nullinvoiceLanguagenull | stringdefaultCurrencystringcreditWarnHalerinteger | nullcreditBlockHalerinteger | nullreminderOnDuebooleanreminderWeekAfterbooleanreminder14DaysAfterbooleanreminderMonthAfterbooleanunreliableVatPayerboolean | nullvatCheckedAtstring | nullviesValidboolean | nullviesCheckedAtstring | nullinsolvencyStatusnull | stringinsolvencyCheckedAtnull | stringdate-timeinsolvencyProceedingsobject[]iconull | stringpovinnéurlstringpovinnénamestringpovinnéstatestringpovinnéactivebooleanpovinnésenatestringpovinnéendedOnanypovinnéstartedOnstringpovinnédatefileNumberstringpovinnégdprRestrictedbooleanmarketingOptOutbooleanowingHalerintegergroupIdsstring[]groupsobject[]object"contact_group"povinnéidstringpovinnénamestringpovinnécreatedAtnull | stringdate-timeupdatedAtnull | stringdate-timeinsolvencyWatchbooleaninsolvencyChangedAtnull | stringdate-timeaddressesobject[]object"address"povinnéidstringpovinnécontactIdnull | stringpovinnétypestringpovinnénamestring | nullpovinnéstreetnull | stringpovinnécitynull | stringpovinnépostalCodenull | stringpovinnécountrynull | stringpovinnéregionnull | stringpovinnéemailstring | nullpovinnéphonestring | nullpovinnéisDefaultbooleanpovinnébankAccountsobject[]object"bank_account"povinnéidstringpovinnécontactIdnull | stringlabelnull | stringaccountNumbernull | stringpovinnébankCodenull | stringpovinnéibannull | stringpovinnécurrencystringpovinnéisDefaultbooleanpovinnépublishedFromRegistrybooleanbicnull | stringbankNamenull | stringbankStreetstring | nullbankCitystring | nullnamestringswiftnull | stringledgerAccountstringisActivebooleanopeningBalanceHalerintegeropeningDatenull | stringdateopeningExchangeRatestring | nullopeningStatestringbankBalanceHalerinteger | nullbankBalanceOnnull | stringdatefioobjectconfiguredbooleanpovinnéenabledbooleanpovinnélastSyncedAtnull | stringpovinnédate-timelastSyncedOnnull | stringpovinnédatelastErrornull | stringpovinnécreatedAtstringdate-timebalanceHalerintegerunmatchedCountintegerbalanceDiffHalerinteger | nullsepaCreditorIdnull | stringpersonsobject[]object"contact_person"povinnéidstringpovinnécontactIdstringpovinnénamestringpovinnégreetingstring | nullpovinnétitlenull | stringpovinnéemailnull | stringpovinnéphonenull | stringpovinnémobilestring | nullpovinnénotestring | nullpovinnéduplicateIcoobjectexistingIdstringpovinnénamestringpovinnéattachmentsany[]documentsobject[]object"credit_note" | "delivery_note" | "invoice" | "proforma" | "received_invoice"povinnéidstringpovinnénumbernull | stringpovinnévariableSymbolnull | stringcontactIdnull | stringpovinnécontactNamenull | stringpovinnéissueDatenull | stringpovinnédatedueDatenull | stringdatecurrencynull | stringtotalHalerinteger | nullpaidHalerintegerstatusstringpovinnéoverduebooleanfileIdnull | stringpovinnésupplierDocumentNumbernull | stringkindstringoriginalInvoiceNumbernull | stringdeliveryDatestringdatecarrierIdstring | nullmergedFromstringÚprava: kontakt
/v1/contacts/{id}Update a contact. Documents already issued keep the details they were issued with
Nástroj MCP: update-contact
Parametry v cestě
idstringpovinnéTělo požadavku
kind"company" | "person"roles"customer" | "supplier" | "both"namestringmax 160 charsnameOnDocumentsstring | nullicostring | nulldicstring | nullvatPayerType"payer" | "non_payer"emailstring | nullphonestring | nullmobilestring | nullwwwstring | nullnotestring | nulldataBoxIdstring | nullexternalCodestring | nullusualDueDaysinteger | nullsupplierDueDaysinteger | nullpreferredPaymentMethod"transfer" | "cash" | "proforma" | "card" | "cod" | nullinvoiceLanguage"cs" | "en" | "sk" | "de" | "fr" | "pl" | nulldefaultCurrencystring3 charscreditWarnHalerinteger | nullcreditBlockHalerinteger | nullreminderOnDuebooleanreminderWeekAfterbooleanreminder14DaysAfterbooleanreminderMonthAfterbooleanallowDuplicateIcobooleanOdpověď · 200
customFieldsobjectoborstringoblaststringregionnull | stringslevaintegersmlouva_odstringdatepoznamka_obchodustringidstringpovinnékindstringrolesstringnamestringnameOnDocumentsstring | nulliconull | stringdicnull | stringvatPayerTypestringemailnull | stringphonenull | stringmobilenull | stringwwwnull | stringnotenull | stringdataBoxIdstring | nullexternalCodenull | stringusualDueDaysinteger | nullsupplierDueDaysinteger | nullpreferredPaymentMethodstring | nullinvoiceLanguagenull | stringdefaultCurrencystringcreditWarnHalerinteger | nullcreditBlockHalerinteger | nullreminderOnDuebooleanreminderWeekAfterbooleanreminder14DaysAfterbooleanreminderMonthAfterbooleanunreliableVatPayerboolean | nullvatCheckedAtstring | nullviesValidboolean | nullviesCheckedAtstring | nullinsolvencyStatusnull | stringinsolvencyCheckedAtnull | stringdate-timeinsolvencyProceedingsobject[]iconull | stringpovinnéurlstringpovinnénamestringpovinnéstatestringpovinnéactivebooleanpovinnésenatestringpovinnéendedOnanypovinnéstartedOnstringpovinnédatefileNumberstringpovinnégdprRestrictedbooleanmarketingOptOutbooleanowingHalerintegergroupIdsstring[]groupsobject[]object"contact_group"povinnéidstringpovinnénamestringpovinnécreatedAtnull | stringdate-timeupdatedAtnull | stringdate-timeinsolvencyWatchbooleaninsolvencyChangedAtnull | stringdate-timeaddressesobject[]object"address"povinnéidstringpovinnécontactIdnull | stringpovinnétypestringpovinnénamestring | nullpovinnéstreetnull | stringpovinnécitynull | stringpovinnépostalCodenull | stringpovinnécountrynull | stringpovinnéregionnull | stringpovinnéemailstring | nullpovinnéphonestring | nullpovinnéisDefaultbooleanpovinnébankAccountsobject[]object"bank_account"povinnéidstringpovinnécontactIdnull | stringlabelnull | stringaccountNumbernull | stringpovinnébankCodenull | stringpovinnéibannull | stringpovinnécurrencystringpovinnéisDefaultbooleanpovinnépublishedFromRegistrybooleanbicnull | stringbankNamenull | stringbankStreetstring | nullbankCitystring | nullnamestringswiftnull | stringledgerAccountstringisActivebooleanopeningBalanceHalerintegeropeningDatenull | stringdateopeningExchangeRatestring | nullopeningStatestringbankBalanceHalerinteger | nullbankBalanceOnnull | stringdatefioobjectconfiguredbooleanpovinnéenabledbooleanpovinnélastSyncedAtnull | stringpovinnédate-timelastSyncedOnnull | stringpovinnédatelastErrornull | stringpovinnécreatedAtstringdate-timebalanceHalerintegerunmatchedCountintegerbalanceDiffHalerinteger | nullsepaCreditorIdnull | stringpersonsobject[]object"contact_person"povinnéidstringpovinnécontactIdstringpovinnénamestringpovinnégreetingstring | nullpovinnétitlenull | stringpovinnéemailnull | stringpovinnéphonenull | stringpovinnémobilestring | nullpovinnénotestring | nullpovinnéduplicateIcoobjectexistingIdstringpovinnénamestringpovinnéattachmentsany[]documentsobject[]object"credit_note" | "delivery_note" | "invoice" | "proforma" | "received_invoice"povinnéidstringpovinnénumbernull | stringpovinnévariableSymbolnull | stringcontactIdnull | stringpovinnécontactNamenull | stringpovinnéissueDatenull | stringpovinnédatedueDatenull | stringdatecurrencynull | stringtotalHalerinteger | nullpaidHalerintegerstatusstringpovinnéoverduebooleanfileIdnull | stringpovinnésupplierDocumentNumbernull | stringkindstringoriginalInvoiceNumbernull | stringdeliveryDatestringdatecarrierIdstring | nullmergedFromstringSmazání: kontakt
/v1/contacts/{id}Delete a contact that no document uses
Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.
Nástroj MCP: delete-contact
Parametry v cestě
idstringpovinnéOdpověď · 200
idstringpovinnédeletedbooleanpovinnéSeznam: aktivita, kontakt
/v1/contacts/{id}/activityList the documents and events connected to a contact
Nástroj MCP: list-contact-activity
Parametry v cestě
idstringpovinnéParametry dotazu
limitintegermin 1max 500offsetintegermin 0max 9007199254740991searchstringmax 200 charsOdpověď · 200
dataobject[]povinnétypestringpovinnéatstringpovinnédate-timecontactIdnull | stringdocumentIdnull | stringnumbernull | stringdocumentTypenull | stringtotalintegerhasMorebooleanpovinnéSeznam: adresy, kontakt
/v1/contacts/{id}/addressesList a contact's addresses
Nástroj MCP: list-contact-addresses
Parametry v cestě
idstringpovinnéParametry dotazu
limitintegermin 1max 500offsetintegermin 0max 9007199254740991searchstringmax 200 charsOdpověď · 200
dataobject[]povinnéobject"address"povinnéidstringpovinnécontactIdnull | stringpovinnétypestringpovinnénamestring | nullpovinnéstreetnull | stringpovinnécitynull | stringpovinnépostalCodenull | stringpovinnécountrynull | stringpovinnéregionnull | stringpovinnéemailstring | nullpovinnéphonestring | nullpovinnéisDefaultbooleanpovinnétotalintegerhasMorebooleanpovinnéVytvoření: adresa, kontakt
/v1/contacts/{id}/addressesAdd an address to a contact
Nástroj MCP: create-contact-address
Parametry v cestě
idstringpovinnéTělo požadavku
type"registered" | "delivery"povinnénamestring | nullstreetstring | nullcitystring | nullpostalCodestring | nullcountrystringmax 2 charsregionstring | nullemailstring | nullphonestring | nullisDefaultbooleanOdpověď · 201
idstringpovinnécontactIdnull | stringpovinnétypestringpovinnénamestring | nullpovinnéstreetnull | stringpovinnécitynull | stringpovinnépostalCodenull | stringpovinnécountrynull | stringpovinnéregionnull | stringpovinnéemailstring | nullpovinnéphonestring | nullpovinnéisDefaultbooleanpovinnéÚprava: adresa, kontakt
/v1/contacts/{id}/addresses/{addressId}Update an address of a contact
Nástroj MCP: update-contact-address
Parametry v cestě
idstringpovinnéaddressIdstringpovinnéTělo požadavku
type"registered" | "delivery"namestring | nullstreetstring | nullcitystring | nullpostalCodestring | nullcountrystringmax 2 charsregionstring | nullemailstring | nullphonestring | nullisDefaultbooleanOdpověď · 200
idstringpovinnécontactIdnull | stringpovinnétypestringpovinnénamestring | nullpovinnéstreetnull | stringpovinnécitynull | stringpovinnépostalCodenull | stringpovinnécountrynull | stringpovinnéregionnull | stringpovinnéemailstring | nullpovinnéphonestring | nullpovinnéisDefaultbooleanpovinnéSmazání: adresa, kontakt
/v1/contacts/{id}/addresses/{addressId}Remove an address from a contact
Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.
Nástroj MCP: delete-contact-address
Parametry v cestě
idstringpovinnéaddressIdstringpovinnéOdpověď · 200
idstringpovinnédeletedbooleanpovinnéSeznam: bankovní účty, kontakt
/v1/contacts/{id}/bank-accountsList a contact's bank accounts
Nástroj MCP: list-contact-bank-accounts
Parametry v cestě
idstringpovinnéParametry dotazu
limitintegermin 1max 500offsetintegermin 0max 9007199254740991searchstringmax 200 charsOdpověď · 200
dataobject[]povinnéobject"bank_account"povinnéidstringpovinnécontactIdnull | stringlabelnull | stringaccountNumbernull | stringpovinnébankCodenull | stringpovinnéibannull | stringpovinnécurrencystringpovinnéisDefaultbooleanpovinnépublishedFromRegistrybooleanbicnull | stringbankNamenull | stringbankStreetstring | nullbankCitystring | nullnamestringswiftnull | stringledgerAccountstringisActivebooleanopeningBalanceHalerintegeropeningDatenull | stringdateopeningExchangeRatestring | nullopeningStatestringbankBalanceHalerinteger | nullbankBalanceOnnull | stringdatefioobjectconfiguredbooleanpovinnéenabledbooleanpovinnélastSyncedAtnull | stringpovinnédate-timelastSyncedOnnull | stringpovinnédatelastErrornull | stringpovinnécreatedAtstringdate-timebalanceHalerintegerunmatchedCountintegerbalanceDiffHalerinteger | nullsepaCreditorIdnull | stringtotalintegerhasMorebooleanpovinnéVytvoření: bankovní účet, kontakt
/v1/contacts/{id}/bank-accountsAdd a bank account to a contact
Nástroj MCP: create-contact-bank-account
Parametry v cestě
idstringpovinnéTělo požadavku
labelstring | nullaccountNumberstring | nullbankCodestring | nullibanstring | nullbicstring | nullbankNamestring | nullbankStreetstring | nullbankCitystring | nullcurrencystring3 charsisDefaultbooleanpublishedFromRegistrybooleanOdpověď · 201
idstringpovinnécontactIdnull | stringlabelnull | stringaccountNumbernull | stringpovinnébankCodenull | stringpovinnéibannull | stringpovinnécurrencystringpovinnéisDefaultbooleanpovinnépublishedFromRegistrybooleanbicnull | stringbankNamenull | stringbankStreetstring | nullbankCitystring | nullnamestringswiftnull | stringledgerAccountstringisActivebooleanopeningBalanceHalerintegeropeningDatenull | stringdateopeningExchangeRatestring | nullopeningStatestringbankBalanceHalerinteger | nullbankBalanceOnnull | stringdatefioobjectconfiguredbooleanpovinnéenabledbooleanpovinnélastSyncedAtnull | stringpovinnédate-timelastSyncedOnnull | stringpovinnédatelastErrornull | stringpovinnécreatedAtstringdate-timebalanceHalerintegerunmatchedCountintegerbalanceDiffHalerinteger | nullsepaCreditorIdnull | stringÚprava: bankovní účet, kontakt
/v1/contacts/{id}/bank-accounts/{accountId}Update a bank account of a contact
Nástroj MCP: update-contact-bank-account
Parametry v cestě
idstringpovinnéaccountIdstringpovinnéTělo požadavku
labelstring | nullaccountNumberstring | nullbankCodestring | nullibanstring | nullbicstring | nullbankNamestring | nullbankStreetstring | nullbankCitystring | nullcurrencystring3 charsisDefaultbooleanpublishedFromRegistrybooleanOdpověď · 200
idstringpovinnécontactIdnull | stringlabelnull | stringaccountNumbernull | stringpovinnébankCodenull | stringpovinnéibannull | stringpovinnécurrencystringpovinnéisDefaultbooleanpovinnépublishedFromRegistrybooleanbicnull | stringbankNamenull | stringbankStreetstring | nullbankCitystring | nullnamestringswiftnull | stringledgerAccountstringisActivebooleanopeningBalanceHalerintegeropeningDatenull | stringdateopeningExchangeRatestring | nullopeningStatestringbankBalanceHalerinteger | nullbankBalanceOnnull | stringdatefioobjectconfiguredbooleanpovinnéenabledbooleanpovinnélastSyncedAtnull | stringpovinnédate-timelastSyncedOnnull | stringpovinnédatelastErrornull | stringpovinnécreatedAtstringdate-timebalanceHalerintegerunmatchedCountintegerbalanceDiffHalerinteger | nullsepaCreditorIdnull | stringSmazání: bankovní účet, kontakt
/v1/contacts/{id}/bank-accounts/{accountId}Remove a bank account from a contact
Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.
Nástroj MCP: delete-contact-bank-account
Parametry v cestě
idstringpovinnéaccountIdstringpovinnéOdpověď · 200
idstringpovinnédeletedbooleanpovinnéGet what the contact owes against its credit limits (Kredit info and Kredit max). An optional amount shows what a new document would do
/v1/contacts/{id}/creditGet what the contact owes against its credit limits (Kredit info and Kredit max). An optional amount shows what a new document would do
Nástroj MCP: get-contact-credit
Parametry v cestě
idstringpovinnéParametry dotazu
documentHalerintegermin 0max 9007199254740991Odpověď · 200
contactIdnull | stringpovinnélevelstringpovinnéexposureHalerintegerpovinnéafterHalerintegerpovinnéwarnHalerinteger | nullpovinnéblockHalerinteger | nullpovinnéavailableHalerinteger | nullpovinnéPřiřazení: skupina, kontakt
/v1/contacts/{id}/groupsPut a contact in a contact group
Nástroj MCP: assign-contact-group
Parametry v cestě
idstringpovinnéTělo požadavku
groupIdstringpovinnéOdpověď · 201
idstringpovinnénamestringpovinnéOdebrání: skupina, kontakt
/v1/contacts/{id}/groups/{groupId}Take a contact out of a contact group
Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.
Nástroj MCP: unassign-contact-group
Parametry v cestě
idstringpovinnégroupIdstringpovinnéOdpověď · 200
idstringpovinnédeletedbooleanpovinnéCheck the contact by IČO in the Czech insolvency register (ISIR). If the register is down the answer is status unknown, not an error
/v1/contacts/{id}/insolvency-checkCheck the contact by IČO in the Czech insolvency register (ISIR). If the register is down the answer is status unknown, not an error. Status found means a proceeding is running; clear means none is, though finished ones may be listed. Only a contact with an IČO can be checked: the register needs a birth number or date of birth to find a person.
Nástroj MCP: check-contact-insolvency
Parametry v cestě
idstringpovinnéOdpověď · 200
iconull | stringpovinnésourcestringpovinnéstatusstringpovinnéproceedingsobject[]povinnéfileNumberstringpovinnésenatestringpovinnénamenull | stringpovinnéiconull | stringpovinnéstatestringpovinnéactivebooleanpovinnéstartedOnstringpovinnédateendedOnanypovinnéurlstringpovinnésyncedAtanypovinnéstalebooleanpovinnécontactIdnull | stringpovinnéHave the insolvency register re-read for this contact every day. A change shows in the notifications and as the contact.insolvency_changed webhook
/v1/contacts/{id}/insolvency-watchHave the insolvency register re-read for this contact every day. A change shows in the notifications and as the contact.insolvency_changed webhook. Needs an IČO. A register that is down changes nothing, and the next run asks again.
Nástroj MCP: set-contact-insolvency-watch
Parametry v cestě
idstringpovinnéTělo požadavku
watchbooleanpovinnéOdpověď · 200
contactIdnull | stringpovinnéwatchbooleanpovinnéSloučení: kontakt
/v1/contacts/{id}/mergeMerge this contact into another one. Its documents move to the other contact and this one disappears
Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.
Nástroj MCP: merge-contact
Parametry v cestě
idstringpovinnéTělo požadavku
intoIdstringpovinnéOdpověď · 200
customFieldsobjectoborstringoblaststringregionnull | stringslevaintegersmlouva_odstringdatepoznamka_obchodustringidstringpovinnékindstringrolesstringnamestringnameOnDocumentsstring | nulliconull | stringdicnull | stringvatPayerTypestringemailnull | stringphonenull | stringmobilenull | stringwwwnull | stringnotenull | stringdataBoxIdstring | nullexternalCodenull | stringusualDueDaysinteger | nullsupplierDueDaysinteger | nullpreferredPaymentMethodstring | nullinvoiceLanguagenull | stringdefaultCurrencystringcreditWarnHalerinteger | nullcreditBlockHalerinteger | nullreminderOnDuebooleanreminderWeekAfterbooleanreminder14DaysAfterbooleanreminderMonthAfterbooleanunreliableVatPayerboolean | nullvatCheckedAtstring | nullviesValidboolean | nullviesCheckedAtstring | nullinsolvencyStatusnull | stringinsolvencyCheckedAtnull | stringdate-timeinsolvencyProceedingsobject[]iconull | stringpovinnéurlstringpovinnénamestringpovinnéstatestringpovinnéactivebooleanpovinnésenatestringpovinnéendedOnanypovinnéstartedOnstringpovinnédatefileNumberstringpovinnégdprRestrictedbooleanmarketingOptOutbooleanowingHalerintegergroupIdsstring[]groupsobject[]object"contact_group"povinnéidstringpovinnénamestringpovinnécreatedAtnull | stringdate-timeupdatedAtnull | stringdate-timeinsolvencyWatchbooleaninsolvencyChangedAtnull | stringdate-timeaddressesobject[]object"address"povinnéidstringpovinnécontactIdnull | stringpovinnétypestringpovinnénamestring | nullpovinnéstreetnull | stringpovinnécitynull | stringpovinnépostalCodenull | stringpovinnécountrynull | stringpovinnéregionnull | stringpovinnéemailstring | nullpovinnéphonestring | nullpovinnéisDefaultbooleanpovinnébankAccountsobject[]object"bank_account"povinnéidstringpovinnécontactIdnull | stringlabelnull | stringaccountNumbernull | stringpovinnébankCodenull | stringpovinnéibannull | stringpovinnécurrencystringpovinnéisDefaultbooleanpovinnépublishedFromRegistrybooleanbicnull | stringbankNamenull | stringbankStreetstring | nullbankCitystring | nullnamestringswiftnull | stringledgerAccountstringisActivebooleanopeningBalanceHalerintegeropeningDatenull | stringdateopeningExchangeRatestring | nullopeningStatestringbankBalanceHalerinteger | nullbankBalanceOnnull | stringdatefioobjectconfiguredbooleanpovinnéenabledbooleanpovinnélastSyncedAtnull | stringpovinnédate-timelastSyncedOnnull | stringpovinnédatelastErrornull | stringpovinnécreatedAtstringdate-timebalanceHalerintegerunmatchedCountintegerbalanceDiffHalerinteger | nullsepaCreditorIdnull | stringpersonsobject[]object"contact_person"povinnéidstringpovinnécontactIdstringpovinnénamestringpovinnégreetingstring | nullpovinnétitlenull | stringpovinnéemailnull | stringpovinnéphonenull | stringpovinnémobilestring | nullpovinnénotestring | nullpovinnéduplicateIcoobjectexistingIdstringpovinnénamestringpovinnéattachmentsany[]documentsobject[]object"credit_note" | "delivery_note" | "invoice" | "proforma" | "received_invoice"povinnéidstringpovinnénumbernull | stringpovinnévariableSymbolnull | stringcontactIdnull | stringpovinnécontactNamenull | stringpovinnéissueDatenull | stringpovinnédatedueDatenull | stringdatecurrencynull | stringtotalHalerinteger | nullpaidHalerintegerstatusstringpovinnéoverduebooleanfileIdnull | stringpovinnésupplierDocumentNumbernull | stringkindstringoriginalInvoiceNumbernull | stringdeliveryDatestringdatecarrierIdstring | nullmergedFromstringSeznam: osoby, kontakt
/v1/contacts/{id}/personsList a contact's people
Nástroj MCP: list-contact-persons
Parametry v cestě
idstringpovinnéParametry dotazu
limitintegermin 1max 500offsetintegermin 0max 9007199254740991searchstringmax 200 charsOdpověď · 200
dataobject[]povinnéobject"contact_person"povinnéidstringpovinnécontactIdstringpovinnénamestringpovinnégreetingstring | nullpovinnétitlenull | stringpovinnéemailnull | stringpovinnéphonenull | stringpovinnémobilestring | nullpovinnénotestring | nullpovinnétotalintegerhasMorebooleanpovinnéVytvoření: osoba, kontakt
/v1/contacts/{id}/personsAdd a person to a contact
Nástroj MCP: create-contact-person
Parametry v cestě
idstringpovinnéTělo požadavku
namestringpovinnémax 160 charsgreetingstring | nulltitlestring | nullemailstring | nullphonestring | nullmobilestring | nullnotestring | nullOdpověď · 201
idstringpovinnécontactIdstringpovinnénamestringpovinnégreetingstring | nullpovinnétitlenull | stringpovinnéemailnull | stringpovinnéphonenull | stringpovinnémobilestring | nullpovinnénotestring | nullpovinnéÚprava: osoba, kontakt
/v1/contacts/{id}/persons/{personId}Update a person of a contact
Nástroj MCP: update-contact-person
Parametry v cestě
idstringpovinnépersonIdstringpovinnéTělo požadavku
namestringmax 160 charsgreetingstring | nulltitlestring | nullemailstring | nullphonestring | nullmobilestring | nullnotestring | nullOdpověď · 200
idstringpovinnécontactIdstringpovinnénamestringpovinnégreetingstring | nullpovinnétitlenull | stringpovinnéemailnull | stringpovinnéphonenull | stringpovinnémobilestring | nullpovinnénotestring | nullpovinnéSmazání: osoba, kontakt
/v1/contacts/{id}/persons/{personId}Remove a person from a contact
Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.
Nástroj MCP: delete-contact-person
Parametry v cestě
idstringpovinnépersonIdstringpovinnéOdpověď · 200
idstringpovinnédeletedbooleanpovinnéKontrola plátce DPH
/v1/contacts/{id}/vat-checkCheck the contact in the Czech VAT register: whether it is a reliable payer and which bank accounts it has published
Nástroj MCP: vat-check-contact
Parametry v cestě
idstringpovinnéTělo požadavku
applyAccountsbooleanOdpověď · 200
sourcestringpovinnécheckedAtnull | stringpovinnédate-timedicnull | stringpovinnéunreliablebooleanpovinnépublishedAccountsobject[]povinnéaccountNumbernull | stringpovinnébankCodenull | stringpovinnéibanstring | nullpovinnéappliedAccountsany[]povinnéKontrola DIČ ve VIES
/v1/contacts/{id}/viesCheck the contact's EU VAT number in the VIES register
Nástroj MCP: vies-check-contact
Parametry v cestě
idstringpovinnéOdpověď · 200
sourcestringpovinnécheckedAtnull | stringdate-timevatNumberstringpovinnévalidbooleanpovinnénamenull | stringaddressnull | stringwellFormedbooleanExport: kontakt
/v1/contacts/exportDownload all contacts as an XLSX spreadsheet
Nástroj MCP: export-contacts
Parametry dotazu
limitintegermin 1max 500offsetintegermin 0max 9007199254740991searchstringmax 200 charsfromstringYYYY-MM-DDtostringYYYY-MM-DDqstringmax 200 charsrolesstringowing"true" | "false"restricted"true" | "false"groupIdstringcustomFieldKeystringcustomFieldValuestringmax 2000 charsOdpověď · 200
Vrací soubor application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.
Import: kontakt
/v1/contacts/importImport contacts from an uploaded spreadsheet file
Nástroj MCP: import-contacts
Tělo požadavku
fileBase64stringrowsobject[]Odpověď · 200
countintegerpovinnéidsstring[]povinnéTurn the daily insolvency re-check on or off for many contacts at once. A contact without an IČO is reported and left as it was
/v1/contacts/insolvency-watchTurn the daily insolvency re-check on or off for many contacts at once. A contact without an IČO is reported and left as it was
Nástroj MCP: set-contacts-insolvency-watch
Tělo požadavku
idsstring[]povinnéwatchbooleanpovinnéOdpověď · 200
resultsobject[]povinnéidstringokbooleanpovinnéerrornull | stringcodenull | stringnumbernull | stringstockDocumentIdnull | stringdocumentIdnull | stringstatusstringcontactNamenull | stringnamenull | stringtostringamountHalerinteger | nullmovementIdnull | stringrowintegerrecognisedbooleanshipmentIdstringtrackingNumbernull | stringtotalintegerpovinnésucceededintegerpovinnéfailedintegerpovinnéVyhledání v ARES
/v1/contacts/lookup/aresLook up a company in the Czech ARES business register by IČO. Changes nothing
Nástroj MCP: lookup-ares
Tělo požadavku
icostringpovinnémax 16 charsOdpověď · 200
sourcestringpovinnéiconull | stringpovinnédicnull | stringpovinnénamenull | stringpovinnévatPayerTypestringpovinnéaddressnull | objectpovinnéstreetnull | stringpovinnécitynull | stringpovinnépostalCodenull | stringpovinnécountrynull | stringpovinné