Venta Interna de Minerales

Para la venta de minerales dentro de Bolivia. Se emite por POST /api/v1/invoices con documentSectorType: 21.

Para la venta al exterior corresponde el sector 20, Exportación de Minerales, que no da crédito fiscal. El sector 3 (Comercial de Exportación) excluye minerales.

Datos del sector

Campo	Valor
`documentSectorType`	`21`
Servicio SIAT	Facturación Electrónica / Computarizada (genérico por modalidad)

Campos específicos

Además de los campos estándar:

Cabecera — la carga

Campo	Tipo	Req	Descripción
`documentSectorType`	integer	Sí	`21`
`buyerAddress`	string	Sí	Dirección del comprador (`direccionComprador`)
`bulkConcentrate`	string	Sí	Concentrado a granel, ej. `"Zinc - Plata"` (`concentradoGranel`)
`origin`	string	Sí	Origen del mineral, ej. `"Potosi - Bolivia"` (`origen`)
`incoterm`	string	Sí	Incoterm de la operación, ej. `"CIFFO"` (`incoterm`)
`transitPort`	string	No	Puerto de tránsito (`puertoTransito`)
`destinationPort`	string	No	Puerto de destino (`puertoDestino`)
`codeCountry`	integer	No	País de destino (`paisDestino`, catálogo SIAT de países)

Cabecera — el lote

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`	number	No	Porcentaje de humedad (`humedadPorcentaje`)
`humidityValue`	number	No	Humedad en valor (`humedadValor`)
`wastePercent`	number	No	Merma en porcentaje (`mermaPorcentaje`)
`wasteValue`	number	No	Merma en valor (`mermaValor`)

Cabecera — la liquidación

Campo	Tipo	Req	Descripción
`exchangeRate`	number	Sí	Tipo de cambio oficial (`tipoCambio`)
`exchangeRateAnb`	number	Sí	Tipo de cambio ANB (`tipoCambioANB`)
`realizationExpenses`	number	Sí	Gastos de realización, mayor a 0 (`gastosRealizacion`)
`preliminarySettlement`	number	No	Ajuste de liquidación preliminar; puede ser negativo (`liquidacionPreliminar`)
`currencyCode`	integer	No	Moneda de la operación (`codigoMoneda`)
`observations`	string	No	Se envía como `otrosDatos`

Cómo se arma el total, según las operaciones publicadas por Impuestos. Los precios del detalle van en la moneda del documento:

subTotal         = Σ (cantidad × precioUnitario − montoDescuento)
iva              = (subTotal − gastosRealizacion) × 0.1494253      ← tasa efectiva
montoTotalMoneda = subTotal − gastosRealizacion + iva
                   + liquidacionPreliminar − descuentoAdicional
montoTotal       = montoTotalMoneda × tipoCambioANB                ← el ANB, no el oficial
montoTotalSujetoIva = montoTotal

Ni subTotal ni el iva se envían: los calcula la API. El IVA sale de la tasa efectiva y el total se lleva a bolivianos con el tipo de cambio ANB (exchangeRateAnb); el exchangeRate oficial se declara igual en el XML.

Detalle

Campo	Tipo	Req	Descripción
`codeNandina`	string	Sí	Código Nandina del mineral (`codigoNandina`)
`gradeDescription`	string	Sí	Ley o pureza del mineral, ej. `"51.90 gr/ton"` (`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

El detalle no admite descuento por línea: el XSD del SIAT fija montoDescuento en 0. Enviar amountDiscount distinto de cero en un ítem devuelve 422. Para descontar del total usá descuentoAdicional en la cabecera.

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": 21,
    "clientDocumentType": 1,
    "clientDocumentNumber": "5115889",
    "clientBusinessName": "MINERA DEL SUR S.A.",
    "buyerAddress": "Av. Arce No 2299 Edif Multicentro Piso 4",
    "bulkConcentrate": "Zinc - Plata",
    "origin": "Potosi - Bolivia",
    "transitPort": "Antofagasta",
    "destinationPort": "Toyama Shinko",
    "codeCountry": 200,
    "incoterm": "CIFFO",
    "lotNumber": "18-ZN-QMA-009 FINAL",
    "netWetKilos": 323.72,
    "humidityPercent": 98,
    "humidityValue": 346.81,
    "netDryKilos": 323.72,
    "currencyCode": 1,
    "exchangeRate": 6.96,
    "exchangeRateAnb": 6.96,
    "realizationExpenses": 74030.63,
    "paymentMethodCode": 1,
    "details": [
      {
        "activityEconomic": "451010",
        "codeProductSin": "49111",
        "codeProduct": "123",
        "codeNandina": "2608.00.00.00",
        "description": "Zinc",
        "gradeDescription": "51.90 gr/ton",
        "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: 21,
    clientDocumentType: 1,
    clientDocumentNumber: '5115889',
    clientBusinessName: 'MINERA DEL SUR S.A.',
    buyerAddress: 'Av. Arce No 2299 Edif Multicentro Piso 4',
    bulkConcentrate: 'Zinc - Plata',
    origin: 'Potosi - Bolivia',
    incoterm: 'CIFFO',
    lotNumber: '18-ZN-QMA-009 FINAL',
    netWetKilos: 323.72,
    netDryKilos: 323.72,
    currencyCode: 1,
    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 gr/ton',
      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': 21,
        'clientDocumentType': 1,
        'clientDocumentNumber': '5115889',
        'clientBusinessName': 'MINERA DEL SUR S.A.',
        'buyerAddress': 'Av. Arce No 2299 Edif Multicentro Piso 4',
        'bulkConcentrate': 'Zinc - Plata',
        'origin': 'Potosi - Bolivia',
        'incoterm': 'CIFFO',
        'lotNumber': '18-ZN-QMA-009 FINAL',
        'netWetKilos': 323.72,
        'netDryKilos': 323.72,
        'currencyCode': 1,
        '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 gr/ton',
            '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

Venta Interna de Minerales

Datos del sector

Campos específicos

Cabecera — la carga

Cabecera — el lote

Cabecera — la liquidación

Detalle

​Datos del sector

​Campos específicos

​Cabecera — la carga

​Cabecera — el lote

​Cabecera — la liquidación

​Detalle

Datos del sector

Campos específicos

Cabecera — la carga

Cabecera — el lote

Cabecera — la liquidación

Detalle