Skip to content
@contaperu

ContaPerú

Un solo puente entre SUNAT y cualquier sistema contable peruano: estándar abierto y motor.

ContaPerú

Un solo puente entre SUNAT y cualquier sistema contable peruano.

En el Perú cada sistema contable —CONCAR, CONTASIS, STARSOFT— pide su propio formato, con sus columnas y sus siglas. Así que cada empresa termina escribiendo el mismo puente una y otra vez, a mano y por cliente, y cada estudio arma sus asientos a pulso. Y ahora que una IA lee cien facturas en un minuto, el cuello de botella dejó de ser la lectura: es que no hay un formato común y validado donde poner el resultado, y una cuenta mal puesta se descubre meses después.

La idea es que ese puente sea uno solo, público, y la base sobre la que se construyan los ERPs que vienen.

ContaPerú es ese formato y el motor que lo llena. Lee los comprobantes que emite SUNAT, arma la partida doble —y comprueba que cuadre antes de escribir un solo byte— y exporta al formato que pide cada sistema. Sin base de datos, sin estado y sin salir a la red.

Las reglas no están diseñadas en papel: salen de archivos reales que un CONCAR de producción, CONTASIS y el propio SIRE de SUNAT aceptaron.

Las piezas

Pieza Qué es
open-accounting El formato abierto de intercambio de documentos contables peruanos: la especificación escrita y su esquema formal (JSON Schema 2020-12), con URL canónica para poder citarlo. Va por la 1.0, y la 1.0 es un compromiso: nada de lo que existe se quita ni cambia de significado hasta una 2.0.
contaperu La implementación de referencia en Python: lectores (XML UBL, TXT del SIRE), el motor de asientos y los drivers de salida. pip install contaperu
Servidor MCP El mismo motor como herramienta para agentes de IA: entra un XML, sale el Excel de asientos como archivo. Cada quien levanta el suyo — no pasa por la base de datos de nadie, porque no hay base de datos.

A dónde sale hoy

Destino Estado
SIRE (TXT de reemplazo del RVIE y del RCE) listo
CONCAR (Excel de asientos) listo, con un mes real importado
CONTASIS (registro de compras y de ventas) listo: CONTASIS importó los archivos que genera (13-sep-2026)
STARSOFT (asientos) en pruebas — genera los archivos, pero nadie ha importado todavía uno de verdad
SISCONT esperando la plantilla de importación y un archivo aceptado
asiento_neutral y CSV listo: el asiento en el propio estándar, para cualquier ERP

Esa columna dice la verdad a propósito. Un driver que nadie ha importado en su sistema no se anuncia como listo: sería prometer algo que no consta.

Para quién

  • Un estudio contable o una empresa que quiere dejar de digitar y que sus archivos entren a la primera.
  • Un desarrollador que necesita generar asientos peruanos sin reimplementar veinte años de reglas.
  • Un agente de IA que ya sabe leer un PDF, pero necesita un riel determinista donde depositar lo que extrajo.

Qué falta en el ecosistema, y por qué existe esto

El open source contable peruano resolvió la emisión: facturación electrónica, XML UBL, envío a SUNAT. Nadie cubría registrar lo que recibes — el asiento, el registro de compras, el SIRE. Ese es el terreno de ContaPerú, y por eso no compite con lo que ya existe: se enchufa detrás.

Contribuir

Un estándar no lo escribe una persona. Estas son las puertas, y ninguna de las tres primeras pide escribir código:

Si tienes… Abre
Un caso que el motor resuelve mal «Regla mal puesta»
El formato de un sistema que aún no tiene driver «El formato de mi sistema»
Un dato que al estándar le falta «Enmienda»
Ganas de programar CONTRIBUTING.md, la receta de un driver

Y lo que el proyecto necesita ahora mismo, hito por hito, está en «Lo que hay que conseguir».

El estándar crece por enmiendas: una por cambio, cada una con su caso real, su fuente y el test que la sostiene, y con un estado que dice si ya está dentro o sigue esperando un archivo de verdad. Quien implemente el estándar por su cuenta puede comprobarlo contra la batería de conformidad, sin sellos ni tercero que la otorgue.

Se agradece especialmente un caso real que el motor resuelva mal: el comprobante anonimizado, lo que produjo el motor y lo que esperaba tu sistema. Vale más que un parche.

Dos reglas que no se negocian:

  • Ninguna regla contable entra sin su fuente — la norma, la resolución o el archivo real que la justifica. Para corregir una, vale lo mismo.
  • Nunca datos de contribuyentes reales. Ni RUC de empresas que existen, ni razones sociales, ni nombres de personas. Lo que entra en la historia de un repositorio público no sale nunca más.

Licencia MIT. Se dona a la comunidad contable peruana.


In English — Open accounting infrastructure for Peru: read SUNAT's electronic receipts, build the double-entry journal, and export to the local accounting systems (CONCAR, CONTASIS, STARSOFT, SIRE). Includes open-accounting, an open interchange format for Peruvian accounting documents, and an MCP server for AI agents. Docs are in Spanish, the language of the domain; issues in English are welcome.

Popular repositories Loading

  1. contaperu contaperu Public

    Un solo puente entre SUNAT y cualquier sistema contable peruano: estándar abierto y motor.

    Python 1 1

  2. .github .github Public

    El perfil publico de la organizacion ContaPeru

Repositories

Showing 2 of 2 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…