---
title: "Create invoice in TOC Online"
method: POST
path: "/api/toc/invoices"
tags: ["toc-online"]
---

# Create invoice in TOC Online

`POST /api/toc/invoices`

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)

## Headers

- `x-api-token` string, nullable

## Request body

- object

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/multigest/apis/multigest-protected-api.md) · [All operations](https://skmtc.dev/multigest/apis/multigest-protected-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/multigest/multigest-protected-api/revisions/4b44eb76b3ee/schema)