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

# 5 · Venta en Zona Franca

Ventas dentro de zona franca, sin crédito fiscal. La cabecera lleva el **número
de parte de recepción** que ampara la mercadería; sin detalle sectorial.

## Cabecera (`data`)

| Campo                    | Tipo   | Obligatorio | Qué significa                             |
| ------------------------ | ------ | ----------- | ----------------------------------------- |
| `numero_parte_recepcion` | string | Ver perfil  | Parte de recepción de la mercadería en ZF |

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

Sin campos sectoriales.

#### SDK TypeScript

```typescript
const factura = await supay.invoices.emit({
  point_of_sale_id: pos.id,
  customer: {
    document_type: "nit",
    document_number: "7890123",
    name: "Usuario ZF",
  },
  items: [
    {
      sku: "ELEC-ZF",
      description: "Electrónicos",
      codigo_producto_sin: 5113100,
      unidad_medida: 58,
      quantity: 5,
      price: 800,
    },
  ],
  sector: "5",

  // La mercadería queda amparada por su parte de recepción
  data: {
    numero_parte_recepcion: "PR-2026-7788",
  },
});
```

#### 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": "7890123",
      "name": "Usuario ZF"
    },
    "items": [
      {
        "sku": "ELEC-ZF",
        "description": "Electrónicos",
        "codigo_producto_sin": 5113100,
        "unidad_medida": 58,
        "quantity": 5,
        "price": 800
      }
    ],
    "sector": "5",
    "data": {
      "numero_parte_recepcion": "PR-2026-7788"
    }
  }' | jq '{id, status}'
```