Show invoice or credit note

One invoice or credit note with its lines - and, if asked, its PDF or XRechnung XML.

RReadIdempotentbetaNeeds account

Tool

manitu_account_financialdocument_geton https://mcp.manitu.de/mcp

POST

/v1/account/financialdocument/geton https://api.manitu.de

Try it

Annotations as tools/list sends them

readOnlyHint truedestructiveHint falseidempotentHint trueopenWorldHint false

Description for the model

Returns one invoice or credit note of the manitu customer account, by its type and the number printed on it (from manitu_account_financialdocument_list, or as the customer quotes it): everything the list shows, plus its lines (what was billed, quantity, period, VAT rate, net prices in cent). Leave file_format out to answer questions about it - the lines say what is on the document. Ask for file_format pdf or xml only when the customer needs the file itself; it comes base64-encoded and is long. The customer finds the PDF in the customer panel as well.

Arguments

typestringrequired

invoice or credit_note - as the list answers it.

One of invoice credit_note

numberinteger | stringrequired

The number printed on the document, digits only, e.g. 1634488 - a prefix like "G" or "R" is ignored. From manitu_account_financialdocument_list or as the customer quotes it; never guess one.

min length 1max length 64min 1

file_formatstring

pdf, or xml (XRechnung / Factur-X) - the file as well, base64. Left out: no file.

One of pdf xml

Result structuredContent, checked against the schema

financial_documentobjectrequired

financial_document.typestringrequired

An invoice, or a credit note (money manitu owes the customer).

One of invoice credit_note

financial_document.subtypestring | nullrequired

invoice for an invoice; for a credit note credit (a credit note) or invoiceamendment (a corrected invoice).

One of invoice credit invoiceamendment null

financial_document.numberstringrequired

The number printed on it - what the customer quotes; together with type what manitu_account_financialdocument_get takes.

financial_document.reasonstring | nullrequired

Why a credit note was issued; null for an invoice.

One of unknown cancellation manitu_goodwill manitu_billingmistake manitu_provision encashment_provision encashment_irrecoverable null

financial_document.issued_onstring | nullrequired

The date of the document.

Format date

financial_document.due_onstring | nullrequired

When an invoice is due; null for a credit note.

Format date

financial_document.currencystring | nullrequired

e.g. "EUR".

financial_document.total_net_centinteger | nullrequired

The total without VAT, in cent - 10000 is 100.00.

financial_document.total_vat_centinteger | nullrequired

The VAT, in cent.

financial_document.total_gross_centinteger | nullrequired

The total including VAT, in cent.

financial_document.payment_statusstring | nullrequired

Whether it is paid - by the customer (invoice) or paid out by manitu (credit note).

One of unpaid paid null

financial_document.amount_paid_centinteger | nullrequired

Paid so far, in cent - by the customer (invoice) or by manitu (credit note).

financial_document.amount_due_centinteger | nullrequired

Still open, in cent: total_gross_cent minus amount_paid_cent.

financial_document.is_unpaid_duebooleanrequired

An invoice not paid whose due date has come - what needs the customer's attention. Always false for a credit note.

financial_document.line_listarray of objectrequired

The lines of the document, net, in its order.

financial_document.line_list[].namestring | nullrequired

financial_document.line_list[].descriptionstring | nullrequired

financial_document.line_list[].quantitynumber | nullrequired

financial_document.line_list[].service_period_start_onstring | nullrequired

The period the line is for, first day.

Format date

financial_document.line_list[].service_period_end_onstring | nullrequired

The period the line is for, last day (inclusive).

Format date

financial_document.line_list[].vat_rate_percentnumber | nullrequired

e.g. 19.

financial_document.line_list[].unit_price_net_centinteger | nullrequired

The price of one unit without VAT, in cent.

financial_document.line_list[].total_net_centinteger | nullrequired

quantity x unit price, without VAT, in cent.

fileobject | nullrequired

The file asked for in file_format; null if none was asked for.

file.filenamestringrequired

file.content_typestringrequired

One of application/pdf application/xml

file.data_base64stringrequired

Authentication

One of X-API-Key, Authorization: Bearer … - never more than one in a request. More

Request body JSON; unknown fields are refused

typestringrequired

invoice or credit_note - as the list answers it.

One of invoice credit_note

numberinteger | stringrequired

The number printed on the document, digits only, e.g. 1634488 - a prefix like "G" or "R" is ignored. From manitu_account_financialdocument_list or as the customer quotes it; never guess one.

min length 1max length 64min 1

file_formatstring

pdf, or xml (XRechnung / Factur-X) - the file as well, base64. Left out: no file.

One of pdf xml

Response in `data`; the rest of the body as on every call

financial_documentobjectrequired

financial_document.typestringrequired

An invoice, or a credit note (money manitu owes the customer).

One of invoice credit_note

financial_document.subtypestring | nullrequired

invoice for an invoice; for a credit note credit (a credit note) or invoiceamendment (a corrected invoice).

One of invoice credit invoiceamendment null

financial_document.numberstringrequired

The number printed on it - what the customer quotes; together with type what manitu_account_financialdocument_get takes.

financial_document.reasonstring | nullrequired

Why a credit note was issued; null for an invoice.

One of unknown cancellation manitu_goodwill manitu_billingmistake manitu_provision encashment_provision encashment_irrecoverable null

financial_document.issued_onstring | nullrequired

The date of the document.

Format date

financial_document.due_onstring | nullrequired

When an invoice is due; null for a credit note.

Format date

financial_document.currencystring | nullrequired

e.g. "EUR".

financial_document.total_net_centinteger | nullrequired

The total without VAT, in cent - 10000 is 100.00.

financial_document.total_vat_centinteger | nullrequired

The VAT, in cent.

financial_document.total_gross_centinteger | nullrequired

The total including VAT, in cent.

financial_document.payment_statusstring | nullrequired

Whether it is paid - by the customer (invoice) or paid out by manitu (credit note).

One of unpaid paid null

financial_document.amount_paid_centinteger | nullrequired

Paid so far, in cent - by the customer (invoice) or by manitu (credit note).

financial_document.amount_due_centinteger | nullrequired

Still open, in cent: total_gross_cent minus amount_paid_cent.

financial_document.is_unpaid_duebooleanrequired

An invoice not paid whose due date has come - what needs the customer's attention. Always false for a credit note.

financial_document.line_listarray of objectrequired

The lines of the document, net, in its order.

financial_document.line_list[].namestring | nullrequired

financial_document.line_list[].descriptionstring | nullrequired

financial_document.line_list[].quantitynumber | nullrequired

financial_document.line_list[].service_period_start_onstring | nullrequired

The period the line is for, first day.

Format date

financial_document.line_list[].service_period_end_onstring | nullrequired

The period the line is for, last day (inclusive).

Format date

financial_document.line_list[].vat_rate_percentnumber | nullrequired

e.g. 19.

financial_document.line_list[].unit_price_net_centinteger | nullrequired

The price of one unit without VAT, in cent.

financial_document.line_list[].total_net_centinteger | nullrequired

quantity x unit price, without VAT, in cent.

fileobject | nullrequired

The file asked for in file_format; null if none was asked for.

file.filenamestringrequired

file.content_typestringrequired

One of application/pdf application/xml

file.data_base64stringrequired

Statuses

200Success.400The request does not match the declared input schema.401No credential was presented, or it was not recognised.403The credential is not permitted to use this operation.500The server failed. Nothing about the request was wrong. Whether a change took effect is not known - check before trying it again.503The channel this operation forwards through is unavailable.

MCPtools/call

Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "manitu_account_financialdocument_get",
    "arguments": {
      "type": "invoice",
      "number": 1
    }
  }
}

Result

{
  "structuredContent": {
    "financial_document": {
      "type": "invoice",
      "subtype": "invoice",
      "number": "string",
      "reason": "unknown",
      "issued_on": "2026-10-23",
      "due_on": "2026-10-23",
      "currency": "string",
      "total_net_cent": 1190,
      "total_vat_cent": 1190,
      "total_gross_cent": 1190,
      "payment_status": "unpaid",
      "amount_paid_cent": 1190,
      "amount_due_cent": 1190,
      "is_unpaid_due": true,
      "line_list": [
        {
          "name": "example.com",
          "description": "Example",
          "quantity": 1.5,
          "service_period_start_on": "2026-10-23",
          "service_period_end_on": "2026-10-23",
          "vat_rate_percent": 1.5,
          "unit_price_net_cent": 1190,
          "total_net_cent": 1190
        }
      ]
    },
    "file": {
      "filename": "string",
      "content_type": "application/pdf",
      "data_base64": "string"
    }
  },
  "content": [
    {
      "type": "text",
      "text": "… the same answer as text …"
    }
  ],
  "isError": false
}

POST/v1/account/financialdocument/get

Request

curl -X POST 'https://api.manitu.de/v1/account/financialdocument/get' \
  -H 'X-API-Key: $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "invoice",
    "number": 1
  }'

const response = await fetch('https://api.manitu.de/v1/account/financialdocument/get', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "type": "invoice",
    "number": 1
  }),
});
const answer = await response.json();

<?php

$curl = curl_init('https://api.manitu.de/v1/account/financialdocument/get');

curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_HTTPHEADER     => [
        'X-API-Key: ' . getenv('API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS     => '{"type":"invoice","number":1}',
    CURLOPT_RETURNTRANSFER => true,
]);

$answer = json_decode(curl_exec($curl), true);

import os

import requests

response = requests.request(
    "POST",
    "https://api.manitu.de/v1/account/financialdocument/get",
    headers={"X-API-Key": os.environ["API_KEY"]},
    json={
        "type": "invoice",
        "number": 1,
    },
)
answer = response.json()

Response 200

{
  "status": {
    "type": "success",
    "code": 200
  },
  "meta": {},
  "data": {
    "financial_document": {
      "type": "invoice",
      "subtype": "invoice",
      "number": "string",
      "reason": "unknown",
      "issued_on": "2026-10-23",
      "due_on": "2026-10-23",
      "currency": "string",
      "total_net_cent": 1190,
      "total_vat_cent": 1190,
      "total_gross_cent": 1190,
      "payment_status": "unpaid",
      "amount_paid_cent": 1190,
      "amount_due_cent": 1190,
      "is_unpaid_due": true,
      "line_list": [
        {
          "name": "example.com",
          "description": "Example",
          "quantity": 1.5,
          "service_period_start_on": "2026-10-23",
          "service_period_end_on": "2026-10-23",
          "vat_rate_percent": 1.5,
          "unit_price_net_cent": 1190,
          "total_net_cent": 1190
        }
      ]
    },
    "file": {
      "filename": "string",
      "content_type": "application/pdf",
      "data_base64": "string"
    }
  }
}

Show invoice or credit note

Annotations as tools/list sends them

Description for the model

Arguments

Result structuredContent, checked against the schema

Authentication

Request body JSON; unknown fields are refused

Response in data; the rest of the body as on every call

Statuses

Response in `data`; the rest of the body as on every call