toc-online

Create invoice in TOC Online

Create an invoice directly from JSON payload via TOC Online API.

No TOC_DocVenda or Vendas tables needed — everything in one request. Automatically creates a Faturas entry with the S3 PDF path.

Required fields:

  • nif_cliente (str): Customer NIF
  • document_type (str): FT, FR, FS, NC, or ND
  • document_series_prefix (str): e.g. "2024", "2025"
  • lines (array): [{description, quantity, unit_price, ...}]

Optional fields:

  • date, due_date, payment_mechanism, operation_country
  • tax_exemption_reason_id, bank_account_id, cash_account_id
  • download_pdf (bool, default true)
post/api/toc/invoices

Request

  • Base URL
    https://api.multigest.pt (the document declares no server; this is the origin it was published from)
  • URL
    https://api.multigest.pt/api/toc/invoices
  • Auth
    API key in header x-api-token and API key in header x-origin-verify

Headers

x-api-tokenstring nullable

Request body

object required

Response

Successful Response

object required

Changes

No recorded changes to this operation across all 21 revisions of this API.