Skip to main content

​
Overview

CUIS (Código Único de Inicio de Sistemas) is a system initialization code required before performing any invoicing operations. This code has a specific validity period and must be obtained for each point of sale and branch office.

​
Single CUIS Request

Request a CUIS code for a specific point of sale.

​
Method Signature

func (s *SiatCodigosService) SolicitudCuis(
    ctx context.Context,
    config config.Config,
    request models.CuisRequest,
) (*soap.EnvelopeResponse[codigos.CuisResponse], error)

​
Building the Request

Use the builder pattern to construct a CUIS request: 
request := models.Codigos.NewCuisRequest().
    WithCodigoAmbiente(1).
    WithCodigoModalidad(1).
    WithCodigoSistema("SystemCode123").
    WithCodigoSucursal(0).
    WithCodigoPuntoVenta(0).
    WithNit(1234567890).
    Build()

​
Request Parameters

​
codigoAmbiente
int
required
Environment code:
  • 1 - Production
  • 2 - Testing/Development
​
codigoModalidad
int
required
Operation modality code. Common values:
  • 1 - Electronic invoicing
  • 2 - Computer-based invoicing
​
codigoSistema
string
required
System identification code assigned by SIAT during registration
​
codigoSucursal
int
required
Branch office code. Use 0 for the main office
​
codigoPuntoVenta
int
required
Point of sale code. Use 0 for the main point of sale
​
nit
int64
required
Company’s tax identification number (NIT)

​
Response Structure

type CuisResponse struct {
    RespuestaCuis RespuestaCuis
}

type RespuestaCuis struct {
    Codigo        string
    FechaVigencia time.Time
    MensajesList  []MensajeServicio
    Transaccion   bool
}

​
Response Fields

​
codigo
string
The generated CUIS code to be used in subsequent operations
​
fechaVigencia
time.Time
Expiration date and time of the CUIS code
​
transaccion
bool
Indicates if the request was successful
​
mensajesList
[]MensajeServicio
List of messages or errors from the service

​
Example Usage

package main

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

func main() {
    // Initialize client
    cfg := config.Config{
        Token:      "your-api-token",
        BaseURL:    "https://pilotosiatservicios.impuestos.gob.bo",
        Ambiente:   1,
        Modalidad:  1,
        Sistema:    "SystemCode123",
        NIT:        1234567890,
    }
    
    siatClient, err := client.NewSiatClient(cfg)
    if err != nil {
        log.Fatal(err)
    }
    
    // Build request
    request := models.Codigos.NewCuisRequest().
        WithCodigoAmbiente(cfg.Ambiente).
        WithCodigoModalidad(cfg.Modalidad).
        WithCodigoSistema(cfg.Sistema).
        WithCodigoSucursal(0).
        WithCodigoPuntoVenta(0).
        WithNit(cfg.NIT).
        Build()
    
    // Execute request
    ctx := context.Background()
    resp, err := siatClient.Codigos.SolicitudCuis(ctx, request)
    if err != nil {
        log.Fatalf("Failed to request CUIS: %v", err)
    }
    
    // Check transaction status
    if !resp.Body.Response.RespuestaCuis.Transaccion {
        fmt.Println("CUIS request failed:")
        for _, msg := range resp.Body.Response.RespuestaCuis.MensajesList {
            fmt.Printf("  Error %d: %s\n", msg.Codigo, msg.Descripcion)
        }
        return
    }
    
    // Success
    fmt.Printf("CUIS Code: %s\n", resp.Body.Response.RespuestaCuis.Codigo)
    fmt.Printf("Valid until: %s\n", resp.Body.Response.RespuestaCuis.FechaVigencia)
}

​
Bulk CUIS Request

Request multiple CUIS codes in a single operation for different branches and points of sale.

​
Method Signature

func (s *SiatCodigosService) SolicitudCuisMasivo(
    ctx context.Context,
    config config.Config,
    request models.CuisMasivoRequest,
) (*soap.EnvelopeResponse[codigos.CuisMasivoResponse], error)

​
Building the Request

// Define the list of branches and points of sale
puntoVenta1 := 0
puntoVenta2 := 1

datosSolicitud := []codigos.SolicitudListaCuisDto{
    {
        CodigoSucursal:   0,
        CodigoPuntoVenta: &puntoVenta1,
    },
    {
        CodigoSucursal:   1,
        CodigoPuntoVenta: &puntoVenta2,
    },
}

request := models.Codigos.NewCuisMasivoRequest().
    WithCodigoAmbiente(1).
    WithCodigoModalidad(1).
    WithCodigoSistema("SystemCode123").
    WithNit(1234567890).
    WithDatosSolicitud(datosSolicitud).
    Build()

​
Request Parameters

​
codigoAmbiente
int
required
Environment code (1 for production, 2 for testing)
​
codigoModalidad
int
required
Operation modality code
​
codigoSistema
string
required
System identification code
​
nit
int64
required
Company’s tax identification number
​
datosSolicitud
[]SolicitudListaCuisDto
required
List of branch and point of sale combinations to request CUIS for

​
SolicitudListaCuisDto Structure

​
codigoSucursal
int
required
Branch office code
​
codigoPuntoVenta
*int
required
Pointer to point of sale code. Can be nil for branch-level CUIS

​
Response Structure

type CuisMasivoResponse struct {
    RespuestaCuisMasivo RespuestaCuisMasivo
}

type RespuestaCuisMasivo struct {
    ListaRespuestasCuis []RespuestaListaRegistroCuisSoapDto
    MensajesList        []MensajeServicio
    Transaccion         bool
}

type RespuestaListaRegistroCuisSoapDto struct {
    Codigo              string
    CodigoPuntoVenta    *int32
    CodigoSucursal      *int32
    FechaVigencia       time.Time
    MensajeServicioList []MensajeServicio
    Transaccion         bool
}

​
Response Fields

​
listaRespuestasCuis
[]RespuestaListaRegistroCuisSoapDto
List of CUIS responses, one for each requested branch/point of sale
​
transaccion
bool
Indicates if the overall request was successful
​
mensajesList
[]MensajeServicio
List of global messages or errors

​
Individual Response Fields

​
codigo
string
The generated CUIS code
​
codigoSucursal
*int32
Branch office code for this CUIS
​
codigoPuntoVenta
*int32
Point of sale code for this CUIS
​
fechaVigencia
time.Time
Expiration date of this CUIS
​
transaccion
bool
Success status for this individual CUIS
​
mensajeServicioList
[]MensajeServicio
Messages specific to this CUIS request

​
Example Usage

package main

import (
    "context"
    "fmt"
    "log"
    
    "github.com/ron86i/go-siat/internal/core/domain/facturacion/codigos"
    "github.com/ron86i/go-siat/pkg/client"
    "github.com/ron86i/go-siat/pkg/config"
    "github.com/ron86i/go-siat/pkg/models"
)

func main() {
    // Initialize client
    cfg := config.Config{
        Token:   "your-api-token",
        BaseURL: "https://pilotosiatservicios.impuestos.gob.bo",
    }
    
    siatClient, err := client.NewSiatClient(cfg)
    if err != nil {
        log.Fatal(err)
    }
    
    // Define multiple branches/points of sale
    puntoVenta0 := 0
    puntoVenta1 := 1
    
    datosSolicitud := []codigos.SolicitudListaCuisDto{
        {
            CodigoSucursal:   0,
            CodigoPuntoVenta: &puntoVenta0,
        },
        {
            CodigoSucursal:   0,
            CodigoPuntoVenta: &puntoVenta1,
        },
        {
            CodigoSucursal:   1,
            CodigoPuntoVenta: &puntoVenta0,
        },
    }
    
    // Build request
    request := models.Codigos.NewCuisMasivoRequest().
        WithCodigoAmbiente(1).
        WithCodigoModalidad(1).
        WithCodigoSistema("SystemCode123").
        WithNit(1234567890).
        WithDatosSolicitud(datosSolicitud).
        Build()
    
    // Execute request
    ctx := context.Background()
    resp, err := siatClient.Codigos.SolicitudCuisMasivo(ctx, request)
    if err != nil {
        log.Fatalf("Failed to request bulk CUIS: %v", err)
    }
    
    // Process responses
    if !resp.Body.Response.RespuestaCuisMasivo.Transaccion {
        fmt.Println("Bulk CUIS request failed")
        return
    }
    
    fmt.Printf("Successfully obtained %d CUIS codes\n", 
        len(resp.Body.Response.RespuestaCuisMasivo.ListaRespuestasCuis))
    
    for i, cuisResp := range resp.Body.Response.RespuestaCuisMasivo.ListaRespuestasCuis {
        if cuisResp.Transaccion {
            fmt.Printf("CUIS %d:\n", i+1)
            fmt.Printf("  Code: %s\n", cuisResp.Codigo)
            fmt.Printf("  Branch: %d\n", *cuisResp.CodigoSucursal)
            fmt.Printf("  Point of Sale: %d\n", *cuisResp.CodigoPuntoVenta)
            fmt.Printf("  Valid until: %s\n\n", cuisResp.FechaVigencia)
        } else {
            fmt.Printf("CUIS %d failed:\n", i+1)
            for _, msg := range cuisResp.MensajeServicioList {
                fmt.Printf("  Error %d: %s\n", msg.Codigo, msg.Descripcion)
            }
        }
    }
}

​
Best Practices

Store CUIS codes securely: CUIS codes should be stored in your database and reused until they expire. Don’t request a new CUIS for every transaction.
Monitor expiration dates: Always check the fechaVigencia field and renew CUIS codes before they expire to avoid service interruptions.
Use bulk requests for multiple locations: If you have multiple branches or points of sale, use SolicitudCuisMasivo to reduce network overhead and improve performance.

CUFD Request

Request daily invoicing codes (requires CUIS)

NIT Verification

Verify tax identification numbers

Build docs developers (and LLMs) love

Get started for freeTalk to us