Guía Rápida
Integrá la API de TukiFact en tu aplicación siguiendo estos 6 pasos. Tiempo estimado: 15 minutos.
1
2
Elegir entorno
Usá el sandbox para probar sin riesgo. Cuando estés listo, cambiá a producción.
| Sandbox | Producción | |
|---|---|---|
| URL | sandbox.tukifact.net.pe | api.tukifact.net.pe |
| API Key | TF_test_xxxx | TF_live_xxxx |
| Envío a SUNAT | No (simulado) | Sí (real) |
| Costo | Gratis | Según plan |
3
Crear tu primera factura
Emití una factura electrónica con el tipo de documento 01 (Factura).
typescriptPaso principal
import { TukiFact } from '@tukifact/sdk';
const client = new TukiFact({
apiKey: process.env.TUKIFACT_API_KEY,
environment: 'sandbox', // 'production' para producción
});
const factura = await client.documents.create({
type: '01', // Factura
series: 'F001',
customer: {
documentType: '6', // RUC
documentNumber: '20100066603',
name: 'EMPRESA CLIENTE SAC',
address: 'Av. Javier Prado 123, Lima',
},
items: [
{
description: 'Servicio de desarrollo de software',
quantity: 1,
unitPrice: 1000.00,
igv: 180.00,
},
],
});
console.log(factura.id); // doc_xxxxxxxxxxxx
console.log(factura.status); // "accepted"4
Consultar estado del documento
Verificá si SUNAT procesó correctamente tu comprobante.
typescript
const documento = await client.documents.getStatus( 'doc_xxxxxxxxxxxx' ); console.log(documento.sunatStatus); // "ACEPTADO" console.log(documento.cdrCode); // "0"
5
Descargar el PDF
Obtené el PDF firmado para enviar a tu cliente.
typescript
const pdf = await client.documents.getPdf(
'doc_xxxxxxxxxxxx'
);
// pdf es un Buffer con el contenido del PDF
fs.writeFileSync('factura.pdf', pdf);6
Configurar webhooks
Recibí notificaciones automáticas cuando SUNAT procese tus documentos.
typescript
const webhook = await client.webhooks.create({
url: 'https://miapp.com/api/webhooks/tukifact',
events: ['document.accepted', 'document.rejected'],
secret: 'mi_secreto_para_validar',
});
console.log(webhook.id);¡Integración completa!
Tu sistema ya puede emitir facturas electrónicas, consultar su estado y recibir notificaciones automáticas.