---
title: "Create Invoice"
method: POST
path: "/{invoices-type}.json"
tags: ["Invoices"]
---

# Create Invoice

`POST /{invoices-type}.json`

Creates a new invoice, simplified_invoice, invoice_receipt, credit_note or debit_note.



### Creating new clients or items along with the documents
This method also allows to create a new client and/or new items in the same request with the following behavior:
* If the client name does not exist, a new one is created.
* If items do not exist with the given names, new ones will be created.
* If item name already exists, the item is updated with the new values.

### Taxes
Regarding item taxes, if the tax name is not found, the default tax is applyed to that item. Portuguese accounts should also send the IVA exemption reason if the invoice contains exempt items (IVA 0%).

> **Note:** Simplified Invoices are only available in Portugal.

## Path parameters

- `invoices-type` 'invoices' | 'invoice_receipts' | 'simplified_invoices' | 'credit_notes' | 'debit_notes', required

## Query parameters

- `api_key` string, required

## Request body

- InvoiceCreateRequest — Document details.
  - `invoice` CreateBody, required — Invoice Body
    - `date` string, required — dd/mm/yyyy
    - `due_date` string, required — dd/mm/yyyy
    - `reference` string
    - `observations` string
    - `retention` string
    - `tax_exemption` string
    - `sequence_id` string
    - `manual_sequence_number` string
    - `client` InvoicesClientRequest, required — Client Details.
      - `name` string, required
      - `code` string, required
      - `email` string
      - `address` string
      - `city` string
      - `postal_code` string
      - `fiscal_id` string
      - `country` string
      - `website` string
      - `phone` string
      - `fax` string
      - `observations` string
    - `items` InvoiceItemRequest[], required
      - `name` string, required
      - `description` string, required
      - `unit_price` number, required
      - `quantity` number, required
      - `unit` string
      - `discount` number
      - `tax` InvoiceTaxRequest
        - `name` string
    - `mb_reference` '0' | '1'
    - `owner_invoice_id` integer
    - `tax_exemption_reason` string
    - `currency_code` string
    - `rate` string
    - `plugin_id` string
    - `global_discount` GlobalDiscountRequest
      - `value_type` 'percentage' | 'absolute'
      - `value` number
  - `proprietary_uid` string

## Response `201`

SUCCESS 

Creates a new quote, proforma or fees_note.

#### Possible values for field atcud:

* ABCD1234-1 (or similar) - Unique document identifier to the Tax Authority, when the sequence is registered.
* N/D - The document's sequence is relevant for ATCUD but is not registered in the Tax Authority.
* N/A - The document's sequence is not relevant for ATCUD and is not registered in the Tax Authority.

- InvoiceGetResponse
  - `invoice` FullDocumentObject
    - `id` integer
    - `status` string
    - `archived` boolean
    - `type` string
    - `sequence_number` string
    - `inverted_sequence_number` string
    - `atcud` string
    - `sequence_id` string
    - `tax_exemption` string
    - `date` string
    - `due_date` string
    - `reference` string
    - `observations` string
    - `retention` string
    - `permalink` string
    - `saft_hash` string
    - `sum` number
    - `discount` number
    - `before_taxes` number
    - `taxes` number
    - `total` number
    - `currency` string
    - `client` InvoiceClient
      - `id` integer
      - `name` string
      - `code` string
      - `country` string
      - `email` string
    - `items` InvoiceItem[]
      - `name` string
      - `description` string
      - `unit_price` number
      - `quantity` number
      - `unit` string
      - `discount` number
      - `tax` object
        - `name` string
        - `value` number
      - `total` number
    - `mb_reference` MbReference
      - `entity` string
      - `reference` string
      - `value` number

## Other responses

- `401` — ACCESS DENIED
- `409` — CONFLICT
- `422` — UNPROCESSABLE ENTITY

---

[API](https://skmtc.net/invoicexpress/apis/invoicexpress-api.md) · [All operations](https://skmtc.net/invoicexpress/apis/invoicexpress-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/invoicexpress/invoicexpress-api/versions/5cea7e1d8f41/schema)