Method | Yii Extension Labs

Cómo trabajamos la integración con SIFEN, paso por paso

Antes de escribir una línea de código revisamos su esquema contable, el ERP que ya usa y el volumen real de comprobantes. El método es el mismo para un conector API nuevo que para una base de datos que ya no aguanta el cierre mensual.

Trabajamos sobre sistemas en producción. No reescribimos el núcleo del ERP: intervenimos la capa fiscal y la capa de datos con cambios medibles y reversibles.

Diagnóstico del flujo actual: qué emite el ERP, dónde se firma, qué códigos de respuesta de SIFEN se ignoran hoy y qué pasa cuando el servicio fiscal no responde. De ahí sale el alcance real del módulo.

Diseño del conector o del ajuste de esquema, con criterios de trazabilidad para auditoría. Cada decisión queda documentada antes de tocar producción.

Implementación por etapas, con pruebas en ambiente de contingencia y una cola de reintentos que no detiene la facturación del día.

Entrega con código comentado, manual de operación y una sesión de traspaso al equipo interno. El soporte posterior depende de lo que su equipo quiera absorber.

Ver los módulos y conectores disponibles Casos con ERPs propietarios y alto volumen

El orden de trabajo, desde el diagnóstico hasta la operación estable

Cada integración con SIFEN sigue una secuencia que ya probamos con ERPs propietarios, sistemas contables heredados y módulos internos escritos a medida. Los plazos varían según el estado de la base de datos y la documentación disponible, pero las etapas y sus entregables no cambian.

Antes de empezar pedimos acceso de lectura al esquema contable, una muestra de comprobantes reales y la versión del certificado digital vigente. Sin eso, cualquier cronograma es una suposición.

Semana 1 — Relevamiento del sistema interno

Revisamos cómo se generan hoy los comprobantes, qué tablas intervienen y dónde vive la numeración fiscal. Salimos con un mapa de puntos de integración y una lista de bloqueos conocidos.

Semana 2 a 3 — Diseño del conector y contrato de datos

Definimos el contrato entre el ERP y el módulo fiscal: campos obligatorios, códigos de respuesta, cola de reintentos y modo contingencia. Se documenta antes de escribir la primera línea de código.

Semana 4 a 6 — Implementación y pruebas contra el ambiente de SIFEN

Se construye el conector, se firma con el certificado del cliente y se ejecutan lotes de prueba. Aquí aparecen los rechazos reales: timbrado vencido, montos mal redondeados, códigos de moneda.

Semana 7 — Optimización de la base contable

Con el flujo ya funcionando, medimos consultas y ajustamos índices, particiones por período fiscal y separación de cargas analíticas. El objetivo es que el cierre mensual no compita con la facturación.

Semana 8 — Puesta en producción y traspaso

Activamos el envío real, dejamos monitoreo de acuses y entregamos la documentación del conector al equipo interno. El soporte posterior queda acotado a cambios normativos y ajustes de esquema.

Cómo trabajamos una integración con SIFEN, paso a paso

Un diagnóstico técnico primero, después un plan acotado y verificable. Cada etapa deja artefactos concretos: esquema de datos, contrato de API, pruebas de contingencia y documentación para su equipo. Nada se despliega en producción sin que su área contable haya validado el flujo completo.

Si todavía no tiene claro si conviene un módulo externo o tocar el núcleo del ERP, conviene revisar antes los servicios de integración y el alcance real de cada uno.

1. Relevamiento del sistema interno

Revisamos cómo emite hoy sus comprobantes: tablas de facturación, catálogos de clientes, numeración por timbrado y puntos de emisión. También qué versión del ERP corre, si tiene API propia o solo base de datos, y qué restricciones impone el proveedor del sistema.

2. Mapeo contra el esquema de SIFEN

Cada campo del comprobante interno se contrasta con lo que exige el formato electrónico: tipo de documento, condición del receptor, IVA por ítem, moneda y retenciones. Aquí aparecen los huecos habituales, como direcciones incompletas o códigos de producto que no existen en el catálogo fiscal.

3. Diseño del conector y del modo contingencia

Definimos si la comunicación va por API directa, por cola de mensajes o por tablas intermedias. Se documenta el manejo de firma digital, certificados, reintentos y el flujo alterno cuando el servicio fiscal no responde y el negocio no puede detenerse.

4. Implementación y pruebas en ambiente de certificación

Se construye el módulo, se conecta al ambiente de pruebas de SIFEN y se ejecuta una batería de casos: emisión normal, rechazos por datos, notas de crédito y anulación. Cada respuesta del servicio queda registrada con su código y su interpretación.

5. Puesta en producción acompañada

El primer cierre mensual se monitorea en conjunto con su equipo contable. Revisamos tiempos de respuesta, conciliación entre comprobantes emitidos y registrados, y cualquier ajuste de índices o consultas que el volumen real exija.

6. Entrega de documentación y traspaso

Al cierre queda el código comentado, el diagrama de flujo, la tabla de códigos de error y una guía de operación para soporte interno. Si su equipo prefiere mantenerlo, se hace una sesión de traspaso; si no, seguimos con el mantenimiento.

Ver ejemplos de integraciones ya resueltas en casos de uso.

Qué entra y qué no en un diagnóstico de integración SIFEN

Antes de firmar cualquier alcance conviene fijar los límites. Estas son las definiciones que usamos en Yii Extension Labs cuando un equipo contable o de sistemas nos pide revisar su vínculo entre inventario interno y facturación electrónica.

Qué consideramos "integración técnica" y qué queda fuera

Hablamos de integración cuando el módulo lee y escribe contra su base de datos o su ERP mediante API, archivos intermedios o vistas controladas, y devuelve el estado del comprobante a SIFEN. No incluye la emisión de facturas manuales, la carga de datos maestros de clientes ni la conciliación bancaria. Tampoco cubre la firma de documentos que su contador tramita por fuera del sistema.

Qué significa "código documentado" en la práctica

Cada conector sale con un README que describe el flujo de emisión, los códigos de respuesta de SIFEN que manejamos, las variables de entorno y los puntos de contingencia. Documentamos también las decisiones de diseño que tomamos durante el desarrollo, no solo el resultado. Si su equipo interno toma el mantenimiento después, esa documentación es la que evita que el módulo se convierta en una caja negra.

Qué pasa cuando SIFEN rechaza un comprobante

Un rechazo no es un error del sistema: es una respuesta del servicio fiscal que el módulo debe interpretar y registrar. Definimos por escrito qué códigos se reintentan automáticamente, cuáles requieren corrección de datos y cuáles se derivan a contingencia. Si su ERP actual descarta esa información, la integramos en una tabla de trazabilidad antes de tocar cualquier otra capa.

Qué alcance tiene la optimización de bases de datos contables

Intervenimos índices, particiones por período fiscal y consultas de cierre, pero no rediseñamos el modelo de datos del ERP ni migramos el histórico completo. Cualquier cambio estructural se propone con plan de reversión y ventana de prueba. Si el problema real está en la lógica de negocio y no en el esquema, lo decimos antes de empezar.

Qué esperamos de su equipo durante el trabajo

Necesitamos acceso a un ambiente de pruebas con datos representativos, un contacto técnico con capacidad de decisión y alguien del área contable que valide los estados de los comprobantes. Sin esas tres piezas el diagnóstico se alarga y las conclusiones quedan a medias. No trabajamos sobre producción sin un plan de contingencia acordado por escrito.

Qué no prometemos

No garantizamos tiempos de respuesta de SIFEN, no asumimos la responsabilidad fiscal de sus comprobantes y no reemplazamos a su contador. Tampoco entregamos módulos cerrados sin documentación ni aceptamos alcances que dependan de sistemas a los que no tenemos acceso verificable. Si algo de esto no encaja, preferimos decirlo en la primera conversación.