Requisitos de la API SIRE SUNAT para integrar registros con Odoo

El alcance de una integración con Odoo debe precisar qué información preparará el ERP y qué actividades realizará el equipo contable ante SUNAT. También debe identificar los resultados que cada responsable revisará antes de dar por terminada una operación. Esa definición permite establecer qué parte del procedimiento contará con asistencia de la integración y qué tareas permanecerán a cargo del personal.

La documentación peruana de Odoo incluye el Registro de Ventas e Ingresos 14.4 entre sus informes de localización. También identifica el Registro de Compras Electrónico 8.4 y el Registro de Compras de operaciones con sujetos no domiciliados 8.5. La descripción de estos informes no acredita por sí sola una conexión directa con la API SIRE. (Odoo)

Antes de definir el trabajo, TI y contabilidad pueden revisar la versión de Odoo y la configuración disponible. El inventario debe señalar el origen de la información y el responsable de aprobarla. También conviene identificar los resultados que el equipo necesitará consultar y la evidencia que conservará durante el proceso.

El servicio de seguridad de SUNAT genera un token mediante una solicitud POST que utiliza la modalidad password y el alcance de la API SIRE. La solicitud incluye el identificador y el secreto del cliente. También incluye la clave SOL y un usuario compuesto por el RUC y el usuario SOL. Los servicios documentados utilizan el token como Bearer en la autorización de cada solicitud. (SUNAT, 2026)

El diseño de la integración debe definir quién administra las credenciales y qué procesos pueden utilizarlas. Una opción es guardarlas en un repositorio de secretos del entorno de ejecución. El equipo puede restringir el acceso a las personas y los procesos autorizados, y evitar que las claves aparezcan en registros de aplicación o archivos compartidos.

El procedimiento operativo debe indicar cómo se entregan, actualizan y retiran las credenciales. También debe asignar la atención de fallas de autenticación. Para investigar esos incidentes, TI puede registrar la fecha, el servicio y el resultado de la operación sin guardar los valores secretos.

El manual de ventas de SUNAT advierte que los servicios de la API SIRE no deben consumirse desde un cliente web debido a errores de CORS. (SUNAT, 2026) El equipo de TI debe considerar esa restricción al diseñar el uso de la integración desde Odoo. Una alternativa consiste en realizar las solicitudes desde un componente de servidor y mostrar al usuario el resultado que necesita revisar.

SUNAT indica que los servicios REST que requieran desarrollar un cliente TUS deben desarrollarse en Java, conforme al anexo de su manual de ventas. (SUNAT, 2026) Antes de elegir los componentes de la solución, TI debe comprobar si las operaciones previstas requieren ese cliente. La decisión y su alcance pueden quedar registrados en el diseño técnico y en el plan de pruebas.

El inventario de servicios debe distinguir las operaciones de ventas de las de compras. El manual de ventas proporcionado corresponde a la versión 32. (SUNAT, 2026) El manual de compras proporcionado corresponde a la versión 29. (SUNAT, 2026) Ambos documentos están fechados el 12 de octubre de 2026. (SUNAT, 2026; SUNAT, 2026) Antes de implementar un servicio, conviene contrastar sus requisitos y respuestas con la documentación vigente de SUNAT.

La API permite consultar el estado de un proceso de carga o descarga mediante su identificador. Cuando el estado es «Terminado», la respuesta devuelve el nombre del archivo generado. Otro servicio permite descargar los archivos generados, comprimidos y particionados. (SUNAT, 2026)

La integración debe conservar el identificador y relacionarlo con la operación que lo originó. Así, el personal puede consultar el avance y reconocer los resultados disponibles. Una bandeja de seguimiento puede mostrar las operaciones pendientes y las que cuentan con archivos para descargar. También puede indicar quién debe revisar cada resultado.

El diseño de la descarga debe contemplar los archivos comprimidos y sus partes. (SUNAT, 2026) Antes de incorporar un resultado al proceso contable, el equipo puede comprobar que recibió los archivos esperados y que puede abrirlos. Conviene conservar la relación entre la operación, los archivos recibidos y la revisión efectuada. Esa información ayuda a reconstruir el recorrido de una incidencia.

El manual de compras describe el servicio «Registrar preliminar» para registrar preliminares de compras o ajustes posteriores. Después de ese registro, el procedimiento continúa en el portal web de SUNAT para generar el registro. El registro preliminar no equivale por sí solo a la generación del registro definitivo. (SUNAT, 2026)

La interfaz de seguimiento debe reflejar esa secuencia con estados comprensibles para contabilidad y TI. Una operación puede figurar como preliminar mientras queda pendiente la actividad en el portal. El responsable contable debe revisar la evidencia de la generación definitiva antes de cerrar el proceso.

El equipo de implementación debe verificar los formatos admitidos y las validaciones de contenido en el contrato técnico vigente de cada servicio seleccionado. Las pruebas pueden incluir la revisión de respuestas y archivos, así como el tratamiento de resultados que requieran corrección. También deben definir quién comunica la incidencia y quién autoriza la repetición de una operación.

El método DMG-RT vincula cada intervención tecnológica con un indicador de negocio y una línea base medida. Entre sus ejemplos figura el indicador de horas de digitación por semana para evaluar el doble registro entre sistemas. Para aplicarlo a una integración tributaria, la empresa puede delimitar las actividades que incluirá en la medición y definir la fuente de los datos.

El método plantea una línea base reproducible aprobada por finanzas del cliente. También establece que una oportunidad sin fuente de datos se reporte como cualitativa. La definición del indicador debe quedar documentada para que las mediciones posteriores utilicen el mismo alcance.

DMG-RT prevé la participación de los dueños del proceso en la implementación. El traspaso incluye responsables de los indicadores y un manual de operación. Para el registro preliminar de compras, el equipo debe identificar al responsable de continuar el procedimiento en el portal de SUNAT. (SUNAT, 2026) El manual operativo puede recoger esa responsabilidad y la ubicación de la evidencia de generación.