Actions50
- Acquisition Actions
- Article Actions
- Customer Actions
- Customer Inquiry Actions
- Delivery Note Actions
- Document Management Actions
- Document Sync Actions
- Invoice Actions
- Newsletter Actions
- Offer Actions
- Order Actions
- Purchase Inquiry Actions
- Purchase Invoice Actions
- Purchase Order Actions
- Supplier Actions
- Workflow Actions
Purchase Invoice → Create
AI-generatedSummary
Creates a TaxMetall purchase invoice from either EN 16931 e-invoice XML or manually supplied header and position fields. Can validate and calculate the invoice without saving it, or create it and return the service response.
Inputs
- Input Mode — Choose E-Invoice to provide Invoice XML, or Parameters to supply the supplier, invoice number, date, and positions.
- Invoice XML (required) — In E-Invoice mode, provide Base64 or plain XML. Extract the embedded XML from a ZUGFeRD PDF first. Supplier Number is optional; when omitted, the service identifies the supplier from the file.
- Discount Handling — In E-Invoice mode, choose whether document-level allowances and charges become separate invoice positions, or allowances apply to the header discount and charges to freight. Header handling is rejected for invoices with mixed VAT rates.
- Supplier Number (required) — In Parameters mode, the supplier number the invoice belongs to.
- Purchase Invoice Number (required) — In Parameters mode, provide the supplier's invoice number, up to 30 characters; the number is required because no number range is used.
- Invoice Date (required) — In Parameters mode, provide the invoice date as yyyy-mm-dd.
- Positions Input — In Parameters mode, choose a JSON list or a manual list of invoice positions. At least one position is required.
- Positions (JSON) — In JSON mode, provide positions with an article number or description, plus quantity and price or total net. Optional fields include price base quantity, discount, VAT rate or key, account, cost center, purchase order reference, service date, and project details. Common English key names are also accepted.
- Positions — In manual-list mode, add one or more positions. Each can include an account, article number, cost center, description, discount, price base quantity, purchase order number and position, quantity, service date, total net, unit price, and VAT key or rate. An article number must exist; leave it blank for a free-text line.
- Validate Only — Run checks and full calculation without creating the invoice.
- Additional Fields — Optional header values such as booking text, business unit, cash discount terms, cost center, currency, delivery note number, document type, freight, G/L account, payment days, note, overall discount, project details, purchase order number, service date, and VAT key or rate. In E-Invoice mode, supplied values override those read from the file. Credit notes must have a negative total.
Output shape
A single service response record per input item.
With Validate Only enabled, returns the validation and calculation response without creating an invoice. Otherwise, creates the invoice and returns the service response; the exact response fields are not established by the supplied source view.