---
title: "addInvoices invoice"
method: POST
path: "/ops/invoices"
tags: ["ops"]
---

# addInvoices invoice

`POST /ops/invoices`

Add invoices for an end customer by ops

## Request body

- AddInvoicesRequestBody
  - `invoices` InvoicePayload[], required — Invoices to add or update
    - `amount` MoneyAmount, required
      - `currency` string, required — Currency code, see ISO 4127 (https://www.iso.org/iso-4217-currency-codes.html) (supported: EUR, GBP, USD)
      - `gross` integer, required — Gross amount of money, expressed in the minor unit for the currency
      - `net` integer, required — Net amount of money, expressed in the minor unit for the currency
    - `confirm_overwrite` boolean — Confirm that the invoice will be overwritten if it already exists.
    - `contract_type` 'pay_now' | 'rent' — Different contracts type
    - `duration` 0 | 6 | 12 | 24 | 30 | 36 | 48 — The duration in months
    - `encrypted_invoice_number` string, required — Unique encrypted Invoice Number
    - `file` string, required — Base64 encoded string containing the invoice
    - `invoice_date` string, required — The date of the invoice
    - `order_id` string, regexp, required — topi order ID
    - `seller_offer_reference` string — Partner's own reference for the offer related with this invoice
    - `transaction_type` 'invoice' | 'credit_note' — Type of the transaction. Credit note means that the customer is credited.
    - `withdrawal_date` string, date-time
  - `send_email` boolean, required — Should adding invoices trigger email to the user

## Response `200`

OK response.

## Other responses

- `400` — BadRequest: Bad Request response.
- `401` — Unauthorized: Unauthorized response.
- `403` — InvalidScopes: Forbidden response.
- `409` — InvoiceUploadConflict: Conflict response.
- `503` — ServiceUnavailable: Service Unavailable response.

---

[API](https://skmtc.net/topi/apis/topi-public-api.md) · [All operations](https://skmtc.net/topi/apis/topi-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/topi/topi-public-api/revisions/c66cdcca5f9e/schema)