Exportacion de Minerales

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.

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:

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.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)

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
      }
    ]
  }'

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
    }]
  })
});

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 para la referencia completa de campos estándar, response y códigos de error.

Información General

Endpoints Disponibles

Documentos Sector

Utilidades y Soporte

Exportacion de Minerales

Datos del sector

Campos específicos

Cabecera — exportador y carga

Cabecera — lote y liquidación

Detalle

​Datos del sector

​Campos específicos

​Cabecera — exportador y carga

​Cabecera — lote y liquidación

​Detalle

Datos del sector

Campos específicos

Cabecera — exportador y carga

Cabecera — lote y liquidación

Detalle