> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cucu.bo/llms.txt
> Use this file to discover all available pages before exploring further.
# Exportacion de Minerales
> Factura comercial de exportacion de minerales. Sector 20.
Para la exportación de minerales al exterior. Se emite por `POST /api/v1/invoices` con `documentSectorType: 20`.
El sector `3` (Comercial de Exportación) **excluye minerales**: por eso existe este documento.
Para la venta dentro del país, ver [Venta Interna de Minerales](/api/sectors/minerals).
## Datos del sector
| Campo | Valor |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `documentSectorType` | `20` |
| 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 |
## Campos específicos
Además de los [campos estándar](/api/create-invoice#request-body):
### Cabecera — exportador y carga
| Campo | Tipo | Req | Descripción |
| -------------------- | ------- | ------ | -------------------------------------------------------- |
| `documentSectorType` | integer | Sí | `20` |
| `buyerAddress` | string | Sí | Dirección del comprador, máx. 300 (`direccionComprador`) |
| `ruex` | string | No | Registro Único de Exportador (`ruex`) |
| `nim` | string | No | Número de Identificación Minera (`nim`) |
| `bulkConcentrate` | string | Sí | Concentrado a granel (`concentradoGranel`) |
| `origin` | string | Sí | Origen del mineral (`origen`) |
| `destinationPort` | string | **Sí** | Puerto de destino (`puertoDestino`) |
| `codeCountry` | integer | **Sí** | País de destino, `1`–`212` (`paisDestino`) |
| `transitPort` | string | No | Puerto de tránsito (`puertoTransito`) |
| `incoterm` | string | Sí | Incoterm de la operación (`incoterm`) |
### Cabecera — lote y liquidación
| Campo | Tipo | Req | Descripción |
| ----------------------------------- | ------- | --- | -------------------------------------------------------- |
| `lotNumber` | string | Sí | Número de lote (`numeroLote`) |
| `netWetKilos` | number | Sí | Kilos netos húmedos, mayor a 0 (`kilosNetosHumedos`) |
| `netDryKilos` | number | Sí | Kilos netos secos, mayor a 0 (`kilosNetosSecos`) |
| `humidityPercent` / `humidityValue` | number | No | Humedad en porcentaje y en valor |
| `wastePercent` / `wasteValue` | number | No | Merma en porcentaje y en valor |
| `exchangeRate` | number | Sí | Tipo de cambio oficial, hasta 5 decimales (`tipoCambio`) |
| `exchangeRateAnb` | number | Sí | Tipo de cambio ANB, hasta 5 decimales (`tipoCambioANB`) |
| `realizationExpenses` | number | Sí | Gastos de realización, mayor a 0 (`gastosRealizacion`) |
| `currencyCode` | integer | No | Moneda de la operación (`codigoMoneda`) |
| `observations` | string | No | Se envía como `otrosDatos` |
**Cómo se arma el total.** Los precios del detalle van en la **moneda del documento**:
```
subTotal = Σ (cantidad × precioUnitario − montoDescuento)
montoTotalMoneda = subTotal − gastosRealizacion
montoTotal = montoTotalMoneda × tipoCambioANB ← el ANB, no el oficial
montoTotalSujetoIva = 0
```
La exportación **no da crédito fiscal**: `montoTotalSujetoIva` siempre viaja en `0` y este
sector no tiene campo `iva` — esa es la diferencia de fondo con la [venta interna](/api/sectors/minerals).
Dos detalles más de la operación: el total se lleva a bolivianos con el **tipo de cambio ANB**
(`exchangeRateAnb`), y el `descuentoAdicional` **no entra en el cálculo** — se declara en el XML,
pero no descuenta del total (en la venta interna sí lo hace).
### Detalle
| Campo | Tipo | Req | Descripción |
| ----------------------- | ------- | --- | ---------------------------------------------------------------------- |
| `codeNandina` | string | Sí | Código Nandina del mineral (`codigoNandina`) |
| `gradeDescription` | string | Sí | Ley o pureza del mineral (`descripcionLeyes`) |
| `extractionQuantity` | number | Sí | Cantidad en la unidad de **extracción** (`cantidadExtraccion`) |
| `extractionUnitMeasure` | integer | Sí | Unidad de medida de extracción (`unidadMedidaExtraccion`) |
| `quantity` | number | Sí | Cantidad en la unidad con la que se **comercializa** |
| `unitMeasure` | integer | Sí | Unidad de medida de venta |
| `priceUnit` | number | Sí | Cotización a la que se comercializó el mineral |
| `amountDiscount` | number | No | Descuento por línea (a diferencia del sector 21, acá **sí** se admite) |
```bash cURL theme={"system"}
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": 20,
"clientDocumentType": 1,
"clientDocumentNumber": "5115889",
"clientBusinessName": "QHAWAQ MINING ANDINA S.R.L.",
"buyerAddress": "Av. Arce No 2299 Edif Multicentro Piso 4",
"ruex": "11858",
"nim": "02-0015-03",
"bulkConcentrate": "Zinc - Plata",
"origin": "Potosi - Bolivia",
"transitPort": "Antofagasta",
"destinationPort": "Toyama Shinko",
"codeCountry": 200,
"incoterm": "CIF",
"lotNumber": "18-ZN-QMA-009 FINAL",
"netWetKilos": 346.81,
"humidityPercent": 98,
"humidityValue": 346.81,
"netDryKilos": 323.72,
"currencyCode": 2,
"exchangeRate": 6.96,
"exchangeRateAnb": 6.96,
"realizationExpenses": 74030.63,
"paymentMethodCode": 1,
"details": [
{
"activityEconomic": "451010",
"codeProductSin": "49111",
"codeProduct": "123456",
"codeNandina": "2608.00.00.00",
"description": "Zinc",
"gradeDescription": "51.90",
"extractionQuantity": 168010.68,
"extractionUnitMeasure": 1,
"quantity": 311375.93,
"unitMeasure": 1,
"priceUnit": 1.46
}
]
}'
```
```javascript JavaScript theme={"system"}
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: 20,
clientDocumentType: 1,
clientDocumentNumber: '5115889',
clientBusinessName: 'QHAWAQ MINING ANDINA S.R.L.',
buyerAddress: 'Av. Arce No 2299 Edif Multicentro Piso 4',
ruex: '11858',
nim: '02-0015-03',
bulkConcentrate: 'Zinc - Plata',
origin: 'Potosi - Bolivia',
destinationPort: 'Toyama Shinko',
codeCountry: 200,
incoterm: 'CIF',
lotNumber: '18-ZN-QMA-009 FINAL',
netWetKilos: 346.81,
netDryKilos: 323.72,
currencyCode: 2,
exchangeRate: 6.96,
exchangeRateAnb: 6.96,
realizationExpenses: 74030.63,
paymentMethodCode: 1,
details: [{
activityEconomic: '451010',
codeProductSin: '49111',
codeNandina: '2608.00.00.00',
description: 'Zinc',
gradeDescription: '51.90',
extractionQuantity: 168010.68,
extractionUnitMeasure: 1,
quantity: 311375.93,
unitMeasure: 1,
priceUnit: 1.46
}]
})
});
```
```python Python theme={"system"}
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': 20,
'clientDocumentType': 1,
'clientDocumentNumber': '5115889',
'clientBusinessName': 'QHAWAQ MINING ANDINA S.R.L.',
'buyerAddress': 'Av. Arce No 2299 Edif Multicentro Piso 4',
'ruex': '11858',
'nim': '02-0015-03',
'bulkConcentrate': 'Zinc - Plata',
'origin': 'Potosi - Bolivia',
'destinationPort': 'Toyama Shinko',
'codeCountry': 200,
'incoterm': 'CIF',
'lotNumber': '18-ZN-QMA-009 FINAL',
'netWetKilos': 346.81,
'netDryKilos': 323.72,
'currencyCode': 2,
'exchangeRate': 6.96,
'exchangeRateAnb': 6.96,
'realizationExpenses': 74030.63,
'paymentMethodCode': 1,
'details': [{
'activityEconomic': '451010',
'codeProductSin': '49111',
'codeNandina': '2608.00.00.00',
'description': 'Zinc',
'gradeDescription': '51.90',
'extractionQuantity': 168010.68,
'extractionUnitMeasure': 1,
'quantity': 311375.93,
'unitMeasure': 1,
'priceUnit': 1.46
}]
}
)
```
Ver [Crear Factura](/api/create-invoice) para la referencia completa de campos estándar, response y códigos de error.