nes

nes-go-sdk

Product-ready Go SDK for NES Developer APIs.

Root package nes wires all services with shared Bearer auth, environments, retries and upload helpers.

Separate from the nes-portal worker — no MSSQL / scheduler dependency.

Install

go get github.com/dgmosdev/nes-go-sdk@latest

Local checkout:

cd nes-go-sdk
make ci

Quick start

client, err := nes.New(
    nes.WithAPIKey("YOUR_API_KEY"),
    nes.WithEnvironment(nes.EnvTest), // or nes.EnvProduction
    nes.WithMaxRetries(2),            // optional, GET only
)
if err != nil {
    log.Fatal(err)
}

resp, err := client.EInvoice.GetV1IncomingInvoicesWithResponse(
    context.Background(),
    &einvoice.GetV1IncomingInvoicesParams{
        PageSize: 20,
        Page:     1,
        Sort:     "issueDate:desc",
    },
)
if err != nil {
    log.Fatal(err)
}
if err := nes.EnsureOK(resp.StatusCode(), resp.Body, nes.ResponseMeta(resp.HTTPResponse)); err != nil {
    log.Fatal(err)
}

Upload

resp, err := client.UploadEInvoice(ctx, nes.UploadDocumentParams{
    FilePath:     "./invoice.xml",
    SenderAlias:  "urn:mail:defaultgb@example.com",
    IsDirectSend: true,
    SourceApp:    "DGMOS",
})

Options

Errors

if apiErr, ok := err.(*nes.APIError); ok {
    switch {
    case apiErr.Forbidden():
    case apiErr.Temporary():
    case apiErr.NotFound():
    }
}

For generated *WithResponse calls, prefer:

nes.EnsureOK(resp.StatusCode(), resp.Body, method, url)

Layout

nes-go-sdk/
├── nes (root)     Client, options, errors, upload, retry
├── einvoice/      generated
├── earchive/
├── edespatch/
├── esmm/
├── emm/
├── general/
├── openapi/       OpenAPI sources for codegen
├── scripts/       generate.sh
└── examples/basic/

Development

make ci          # tidy + vet + race tests + example build
make generate    # regenerate from openapi/*.openapi.json
make test

# live API (optional)
NES_API_KEY=... go test -tags=integration -count=1 .

Production checklist

• Typed clients for all 6 NES APIs
• Bearer auth on every request
• Test + Production hosts
• Context-aware HTTP
• Structured APIError + errors.As
• Upload multipart helpers with validation
• Optional idempotent GET retries
• Concurrent-safe client after New
• Unit tests (httptest, race detector)
• Integration test tag
• Example + README + CHANGELOG + LICENSE
• CI workflow (make ci)
• No secrets in repo (.env.example only)

License

MIT