> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.supay.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.supay.dev/_mcp/server.

# 21 · Venta de Minerales

Venta interna de minerales con crédito fiscal. Igual trazabilidad que la
[20 · Exportación minera](/sectores/exportacion/20-exportacion-minera), más liquidación e IVA
de la operación interna.

## Cabecera (`data`)

| Campo                                       | Tipo   | Obligatorio | Qué significa        |
| ------------------------------------------- | ------ | ----------- | -------------------- |
| `origen`                                    | string | Ver perfil  | Origen del mineral   |
| `puerto_destino` / `puerto_transito`        | string | Ver perfil  | Puertos              |
| `incoterm`                                  | string | Ver perfil  | Término comercial    |
| `tipo_cambio_anb`                           | number | Ver perfil  | Tipo de cambio ANB   |
| `concentrado_granel`                        | string | Ver perfil  | Concentrado o granel |
| `kilos_netos_humedos` / `kilos_netos_secos` | number | Ver perfil  | Pesos                |

#### Ver el resto de campos (humedad, merma, gastos, lote)

| Campo                                                  | Tipo   | Obligatorio | Qué significa          |
| ------------------------------------------------------ | ------ | ----------- | ---------------------- |
| `humedad_porcentaje` / `humedad_valor`                 | number | Ver perfil  | Humedad                |
| `merma_porcentaje` / `merma_valor`                     | number | Ver perfil  | Merma                  |
| `gastos_realizacion`                                   | number | Ver perfil  | Gastos de realización  |
| `iva`                                                  | number | Ver perfil  | IVA de la operación    |
| `liquidacion_preliminar`                               | string | Ver perfil  | Liquidación preliminar |
| `numero_lote`                                          | string | Ver perfil  | Lote                   |
| `sub_total`                                            | number | Ver perfil  | Subtotal operativo     |
| `pais_destino` / `direccion_comprador` / `otros_datos` | string | Ver perfil  | Destino y extras       |

## Detalle (`items[].data`)

| Campo                      | Tipo   | Obligatorio | Para qué sirve       |
| -------------------------- | ------ | ----------- | -------------------- |
| `codigo_nandina`           | string | Ver perfil  | Arancel del mineral  |
| `descripcion_leyes`        | string | Ver perfil  | Leyes del mineral    |
| `cantidad_extraccion`      | number | Ver perfil  | Cantidad extraída    |
| `unidad_medida_extraccion` | string | Ver perfil  | Unidad de extracción |

#### SDK TypeScript

```typescript
const factura = await supay.invoices.emit({
  point_of_sale_id: pos.id,
  customer: {
    document_type: "nit",
    document_number: "4567890",
    name: "Fundidora SA",
  },
  items: [
    {
      sku: "ZN-CONC",
      description: "Concentrado de zinc",
      codigo_producto_sin: 5214100,
      unidad_medida: 58,
      quantity: 20,
      price: 1800,
      data: {
        codigo_nandina: "2608.00.00",
        descripcion_leyes: "Zn 52%",
        cantidad_extraccion: 20,
        unidad_medida_extraccion: "TM",
      },
    },
  ],
  sector: "21",
  data: {
    origen: "Potosí",
    puerto_destino: "Arica",
    incoterm: "FOB",
    numero_lote: "L-2026-014",
  },
});
```

#### REST API

```bash
curl -s -X POST "$BASE/v1/invoices/emit" \
  -H "X-API-Key: $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "point_of_sale_id": "'$POS'",
    "customer": {
      "document_type": "nit",
      "document_number": "4567890",
      "name": "Fundidora SA"
    },
    "items": [
      {
        "sku": "ZN-CONC",
        "description": "Concentrado de zinc",
        "codigo_producto_sin": 5214100,
        "unidad_medida": 58,
        "quantity": 20,
        "price": 1800,
        "data": {
          "codigo_nandina": "2608.00.00"
        }
      }
    ],
    "sector": "21",
    "data": {
      "origen": "Potosí",
      "incoterm": "FOB"
    }
  }' | jq '{id, status}'
```