Inicio rápido

1. Crea tu cuenta en chaski.ec. Entras con tu correo, sin contraseña.

2. Registra tu RUC en el panel (Emisores → Nuevo emisor). Necesitas tu certificado de firma electrónica (.p12) y su contraseña, y un punto de emisión (por ejemplo 001-001).

3. Crea una API key de pruebas en el panel (API keys). Empieza con sk_test_. Guárdala: solo se muestra una vez.

4. Emite una factura:

   curl

   curl https://api.chaski.ec/v1/invoices \
     -H "Authorization: Bearer $CHASKI_API_KEY" \
     -H "Content-Type: application/json" \
     -H "Idempotency-Key: pedido-1042" \
     -d '{
       "issuer": "iss_01jbx3k9q2f8m4tn6vwz0yh5ce",
       "emission_point": "001-001",
       "buyer": {
         "id_type": "cedula", "id": "1710034065",
         "name": "María Pérez", "email": "[email protected]"
       },
       "items": [{
         "description": "Plan Pro mensual",
         "quantity": "1", "unit_price": "20.00",
         "taxes": [{ "type": "iva", "rate": "15" }]
       }],
       "payments": [{ "method": "credit_card" }]
     }'

   JavaScript

   import { Chaski } from '@chaski/sdk';
   
   const chaski = new Chaski(process.env.CHASKI_API_KEY!);
   const invoice = await chaski.invoices.create(
     {
       issuer: 'iss_01jbx3k9q2f8m4tn6vwz0yh5ce',
       emission_point: '001-001',
       buyer: { id_type: 'cedula', id: '1710034065', name: 'María Pérez', email: '[email protected]' },
       items: [
         { description: 'Plan Pro mensual', quantity: '1', unit_price: '20.00', taxes: [{ type: 'iva', rate: '15' }] },
       ],
       payments: [{ method: 'credit_card' }],
     },
     { idempotencyKey: 'pedido-1042' },
   );

   La respuesta llega enseguida, con la factura en pending, su número (001-001-000000001) y la clave de acceso de 49 dígitos.

5. Espera la autorización. En segundos, la factura pasa a authorized (o a rejected, con los mensajes del SRI). Para enterarte, configura un webhook o consulta GET /v1/invoices/{id}.

6. Descarga el RIDE y el XML con GET /v1/invoices/{id}/pdf y GET /v1/invoices/{id}/xml. En producción, el comprador los recibe por correo.

Cuando todo funcione en pruebas, sigue la guía de paso a producción.