External Multiple Accounting

Name: ExternalMultipleAccounting

La herramienta de integración es un componente que permite a sistemas externos realizar la contabilización de comprobantes dentro de sistema contable AASI.net. Características principales:

• Recepción de múltiples comprobantes en lote.
• Posibilidad de adjuntar archivos o evidencias en el nivel de comprobante o de ítem, mediante URLs públicas o enlaces de Amazon S3.
• Procesamiento y validación automática de los comprobantes de acuerdo con las reglas contables del sistema.

Este componente garantiza la consistencia de la información, reduce tiempos de integración y optimiza la automatización de los procesos financieros.

Request

<AASIS>
    <Context>
        <AccountingEntity>8311</AccountingEntity>
        <Certificate>[Certificado_cliente_de_integración]</Certificate>
    </Context>
    <Component>
        <Name>ExternalMultipleAccounting</Name>
    </Component>
    <Parameters>
        <ExternalMultipleAccountingParams>
            <ExternalSystem>1</ExternalSystem>
        </ExternalMultipleAccountingParams>
    </Parameters>
    <Content>
        <JournalList>
            <Journal>
                <ItemId>1</ItemId>
                <PostedPeriod>032023</PostedPeriod>
                <JournalDate>19032023</JournalDate>
                <Description>integration test S3</Description>
                <S3Attachments>
                    <Attachment>
                        <BucketName>[bucket_name]</BucketName>
                        <PathTarget>s3://[bucket_name]/iatec.jpg</PathTarget>
                        <FileName>test.jpg</FileName>
                    </Attachment>
                </S3Attachments>
                <ExternalFileUrls>
                    <ExternalFileUrl>
                        <FileName>file1.jpg</FileName>
                        <FileUrl>https://www.tooltyp.com/web.jpg</FileUrl>
                    </ExternalFileUrl>
                </ExternalFileUrls>
                <Items>
                    <Item>
                        <ItemId>1</ItemId>
                        <AccountCode>1111010</AccountCode>
                        <SubAccountCode>111111</SubAccountCode>
                        <FundCode>10</FundCode>
                        <FunctionCode>0000</FunctionCode>
                        <RestrictionCode>0A</RestrictionCode>
                        <EntityValue>77.00</EntityValue>
                        <Description>Test 1</Description>
                        <TransactionDate>19052023</TransactionDate>
                        <Reference>CH - 12323</Reference>
                        <InvoiceNumber>1000801010|12345</InvoiceNumber>
                        <DueDate>1000801010|12345</DueDate>
                        <InvoiceDate>1000801010|12345</InvoiceDate>
                        <S3Attachments>
                            <Attachment>
                                <BucketName>[bucket_name]</BucketName>
                                <PathTarget>s3://[bucket_name]/iatec.jpg</PathTarget>
                                <FileName>test.jpg</FileName>
                            </Attachment>
                            <Attachment>
                                <BucketName>b[bucket_name]</BucketName>
                                <PathTarget>s3://[bucket_name]/TestConNot.jpg</PathTarget>
                                <FileName>test.jpg</FileName>
                            </Attachment>
                        </S3Attachments>
                        <ExternalFileUrls>
                            <ExternalFileUrl>
                                <FileName>file2.jpg</FileName>
                                <FileUrl>https://www.tooltyp.com/imagenes.jpg</FileUrl>
                            </ExternalFileUrl>
                        </ExternalFileUrls>
                    </Item>
                    <Item>
                        <ItemId>2</ItemId>
                        <AccountCode>1111010</AccountCode>
                        <SubAccountCode>111111</SubAccountCode>
                        <FundCode>10</FundCode>
                        <FunctionCode>0000</FunctionCode>
                        <RestrictionCode>0A</RestrictionCode>
                        <EntityValue>-77.00</EntityValue>
                        <Description>Test 2</Description>
                        <TransactionDate>19052023</TransactionDate>
                        <InvoiceNumber>1000801010|12345</InvoiceNumber>
                        <DueDate>1000801010|12345</DueDate>
                        <InvoiceDate>1000801010|12345</InvoiceDate>
                        <S3Attachments>
                            <Attachment>
                                <BucketName>[bucket_name]</BucketName>
                                <PathTarget>s3://[bucket_name]/iatec.jpg</PathTarget>
                                <FileName>test.jpg</FileName>
                            </Attachment>
                        </S3Attachments>
                        <ExternalFileUrls>
                            <ExternalFileUrl>
                                <FileName>file3.jpg</FileName>
                                <FileUrl>https://www.tooltyp.com/ejemplo.jpg</FileUrl>
                            </ExternalFileUrl>
                        </ExternalFileUrls>
                    </Item>
                </Items>
            </Journal>
        </JournalList>
    </Content>
</AASIS>

Parameters

NOMBRE	FORMATO	DESCRIPCIÓN	EJEMPLO
ExternalSystem	YYYY	Identificador del sistema externo.	1

Journal

NOMBRE	FORMATO	DESCRIPCIÓN	EJEMPLO	REQUERIDO
ItemId	Numero	Enumerador de Lote	1	✅
PostedPeriod	Numero	[mes][año] con formato [mm][yyyy]	032023	✅
JournalDate	Numero	[dia][mes][año] con formato [dd][mm][yyyy]	19032023	✅
Description	Numero	Descripcion del lote	Contabilización	✅

Journal Item

NOMBRE	FORMATO	DESCRIPCIÓN	EJEMPLO	REQUERIDO
ItemId	Numero	Enumerador de Lote	1	✅
AccountCode	Texto	Código de cuenta	1111010	✅
SubAccountCode	Texto	Código de subCuenta	111111	✅
FundCode	Texto	Código fondo	10	✅
FunctionCode	Texto	Código departamento	0000	✅
RestrictionCode	Texto	Código restricción	E0	✅
EntityValue	Decimal	Valor del item	12.00	✅
Description	Texto	Descripcion del item	Compra lapiceros	✅
TransactionDate	Numero	[dia][mes][año] con formato [dd][mm][yyyy]	19052025	✅
Guid	Texto	Identificador único	E3FD47A8-96BD-4ED8-BB6B-D353B3875209	✅
InvoiceNumber	Texto	[No_factura]/[No_factura2]	8172638234|3243
DueDate	Numero	Fecha final de pago formato regional [dd]/[mm]/[yyyy]	15/10/2025
InvoiceDate	Numero	Fecha de factura formato regional [dd]/[mm]/[yyyy]	15/10/2025
SendMemo	Bit	Define si se guardara en la tabla DebitCreditMemo	0 or 1

S3Attachments (Opcional)

NOMBRE	FORMATO	DESCRIPCIÓN	EJEMPLO	REQUERIDO
BucketName	Texto	Nombre del bucket	[BucketName]	✅
PathTarget	Texto	Dirección y nombre del archivo	s3://imagen_adjunto1.jpg	✅
FileName	Texto	Nombre del archivo	imagen_adjunto1.jpg	✅

ExternalFileUrls (Opcional)

NOMBRE	FORMATO	DESCRIPTION	EJEMPLO	REQUERIDO
FileName	Texto	Nombre del archivo con extension requerida.	ejemplo.jpg	✅
FileUrl	Texto	Url del archivo (1).	https://www.imagenes.com/image.png	✅

(1) Requisitos y recomendaciones

Este campo permite registrar enlaces de descarga directa (file URLs) que apuntan a archivos almacenados en servicios externos, como Amazon S3, Google Cloud Storage, Azure Blob Storage u otros servidores web. El sistema utiliza estas URLs para acceder directamente al contenido del archivo durante procesos automáticos de importación o validación.

1. Debe ser una URL de descarga directa.

   • Ejemplo válido
     https://s3.amazonaws.com/mi-bucket/archivo.pdf?X-Amz-Algorithm=...
   • Ejemplo No válido
     https://drive.google.com/file/d/abc123/view

2. Debe comenzar con http:// o https://.

   • Asegura que el archivo esté disponible públicamente o con una firma temporal válida (en caso de presigned URLs).

3. Si la URL contiene caracter &, debe reemplazarse por &

   • Motivo: El carácter & tiene un significado especial en XML y puede causar errores al procesar o guardar la información.
     • Ejemplo
       • ❌ Incorrecto:
         https://s3.amazonaws.com/bucket/file.pdf?X-Amz-Date=20251027&X-Amz-Signature=abc
       • ✅ Correcto:
         https://s3.amazonaws.com/bucket/file.pdf?X-Amz-Date=20251027&X-Amz-Signature=abc
   • Si no se realiza este reemplazo, el archivo XML generado podría quedar mal formado, provocando errores en el sistema o rechazo en integraciones externas.

4. Evite caracteres especiales no válidos en XML

   • Los siguientes caracteres deben ser escapados si aparecen en la URL o nombres de archivos:

5. No incluir espacios ni saltos de línea

   • Si el sistema detecta espacios dentro de la URL, estos deben reemplazarse por %20.

6. Verificar que el enlace esté activo

   • Se recomienda probar el enlace en el navegador antes de registrarlo.
   • Si el servidor devuelve 403 (Forbidden), 404 (Not Found) o el archivo no descarga correctamente, el sistema podría rechazarlo.

7. Duración de validez (en caso de URLs firmadas).

   • Si el enlace proviene de un servicio como Amazon S3 con firma temporal (X-Amz-Expires), asegúrese de que la fecha de expiración cubra el tiempo necesario para el procesamiento del archivo.

CARACTER	REEMPLAZO XML
&	&
<	&lt;
>	&gt;
=	&quot;
'	&apos;

Response

<Result>
    <ExternalMultipleAccountingResult>
        <JournalInfo>
            <ItemId>1</ItemId>
            <JournalCode>132</JournalCode>
            <JournalDate>31102022</JournalDate>
            <JournalGuid>b0ca079a-c3ab-4e38-a51e-6edc33361300</JournalGuid>
            <JournalTypeCode>IN</JournalTypeCode>
        </JournalInfo>
    </ExternalMultipleAccountingResult>
</Result>

ExternalMultipleAccountingResult

NOMBRE	FORMATO	DESCRIPTION	EJEMPLO
JournalCode	Texto	Código de lote	132
JournalDate	Número	Fecha de lote con formato [dd][mm][yyyy]	31102022
JournalGuid	Texto	Identificador único	b0ca079a-c3ab-4e38-a51e-6edc33361300
JournalTypeCode	Texto	Código de tipo lote	IN

Restricciones

Antes de realizar la contabilización Verificar que el periodo este abierto en el sistema de aasi.net.