> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Validates a Peppol-BIS invoice payload against the BIS Billing 3.0 business

> rules (EN 16931 + PEPPOL) without generating or persisting — the conformance gate before handing UBL to an access point.

rules (EN 16931 + PEPPOL) without generating or persisting — the conformance
gate before handing UBL to an access point.

### Path parameters

<ParamField path="partner_id" type="string" required>
  Partner ID
</ParamField>

### Request body

`UblInvoiceInput`

<ParamField body="buyer_reference" type="string" />

<ParamField body="currency" type="string">
  ISO 4217 currency, e.g. `EUR`.
</ParamField>

<ParamField body="customer" type="EInvoiceParty" required />

<ParamField body="due_date" type="string" />

<ParamField body="invoice_number" type="string" required />

<ParamField body="issue_date" type="string" required>
  ISO date `YYYY-MM-DD`.
</ParamField>

<ParamField body="lines" type="UblLine[]" required />

<ParamField body="supplier" type="EInvoiceParty" required />

<ParamField body="tax_percent" type="string">
  Single VAT rate (percent) applied to the whole invoice — the common case; multi-rate breakdown is a later refinement.
</ParamField>

### Response

No response body. BIS validation result (valid + per-rule issues).

### Status codes

| Code  | Meaning                                         |
| ----- | ----------------------------------------------- |
| `200` | BIS validation result (valid + per-rule issues) |

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST \
    --url 'https://edi.stateset.com/v1/einvoice/ubl/{partner_id}/validate' \
    --header 'Authorization: Bearer YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{
    "buyer_reference": "string",
    "currency": "USD",
    "customer": {
      "city": "San Francisco",
      "country": "US",
      "endpoint_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "endpoint_scheme": "string",
      "name": "Two-Person Tent",
      "postal_code": "94107",
      "street": [
        "548 Market St"
      ],
      "vat_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    },
    "due_date": "2026-08-31T14:22:05Z",
    "invoice_number": "ORD-10042",
    "issue_date": "2026-08-31T14:22:05Z",
    "lines": [
      {
        "description": "Two-person tent, green — replacement for damaged pole set.",
        "quantity": "string",
        "unit_price": "49.00",
        "uom": "string"
      }
    ],
    "supplier": {
      "city": "San Francisco",
      "country": "US",
      "endpoint_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "endpoint_scheme": "string",
      "name": "Two-Person Tent",
      "postal_code": "94107",
      "street": [
        "548 Market St"
      ],
      "vat_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    },
    "tax_percent": "string"
  }'
  ```
</RequestExample>