curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.edi.stateset.com/v1/einvoice/ubl/{partner_id}/validate' \
--header "Authorization: Bearer $EDI_API_TOKEN" \
--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-31",
"lines": [
{
"description": "Two-person tent, green — replacement for damaged pole set.",
"quantity": "2",
"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"
}'
Validates a Peppol-BIS invoice payload against the BIS Billing 3.0 business…
BIS validation result (valid + per-rule issues)
POST
/
v1
/
einvoice
/
ubl
/
{partner_id}
/
validate
curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.edi.stateset.com/v1/einvoice/ubl/{partner_id}/validate' \
--header "Authorization: Bearer $EDI_API_TOKEN" \
--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-31",
"lines": [
{
"description": "Two-person tent, green — replacement for damaged pole set.",
"quantity": "2",
"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"
}'
Path parameters
string
required
Partner ID
Request body
UblInvoiceInput
string,null
string
ISO 4217 currency, e.g.
EUR.EInvoiceParty
required
A party on a Peppol invoice.
endpoint_id + endpoint_scheme are the Peppol participant identifier (e.g. scheme 0088 GLN, 9930 DE:VAT) that routing depends on; vat_id and country are BIS-mandatory.string,null
string
required
string
required
ISO date
YYYY-MM-DD.EInvoiceParty
required
A party on a Peppol invoice.
endpoint_id + endpoint_scheme are the Peppol participant identifier (e.g. scheme 0088 GLN, 9930 DE:VAT) that routing depends on; vat_id and country are BIS-mandatory.string
Single VAT rate (percent) applied to the whole invoice — the common case; multi-rate breakdown is a later refinement.
Response
No response body. BIS validation result (valid + per-rule issues).Status codes
| Code | Meaning |
|---|---|
200 | BIS validation result (valid + per-rule issues) |
Using this contract
Read the source OpenAPI document for declared schemas and alternatives. This page also includes documented corrections from the spec overlays. Example IDs and values are illustrative; replace them with records from your workspace.curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.edi.stateset.com/v1/einvoice/ubl/{partner_id}/validate' \
--header "Authorization: Bearer $EDI_API_TOKEN" \
--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-31",
"lines": [
{
"description": "Two-person tent, green — replacement for damaged pole set.",
"quantity": "2",
"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"
}'
Last modified on October 20, 2026