Exportacion

Para la exportación de bienes al exterior. Se emite por POST /api/v1/invoices con documentSectorType: 3.

Este sector excluye minerales: para exportarlos, ver Exportación de Minerales (sector 20). Para servicios, ver Exportación de Servicios (sector 28).

Disponible en sandbox (sandbox.cucu.bo). Llega a producción con la próxima versión de la API; hasta entonces, api.cucu.bo responde 422 SECTOR_NOT_SUPPORTED para el sector 3.

Datos del sector

Campo	Valor
`documentSectorType`	`3`
Servicio SIAT	Facturación Electrónica / Computarizada (genérico por modalidad)
Tipo de documento	`2` — sin derecho a crédito fiscal. Lo fija el sector: no hace falta mandar `invoiceType` y, si se manda, se ignora
`codigoCliente`	Lo que mandes en `clientCode` (el código de cliente de tu sistema); si no lo mandas, el `clientDocumentNumber` del comprador
Notas de crédito-débito	No admite (ver la sección Notas de crédito-débito más abajo)

Campos específicos

Además de los campos estándar:

Cabecera — comprador y destino

Campo	Tipo	Req	Descripción
`documentSectorType`	integer	Sí	`3`
`clientDocumentType`	integer	Sí	`1`–`5` (`codigoTipoDocumentoIdentidad`). Para un comprador del exterior suele ser `4` (otro documento)
`buyerAddress`	string	Sí	Dirección del comprador, máx. 255 (`direccionComprador`)
`incoterm`	string	Sí	Incoterm de la operación, máx. 100 (`incoterm`)
`incotermDetail`	string	Sí	Alcance del incoterm, máx. 100 (`incotermDetalle`)
`destinationPort`	string	Sí	Puerto de destino, máx. 100 (`puertoDestino`)
`destinationPlace`	string	Sí	Lugar de destino, máx. 255 (`lugarDestino`)
`codeCountry`	integer	Sí	País de destino, código de la paramétrica de países del SIAT (`codigoPais`)
`packagesDescription`	string	No	Número y descripción de paquetes o bultos, máx. 10000 (`numeroDescripcionPaquetesBultos`)
`observations`	string	No	Se envía como `informacionAdicional`

Si falta un campo obligatorio, la emisión responde 400 antes de llegar al SIAT, con el campo en el mensaje (p. ej. incotermDetail (incotermDetalle) es obligatorio para exportación (sector 3)).

Cabecera — moneda y gastos

Campo	Tipo	Req	Descripción
`currencyCode`	integer	No	Moneda de la operación (`codigoMoneda`). Default `1` (bolivianos)
`exchangeRate`	number	No	Tipo de cambio oficial, hasta 5 decimales (`tipoCambio`). Default `1`
`nationalExpenses`	object	No	Gastos nacionales hasta frontera, como mapa concepto → monto (`costosGastosNacionales`)
`internationalExpenses`	object	No	Gastos internacionales, como mapa concepto → monto (`costosGastosInternacionales`)
`descuentoAdicional`	number	No	Descuento sobre el total, en la moneda del documento (`descuentoAdicional`). Resta del `montoTotalMoneda`

Los gastos se mandan como objeto clave-valor: la clave es el concepto y el valor el monto en la moneda del documento, mayor o igual a 0. Viajan al SIAT tal cual, en el mismo orden:

"nationalExpenses": { "Gasto Transporte": 500.00, "Gasto de Seguro": 150.00 }

Cómo se arma el total. Los precios del detalle y los gastos van en la moneda del documento. La API calcula los totales con las operaciones que publica Impuestos; no se aceptan en el request:

subTotal                   = cantidad × precioUnitario − montoDescuento
montoDetalle               = Σ subTotal
totalGastosNacionalesFob   = montoDetalle + Σ nationalExpenses        ← el valor FOB
totalGastosInternacionales = Σ internationalExpenses
montoTotalMoneda           = totalGastosNacionalesFob + totalGastosInternacionales − descuentoAdicional
montoTotal                 = montoTotalMoneda × tipoCambio
montoTotalSujetoIva        = 0

La exportación no da crédito fiscal: montoTotalSujetoIva siempre viaja en 0. El descuentoAdicional sí resta del total en la moneda de la operación (Impuestos rechaza con [1014] si no se resta).

Detalle

Campo	Tipo	Req	Descripción
`codeNandina`	string	Sí	Código arancelario Nandina del producto, máx. 50 (`codigoNandina`)
`quantity`	number	Sí	Cantidad, hasta 5 decimales
`priceUnit`	number	Sí	Precio unitario en la moneda del documento, hasta 5 decimales
`amountDiscount`	number	No	Descuento por línea

Ejemplo

1000 unidades a 15.00 USD (montoDetalle 15000.00) + 650.00 de gastos nacionales → FOB 15650.00; + 1200.00 de flete internacional → montoTotalMoneda 16850.00; × 6.96 → montoTotal 117276.00 Bs.

curl -X POST https://sandbox.cucu.bo/api/v1/invoices \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "pointOfSaleId": "660e8400-e29b-41d4-a716-446655440004",
    "documentSectorType": 3,
    "clientDocumentType": 4,
    "clientDocumentNumber": "99001",
    "clientBusinessName": "IMPORTADORA INTERNACIONAL LLC",
    "buyerAddress": "Av. Providencia 1208, Santiago",
    "incoterm": "CIF",
    "incotermDetail": "CIF Arica, seguro a cargo del vendedor",
    "destinationPort": "Arica",
    "destinationPlace": "Santiago",
    "codeCountry": 100,
    "packagesDescription": "40 bultos de 25 kg",
    "currencyCode": 2,
    "exchangeRate": 6.96,
    "nationalExpenses": { "Gasto Transporte": 500.00, "Gasto de Seguro": 150.00 },
    "internationalExpenses": { "Flete internacional": 1200.00 },
    "paymentMethodCode": 1,
    "details": [
      {
        "activityEconomic": "620100",
        "codeProductSin": "83141",
        "codeNandina": "1008509000",
        "description": "Quinua real organica",
        "quantity": 1000,
        "unitMeasure": 2,
        "priceUnit": 15.00
      }
    ]
  }'

const response = await fetch('https://sandbox.cucu.bo/api/v1/invoices', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    pointOfSaleId: '660e8400-e29b-41d4-a716-446655440004',
    documentSectorType: 3,
    clientDocumentType: 4,
    clientDocumentNumber: '99001',
    clientBusinessName: 'IMPORTADORA INTERNACIONAL LLC',
    buyerAddress: 'Av. Providencia 1208, Santiago',
    incoterm: 'CIF',
    incotermDetail: 'CIF Arica, seguro a cargo del vendedor',
    destinationPort: 'Arica',
    destinationPlace: 'Santiago',
    codeCountry: 100,
    packagesDescription: '40 bultos de 25 kg',
    currencyCode: 2,
    exchangeRate: 6.96,
    nationalExpenses: { 'Gasto Transporte': 500.00, 'Gasto de Seguro': 150.00 },
    internationalExpenses: { 'Flete internacional': 1200.00 },
    paymentMethodCode: 1,
    details: [{
      activityEconomic: '620100',
      codeProductSin: '83141',
      codeNandina: '1008509000',
      description: 'Quinua real organica',
      quantity: 1000,
      unitMeasure: 2,
      priceUnit: 15.00
    }]
  })
});

import requests

response = requests.post(
    'https://sandbox.cucu.bo/api/v1/invoices',
    headers={
        'Content-Type': 'application/json',
        'X-API-Key': 'YOUR_API_KEY'
    },
    json={
        'pointOfSaleId': '660e8400-e29b-41d4-a716-446655440004',
        'documentSectorType': 3,
        'clientDocumentType': 4,
        'clientDocumentNumber': '99001',
        'clientBusinessName': 'IMPORTADORA INTERNACIONAL LLC',
        'buyerAddress': 'Av. Providencia 1208, Santiago',
        'incoterm': 'CIF',
        'incotermDetail': 'CIF Arica, seguro a cargo del vendedor',
        'destinationPort': 'Arica',
        'destinationPlace': 'Santiago',
        'codeCountry': 100,
        'packagesDescription': '40 bultos de 25 kg',
        'currencyCode': 2,
        'exchangeRate': 6.96,
        'nationalExpenses': {'Gasto Transporte': 500.00, 'Gasto de Seguro': 150.00},
        'internationalExpenses': {'Flete internacional': 1200.00},
        'paymentMethodCode': 1,
        'details': [{
            'activityEconomic': '620100',
            'codeProductSin': '83141',
            'codeNandina': '1008509000',
            'description': 'Quinua real organica',
            'quantity': 1000,
            'unitMeasure': 2,
            'priceUnit': 15.00
        }]
    }
)

Notas de crédito-débito

Las facturas del sector 3 no admiten notas de crédito-débito. La nota es un ajuste de IVA (Art. 36, RND 102100000011) y la exportación está exenta (Art. 11, Ley 843): no hay nada que ajustar. POST /api/v1/invoices/{id}/credit-note sobre una factura de exportación responde 422:

{
  "success": false,
  "message": null,
  "data": null,
  "error": {
    "code": "CREDIT_DEBIT_NOTE_NOT_ALLOWED",
    "details": "Las facturas del documento sector 3 no admiten notas de crédito-débito: la nota ajusta IVA (Art. 36 RND 102100000011) y este sector no lo genera."
  }
}

Para corregir una factura de exportación, se anula y se emite una nueva.

Ver Crear Factura para la referencia completa de campos estándar, response y códigos de error.

Información General

Endpoints Disponibles

Documentos Sector

Utilidades y Soporte

Datos del sector

Campos específicos

Cabecera — comprador y destino

Cabecera — moneda y gastos

Detalle

Ejemplo

Notas de crédito-débito

​Datos del sector

​Campos específicos

​Cabecera — comprador y destino

​Cabecera — moneda y gastos

​Detalle

​Ejemplo

​Notas de crédito-débito

Datos del sector

Campos específicos

Cabecera — comprador y destino

Cabecera — moneda y gastos

Detalle

Ejemplo

Notas de crédito-débito