@kaydte/sdk

SDK oficial de Node.js / TypeScript para la API comercial KayDTE v1.

Instalación

pnpm add @kaydte/sdk
# npm i @kaydte/sdk

Uso rápido

import { createKayDteClient } from '@kaydte/sdk';

const kaydte = createKayDteClient({
  apiKey: process.env.KAYDTE_API_KEY!, // kdte_...
  // baseUrl: 'https://www.kaydte.com', // default
});

await kaydte.hacienda.createSession({
  emisorId: 1,
  environment: 'test',
});

const emission = await kaydte.emissions.create({
  tipoDte: '01',
  environment: '00',
  emisorId: 1,
  passwordPri: process.env.KAYDTE_CERT_PASSWORD!,
  documentRequest: {
    /* payload MH / builders KayDTE */
  },
});

Seguridad

• Use la API key solo en el backend (nunca en el browser del usuario final).
• No envíe NIT, password MH, JWT ni organizationId.
• Verifique webhooks con verifyAndParseWebhook.

Webhooks

import { verifyAndParseWebhook } from '@kaydte/sdk';

const payload = verifyAndParseWebhook({
  rawBody,
  secret: process.env.KAYDTE_WEBHOOK_SECRET!, // whsec_...
  headers: req.headers as Record<string, string>,
});

Otros lenguajes

Este paquete es npm. El contrato HTTP (OpenAPI + Postman) sirve para PHP, C#, Java, etc. Ver /openapi y /docs en el monorepo.

Licencia

MIT