---
title: "Create the paid invoice for one bank credit the importer did not book"
method: POST
path: "/invoices/from-credit"
tags: ["Invoices"]
---

# Create the paid invoice for one bank credit the importer did not book

`POST /invoices/from-credit`

## Request

- Base URL: `https://api.vocal.email/v1`
- URL: `https://api.vocal.email/v1/invoices/from-credit`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/vocal/apis/magic-heidi-invoicing-software-api/docs/invoices/from-credit/post.ts> (a function with typed inputs; its response is checked against the schema)

The manual override for `/invoices/import`. Every credit the import left uncreated — `unclassified` (the model was unsure) and `nonInvoiceable` (it judged the credit not to be revenue) — comes back with a ready-made `payload` under `details`; post that object here verbatim to create the invoice anyway, optionally overriding `clientName` and `itemName` first. The invoice is built by the importer's own builder: stored paid, payment recorded on the transaction date, VAT inclusive, and carrying the same `importRef`, so a later re-import of the statement recognises it. Confirming the same credit twice returns the first invoice (`alreadyExisted: true`) instead of creating a second.

## Request body

- object
  - `clientName` string: Who to invoice. Defaults to the credit's payer, then its description.
  - `credit` object, required
    - `amount` number, required
    - `counterparty` string
    - `currency` string
    - `date` string, date, required
    - `description` string
    - `importRef` string: Fingerprint from the import summary; makes the confirmation idempotent.
  - `itemName` string: What was sold. Defaults to the client name.

## Response `200`

This credit was already confirmed; the existing invoice is returned

## Other responses

- `201`: Invoice created
- `400`: The credit has no usable date, amount or client name
- `401`: Unauthorized
- `500`: Internal Server Error

---

[API](https://skmtc.dev/vocal/apis/magic-heidi-invoicing-software-api.md) - [All operations](https://skmtc.dev/vocal/apis/magic-heidi-invoicing-software-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vocal/apis/magic-heidi-invoicing-software-api/revisions/d0319ad57804?raw)