Chart Of Accounts

Name: ChartOfAccounts

Obtiene el listado del plan de cuentas vigente de la gestión contable asociada a la entidad seleccionada

Request

<AASIS>
  <Context>
    <AccountingEntity>8111</AccountingEntity>
    <Certificate>[Certificado_cliente_de_integración]</Certificate>
  </Context>
  <Component>
    <Name>ChartOfAccounts</Name>
    <Version>1.0</Version>
  </Component>
  <Parameters>
    <ChartOfAccountsParams>
      <AcceptEntries>True</AcceptEntries>
      <AccountingPeriod>012024</AccountingPeriod>
    </ChartOfAccountsParams>
  </Parameters>
</AASIS>

Request Elements

NOMBRE	FORMATO	DESCRIPCIÓN	EJEMPLO	REQUERIDO
AccountingEntity	Texto	Código único de la entidad contable dentro del sistema AASI.net.	8111	✅
Certificate	GUID	Identificador único del certificado de integración asignado al cliente.	1111A-22222B-3333C-444D-5555E	✅
Component/Name	Texto	Nombre del componente a ejecutar, debe ser "ChartOfAccounts".	ChartOfAccounts	✅
Component/Version	Texto	Versión de la API del componente.	1.0
AcceptEntries	Boolean	Filtra cuentas que aceptan lanzamientos contables (true), totalizadoras (false) o todas (vacío).	True
AccountingPeriod	MMYYYY	Período contable para el cual se requiere el plan de cuentas.	012024

Parametros

NAME	FORMATO	DESCRIPTION	EXAMPLE
AcceptEntries	Boolean	Define el tipo de cuenta que desea obtener, se pueden tener tres estados: - True (trae las cuentas que aceptan lanzamientos contables) - False (Trae las cuentas totalizadores) - Vacío (cuando envía este parámetro vacío trae todo el plan de cuentas)	True
AccountingPeriod	MMYYYY	Ingrese el mes y el año en el formato MMYYYY: los dos primeros dígitos corresponden al mes (01 a 12) y los cuatro siguientes al año.	062021

(*) Requisitos y recomendaciones

Estas consideraciones son esenciales para el correcto funcionamiento de la consulta y se derivan del comportamiento observado en el sistema.

1. Período por defecto

   • Si el parámetro AccountingPeriod no se especifica en la solicitud, el sistema utilizará automáticamente el período contable actual de la entidad.

2. Formato del período

   • El valor de AccountingPeriod debe ser estrictamente MMYYYY.
     • Ejemplo válido
       012024 (Enero de 2024)
   • Cualquier otro formato resultará en un error de validación.

3. Configuración del certificado

   • El certificado de integración proporcionado debe:
     • Estar registrado en el sistema.
     • Estar habilitado (Enabled = 1).
     • Tener asignado específicamente el componente ChartOfAccounts.
   • La asignación debe corresponder a la AccountingEntity utilizada.
   • De lo contrario, la solicitud fallará.

4. Período contable abierto

   • La consulta solo será exitosa si el período contable especificado (o el período actual, cuando no se envía el parámetro) se encuentra:
     • Abierto.
     • Disponible en el sistema AASI.net.
   • Esto debe cumplirse para la entidad contable correspondiente.

Response

<Result>
    <ChartOfAccountsResult>
        <ArrayOfAccount>
            <Account>
                <Code>1111001</Code>
                <Name>Caja General</Name>
                <Id>0</Id>
                <IsActive>true</IsActive>
                <Nature>0</Nature>
                <ParentCode>1111000</ParentCode>
                <ParentId>0</ParentId>
                <Restrictions>
                    <BaseEntity>
                        <Code>0A</Code>
                        <Name>Activo y Pasivo o Sin Restrición</Name>
                    </BaseEntity>
                </Restrictions>
                <SubAccountType>
                    <Code>CTB</Code>
                    <Name>Cuenta Bancária</Name>
                    <EnumType>satBankAccount</EnumType>
                </SubAccountType>
            </Account>
            <Account>
                <Code>1111005</Code>
                <Name>Caja Departamentos</Name>
                <Id>0</Id>
                <IsActive>true</IsActive>
                <Nature>0</Nature>
                <ParentCode>1111000</ParentCode>
                <ParentId>0</ParentId>
                <Restrictions>
                    <BaseEntity>
                        <Code>0A</Code>
                        <Name>Activo y Pasivo o Sin Restrición</Name>
                    </BaseEntity>
                </Restrictions>
                <SubAccountType>
                    <Code>D070</Code>
                    <Name>Caja Departamentos</Name>
                    <EnumType>satGeneric</EnumType>
                </SubAccountType>
            </Account>
        </ArrayOfAccount>
    </ChartOfAccountsResult>
</Result>

AccountResult

NOMBRE	FORMATO	DESCRIPCIÓN	EJEMPLO	REQUERIDO
Code	Texto	Código único de la cuenta contable.	1111001	✅
Name	Texto	Nombre descriptivo de la cuenta.	Caja General	✅
Id	Número	Identificador interno de la cuenta.	0
IsActive	Boolean	Indica si la cuenta está activa (true) o inactiva (false).	true
Nature	Número	Naturaleza contable de la cuenta (ej., 0 para Deudora, 1 para Acreedora).	0
ParentCode	Texto	Código de la cuenta padre en la jerarquía del plan de cuentas.	1111000
ParentId	Número	Identificador interno de la cuenta padre.	0
Restrictions	Lista de BaseEntity	Lista de restricciones presupuestarias o contables asociadas a la cuenta.	<BaseEntity><Code>0A</Code><Name>Activo y Pasivo o Sin Restricción</Name></BaseEntity>
SubAccountType	Objeto	Tipo de subcuenta asociado. Contiene los campos Code, Name y EnumType.	<SubAccountType><Code>CTB</Code><Name>Cuenta Bancária</Name><EnumType>satBankAccount</EnumType></SubAccountType>

Restricciones

Antes de realizar la consulta, verifique que el período contable referenciado esté abierto en el sistema AASI.net para la entidad contable especificada y que el certificado de integración esté correctamente configurado.