Manuales para integradores
Prepará la integración fiscal antes de escribir código
El primer manual no es una referencia API: es una lista clara de datos, autorizaciones, credenciales y decisiones que necesitás tener resueltas antes de integrar como autoimpresor o con factura electrónica SIFEN/e-Kuatia.
A. Autoimpresor autorizado
- RUC, razón social, régimen y datos fiscales de la empresa.
- Sucursal y punto de expedición autorizados.
- Autorización de autoimpresor y software declarado.
- Timbrado, vigencia, rango y próximo número por tipo de documento.
- Endpoint y credencial del backend autoimpresor.
- Primer documento controlado para validar reserva de número, PDF/imprimible y webhook.
B. Factura electrónica SIFEN/e-Kuatia
- RUC, razón social, sucursales y puntos de emisión reales.
- Certificado digital PFX vigente y contraseña.
- Timbrado electrónico y numeración por tipo documental.
- Ambiente de prueba y producción definidos.
- Clave API, payload canónico mínimo e idempotencia.
- Primer documento controlado para validar XML, KUDE, respuesta SIFEN y webhook.
Para ambos canales
- Contacto fiscal que aprueba datos y primer documento.
- Contacto técnico que opera API, webhooks y errores.
- external_id estable en el sistema origen.
- Manejo de estados, errores recuperables y errores terminales.
- Política de acceso a artefactos: PDF, XML, KUDE, payload y respuesta del canal.
- Procedimiento para rotar credenciales sin cortar la operación.
Cuándo usar otros manuales
- Usá Docs API cuando el checklist fiscal ya esté claro.
- Usá Webhooks cuando el sistema origen necesite sincronización automática.
- Usá Checklist SIFEN para salir a producción.
- Usá Autoimpresión a SIFEN si el cliente hoy imprime y después migrará.
- Usá Seguridad para credenciales, certificados y retención.
- Usá Status para límites del piloto y soporte operativo.
Cliente o integrador que empieza
- 1
/manuales/autoimpresor - Si ya tiene autorización de autoimpresor y necesita emitir imprimibles fiscales desde su sistema.
- 2
/manuales/factura-electronica - Si va a operar factura electrónica SIFEN/e-Kuatia o prepara el cambio desde autoimpresión.
- 3
/docs/api - Cuando ya tiene datos fiscales y quiere implementar validación, creación, consulta y artefactos.
Casa de software
- 1
/manuales - Usar esta página como checklist comercial y técnico para cada cliente.
- 2
/partners - Revisar modelo partner, multi-cliente y soporte.
- 3
/webhooks-sifen - Diseñar sincronización reusable por cliente, evento y ambiente.
Formato recomendado
HTML primero. Es más fácil de mantener, se puede enlazar desde ventas, soporte y consola, aparece en buscadores y evita que DOCX/PDF queden desactualizados. PDF o DOCX pueden generarse después como exportación para clientes que lo pidan.
