---
title: "Import a customer e-invoice"
method: POST
path: "/api/external/v2/customer_invoices/e_invoices/imports"
tags: ["Customer Invoices"]
---

# Import a customer e-invoice

`POST /api/external/v2/customer_invoices/e_invoices/imports`

Import a customer invoice from an e-invoice file.
The file must be a Factur-X PDF, a standalone UBL XML invoice, or a standalone CII XML invoice.
Optionally provide `invoice_options` to pre-fill customer and line-level data.
Invoice line `e_invoice_line_id` must match Factur-X BT-126 (LineID) or the UBL/CII line identifier.

> ⚠️ **UBL and CII XML support is in alpha.**
> A 201 response confirms the file was accepted and parsed, but invoices imported via
> standalone UBL or CII XML have two known limitations:
> - The uploaded file is **not displayed** in the app — no document preview is generated yet for these formats.
> - The invoice is **not recognized as an electronic invoice** within Pennylane.
>
> Factur-X PDF remains the recommended format for production use.


> ℹ️
> This endpoint requires the following scope: `customer_invoices:all`

## Response `201`

Customer e-invoice imported successfully

- object
  - `id` integer, required
  - `url` string, required — The URL of the imported customer e-invoice. This can be used to access the document later.

## Other responses

- `400` — Bad request
- `401` — Access token is missing or invalid
- `403` — Access to this resource forbidden
- `404` — The resource was not found
- `422` — Unprocessable content

---

[API](https://skmtc.net/pennylane/apis/company-v2.md) · [All operations](https://skmtc.net/pennylane/apis/company-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pennylane/company-v2/revisions/a5b7236473c6/schema)