Zum Inhalt
HALOWERK

Commerce validator

eu / vat customs country origin validator

Validate the country origin signal in a fixed vat customs text or HTML snapshot. It reports evidence and missing signals without fetching or retaining the page and without certifying legal compliance.

POST https://commerce-validator.halowerk.com/v1/eu/vat-customs-country-origin-validator

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
effective_datestringJaDate on which the commercial decision is evaluated (YYYY-MM-DD).
seller_countrystringJa
customer_countrystringJa
document_textstringJaFixed text or HTML snapshot to validate. It is processed in memory and not persisted.
declared_fieldsarrayNein
page_urlstringNeinOptional provenance URL. The validator does not fetch it.
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "effective_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date on which the commercial decision is evaluated (YYYY-MM-DD)."
    },
    "seller_country": {
      "type": "string",
      "enum": [
        "AT",
        "BE",
        "BG",
        "HR",
        "CY",
        "CZ",
        "DK",
        "EE",
        "FI",
        "FR",
        "DE",
        "GR",
        "HU",
        "IE",
        "IT",
        "LV",
        "LT",
        "LU",
        "MT",
        "NL",
        "PL",
        "PT",
        "RO",
        "SK",
        "SI",
        "ES",
        "SE"
      ]
    },
    "customer_country": {
      "type": "string",
      "enum": [
        "AT",
        "BE",
        "BG",
        "HR",
        "CY",
        "CZ",
        "DK",
        "EE",
        "FI",
        "FR",
        "DE",
        "GR",
        "HU",
        "IE",
        "IT",
        "LV",
        "LT",
        "LU",
        "MT",
        "NL",
        "PL",
        "PT",
        "RO",
        "SK",
        "SI",
        "ES",
        "SE"
      ]
    },
    "document_text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 50000,
      "description": "Fixed text or HTML snapshot to validate. It is processed in memory and not persisted."
    },
    "declared_fields": {
      "type": "array",
      "maxItems": 200,
      "uniqueItems": true,
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      },
      "default": []
    },
    "page_url": {
      "type": "string",
      "pattern": "^https?://",
      "maxLength": 2048,
      "description": "Optional provenance URL. The validator does not fetch it."
    }
  },
  "required": [
    "effective_date",
    "seller_country",
    "customer_country",
    "document_text"
  ]
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "effective_date": "2026-09-04",
  "seller_country": "DE",
  "customer_country": "FR",
  "document_text": "Seller GmbH — country origin declared for this transaction.",
  "declared_fields": [
    "country-origin"
  ]
}

Ergebnis & Dokumentation

Veröffentlichtes Ergebnisschema anzeigen
{
  "$ref": "https://commerce-validator.halowerk.com/v1/eu/vat-customs-country-origin-validator/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

Alle Endpunkte dieses Hubs →