Skip to main content
POST
https://sandbox.cucu.bo
/
api
/
v1
/
invoices
curl -X POST https://sandbox.cucu.bo/api/v1/invoices \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sk_test_MuLfItnPAScdhgrOsYn6Y4ur_gdMfCSMXtLciK9P8S8" \
  -d '{
    "invoiceType": "ELECTRONIC_SALE",
    "pointOfSaleId": "660e8400-e29b-41d4-a716-446655440004",
    "clientDocumentType": 5,
    "clientDocumentNumber": "99001",
    "clientBusinessName": "EMPRESA DEMO S.R.L.",
    "clientEmail": "demo@ejemplo.com",
    "paymentMethodCode": 1,
    "details": [
      {
        "activityEconomic": "620100",
        "codeProductSin": "83141",
        "description": "Servicio de desarrollo de software",
        "quantity": 1,
        "unitMeasure": 58,
        "priceUnit": 500.00
      }
    ]
  }'

{
  "success": true,
  "message": "Factura emitida exitosamente",
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "invoiceNumber": 1,
    "cuf": "2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74",
    "state": "VALIDATED",
    "emissionType": "NORMAL",
    "clientBusinessName": "EMPRESA DEMO S.R.L.",
    "clientDocumentNumber": "99001",
    "amountSubtotal": 500.00,
    "amountDiscount": 0.00,
    "amountTotal": 500.00,
    "literal": "Quinientos 00/100 Bolivianos",
    "emissionDate": "2026-02-11T12:00:00",
    "pdfUrl": "https://sandbox.cucu.bo/api/v1/public/invoice/2872F...AF74/pdf",
    "xmlUrl": "https://sandbox.cucu.bo/api/v1/public/invoice/2872F...AF74/xml"
  },
  "timestamp": "2026-02-11T12:00:00"
}
Crea una nueva factura electronica, la firma digitalmente, la envia al SIAT para validacion, genera PDF (A4 y ticket), XML, y opcionalmente envia por email al cliente.

​
Headers

​
X-API-Key
string
required
Tu API Key de sandbox (sk_test_) o produccion (sk_live_).
​
Content-Type
string
required
application/json

​
Request Body

​
invoiceType
string
required
Tipo de factura que determina el documento sector y modalidad. Default: ELECTRONIC_SALE. Ver Documentos Sector para todos los valores.
​
pointOfSaleId
string
required
UUID del punto de venta. Ejemplo: 660e8400-e29b-41d4-a716-446655440004
​
clientDocumentType
integer
required
Tipo de documento del cliente. Valores: 1 (CI), 2 (CEX), 3 (PAS), 4 (OD), 5 (NIT).
​
clientDocumentNumber
string
required
Numero de documento del cliente (max 50 caracteres).
​
clientBusinessName
string
required
Razon social del cliente (max 255 caracteres).
​
clientEmail
string
Email del cliente. Si se proporciona, se envia automaticamente la factura por correo.
​
clientComplement
string
Complemento del documento de identidad.
​
paymentMethodCode
integer
required
Metodo de pago. 1 = Efectivo, 2 = Tarjeta, 3 = Cheque, etc.
​
cardNumber
string
Ultimos 4 digitos de tarjeta (solo si paymentMethodCode = 2).
​
exchangeRate
number
Tipo de cambio (solo si la factura es en moneda extranjera).
​
observations
string
Observaciones o notas (max 500 caracteres).
​
isTicket
boolean
default:"false"
Si true, adjunta tambien el formato ticket (80mm) en el email.
​
details
array
required
Lista de items de la factura (minimo 1).

​
Response

​
success
boolean
true si la factura fue emitida exitosamente.
​
data
object
curl -X POST https://sandbox.cucu.bo/api/v1/invoices \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sk_test_MuLfItnPAScdhgrOsYn6Y4ur_gdMfCSMXtLciK9P8S8" \
  -d '{
    "invoiceType": "ELECTRONIC_SALE",
    "pointOfSaleId": "660e8400-e29b-41d4-a716-446655440004",
    "clientDocumentType": 5,
    "clientDocumentNumber": "99001",
    "clientBusinessName": "EMPRESA DEMO S.R.L.",
    "clientEmail": "demo@ejemplo.com",
    "paymentMethodCode": 1,
    "details": [
      {
        "activityEconomic": "620100",
        "codeProductSin": "83141",
        "description": "Servicio de desarrollo de software",
        "quantity": 1,
        "unitMeasure": 58,
        "priceUnit": 500.00
      }
    ]
  }'

{
  "success": true,
  "message": "Factura emitida exitosamente",
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "invoiceNumber": 1,
    "cuf": "2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74",
    "state": "VALIDATED",
    "emissionType": "NORMAL",
    "clientBusinessName": "EMPRESA DEMO S.R.L.",
    "clientDocumentNumber": "99001",
    "amountSubtotal": 500.00,
    "amountDiscount": 0.00,
    "amountTotal": 500.00,
    "literal": "Quinientos 00/100 Bolivianos",
    "emissionDate": "2026-02-11T12:00:00",
    "pdfUrl": "https://sandbox.cucu.bo/api/v1/public/invoice/2872F...AF74/pdf",
    "xmlUrl": "https://sandbox.cucu.bo/api/v1/public/invoice/2872F...AF74/xml"
  },
  "timestamp": "2026-02-11T12:00:00"
}