Period Status External System Info

Name: PeriodStatusExternalSystemInfo

Este componente de integración permite consultar el estado de los periodos contables y de los sistemas externos asociados, en función del mes y año indicados.

Características principales:

• Consulta el estado de uno o varios periodos contables (abierto/cerrado).
• Retorna información de todos los sistemas externos vinculados a cada periodo.
• Proporciona detalles de cierre: usuario, fecha y hora de cierre.
• Permite filtrar por año específico o por año y mes.
• Los sistemas externos se ordenan automáticamente por código ascendente.

Este componente es útil para verificar el estado de cierre de periodos antes de realizar operaciones contables, validar permisos de contabilización y generar reportes de control de cierre periódico.

Parámetros

NOMBRE	FORMATO	DESCRIPCIÓN	EJEMPLO	REQUERIDO
Year	YYYY	Año base utilizado para la consulta de los períodos contables correspondientes	2024	✅
Month	MM	Mes o período utilizado como filtro para consultar el estado. En caso de no especificarse, el sistema devolverá el estado de todos los periodos del año	11

Request

<AASIS>
    <Context>
        <AccountingEntity>8111</AccountingEntity>
        <Certificate>[Certificado_cliente_de_integración]</Certificate>
    </Context>
    <Component>
        <Name>PeriodStatusExternalSystemInfo</Name>
    </Component>
    <Parameters>
        <PeriodStatusExternalSystemInfoParams>
            <Year>2024</Year>
            <Month>11</Month>
        </PeriodStatusExternalSystemInfoParams>
    </Parameters>
</AASIS>

Response

<Result>
    <PeriodStatusExternalSystemInfoResult>
        <Periods>
            <PeriodWithExternalSystems>
                <Month>11</Month>
                <Year>2024</Year>
                <Status>Closed</Status>
                <ClosedBy>user@mail.com</ClosedBy>
                <ClosedDate>2025-03-07T07:24:26</ClosedDate>
                <ExternalSystems>
                    <ExternalSystemDetail>
                        <ExternalSystemCode>1</ExternalSystemCode>
                        <ExternalSystemName>APS</ExternalSystemName>
                        <Status>Closed</Status>
                        <ClosedBy>user@mail.com</ClosedBy>
                        <ClosedDate>2024-12-16T13:06:27</ClosedDate>
                    </ExternalSystemDetail>
                    <ExternalSystemDetail>
                        <ExternalSystemCode>11</ExternalSystemCode>
                        <ExternalSystemName>DRACMA</ExternalSystemName>
                        <Status>Open</Status>
                        <ClosedBy></ClosedBy>
                        <ClosedDate></ClosedDate>
                    </ExternalSystemDetail>
                    <ExternalSystemDetail>
                        <ExternalSystemCode>60</ExternalSystemCode>
                        <ExternalSystemName>AANS</ExternalSystemName>
                        <Status>Closed</Status>
                        <ClosedBy>user@mail.com</ClosedBy>
                        <ClosedDate>2024-12-16T10:36:05</ClosedDate>
                    </ExternalSystemDetail>
                </ExternalSystems>
            </PeriodWithExternalSystems>
        </Periods>
    </PeriodStatusExternalSystemInfoResult>
</Result>

PeriodStatusExternalSystemInfoResult

Periods (PeriodWithExternalSystems)

Cada periodo contable retorna la siguiente información:

NOMBRE	FORMATO	DESCRIPCIÓN	EJEMPLO
Month	Número	Mes del periodo contable	11
Year	Número	Año del periodo contable	2024
Status	Texto	Estado del periodo: "Open" (abierto) o "Closed" (cerrado)	Closed
ClosedBy	Texto	Usuario que cerró el periodo. Vacío si el periodo está abierto.	user@mail.com
ClosedDate	Fecha	Fecha y hora de cierre del periodo en formato ISO 8601. Vacío si está abierto.	2025-03-07T07:24:26

ExternalSystems (ExternalSystemDetail)

Dentro de cada periodo, se retorna una lista de sistemas externos con la siguiente información:

NOMBRE	FORMATO	DESCRIPCIÓN	EJEMPLO
ExternalSystemCode	Número	Código identificador del sistema externo	1
ExternalSystemName	Texto	Nombre descriptivo del sistema externo	APS
Status	Texto	Estado del sistema externo en el periodo: "Open" (abierto) o "Closed" (cerrado)	Closed
ClosedBy	Texto	Usuario que cerró el sistema externo. Vacío si está abierto.	user@mail.com
ClosedDate	Fecha	Fecha y hora de cierre del sistema externo en formato ISO 8601. Vacío si está abierto.	2024-12-16T13:06:27

Notas Importantes

1. Orden de Resultados:

   • Los periodos se ordenan por año y mes.
   • Los sistemas externos dentro de cada periodo se ordenan por código ascendente.

2. Campos Vacíos:

   • Si un periodo o sistema externo está abierto (Status = "Open"), los campos ClosedBy y ClosedDate estarán vacíos.

3. Filtrado:

   • Si se proporciona Year y Month, se retorna únicamente ese periodo específico.
   • Si solo se proporciona Year, se retornan todos los periodos de ese año.

4. Validación:

   • La entidad contable (AccountingEntity) debe tener acceso configurado al componente.
   • El certificado debe estar registrado y autorizado para la entidad especificada.

Casos de Uso

• Validación antes de contabilización: Verificar si un periodo y sus sistemas externos están abiertos antes de enviar comprobantes.
• Reportes de auditoría: Consultar quién y cuándo se cerraron los periodos y sistemas externos.
• Control de procesos: Monitorear el estado de cierre de múltiples sistemas externos en un periodo determinado.
• Integración con sistemas externos: Permitir que sistemas externos validen permisos de contabilización según el estado del periodo.