Merit Aktiva MCP by usefulapi

Read Merit Aktiva invoices, customers, vendors, items, payments and reports; create a customer.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
92%
Naming quality
80%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~6,133Tokens (tool definitions)
~1.7 KBTypical response size
Significant attention impact (4.79% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "merit-aktiva": {
      "url": "https://merit-aktiva.usefulapi.io/mcp"
    }
  }
}

Remote endpoints

https://merit-aktiva.usefulapi.io/mcpstreamable-http

What it can do

Tool inventory

Tools (26)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢merit_list_sales_invoices(period_start, period_end, unpaid_only, date_type, max_results)

List sales invoices (header level: number, customer, dates, totals, paid flag) of a period. The period may span at most 3 months (Merit limit); for longer spans make several calls. Use merit_get_sales_invoice for the lines. POST /api/v2/getinvoices.

Input Schema

{
  "type": "object",
  "properties": {
    "period_start": {
      "type": "string",
      "description": "First day of the period, yyyy-mm-dd."
    },
    "period_end": {
      "type": "string",
      "description": "Last day of the period, yyyy-mm-dd (max 3 months after the start)."
    },
    "unpaid_only": {
      "description": "true = only unpaid invoices.",
      "type": "boolean"
    },
    "date_type": {
      "description": "Which date the period filters: 0 = document date (default), 1 = date of last change.",
      "anyOf": [
        {
          "type": "number",
          "const": 0
        },
        {
          "type": "number",
          "const": 1
        }
      ]
    },
    "max_results": {
      "description": "Show at most this many rows (default 100, max 1000); the reply says how many there are in total.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "required": [
    "period_start",
    "period_end"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢merit_search_sales_invoices(invoice_no, customer_name, customer_id, max_results)

Find sales invoices by invoice number, customer name or customer id (give at least one). POST /api/v2/getinvoices2.

Input Schema

{
  "type": "object",
  "properties": {
    "invoice_no": {
      "description": "Invoice number.",
      "type": "string",
      "minLength": 1,
      "maxLength": 35
    },
    "customer_name": {
      "description": "Customer name.",
      "type": "string",
      "minLength": 1,
      "maxLength": 150
    },
    "customer_id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Customer id (from merit_list_customers)."
    },
    "max_results": {
      "description": "Show at most this many rows (default 100, max 1000); the reply says how many there are in total.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢merit_get_sales_invoice(id)

One sales invoice in full: header, lines (items, quantities, VAT, accounts), payments and dimension allocations. The PDF attachment is never requested. POST /api/v2/getinvoice.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Invoice id (SIHId from merit_list_sales_invoices)."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢merit_list_purchase_invoices(period_start, period_end, unpaid_only, date_type, max_results)

List purchase invoices (vendor bills) of a period: bill number, vendor, dates, totals, paid flag. The period may span at most 3 months (Merit limit); for longer spans make several calls. POST /api/v2/getpurchorders.

Input Schema

{
  "type": "object",
  "properties": {
    "period_start": {
      "type": "string",
      "description": "First day of the period, yyyy-mm-dd."
    },
    "period_end": {
      "type": "string",
      "description": "Last day of the period, yyyy-mm-dd (max 3 months after the start)."
    },
    "unpaid_only": {
      "description": "true = only unpaid bills.",
      "type": "boolean"
    },
    "date_type": {
      "description": "Which date the period filters: 0 = document date (default), 1 = date of last change.",
      "anyOf": [
        {
          "type": "number",
          "const": 0
        },
        {
          "type": "number",
          "const": 1
        }
      ]
    },
    "max_results": {
      "description": "Show at most this many rows (default 100, max 1000); the reply says how many there are in total.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "required": [
    "period_start",
    "period_end"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢merit_get_purchase_invoice(id)

One purchase invoice in full: header, lines, payments. The attachment is never requested. POST /api/v2/getpurchorder.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Purchase invoice id (PIHId from merit_list_purchase_invoices)."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢merit_list_customers(name, reg_no, vat_reg_no, id, changed_since, ...)

Search customers by name (partial match), registry number or VAT number (exact), id, or changed since a date. At least one filter is required: Merit cannot return the whole customer list in one reply. POST /api/v1/getcustomers.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "description": "Part of the customer name.",
      "type": "string",
      "minLength": 1,
      "maxLength": 150
    },
    "reg_no": {
      "description": "Registry number, exact.",
      "type": "string",
      "minLength": 1,
      "maxLength": 30
    },
    "vat_reg_no": {
      "description": "VAT number, exact.",
      "type": "string",
      "minLength": 1,
      "maxLength": 30
    },
    "id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Customer id."
    },
    "changed_since": {
      "type": "string",
      "description": "Only customers created or changed on or after this date."
    },
    "max_results": {
      "description": "Show at most this many rows (default 100, max 1000); the reply says how many there are in total.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢merit_list_vendors(name, reg_no, vat_reg_no, id, changed_since, ...)

Search vendors (suppliers) by name (partial match), registry number or VAT number (exact), id, or changed since a date. At least one filter is required: Merit cannot return the whole vendor list in one reply. POST /api/v1/getvendors.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "description": "Part of the vendor name.",
      "type": "string",
      "minLength": 1,
      "maxLength": 150
    },
    "reg_no": {
      "description": "Registry number, exact.",
      "type": "string",
      "minLength": 1,
      "maxLength": 30
    },
    "vat_reg_no": {
      "description": "VAT number, exact.",
      "type": "string",
      "minLength": 1,
      "maxLength": 30
    },
    "id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Vendor id."
    },
    "changed_since": {
      "type": "string",
      "description": "Only vendors created or changed on or after this date."
    },
    "max_results": {
      "description": "Show at most this many rows (default 100, max 1000); the reply says how many there are in total.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢merit_list_items(id, code, description, type, location_code, ...)

List items, services and stock articles with price, unit, VAT and accounts. Optional filters: code or description (partial), type, id. With location_code the reply adds stock quantity and cost of that warehouse. POST /api/v1/getitems.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Item id."
    },
    "code": {
      "description": "Part of the item code.",
      "type": "string",
      "minLength": 1,
      "maxLength": 20
    },
    "description": {
      "description": "Part of the item description.",
      "type": "string",
      "minLength": 1,
      "maxLength": 150
    },
    "type": {
      "description": "1 = stock item, 2 = service, 3 = item.",
      "anyOf": [
        {
          "type": "number",
          "const": 1
        },
        {
          "type": "number",
          "const": 2
        },
        {
          "type": "number",
          "const": 3
        }
      ]
    },
    "location_code": {
      "description": "Warehouse code: adds goods on hand quantity and cost.",
      "type": "string",
      "minLength": 1,
      "maxLength": 20
    },
    "max_results": {
      "description": "Show at most this many rows (default 100, max 1000); the reply says how many there are in total.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢merit_list_accounts(max_results)

The general ledger chart of accounts (code, names, VAT, parent flag, active flag). GET /api/v2/accounts.

Input Schema

{
  "type": "object",
  "properties": {
    "max_results": {
      "description": "Show at most this many rows (default 100, max 1000); the reply says how many there are in total.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢merit_list_taxes(max_results)

All VAT rates of the company (TaxId, code, name, percent, active flag). The TaxId is what invoice rows refer to. GET /api/v2/taxes.

Input Schema

{
  "type": "object",
  "properties": {
    "max_results": {
      "description": "Show at most this many rows (default 100, max 1000); the reply says how many there are in total.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢merit_list_departments(max_results)

Departments (code, name, active flag). GET /api/v2/departments.

Input Schema

{
  "type": "object",
  "properties": {
    "max_results": {
      "description": "Show at most this many rows (default 100, max 1000); the reply says how many there are in total.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢merit_list_banks(max_results)

The company's bank and cash accounts (BankId, name, IBAN, currency, ledger account). BankId feeds the payment tools. GET /api/v2/banks.

Input Schema

{
  "type": "object",
  "properties": {
    "max_results": {
      "description": "Show at most this many rows (default 100, max 1000); the reply says how many there are in total.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢merit_list_financial_years

Accounting periods (financial years) with start, end and active flag. POST /api/v2/getaccperiods.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢merit_list_dimensions(all_values, max_results)

Accounting dimensions and their values (DimId, name, value code, expiry). all_values = true also lists expired values. POST /api/v2/getdimensions.

Input Schema

{
  "type": "object",
  "properties": {
    "all_values": {
      "description": "true = include expired dimension values (default false).",
      "type": "boolean"
    },
    "max_results": {
      "description": "Show at most this many rows (default 100, max 1000); the reply says how many there are in total.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢merit_list_payment_types(type, max_results)

Payment methods and sources (cash, banks, reporting entities, ledger accounts) usable for purchases, expense reports or sales. POST /api/v2/getpaymenttypes.

Input Schema

{
  "type": "object",
  "properties": {
    "type": {
      "description": "1 = purchases, 2 = expense reports, 3 = sales.",
      "anyOf": [
        {
          "type": "number",
          "const": 1
        },
        {
          "type": "number",
          "const": 2
        },
        {
          "type": "number",
          "const": 3
        }
      ]
    },
    "max_results": {
      "description": "Show at most this many rows (default 100, max 1000); the reply says how many there are in total.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢merit_list_payments(period_start, period_end, bank_id, payment_type, date_type, ...)

List payments (customer and vendor receipts and payouts) of a period, with the documents they paid. The period may span at most 3 months (Merit limit); for longer spans make several calls. POST /api/v2/getpayments.

Input Schema

{
  "type": "object",
  "properties": {
    "period_start": {
      "type": "string",
      "description": "First day of the period, yyyy-mm-dd."
    },
    "period_end": {
      "type": "string",
      "description": "Last day of the period, yyyy-mm-dd (max 3 months after the start)."
    },
    "bank_id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Only this bank account (BankId from merit_list_banks)."
    },
    "payment_type": {
      "description": "Merit payment type filter (see merit_list_payment_types).",
      "type": "integer",
      "minimum": 0,
      "maximum": 20
    },
    "date_type": {
      "description": "Which date the period filters: 0 = document date (default), 1 = date of last change.",
      "anyOf": [
        {
          "type": "number",
          "const": 0
        },
        {
          "type": "number",
          "const": 1
        }
      ]
    },
    "max_results": {
      "description": "Show at most this many rows (default 100, max 1000); the reply says how many there are in total.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "required": [
    "period_start",
    "period_end"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢merit_list_bank_payments(bank_id, direction, doc_date_from, doc_date_to, max_results)

List the income payments (money received) or expense payments (money paid out) booked on one bank account for a document-date period, with the documents each paid. The period may span at most 3 months (Merit limit); for longer spans make several calls. GET /api/v2/Banks/{bankId}/IncomePayments or /ExpensePayments.

Input Schema

{
  "type": "object",
  "properties": {
    "bank_id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "BankId from merit_list_banks."
    },
    "direction": {
      "type": "string",
      "enum": [
        "income",
        "expense"
      ],
      "description": "income = payments received, expense = payments made."
    },
    "doc_date_from": {
      "type": "string",
      "description": "Document date from, yyyy-mm-dd."
    },
    "doc_date_to": {
      "type": "string",
      "description": "Document date to, yyyy-mm-dd (max 3 months after doc_date_from)."
    },
    "max_results": {
      "description": "Show at most this many rows (default 100, max 1000); the reply says how many there are in total.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "required": [
    "bank_id",
    "direction",
    "doc_date_from",
    "doc_date_to"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢merit_list_gl_batches(period_start, period_end, date_type, max_results)

List general ledger batches (journal entries, also those created from invoices and payments) of a period: batch code, number, date, total. The period may span at most 3 months (Merit limit); for longer spans make several calls. POST /api/v1/getglbatches.

Input Schema

{
  "type": "object",
  "properties": {
    "period_start": {
      "type": "string",
      "description": "First day of the period, yyyy-mm-dd."
    },
    "period_end": {
      "type": "string",
      "description": "Last day of the period, yyyy-mm-dd (max 3 months after the start)."
    },
    "date_type": {
      "description": "Which date the period filters: 0 = document date (default), 1 = date of last change.",
      "anyOf": [
        {
          "type": "number",
          "const": 0
        },
        {
          "type": "number",
          "const": 1
        }
      ]
    },
    "max_results": {
      "description": "Show at most this many rows (default 100, max 1000); the reply says how many there are in total.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "required": [
    "period_start",
    "period_end"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢merit_get_gl_batch(id)

One general ledger batch with all its debit and credit lines (account, memo, department, tax, amounts). The attachment is never requested. POST /api/v1/getglbatch.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Batch id (GLBId from merit_list_gl_batches)."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢merit_customer_debts_report(customer_name, customer_id, over_due_days, as_of, max_results)

Open customer receivables: for each unpaid document the customer, date, due date, total, paid and unpaid amount. Give a customer name (empty string = all customers) or a customer id; over_due_days keeps only documents overdue by at least that many days. POST /api/v1/getcustdebtrep.

Input Schema

{
  "type": "object",
  "properties": {
    "customer_name": {
      "description": "Customer name; an empty string or omitting it with no customer_id selects ALL customers.",
      "type": "string",
      "maxLength": 150
    },
    "customer_id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Customer id."
    },
    "over_due_days": {
      "description": "Only documents overdue by at least this many days.",
      "type": "integer",
      "minimum": 0,
      "maximum": 999
    },
    "as_of": {
      "type": "string",
      "description": "Debt as of this date (default today)."
    },
    "max_results": {
      "description": "Show at most this many rows (default 100, max 1000); the reply says how many there are in total.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢merit_customer_payments_report(customer_name, customer_id, period_start, period_end, currency_code)

Customer invoices with their unpaid amount and overdue flag for a period, for one customer (name or id). Only the FIRST page is returned: if has_more is true, narrow the period or the customer (the continuation endpoint is not supported). POST /api/v2/getcustpaymrep.

Input Schema

{
  "type": "object",
  "properties": {
    "customer_name": {
      "description": "Customer name.",
      "type": "string",
      "minLength": 1,
      "maxLength": 150
    },
    "customer_id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Customer id."
    },
    "period_start": {
      "type": "string",
      "description": "Period start, yyyy-mm-dd."
    },
    "period_end": {
      "type": "string",
      "description": "Period end, yyyy-mm-dd."
    },
    "currency_code": {
      "description": "Currency, e.g. EUR.",
      "type": "string",
      "minLength": 3,
      "maxLength": 4
    }
  },
  "required": [
    "period_start",
    "period_end"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢merit_income_statement(end_date, per_count, department_code)

The profit and loss report: one row per report line, with balances for per_count months counting back from end_date (newest first). Optional department filter. POST /api/v1/getprofitrep.

Input Schema

{
  "type": "object",
  "properties": {
    "end_date": {
      "type": "string",
      "description": "Last day of the newest month, yyyy-mm-dd."
    },
    "per_count": {
      "description": "Number of monthly periods, counting back from end_date (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 36
    },
    "department_code": {
      "description": "Only this department (code from merit_list_departments).",
      "type": "string",
      "maxLength": 20
    }
  },
  "required": [
    "end_date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢merit_balance_sheet(end_date, per_count)

The balance sheet: one row per report line (assets, liabilities, equity) with balances for per_count months counting back from end_date. POST /api/v1/getbalancerep.

Input Schema

{
  "type": "object",
  "properties": {
    "end_date": {
      "type": "string",
      "description": "Balance date, yyyy-mm-dd."
    },
    "per_count": {
      "description": "Number of monthly periods, counting back from end_date (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 36
    }
  },
  "required": [
    "end_date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢merit_sales_report(start_date, end_date, report_type, max_results)

Sales totals for a period, grouped by invoice, customer, item or country. POST /api/v2/getsalesrep.

Input Schema

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "description": "Period start, yyyy-mm-dd."
    },
    "end_date": {
      "type": "string",
      "description": "Period end, yyyy-mm-dd."
    },
    "report_type": {
      "anyOf": [
        {
          "type": "number",
          "const": 1
        },
        {
          "type": "number",
          "const": 2
        },
        {
          "type": "number",
          "const": 3
        },
        {
          "type": "number",
          "const": 4
        },
        {
          "type": "number",
          "const": 5
        }
      ],
      "description": "1 = by invoices, 2 = by customers, 3 = by items, 4 = by countries, 5 = by countries (general)."
    },
    "max_results": {
      "description": "Show at most this many rows (default 100, max 1000); the reply says how many there are in total.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "required": [
    "start_date",
    "end_date",
    "report_type"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢merit_purchase_report(start_date, end_date, report_type, max_results)

Purchase totals for a period, grouped by invoice, vendor, item or fixed asset. POST /api/v2/getpurchrep.

Input Schema

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "description": "Period start, yyyy-mm-dd."
    },
    "end_date": {
      "type": "string",
      "description": "Period end, yyyy-mm-dd."
    },
    "report_type": {
      "anyOf": [
        {
          "type": "number",
          "const": 1
        },
        {
          "type": "number",
          "const": 2
        },
        {
          "type": "number",
          "const": 3
        },
        {
          "type": "number",
          "const": 4
        }
      ],
      "description": "1 = by invoices, 2 = by vendors, 3 = by items, 4 = by fixed assets."
    },
    "max_results": {
      "description": "Show at most this many rows (default 100, max 1000); the reply says how many there are in total.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "required": [
    "start_date",
    "end_date",
    "report_type"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟡merit_create_customer(name, country_code, not_td_customer, reg_no, vat_reg_no, ...)

WRITE: creates ONE new customer record in the Merit company (name must be unique; an existing customer is never overwritten, Merit answers with an error). Nothing is invoiced, sent or paid. In Estonia not_td_customer must be true for private persons and foreign companies; city is required in Estonia for a non-EE country. Returns the new customer id. POST /api/v2/sendcustomer.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 150,
      "description": "Customer name (unique in the company)."
    },
    "country_code": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "2-letter ISO country code, e.g. EE, PL."
    },
    "not_td_customer": {
      "type": "boolean",
      "description": "true for private persons and foreign companies (Estonia), true for private persons (Poland); false for a local company."
    },
    "reg_no": {
      "description": "Registry or personal id code.",
      "type": "string",
      "maxLength": 30
    },
    "vat_reg_no": {
      "description": "VAT number.",
      "type": "string",
      "maxLength": 30
    },
    "currency_code": {
      "description": "Default currency, e.g. EUR.",
      "type": "string",
      "minLength": 3,
      "maxLength": 4
    },
    "payment_deadline_days": {
      "description": "Payment term in days (default from company settings).",
      "type": "integer",
      "minimum": 0,
      "maximum": 365
    },
    "address": {
      "description": "Street address.",
      "type": "string",
      "maxLength": 100
    },
    "city": {
      "description": "City.",
      "type": "string",
      "maxLength": 30
    },
    "county": {
      "description": "County.",
      "type": "string",
      "maxLength": 100
    },
    "postal_code": {
      "description": "Postal code.",
      "type": "string",
      "maxLength": 15
    },
    "phone_no": {
      "description": "Phone number.",
      "type": "string",
      "maxLength": 50
    },
    "email": {
      "description": "E-mail address (stored only; Merit sends nothing).",
      "type": "string",
      "maxLength": 80,
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    },
    "home_page": {
      "description": "Web page.",
      "type": "string",
      "maxLength": 80
    },
    "sales_invoice_language": {
      "description": "Invoice language for this customer (Estonia: ET, EN, RU, FI; Poland: PL, EN, RU).",
      "type": "string",
      "enum": [
        "ET",
        "EN",
        "RU",
        "FI",
        "PL"
      ]
    },
    "contact": {
      "description": "Contact person.",
      "type": "string",
      "maxLength": 35
    },
    "bank_account": {
      "description": "Customer bank account (IBAN).",
      "type": "string",
      "maxLength": 50
    }
  },
  "required": [
    "name",
    "country_code",
    "not_td_customer"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded26 tools