TukiFact

SDKs Oficiales

Librerías oficiales de TukiFact. Tipado completo, manejo de errores y ejemplos listos para producción.

🟦
TypeScript
@tukifact/sdk
v1.0.0Estable

SDK oficial para TypeScript y JavaScript. Soporte completo para Node.js, Next.js, y cualquier entorno JS moderno.

✓ Tipos TypeScript completos✓ Async/await nativo✓ Reintentos automáticos✓ Paginación automática

Instalación

npm
npm install @tukifact/sdk

Ejemplo de uso

typescript
import { TukiFact } from '@tukifact/sdk';

const client = new TukiFact({
  apiKey: process.env.TUKIFACT_API_KEY,
  environment: 'sandbox',
});

// Crear factura
const factura = await client.documents.create({
  type: '01',
  series: 'F001',
  customer: {
    documentType: '6',
    documentNumber: '20100066603',
    name: 'EMPRESA CLIENTE SAC',
  },
  items: [{
    description: 'Servicio de consultoría',
    quantity: 1,
    unitPrice: 1000.00,
    igv: 180.00,
  }],
});

console.log(factura.id);     // doc_xxxx
console.log(factura.status); // "accepted"
🐍
Python
tukifact
v1.0.0Estable

SDK oficial para Python 3.8+. Compatible con Django, FastAPI, Flask y scripts de automatización.

✓ Type hints completos✓ Soporte sync y async✓ Reintentos con backoff✓ Context managers

Instalación

pip
pip install tukifact

Ejemplo de uso

python
from tukifact import TukiFact
import os

client = TukiFact(
    api_key=os.environ["TUKIFACT_API_KEY"],
    environment="sandbox",
)

# Crear factura
factura = client.documents.create(
    type="01",
    series="F001",
    customer={
        "document_type": "6",
        "document_number": "20100066603",
        "name": "EMPRESA CLIENTE SAC",
    },
    items=[{
        "description": "Servicio de consultoría",
        "quantity": 1,
        "unit_price": 1000.00,
        "igv": 180.00,
    }],
)

print(factura.id)      # doc_xxxx
print(factura.status)  # accepted
🌐
REST API
API Directa
vv1Estable

Integrá directamente con HTTP desde cualquier lenguaje o plataforma. Compatible con cualquier stack tecnológico.

✓ Sin dependencias✓ Compatible con cualquier lenguaje✓ JSON estándar✓ TLS 1.3

Ejemplo de uso

rest api
# Crear factura con cURL
curl -X POST https://sandbox.tukifact.net.pe/v1/documents \
  -H "Authorization: Bearer TF_test_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "01",
    "series": "F001",
    "customer": {
      "documentType": "6",
      "documentNumber": "20100066603",
      "name": "EMPRESA CLIENTE SAC"
    },
    "items": [{
      "description": "Servicio de consultoría",
      "quantity": 1,
      "unitPrice": 1000.00,
      "igv": 180.00
    }]
  }'

¿Usás otro lenguaje?

Podés integrarte directamente con la API REST usando HTTP estándar desde cualquier lenguaje: PHP, Ruby, Go, Java, .NET, y más.

Si necesitás un SDK oficial para tu stack, escribinos a developers@tukifact.net.pe