StateSet API Docs

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": "string",
  "customer": {
    "city": "string",
    "country": "string",
    "endpoint_id": "string",
    "endpoint_scheme": "string",
    "name": "string",
    "postal_code": "string",
    "street": [
      "string"
    ],
    "vat_id": "string"
  },
  "due_date": "string",
  "invoice_number": "string",
  "issue_date": "string",
  "lines": [
    {
      "description": "string",
      "quantity": "string",
      "unit_price": "string",
      "uom": "string"
    }
  ],
  "supplier": {
    "city": "string",
    "country": "string",
    "endpoint_id": "string",
    "endpoint_scheme": "string",
    "name": "string",
    "postal_code": "string",
    "street": [
      "string"
    ],
    "vat_id": "string"
  },
  "tax_percent": "string"
}'

POST

einvoice

ubl

{partner_id}

validate

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": "string",
  "customer": {
    "city": "string",
    "country": "string",
    "endpoint_id": "string",
    "endpoint_scheme": "string",
    "name": "string",
    "postal_code": "string",
    "street": [
      "string"
    ],
    "vat_id": "string"
  },
  "due_date": "string",
  "invoice_number": "string",
  "issue_date": "string",
  "lines": [
    {
      "description": "string",
      "quantity": "string",
      "unit_price": "string",
      "uom": "string"
    }
  ],
  "supplier": {
    "city": "string",
    "country": "string",
    "endpoint_id": "string",
    "endpoint_scheme": "string",
    "name": "string",
    "postal_code": "string",
    "street": [
      "string"
    ],
    "vat_id": "string"
  },
  "tax_percent": "string"
}'

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

Path parameters

string

required

Partner ID

Request body

UblInvoiceInput

string

ISO 4217 currency, e.g. EUR.

EInvoiceParty

required

string

required

string

required

ISO date YYYY-MM-DD.

UblLine[]

required

EInvoiceParty

required

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)

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": "string",
  "customer": {
    "city": "string",
    "country": "string",
    "endpoint_id": "string",
    "endpoint_scheme": "string",
    "name": "string",
    "postal_code": "string",
    "street": [
      "string"
    ],
    "vat_id": "string"
  },
  "due_date": "string",
  "invoice_number": "string",
  "issue_date": "string",
  "lines": [
    {
      "description": "string",
      "quantity": "string",
      "unit_price": "string",
      "uom": "string"
    }
  ],
  "supplier": {
    "city": "string",
    "country": "string",
    "endpoint_id": "string",
    "endpoint_scheme": "string",
    "name": "string",
    "postal_code": "string",
    "street": [
      "string"
    ],
    "vat_id": "string"
  },
  "tax_percent": "string"
}'

Overview

Partners

Inbound

Outbound

Operations

System

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

Path parameters

Request body

Response

Status codes

​Path parameters

​Request body

​Response

​Status codes

Path parameters

Request body

Response

Status codes