go-siat is a professional SDK developed in Go, designed to simplify integration with SIAT (Integrated Tax Administration System) SOAP web services.

Important

Full Documentation: English | Español

Architecture, API Reference, Invoicing Guide, Error Codes, Utilities, and Configuration.

💡 Why go-siat?

Integrating with SIAT's SOAP web services for electronic invoicing in Bolivia is often a complex process involving manual XML handling, digital signatures (XMLDSig), and error-prone nested data structures.

go-siat abstracts all this complexity behind a modern, idiomatic, and type-safe SDK. Our goal is to allow Bolivian developers to focus on the business logic of their applications (POS, ERPs), while the SDK handles:

• Building perfect SOAP envelopes.
• Digital signatures required by the tax authority.
• Compression and encoding of invoice packages.
• Structured management of catalogs and operations.

---

🎯 Features

• 🛡️ Type-Safe: Rigorous data structures for ALL requests and responses (goodbye to generic maps and hardcoded strings).
• 🏗️ Builder Pattern: Intuitive construction of complex requests (such as invoices and cancellations) through fluid interfaces.
• 📦 Total SOAP Abstraction: Transparent management of the SOAP layer. The developer interacts with structs, not XML.
• ✍️ Integrated Digital Signature (XMLDSig): Utilities to automatically sign invoices with your digital certificate.
• 🚀 High Performance: Zero unnecessary dependencies, leveraging Go's native speed for byte manipulation and compression.
• 🧩 Modular: Multiple services (Codes, Synchronization, Operations, Sales, Electronic, Computerized) clearly separated.
• 🏢 Multi-Sector: Native and verified support for 35 different sectors (Sales, Hotels, Mining, Hospitals, Hydrocarbons, etc.).

---

Implemented Capabilities

The SDK covers the critical services of the SIAT ecosystem:

Services	Key Functionalities
Codes	CUIS/CUFD Request (Individual and Massive), NIT Validation, Communication.
Synchronization	Catalogs for activities, parametric, products, services, and sector documents.
Operations	POS Registration/Closing, Significant Event Management.
Sales	Specific service for sales, bonuses, and fees.
Adjustment Documents	Management of Credit/Debit notes, Conciliation, and Reversions.
Online Electronic	Full support for invoicing with digital signature.
Online Computerized	Support for modalities without digital signature.
Specialized Sectors	Services for Telecommunications, Basic Services, Financial Entities, and Airline Tickets.
Special Sectors	Verified support for the 48 regulatory sectors of SIAT.

---

🚀 Quick Start Guide

Installation

go get github.com/ron86i/go-siat

Requirements

• Go 1.25 or higher.
• Valid digital certificate (p12/pfx) and private key (for Electronic modality).

Tip

Context Best Practices: Always provide a context with a timeout (e.g., 30s) to all SDK calls. Avoid using context.Background() directly to prevent hanging requests if the SIAT server is slow.

Example: Verifying NIT

package main

import (
    "context"
    "fmt"
    "github.com/ron86i/go-siat"
    "github.com/ron86i/go-siat/pkg/models"
)

func main() {
    // 1. Initialize the client
    s, _ := siat.New("YOUR_SIAT_URL", nil)

    // 2. Prepare the request using builders
    req := models.Codigos().NewVerificarNitBuilder().
        WithNit(123456789).
        Build()

    // 3. Execute call
    resp, err := s.Codigos().VerificarNit(context.Background(), req)
    if err != nil {
        panic(err)
    }

    fmt.Printf("NIT Transaction status: %v\n", resp.Body.Content.RespuestaVerificarNit.Transaccion)
}

For advanced guides (full invoicing flow, digital signatures, error handling, middleware), see the Full Documentation.

---

🛠️ Usage Reference (Tests)

The Integration Tests serve as living technical documentation for the SDK:

Category	Test File
Codes	siat_codigos_service_test.go
Synchronization	siat_sincronizacion_service_test.go
Operations	siat_operaciones_service_test.go
Sales	siat_compra_venta_service_test.go
Electronic	siat_electronica_service_test.go
Computerized	siat_computarizada_service_test.go
Adjustment Documents	siat_documento_ajuste_service_test.go
Telecommunications	siat_telecomunicaciones_service_test.go
Basic Services	siat_servicio_basico_service_test.go
Financial Entities	siat_entidad_financiera_service_test.go
Airline Tickets	siat_boleto_aereo_service_test.go
Invoicing (Sectors)	pkg/models/invoices/
End-to-End	siat_test.go

---

👍 Contribution and Support

Contributions are welcome! If you find a bug or have a suggestion, please open an Issue or a Pull Request (please review the CONTRIBUTING.md).

If you need technical help or commercial support for integrating electronic invoicing in your company, please check our SUPPORT.md.

---

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.