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

# 4 · Libre Consignación

Mercadería en consignación al exterior, sin crédito fiscal. Cabecera mínima de
ruta + NANDINA por línea.

## Cabecera (`data`)

| Campo            | Tipo   | Obligatorio | Qué significa           |
| ---------------- | ------ | ----------- | ----------------------- |
| `codigo_pais`    | string | Ver perfil  | País de la consignación |
| `puerto_destino` | string | Ver perfil  | Puerto de destino       |

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

| Campo            | Tipo   | Obligatorio | Para qué sirve           |
| ---------------- | ------ | ----------- | ------------------------ |
| `codigo_nandina` | string | Ver perfil  | Arancel de la mercadería |

#### SDK TypeScript

```typescript
const factura = await supay.invoices.emit({
  point_of_sale_id: pos.id,
  customer: {
    document_type: "nit",
    document_number: "80013826",
    name: "Consignatario Exterior",
  },
  items: [
    {
      sku: "QUINUA",
      description: "Quinua a granel",
      codigo_producto_sin: 5214100,
      unidad_medida: 58,
      quantity: 500,
      price: 8,
      data: {
        codigo_nandina: "1008.50.00",
      },
    },
  ],
  sector: "4",
  data: {
    codigo_pais: "DE",
    puerto_destino: "Arica",
  },
});
```

#### 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": "80013826",
      "name": "Consignatario Exterior"
    },
    "items": [
      {
        "sku": "QUINUA",
        "description": "Quinua a granel",
        "codigo_producto_sin": 5214100,
        "unidad_medida": 58,
        "quantity": 500,
        "price": 8,
        "data": {
          "codigo_nandina": "1008.50.00"
        }
      }
    ],
    "sector": "4",
    "data": {
      "codigo_pais": "DE",
      "puerto_destino": "Arica"
    }
  }' | jq '{id, status}'
```