---
title: "SDK y CLI para la API de Printags: npm install printags | Printags"
description: "SDK y línea de comandos oficiales de Printags en npm: listar y crear pedidos de tarjetas, probar con el sandbox, sin dependencias, licencia MIT."
canonical: "https://www.printags.com/es/sdk-y-cli/"
---

# SDK y CLI de Printags para la API

Llame a la API de Printags desde Node.js o desde la línea de comandos. Un solo paquete npm, sin dependencias.

[Instalar el paquete](#install)[Ver en npm](https://www.npmjs.com/package/printags)

## Instalación

Node.js 18 o superior. El paquete contiene el SDK y el comando printags.

npm install printags

## SDK para Node.js

Cada método corresponde a una operación del documento OpenAPI, con el nombre de la propia operación. Los errores son objetos PrintagsError con el estado HTTP y el código de error de la API.

import { Printags } from "printags";

const printags = new Printags({ apiKey: process.env.PRINTAGS_API_KEY });

const { orders } = await printags.listOrders("@me", { perPage: 10 });

// A draft prints and charges nothing until it is validated.
// The idempotency key makes a retry safe: the same key returns the order already created.
const { orderId } = await printags.createOrder("@me", {
  isDraft: true,
  reference: "Order-2026-001",
  shipTo: { name: "Jean Dupont", phone: "+33612345678", email: "jean@example.com",
    address: { addressLine1: "12 rue de la Paix", city: "Paris", postcode: "75002", countryCode: "FR" } },
  items: [{ productId: "ntag213_pvccard_white", quantity: 10, printingVisuals: [fileId],
    nfc: { type: "uri", content: "https://example.com/jean" } }]
}, { idempotencyKey: "order-2026-001" });

## Línea de comandos

Las mismas operaciones desde un terminal o un script. La salida es JSON.

export PRINTAGS_API_KEY=sk_test_...
export PRINTAGS_SANDBOX=1

npx printags statuses
npx printags carriers --to-country FR
npx printags orders list --per-page 5
npx printags orders create --file order.json --idempotency-key order-2026-001

## Sandbox

Una clave de prueba (sk\_test\_...) crea pedidos de prueba que no se cobran ni se fabrican. Con la opción sandbox, el SDK y la CLI usan sandbox-api.printags.com, que solo acepta claves de prueba: una clave real se rechaza antes de que ninguna solicitud salga de su equipo.

## Recursos

* [Documentación de la API (docs.printags.com)](https://docs.printags.com)
* [Documento OpenAPI (JSON)](https://www.printags.com/openapi.json)
* [Código fuente en GitHub (printags/printags-js)](https://github.com/printags/printags-js)
* [Integración de la API REST](https://www.printags.com/es/integracion-api/)
* [Servidor MCP de Printags](https://www.printags.com/es/servidor-mcp/)
* [Skills de agentes en GitHub (printags/agent-skills)](https://github.com/printags/agent-skills)

Preguntas

## SDK y CLI: sus preguntas

### ¿Existe un SDK oficial de Printags?

Sí: el paquete npm printags, para Node.js 18 o superior, sin dependencias. La API es una API REST estándar descrita por un documento OpenAPI, así que cualquier lenguaje puede llamarla.

### ¿Puedo probar el SDK sin pedir tarjetas reales?

Sí. Use una clave de prueba (sk\_test\_...) con la opción sandbox: los pedidos creados son pedidos de prueba, que no se cobran ni se fabrican.

### ¿Con qué licencia se publica el paquete?

MIT. El código fuente está en GitHub: printags/printags-js.