SDKs
The SDKs are generated from openapi.json with OpenAPI Generator and add two hand-written helpers:
webhook signature verification and UBL submission. Source, README and a runnable example for each are in the einvo repository under sdk/.
Until they are published to the package registries, build them from source or call the API directly: it is plain HTTPS and JSON.
| Language | Package | Helpers |
|---|---|---|
| Java 17+ | ae.einvo:einvo-sdk (Maven) | EinvoWebhooks.verify, EinvoUbl.submit |
| .NET 8+ | Einvo.Sdk (NuGet) | EinvoWebhooks.Verify, EinvoUbl.SubmitAsync |
| Python 3.9+ | einvo (PyPI) | einvo.helpers.verify_signature, submit_ubl |
| Node.js 18+ | @einvo/sdk (npm) | verifySignature, submitUbl |
Node.js
import { readFile } from 'node:fs/promises';
import { submitUbl, verifySignature } from '@einvo/sdk/helpers';
const doc = await submitUbl({ apiKey: process.env.EINVO_API_KEY, ubl: await readFile('invoice.xml'), idempotencyKey: 'INV-2026-00042' });
console.log(doc.status, doc.issues);
Python
import os
from einvo.helpers import submit_ubl
doc = submit_ubl(open("invoice.xml", "rb").read(), api_key=os.environ["EINVO_API_KEY"], idempotency_key="INV-2026-00042")
print(doc["status"], doc["issues"])
Java
var doc = EinvoUbl.submit(System.getenv("EINVO_API_KEY"), Files.readAllBytes(Path.of("invoice.xml")), "INV-2026-00042");
System.out.println(doc.get("status"));
.NET
var doc = await EinvoUbl.SubmitAsync(Environment.GetEnvironmentVariable("EINVO_API_KEY")!, await File.ReadAllBytesAsync("invoice.xml"), "INV-2026-00042");
Console.WriteLine(doc.RootElement.GetProperty("status"));
Other languages
Generate a client for any language supported by OpenAPI Generator:
npx @openapitools/openapi-generator-cli generate -i https://www.einvo.ae/developers/openapi.json -g go -o einvo-go
Or import the Postman collection: set the apiKey collection variable to a sandbox key.