Workflow-Verarbeitung auslösen
curl --request POST \
--url https://api.comstruct.com/v1/workflows/trigger \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"external_id": "INV-2024-001",
"base64document": "JVBERi0xLjQKJcOkw7zDtsO...",
"project_number": "PRJ-2024-001",
"creditor_number": "CR-001",
"creditor_name": "ABC Supplies Ltd.",
"invoice_number": "INV-2024-001",
"invoice_date": "2024-01-15",
"due_date": "2024-02-15",
"currency": "EUR",
"net_amount": 1000,
"total_amount": 1190,
"total_tax_amount": 190,
"tenant": "tenant-123",
"comment": "Spezielle Handhabung erforderlich",
"document_type": "INVOICE",
"payment_term_number": "ZB01",
"assignee": "john.doe@example.com",
"accounts": [
{
"account_number": "1000",
"project_number": "PRJ-2024-001",
"quantity": 10,
"unit": "h",
"net_amount": 1000,
"gross_amount": 1190,
"tax_amount": 190,
"tax_code_number": "V2",
"dimensions": [
{
"dimension_label": "Cost Center",
"text_value": "CC-001-A"
}
]
}
],
"dimensions": [
{
"dimension_label": "Cost Center",
"option_title": "Material"
},
{
"dimension_label": "Order Number",
"text_value": "4500012345"
}
]
}
'import requests
url = "https://api.comstruct.com/v1/workflows/trigger"
payload = {
"external_id": "INV-2024-001",
"base64document": "JVBERi0xLjQKJcOkw7zDtsO...",
"project_number": "PRJ-2024-001",
"creditor_number": "CR-001",
"creditor_name": "ABC Supplies Ltd.",
"invoice_number": "INV-2024-001",
"invoice_date": "2024-01-15",
"due_date": "2024-02-15",
"currency": "EUR",
"net_amount": 1000,
"total_amount": 1190,
"total_tax_amount": 190,
"tenant": "tenant-123",
"comment": "Spezielle Handhabung erforderlich",
"document_type": "INVOICE",
"payment_term_number": "ZB01",
"assignee": "john.doe@example.com",
"accounts": [
{
"account_number": "1000",
"project_number": "PRJ-2024-001",
"quantity": 10,
"unit": "h",
"net_amount": 1000,
"gross_amount": 1190,
"tax_amount": 190,
"tax_code_number": "V2",
"dimensions": [
{
"dimension_label": "Cost Center",
"text_value": "CC-001-A"
}
]
}
],
"dimensions": [
{
"dimension_label": "Cost Center",
"option_title": "Material"
},
{
"dimension_label": "Order Number",
"text_value": "4500012345"
}
]
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
external_id: 'INV-2024-001',
base64document: 'JVBERi0xLjQKJcOkw7zDtsO...',
project_number: 'PRJ-2024-001',
creditor_number: 'CR-001',
creditor_name: 'ABC Supplies Ltd.',
invoice_number: 'INV-2024-001',
invoice_date: '2024-01-15',
due_date: '2024-02-15',
currency: 'EUR',
net_amount: 1000,
total_amount: 1190,
total_tax_amount: 190,
tenant: 'tenant-123',
comment: 'Spezielle Handhabung erforderlich',
document_type: 'INVOICE',
payment_term_number: 'ZB01',
assignee: 'john.doe@example.com',
accounts: [
{
account_number: '1000',
project_number: 'PRJ-2024-001',
quantity: 10,
unit: 'h',
net_amount: 1000,
gross_amount: 1190,
tax_amount: 190,
tax_code_number: 'V2',
dimensions: [{dimension_label: 'Cost Center', text_value: 'CC-001-A'}]
}
],
dimensions: [
{dimension_label: 'Cost Center', option_title: 'Material'},
{dimension_label: 'Order Number', text_value: '4500012345'}
]
})
};
fetch('https://api.comstruct.com/v1/workflows/trigger', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.comstruct.com/v1/workflows/trigger",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'external_id' => 'INV-2024-001',
'base64document' => 'JVBERi0xLjQKJcOkw7zDtsO...',
'project_number' => 'PRJ-2024-001',
'creditor_number' => 'CR-001',
'creditor_name' => 'ABC Supplies Ltd.',
'invoice_number' => 'INV-2024-001',
'invoice_date' => '2024-01-15',
'due_date' => '2024-02-15',
'currency' => 'EUR',
'net_amount' => 1000,
'total_amount' => 1190,
'total_tax_amount' => 190,
'tenant' => 'tenant-123',
'comment' => 'Spezielle Handhabung erforderlich',
'document_type' => 'INVOICE',
'payment_term_number' => 'ZB01',
'assignee' => 'john.doe@example.com',
'accounts' => [
[
'account_number' => '1000',
'project_number' => 'PRJ-2024-001',
'quantity' => 10,
'unit' => 'h',
'net_amount' => 1000,
'gross_amount' => 1190,
'tax_amount' => 190,
'tax_code_number' => 'V2',
'dimensions' => [
[
'dimension_label' => 'Cost Center',
'text_value' => 'CC-001-A'
]
]
]
],
'dimensions' => [
[
'dimension_label' => 'Cost Center',
'option_title' => 'Material'
],
[
'dimension_label' => 'Order Number',
'text_value' => '4500012345'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.comstruct.com/v1/workflows/trigger"
payload := strings.NewReader("{\n \"external_id\": \"INV-2024-001\",\n \"base64document\": \"JVBERi0xLjQKJcOkw7zDtsO...\",\n \"project_number\": \"PRJ-2024-001\",\n \"creditor_number\": \"CR-001\",\n \"creditor_name\": \"ABC Supplies Ltd.\",\n \"invoice_number\": \"INV-2024-001\",\n \"invoice_date\": \"2024-01-15\",\n \"due_date\": \"2024-02-15\",\n \"currency\": \"EUR\",\n \"net_amount\": 1000,\n \"total_amount\": 1190,\n \"total_tax_amount\": 190,\n \"tenant\": \"tenant-123\",\n \"comment\": \"Spezielle Handhabung erforderlich\",\n \"document_type\": \"INVOICE\",\n \"payment_term_number\": \"ZB01\",\n \"assignee\": \"john.doe@example.com\",\n \"accounts\": [\n {\n \"account_number\": \"1000\",\n \"project_number\": \"PRJ-2024-001\",\n \"quantity\": 10,\n \"unit\": \"h\",\n \"net_amount\": 1000,\n \"gross_amount\": 1190,\n \"tax_amount\": 190,\n \"tax_code_number\": \"V2\",\n \"dimensions\": [\n {\n \"dimension_label\": \"Cost Center\",\n \"text_value\": \"CC-001-A\"\n }\n ]\n }\n ],\n \"dimensions\": [\n {\n \"dimension_label\": \"Cost Center\",\n \"option_title\": \"Material\"\n },\n {\n \"dimension_label\": \"Order Number\",\n \"text_value\": \"4500012345\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.comstruct.com/v1/workflows/trigger")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"external_id\": \"INV-2024-001\",\n \"base64document\": \"JVBERi0xLjQKJcOkw7zDtsO...\",\n \"project_number\": \"PRJ-2024-001\",\n \"creditor_number\": \"CR-001\",\n \"creditor_name\": \"ABC Supplies Ltd.\",\n \"invoice_number\": \"INV-2024-001\",\n \"invoice_date\": \"2024-01-15\",\n \"due_date\": \"2024-02-15\",\n \"currency\": \"EUR\",\n \"net_amount\": 1000,\n \"total_amount\": 1190,\n \"total_tax_amount\": 190,\n \"tenant\": \"tenant-123\",\n \"comment\": \"Spezielle Handhabung erforderlich\",\n \"document_type\": \"INVOICE\",\n \"payment_term_number\": \"ZB01\",\n \"assignee\": \"john.doe@example.com\",\n \"accounts\": [\n {\n \"account_number\": \"1000\",\n \"project_number\": \"PRJ-2024-001\",\n \"quantity\": 10,\n \"unit\": \"h\",\n \"net_amount\": 1000,\n \"gross_amount\": 1190,\n \"tax_amount\": 190,\n \"tax_code_number\": \"V2\",\n \"dimensions\": [\n {\n \"dimension_label\": \"Cost Center\",\n \"text_value\": \"CC-001-A\"\n }\n ]\n }\n ],\n \"dimensions\": [\n {\n \"dimension_label\": \"Cost Center\",\n \"option_title\": \"Material\"\n },\n {\n \"dimension_label\": \"Order Number\",\n \"text_value\": \"4500012345\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.comstruct.com/v1/workflows/trigger")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"external_id\": \"INV-2024-001\",\n \"base64document\": \"JVBERi0xLjQKJcOkw7zDtsO...\",\n \"project_number\": \"PRJ-2024-001\",\n \"creditor_number\": \"CR-001\",\n \"creditor_name\": \"ABC Supplies Ltd.\",\n \"invoice_number\": \"INV-2024-001\",\n \"invoice_date\": \"2024-01-15\",\n \"due_date\": \"2024-02-15\",\n \"currency\": \"EUR\",\n \"net_amount\": 1000,\n \"total_amount\": 1190,\n \"total_tax_amount\": 190,\n \"tenant\": \"tenant-123\",\n \"comment\": \"Spezielle Handhabung erforderlich\",\n \"document_type\": \"INVOICE\",\n \"payment_term_number\": \"ZB01\",\n \"assignee\": \"john.doe@example.com\",\n \"accounts\": [\n {\n \"account_number\": \"1000\",\n \"project_number\": \"PRJ-2024-001\",\n \"quantity\": 10,\n \"unit\": \"h\",\n \"net_amount\": 1000,\n \"gross_amount\": 1190,\n \"tax_amount\": 190,\n \"tax_code_number\": \"V2\",\n \"dimensions\": [\n {\n \"dimension_label\": \"Cost Center\",\n \"text_value\": \"CC-001-A\"\n }\n ]\n }\n ],\n \"dimensions\": [\n {\n \"dimension_label\": \"Cost Center\",\n \"option_title\": \"Material\"\n },\n {\n \"dimension_label\": \"Order Number\",\n \"text_value\": \"4500012345\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"external_id": "INV-2024-001",
"invoiceId": "123",
"jobId": "job-789xyz012"
}
Workflows
Workflow auslösen
Erforderliche Berechtigungen: invoices:write
Löst den Rechnungsverarbeitungs-Workflow für die JobRouter-Integration aus.
Dieser Endpunkt ermöglicht es, eine Rechnung mit umfassenden Daten (Lieferant, Beträge, Daten und Metadaten) zur Verarbeitung einzureichen. Die Rechnung wird asynchron im Hintergrund verarbeitet. API-Schlüssel muss mit einem Kunden verknüpft sein.
POST
/
workflows
/
trigger
Workflow-Verarbeitung auslösen
curl --request POST \
--url https://api.comstruct.com/v1/workflows/trigger \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"external_id": "INV-2024-001",
"base64document": "JVBERi0xLjQKJcOkw7zDtsO...",
"project_number": "PRJ-2024-001",
"creditor_number": "CR-001",
"creditor_name": "ABC Supplies Ltd.",
"invoice_number": "INV-2024-001",
"invoice_date": "2024-01-15",
"due_date": "2024-02-15",
"currency": "EUR",
"net_amount": 1000,
"total_amount": 1190,
"total_tax_amount": 190,
"tenant": "tenant-123",
"comment": "Spezielle Handhabung erforderlich",
"document_type": "INVOICE",
"payment_term_number": "ZB01",
"assignee": "john.doe@example.com",
"accounts": [
{
"account_number": "1000",
"project_number": "PRJ-2024-001",
"quantity": 10,
"unit": "h",
"net_amount": 1000,
"gross_amount": 1190,
"tax_amount": 190,
"tax_code_number": "V2",
"dimensions": [
{
"dimension_label": "Cost Center",
"text_value": "CC-001-A"
}
]
}
],
"dimensions": [
{
"dimension_label": "Cost Center",
"option_title": "Material"
},
{
"dimension_label": "Order Number",
"text_value": "4500012345"
}
]
}
'import requests
url = "https://api.comstruct.com/v1/workflows/trigger"
payload = {
"external_id": "INV-2024-001",
"base64document": "JVBERi0xLjQKJcOkw7zDtsO...",
"project_number": "PRJ-2024-001",
"creditor_number": "CR-001",
"creditor_name": "ABC Supplies Ltd.",
"invoice_number": "INV-2024-001",
"invoice_date": "2024-01-15",
"due_date": "2024-02-15",
"currency": "EUR",
"net_amount": 1000,
"total_amount": 1190,
"total_tax_amount": 190,
"tenant": "tenant-123",
"comment": "Spezielle Handhabung erforderlich",
"document_type": "INVOICE",
"payment_term_number": "ZB01",
"assignee": "john.doe@example.com",
"accounts": [
{
"account_number": "1000",
"project_number": "PRJ-2024-001",
"quantity": 10,
"unit": "h",
"net_amount": 1000,
"gross_amount": 1190,
"tax_amount": 190,
"tax_code_number": "V2",
"dimensions": [
{
"dimension_label": "Cost Center",
"text_value": "CC-001-A"
}
]
}
],
"dimensions": [
{
"dimension_label": "Cost Center",
"option_title": "Material"
},
{
"dimension_label": "Order Number",
"text_value": "4500012345"
}
]
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
external_id: 'INV-2024-001',
base64document: 'JVBERi0xLjQKJcOkw7zDtsO...',
project_number: 'PRJ-2024-001',
creditor_number: 'CR-001',
creditor_name: 'ABC Supplies Ltd.',
invoice_number: 'INV-2024-001',
invoice_date: '2024-01-15',
due_date: '2024-02-15',
currency: 'EUR',
net_amount: 1000,
total_amount: 1190,
total_tax_amount: 190,
tenant: 'tenant-123',
comment: 'Spezielle Handhabung erforderlich',
document_type: 'INVOICE',
payment_term_number: 'ZB01',
assignee: 'john.doe@example.com',
accounts: [
{
account_number: '1000',
project_number: 'PRJ-2024-001',
quantity: 10,
unit: 'h',
net_amount: 1000,
gross_amount: 1190,
tax_amount: 190,
tax_code_number: 'V2',
dimensions: [{dimension_label: 'Cost Center', text_value: 'CC-001-A'}]
}
],
dimensions: [
{dimension_label: 'Cost Center', option_title: 'Material'},
{dimension_label: 'Order Number', text_value: '4500012345'}
]
})
};
fetch('https://api.comstruct.com/v1/workflows/trigger', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.comstruct.com/v1/workflows/trigger",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'external_id' => 'INV-2024-001',
'base64document' => 'JVBERi0xLjQKJcOkw7zDtsO...',
'project_number' => 'PRJ-2024-001',
'creditor_number' => 'CR-001',
'creditor_name' => 'ABC Supplies Ltd.',
'invoice_number' => 'INV-2024-001',
'invoice_date' => '2024-01-15',
'due_date' => '2024-02-15',
'currency' => 'EUR',
'net_amount' => 1000,
'total_amount' => 1190,
'total_tax_amount' => 190,
'tenant' => 'tenant-123',
'comment' => 'Spezielle Handhabung erforderlich',
'document_type' => 'INVOICE',
'payment_term_number' => 'ZB01',
'assignee' => 'john.doe@example.com',
'accounts' => [
[
'account_number' => '1000',
'project_number' => 'PRJ-2024-001',
'quantity' => 10,
'unit' => 'h',
'net_amount' => 1000,
'gross_amount' => 1190,
'tax_amount' => 190,
'tax_code_number' => 'V2',
'dimensions' => [
[
'dimension_label' => 'Cost Center',
'text_value' => 'CC-001-A'
]
]
]
],
'dimensions' => [
[
'dimension_label' => 'Cost Center',
'option_title' => 'Material'
],
[
'dimension_label' => 'Order Number',
'text_value' => '4500012345'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.comstruct.com/v1/workflows/trigger"
payload := strings.NewReader("{\n \"external_id\": \"INV-2024-001\",\n \"base64document\": \"JVBERi0xLjQKJcOkw7zDtsO...\",\n \"project_number\": \"PRJ-2024-001\",\n \"creditor_number\": \"CR-001\",\n \"creditor_name\": \"ABC Supplies Ltd.\",\n \"invoice_number\": \"INV-2024-001\",\n \"invoice_date\": \"2024-01-15\",\n \"due_date\": \"2024-02-15\",\n \"currency\": \"EUR\",\n \"net_amount\": 1000,\n \"total_amount\": 1190,\n \"total_tax_amount\": 190,\n \"tenant\": \"tenant-123\",\n \"comment\": \"Spezielle Handhabung erforderlich\",\n \"document_type\": \"INVOICE\",\n \"payment_term_number\": \"ZB01\",\n \"assignee\": \"john.doe@example.com\",\n \"accounts\": [\n {\n \"account_number\": \"1000\",\n \"project_number\": \"PRJ-2024-001\",\n \"quantity\": 10,\n \"unit\": \"h\",\n \"net_amount\": 1000,\n \"gross_amount\": 1190,\n \"tax_amount\": 190,\n \"tax_code_number\": \"V2\",\n \"dimensions\": [\n {\n \"dimension_label\": \"Cost Center\",\n \"text_value\": \"CC-001-A\"\n }\n ]\n }\n ],\n \"dimensions\": [\n {\n \"dimension_label\": \"Cost Center\",\n \"option_title\": \"Material\"\n },\n {\n \"dimension_label\": \"Order Number\",\n \"text_value\": \"4500012345\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.comstruct.com/v1/workflows/trigger")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"external_id\": \"INV-2024-001\",\n \"base64document\": \"JVBERi0xLjQKJcOkw7zDtsO...\",\n \"project_number\": \"PRJ-2024-001\",\n \"creditor_number\": \"CR-001\",\n \"creditor_name\": \"ABC Supplies Ltd.\",\n \"invoice_number\": \"INV-2024-001\",\n \"invoice_date\": \"2024-01-15\",\n \"due_date\": \"2024-02-15\",\n \"currency\": \"EUR\",\n \"net_amount\": 1000,\n \"total_amount\": 1190,\n \"total_tax_amount\": 190,\n \"tenant\": \"tenant-123\",\n \"comment\": \"Spezielle Handhabung erforderlich\",\n \"document_type\": \"INVOICE\",\n \"payment_term_number\": \"ZB01\",\n \"assignee\": \"john.doe@example.com\",\n \"accounts\": [\n {\n \"account_number\": \"1000\",\n \"project_number\": \"PRJ-2024-001\",\n \"quantity\": 10,\n \"unit\": \"h\",\n \"net_amount\": 1000,\n \"gross_amount\": 1190,\n \"tax_amount\": 190,\n \"tax_code_number\": \"V2\",\n \"dimensions\": [\n {\n \"dimension_label\": \"Cost Center\",\n \"text_value\": \"CC-001-A\"\n }\n ]\n }\n ],\n \"dimensions\": [\n {\n \"dimension_label\": \"Cost Center\",\n \"option_title\": \"Material\"\n },\n {\n \"dimension_label\": \"Order Number\",\n \"text_value\": \"4500012345\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.comstruct.com/v1/workflows/trigger")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"external_id\": \"INV-2024-001\",\n \"base64document\": \"JVBERi0xLjQKJcOkw7zDtsO...\",\n \"project_number\": \"PRJ-2024-001\",\n \"creditor_number\": \"CR-001\",\n \"creditor_name\": \"ABC Supplies Ltd.\",\n \"invoice_number\": \"INV-2024-001\",\n \"invoice_date\": \"2024-01-15\",\n \"due_date\": \"2024-02-15\",\n \"currency\": \"EUR\",\n \"net_amount\": 1000,\n \"total_amount\": 1190,\n \"total_tax_amount\": 190,\n \"tenant\": \"tenant-123\",\n \"comment\": \"Spezielle Handhabung erforderlich\",\n \"document_type\": \"INVOICE\",\n \"payment_term_number\": \"ZB01\",\n \"assignee\": \"john.doe@example.com\",\n \"accounts\": [\n {\n \"account_number\": \"1000\",\n \"project_number\": \"PRJ-2024-001\",\n \"quantity\": 10,\n \"unit\": \"h\",\n \"net_amount\": 1000,\n \"gross_amount\": 1190,\n \"tax_amount\": 190,\n \"tax_code_number\": \"V2\",\n \"dimensions\": [\n {\n \"dimension_label\": \"Cost Center\",\n \"text_value\": \"CC-001-A\"\n }\n ]\n }\n ],\n \"dimensions\": [\n {\n \"dimension_label\": \"Cost Center\",\n \"option_title\": \"Material\"\n },\n {\n \"dimension_label\": \"Order Number\",\n \"text_value\": \"4500012345\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"external_id": "INV-2024-001",
"invoiceId": "123",
"jobId": "job-789xyz012"
}
Ermöglicht das Einreichen von Rechnungen aus externen Systemen (z.B. JobRouter) zur asynchronen Verarbeitung in comstruct.
Verwenden Sie die
external_id später mit dem Workflow-Status-Endpunkt, um den Verarbeitungsstatus abzufragen.
Dimensionszuweisungen
Über das optionaledimensions-Feld können externe Systeme Dimensionswerte als { dimension_label, option_title }-Paare übergeben. Diese werden anhand der konfigurierten Rechnungsdimensionen des Mandanten aufgelöst und der erstellten Rechnung zugewiesen. Übergebene Dimensionswerte haben Vorrang vor KI-extrahierten Werten.Autorisierungen
API-Schlüssel zur Authentifizierung. Kontaktieren Sie Ihren Customer Success Manager, um einen API-Schlüssel zu erhalten.
Jeder Endpunkt erfordert spezifische Berechtigungen (Scopes); die erforderlichen Scopes werden pro Endpunkt angezeigt.
Scopes
invoices:write
Body
application/json
Externe Kennung für die Rechnung (zur späteren Statusabfrage)
Beispiel:
"INV-2024-001"
Base64-kodiertes PDF-Dokument
Beispiel:
"JVBERi0xLjQKJcOkw7zDtsO..."
Projektnummer
Beispiel:
"PRJ-2024-001"
Name des Kreditors/Lieferanten
Beispiel:
"ABC Supplies Ltd."
Rechnungsnummer
Beispiel:
"INV-2024-001"
Rechnungsdatum im Format YYYY-MM-DD
Beispiel:
"2024-01-15"
Nettobetrag
Beispiel:
1000
Gesamtbetrag (brutto)
Beispiel:
1190
Mandanten-Kennung
Beispiel:
"tenant-123"
Kreditorennummer (optional)
Beispiel:
"CR-001"
Fälligkeitsdatum im Format YYYY-MM-DD (optional)
Beispiel:
"2024-02-15"
Buchungsdatum im Format YYYY-MM-DD (optional). Wenn nicht angegeben, wird das aktuelle Datum verwendet.
Beispiel:
"2024-01-16"
Währungscode (ISO-4217)
Beispiel:
"EUR"
Kommentar (optional)
Beispiel:
"Spezielle Handhabung erforderlich"
Dokumenttyp
Verfügbare Optionen:
INVOICE, CREDIT_NOTE, DOWN_PAYMENT, FINAL_INVOICE, PAYMENT_REMINDER, GUARANTEE Beispiel:
"INVOICE"
Zahlungsbedingungsnummer zur Auflösung. Wird gesetzt, wenn gefunden; sonst bleibt die Erkennung offen.
Beispiel:
"ZB01"
Gesamter Steuerbetrag (optional)
Beispiel:
190
E-Mail-Adresse des Benutzers, dem die Rechnung zugewiesen werden soll (optional)
Beispiel:
"john.doe@example.com"
Vordefinierte Rechnungskontierungen mit Kontonummern, Mengen und Projektnummern (optional). Hat Vorrang vor der Comstruct-Kontierung.
Show child attributes
Show child attributes
Beispiel:
[ { "account_number": "1000", "project_number": "PRJ-001", "quantity": 10, "unit": "h", "net_amount": 1000, "gross_amount": 1190, "tax_amount": 190, "tax_code_number": "V2", "dimensions": [ { "dimension_label": "Cost Center", "text_value": "CC-001-A" } ] } ]
Optionale Header-Dimensionszuweisungen als Label/Titel- oder Label/Text-Paare.
Für Options-Dimensionen option_title setzen; für Text-Dimensionen text_value.
Hat Vorrang vor KI-extrahierten Header-Werten. Für Kontierungs-Dimensionen accounts[].dimensions verwenden.
Show child attributes
Show child attributes
Beispiel:
[ { "dimension_label": "Cost Center", "option_title": "Material" }, { "dimension_label": "Order Number", "text_value": "4500012345" } ]
Antwort
Workflow erfolgreich ausgelöst
Gibt an, ob der Workflow erfolgreich ausgelöst wurde
Beispiel:
true
Externe Kennung der verarbeiteten Rechnung
Beispiel:
"INV-2024-001"
Interne Rechnungs-ID
Beispiel:
"123"
Hintergrund-Job-ID zur Verfolgung des Verarbeitungsstatus
Beispiel:
"job-789xyz012"