Skip to content

Create documents

This guide describes how to create or upload invoices and credit notes in xTool — via the web interface or API.

Methods

Method Web API
Form (model) Documents → Create → choose format and direction → fill the form. POST upload model (JSON body).
XML Documents → Upload → select file; format can be specified or auto-detected. POST upload XML with file or body.

The result is a document with an id. You can then send it (Peppol, email), view it, or use validation/convert endpoints. See Document model and Formats.

Web: Create from form

  1. Documents → Create.
  2. Choose format (e.g. XRechnung UBL, Peppol BIS Billing) and direction (outbound / inbound).
  3. Fill in the required fields (seller, buyer, lines, amounts, etc.). Required fields depend on the format.
  4. Save. The document is created and appears in the list. You can then send it or edit it.

Web: Upload XML

  1. Documents → Upload.
  2. Select the XML file (or paste content if the interface allows).
  3. Optionally specify the format; otherwise it is detected from the file.
  4. Confirm. The document is created from the XML.

API: Upload model (JSON)

Send a POST request to the upload model endpoint with a JSON body that matches the format model for the chosen format.

Endpoint: POST /api/v2/documents/upload/model

Headers: x-api-key, Content-Type: application/json

Body: JSON according to the format (e.g. base model or minimal model). See Format models and Base model example.

The response contains the created document (including id). You can use this id for send, get, or list.

API: Upload XML

Send a POST request to the upload XML endpoint with the XML file or raw XML body.

Endpoint: POST /api/v2/documents/upload/xml

Headers: x-api-key, Content-Type: application/xml (or multipart if your client sends a file).

Body: XML invoice or credit note in a supported format (e.g. XRechnung UBL, Peppol BIS).

The response contains the created document (including id). Format is usually detected from the XML; some APIs allow specifying the format explicitly.

Next steps