Handelswerk

po invoice match

Compares a purchase order against a delivery note and an invoice, line by line. Lines are paired by article number where both sides carry one, and otherwise by text similarity — a text pairing is marked as such with its similarity score, because quietly matching on similar wording is exactly how a wrong invoice gets approved.

POST https://handel.halowerk.com/v1/po-invoice-match

Eingaben

Felder des veröffentlichten Eingabeschemas
Feld	Typ	Pflicht	Beschreibung
purchase_order	array	Ja	Ordered lines.
delivery_note	array	Nein	Delivered lines. Optional — without it only a two-way match runs.
invoice	array	Ja	Invoiced lines.
quantity_tolerance_pct	number	Nein	Allowed quantity deviation in percent.
price_tolerance_pct	number	Nein	Allowed unit-price deviation in percent.
text_match_threshold	number	Nein	Minimum text similarity to pair lines without an article number.
currency	string	Nein

Vollständiges Eingabeschema anzeigen

{
  "type": "object",
  "required": [
    "purchase_order",
    "invoice"
  ],
  "additionalProperties": false,
  "properties": {
    "purchase_order": {
      "type": "array",
      "minItems": 1,
      "maxItems": 300,
      "description": "Ordered lines.",
      "items": {
        "type": "object",
        "required": [
          "quantity"
        ],
        "additionalProperties": false,
        "properties": {
          "sku": {
            "type": "string",
            "maxLength": 100
          },
          "description": {
            "type": "string",
            "maxLength": 300
          },
          "quantity": {
            "type": "number"
          },
          "unit_price": {
            "type": "number"
          }
        }
      }
    },
    "delivery_note": {
      "type": "array",
      "maxItems": 300,
      "description": "Delivered lines. Optional — without it only a two-way match runs.",
      "items": {
        "type": "object",
        "required": [
          "quantity"
        ],
        "additionalProperties": false,
        "properties": {
          "sku": {
            "type": "string",
            "maxLength": 100
          },
          "description": {
            "type": "string",
            "maxLength": 300
          },
          "quantity": {
            "type": "number"
          }
        }
      }
    },
    "invoice": {
      "type": "array",
      "minItems": 1,
      "maxItems": 300,
      "description": "Invoiced lines.",
      "items": {
        "type": "object",
        "required": [
          "quantity"
        ],
        "additionalProperties": false,
        "properties": {
          "sku": {
            "type": "string",
            "maxLength": 100
          },
          "description": {
            "type": "string",
            "maxLength": 300
          },
          "quantity": {
            "type": "number"
          },
          "unit_price": {
            "type": "number"
          }
        }
      }
    },
    "quantity_tolerance_pct": {
      "type": "number",
      "minimum": 0,
      "maximum": 50,
      "default": 0,
      "description": "Allowed quantity deviation in percent."
    },
    "price_tolerance_pct": {
      "type": "number",
      "minimum": 0,
      "maximum": 50,
      "default": 0,
      "description": "Allowed unit-price deviation in percent."
    },
    "text_match_threshold": {
      "type": "number",
      "minimum": 0.1,
      "maximum": 1,
      "default": 0.5,
      "description": "Minimum text similarity to pair lines without an article number."
    },
    "currency": {
      "type": "string",
      "minLength": 3,
      "maxLength": 3,
      "default": "EUR"
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "purchase_order": [
    {
      "sku": "EXAMPLE-001",
      "quantity": 2,
      "unit_price": 10
    }
  ],
  "invoice": [
    {
      "sku": "EXAMPLE-001",
      "quantity": 2,
      "unit_price": 10
    }
  ],
  "currency": "EUR"
}

Ergebnis & Dokumentation

Veröffentlichtes Ergebnisschema anzeigen

{
  "$ref": "https://handel.halowerk.com/v1/po-invoice-match/schema#/outputSchema"
}

Veröffentlichtes Ergebnisbeispiel öffnen

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.

Weitere Endpunkte dieses Hubs

Handelswerk0,005 USDC
allergen check
POSThttps://handel.halowerk.com/v1/allergen-check
Returns what a product declares about allergens: the allergen tags, the trace warnings, the ingredients text in its original language, and the completeness of the record. The distinction it holds to throughout is between not declared and no
Handelswerk0,006 USDC
container load
POSThttps://handel.halowerk.com/v1/container-load
Loads a package list into one loading space and returns the plan, not an estimate. The floor starts as one free surface; packages are sorted by footprint, then height, then weight, then identifier, and each one is placed on the lowest, then
Handelswerk0,004 USDC
delivery note json
POSThttps://handel.halowerk.com/v1/delivery-note-json
Adds structured delivery-note extraction alongside the existing invoice extractor and purchase-order matcher; does not duplicate invoice-extract or filing-to-json. Strict namespace-aware XML parsing, no model or foreign API. Only supplied s

Alle Endpunkte dieses Hubs →

po invoice match

Eingaben

Veröffentlichtes Eingabebeispiel

Ergebnis & Dokumentation

Weitere Endpunkte dieses Hubs

allergen check

container load

delivery note json