SDK TypeScript

npm install @engineapi/sdk

import { EngineApiClient } from '@engineapi/sdk';

const client = new EngineApiClient({
  baseUrl: 'https://api.engineapi.com.br',
  apiKey: 'ek_live_SEU_API_KEY',
  timeout: 30000, // opcional, padrão 30s
});

client.nfe        // NFe: emissão, cancelamento, CC-e, download, status SEFAZ
client.companies  // Empresas: cadastro e certificados

import { EngineApiClient } from '@engineapi/sdk';

const client = new EngineApiClient({
  baseUrl: 'https://api.engineapi.com.br',
  apiKey: 'ek_live_SEU_API_KEY',
});

const nfe = await client.nfe.emitir({
  destinatario: {
    cnpjCpf: '99888777000100',
    nome: 'Cliente Exemplo SA',
    endereco: {
      logradouro: 'Av Brasil', numero: '500',
      bairro: 'Centro', municipio: 'São Paulo',
      uf: 'SP', cep: '01001000',
      codigoMunicipio: '3550308',
    },
  },
  items: [{
    codigo: 'PROD001',
    descricao: 'Produto Teste',
    ncm: '61091000',
    cfop: '5102',
    unidade: 'UN',
    quantidade: 1,
    valorUnitario: 100.00,
    icms: { origem: 0, csosn: '400' },
  }],
  pagamentos: [{ forma: '01', valor: 100.00 }],
});

console.log('Chave:', nfe.data.accessKey);
console.log('Status:', nfe.data.status);  // "AUTHORIZED"
console.log('Protocolo:', nfe.data.protocol);
console.log('Downloads:', nfe.data.downloads); // { xml, pdf }, rotas reais de download

const lista = await client.nfe.listar({
  page: 1,
  limit: 20,
  issuerId: 'ISSUER_UUID',
  status: 'AUTHORIZED',
});

await client.nfe.cancelar('35260211222333000181550010000000011000000019', {
  justificativa: 'Erro nos dados do destinatário informado na venda',
});

await client.nfe.cartaCorrecao('35260211222333000181550010000000011000000019', {
  correcao: 'Corrijo o endereço do destinatário para Av Brasil, 500',
});

// PDF (DANFE)
const pdf = await client.nfe.downloadPdf('35260211...');
fs.writeFileSync('danfe.pdf', pdf);

// XML
const xml = await client.nfe.downloadXml('35260211...');
fs.writeFileSync('nfe.xml', xml);

// XML/PDF da CC-e
const cceXml = await client.nfe.downloadCceXml('35260211...');
const ccePdf = await client.nfe.downloadCcePdf('35260211...');

const status = await client.nfe.status();

const company = await client.companies.criar({
  cnpj: '11222333000181',
  name: 'Empresa Exemplo Ltda',
  crt: 1,
});

await client.companies.uploadCertificado(
  company.data.id,
  fs.readFileSync('certificado.pfx'),
  'senhaDoCertificado',
);

import { EngineApiClient, EngineApiError } from '@engineapi/sdk';

try {
  await client.nfe.emitir(params);
} catch (error) {
  if (error instanceof EngineApiError) {
    console.error('Status:', error.statusCode);
    console.error('Mensagem:', error.message);
    console.error('Response:', error.response); // envelope RFC 7807 completo

    if (error.statusCode === 400) {
      // Validação OU rejeição SEFAZ: ver error.response?.error?.erros
    }
    if (error.statusCode === 401) {
      // API key/token inválido ou expirado
    }
    if (error.statusCode === 429) {
      // Rate limit: retry após Retry-After
    }
    if (error.statusCode === 404) {
      // Recurso não encontrado
    }
    if (error.statusCode >= 500) {
      // Retry com backoff
    }
  }
}

const client = new EngineApiClient({
  baseUrl: 'https://api.engineapi.com.br',
});

const login = await client.login({
  email: 'usuario@partner.com',
  password: 'senha',
});

console.log('Token:', login.access_token);
console.log('Usuário:', login.user.email, login.user.role);

// Agora o client usa o JWT automaticamente (setToken() já foi chamado
// internamente por login())
const empresas = await client.companies.listar();

// app/api/emitir-nfe/route.ts
import { EngineApiClient } from '@engineapi/sdk';
import { NextResponse } from 'next/server';

const engine = new EngineApiClient({
  baseUrl: process.env.ENGINE_API_URL!,
  apiKey: process.env.ENGINE_API_KEY!,
});

export async function POST(request: Request) {
  const body = await request.json(); // já no formato real: destinatario/items/pagamentos
  const nfe = await engine.nfe.emitir(body);
  return NextResponse.json(nfe);
}

import express from 'express';
import { EngineApiClient, EngineApiError } from '@engineapi/sdk';

const app = express();
const engine = new EngineApiClient({
  baseUrl: process.env.ENGINE_API_URL!,
  apiKey: process.env.ENGINE_API_KEY!,
});

app.post('/nfe', async (req, res) => {
  try {
    const nfe = await engine.nfe.emitir(req.body);
    res.json(nfe);
  } catch (error) {
    if (error instanceof EngineApiError) {
      res.status(error.statusCode).json({ error: error.message });
    } else {
      res.status(500).json({ error: 'Internal server error' });
    }
  }
});