Introducción

Guía para developers. El SDK oficial es @traky-app/sdk: un cliente de Node.js 20+ para la API de organización. No tiene dependencias de runtime y usa fetch. El paquete publicado está en npm y el código en GitHub.

https://www.npmjs.com/package/@traky-app/sdk

https://github.com/traky-app/traky-sdk-typescript

Instalar

Elige el gestor. Comando copia la instalación; Manual muestra la dependencia en package.json.

pnpm add @traky-app/sdk

Primer cliente

Crea la API key en Ajustes → Desarrollo de la empresa y guárdala en TRAKY_API_KEY. El SDK la envía como Authorization: Bearer.

import { Traky } from "@traky-app/sdk";

const traky = new Traky({
  apiKey: process.env.TRAKY_API_KEY!,
});

const organization = await traky.organization.retrieve();
const packages = await traky.packages.list();

const created = await traky.packages.create({
  registrationDate: new Date().toISOString(),
  trackingNumber: "1Z999",
  itemStatusId: "00000000-0000-4000-8000-000000000001",
  locationId: "00000000-0000-4000-8000-000000000002",
  weight: 2,
});
await traky.packages.update(created.id, { warehouseComments: "Retener" });
await traky.packages.delete(created.id);

• organization.retrieve() Empresa dueña de la clave.
• packages.list() Hasta 500 paquetes, los más recientes.
• packages.create() / update() / delete() Alta, cambio parcial y borrado de un paquete.
• receipts, customers, contacts, statuses El mismo CRUD para recibos, clientes, contactos y estados.