Invoicing Documents

get/invoicing/documents/{id}

Request

  • Base URL: https://developer.meetergo.com (the document declares no server; this is the origin it was published from)
  • URL: https://developer.meetergo.com/invoicing/documents/{id}
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer
    • API key in header x-meetergo-api-user-id

Path parameters

idstring required

Response

idstring required
kind'offer' | 'order_confirmation' | 'invoice' | 'credit_note' | 'cancellation' required
status'draft' | 'finalized' | 'sent' | 'partially_paid' | 'paid' | 'cancelled' | 'accepted' | 'rejected' required
numberstring nullable

Allocated at finalization; null on drafts (drafts never consume numbers)

issueDatestring required
deliveryDatestring nullable

Leistungs-/Lieferdatum (§ 14 Abs. 4 Nr. 6 UStG); period start when deliveryDateEnd is set

deliveryDateEndstring nullable

Leistungszeitraum end: set → the document covers a service period (BT-73/BT-74) instead of a single date

dueDatestring nullable
currencystring required
buyerobject required
language'de' | 'en' nullable

Language this document is written in, chosen when the draft is created and frozen with the rest of the snapshot at finalization.

Stored per document, not read from settings at render time: re-rendering a finalized invoice must reproduce the PDF the buyer received, and a seller switching their default must not reword documents already sent. null means the document predates document languages, so it renders in German, the only language the module used to speak.

subjectstring nullable

Betreff shown on the document and as email subject

headTextstring nullable

Kopf-Text: free text above the line items (sevDesk pattern)

footTextstring nullable

Fuss-Text: free text below the totals

notestring nullable

Free-text document note (also carries the § 19 wording when applicable)

paymentTermsNotestring nullable
deliveryTermsNotestring nullable

Lieferbedingungen shown on the PDF

totalDiscountPercentnumber nullable

Gesamtrabatt: document-level percent discount, compounded onto every line at totals/snapshot time

internalContactUserIdstring nullable

Interne Kontaktperson: company user shown as seller contact (PDF + XML)

skontoPercentnumber nullable

Skonto: early-payment discount in percent (null = no Skonto offered)

skontoDaysnumber nullable

Skonto: days from issue date within which the discount applies

depositPercentnumber nullable

Offers only: deposit (Anzahlung) in percent of the gross total. When the buyer accepts the shared offer, a finalized deposit invoice over this share is created automatically (null = no deposit asked).

taxTreatment'standard' | 'tax_free_de' | 'reverse_charge_13b' | 'reverse_charge_18b' | 'intra_community' | 'oss' | 'export' | 'out_of_scope' required
netTotalnumber required
taxTotalnumber required
grossTotalnumber required
snapshotobject nullable

Frozen EN 16931 record; set exactly once at finalization

pdfFileAssetIdstring nullable
xmlFileAssetIdstring nullable
finalizedAtstring date-time nullable
publicTokenstring nullable
onlinePaymentboolean required

Whether this invoice may be paid through the connected providers (invoicePayableOnline): the pay button in mails and reminders AND the methods the pay page offers, so a stale link cannot pay what the mail did not offer. The page link itself stays valid: it is the invoice view (PDF, bank details), which WhatsApp delivery and "copy link" hand out. Off for invoices born from a manual-payment booking whose meeting type asked for it; operational state, so it may change after issue.

amountPaidnumber required
paidAtstring date-time nullable

When the outstanding amount reached zero

dunningLevelnumber required
lastDunningAtstring date-time nullable
dunningPausedboolean required

Excluded from dunning auto-send (manual sends stay possible)

companyIdstring required
contactIdstring nullable

CRM contact this document belongs to (buyer jsonb stays authoritative)

crmCompanyIdstring nullable

CRM company the buyer was taken from.

The buyer jsonb stays authoritative — an issued document must not change because someone later edited the company record. This only records where the address came from, so the editor can offer to pull it again and so a company's documents can be found.

dealIdstring nullable
bankAccountIdstring nullable

Which of the seller's bank accounts to print. Null falls back to the single account on invoicing settings, which is what every existing document does.

appointmentIdstring nullable
previousDocumentIdstring nullable

Chain reference: offer→invoice conversion, Storno→original

createdByIdstring
createdAtstring date-time required
updatedAtstring date-time required
deletedAtstring nullable

Soft delete is permitted for DRAFTS ONLY (service-enforced)

Changes

No recorded changes to this operation across all 1 revision of this API.