# a3ERP

## Api de conexión:

El objetivo de este documento es suministrar toda la información necesaria para que una empresa que desee que los documentos tratados por la digitalización de CaptoDocs se envien al sistema a3ERP de forma semiautomática ya que lo deja dentro del fichero [SUENLACE.DAT](https://a3responde.wolterskluwer.es/documentos/a3asesor-eco/enlace-contable-de-entrada-suenlace-dat-descripcion-de-registros.html) dentro de la carpeta ENLACE

Debe estar intalado el api y el endpoint en la carpeta donde esta instalado a3ERP y su ubicación será dentro de la carpeta: ?????

Los documentos a tratar se pueden recibir mediante plantillas predefinadas ó sin ninguna predefinición mediante la inteligencia artificial, en este último caso los campos dependerán de la definición del modelo de datos

Para las plantillas se dispone de un entrenador gráfico que nos permite definir los diferentes atributos a utilizar, por defecto el sistema contempla los siguientes:

| Atributo                                         | Descripción                       | Valores                                                                                                                                                             | Requerido                                                  |
| ------------------------------------------------ | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| InvoiceNumber                                    | Nº. del Documento                 |                                                                                                                                                                     | Si                                                         |
| InvoiceSeriesCode                                | Serie facturas                    |                                                                                                                                                                     | No                                                         |
| InvoiceIssueDateOperationsDate                   | Fecha Operación                   | AAAAMMDD                                                                                                                                                            | Si                                                         |
| InvoiceIssueDate                                 | Fecha expedición ó Fecha factura  | AAAAMMDD                                                                                                                                                            | Si                                                         |
| InvoiceCurrencyCode                              | Moneda del documento              | ISO 4127 Alfabñetico)                                                                                                                                               | Si                                                         |
| InvoicePeriodStartDate                           | Periodo desde                     | AAAAMMDD                                                                                                                                                            | No                                                         |
| InvoicePeriodEndDate                             | Periodo hasta                     | AAAAMMDD                                                                                                                                                            | No                                                         |
| InvoiceDescription                               | Descripción                       |                                                                                                                                                                     | No                                                         |
| InvoiceTransactionReference                      | Referencia                        |                                                                                                                                                                     | No                                                         |
| InvoiceContractReference                         | Referencia contrato               |                                                                                                                                                                     | No                                                         |
| TotalInvoiceAmount                               | Total Factura                     |                                                                                                                                                                     | Si                                                         |
| InvoiceTotalsGrossAmount                         | Total Bruto                       |                                                                                                                                                                     | Si, sin impuestos y sin descuentos                         |
| InvoiceTotalDiscounts                            | Total descuentos                  |                                                                                                                                                                     | No                                                         |
| DiscountRate                                     | % Descuento                       |                                                                                                                                                                     | No                                                         |
| DiscountAmount                                   | Importe descuento                 |                                                                                                                                                                     | No                                                         |
| PaymentsOnAccountDate                            | Fecha pago                        | AAAAMMDD                                                                                                                                                            | No, si no existe se pone la fecha de la factura            |
| PaymentsOnAccounIBAN                             | IBAN                              |                                                                                                                                                                     | No                                                         |
| PaymentsOnAccountNumber                          | Cuenta Bancaria                   |                                                                                                                                                                     | No                                                         |
| PaymentsOnAccountBIC                             | BIC/SWIFT                         |                                                                                                                                                                     | No                                                         |
| **VENDEDOR**                                     |                                   |                                                                                                                                                                     |                                                            |
| SellerPersonTypeCode                             | Tipo Persona                      | F-Fisica, J-Jurídica                                                                                                                                                | No                                                         |
| SellerPersonResidenceTypeCode                    | Tipo Residencia                   | <p>-NIF/DNI Nacional,</p><p> 02-NIF/IVA ,</p><p>03-Pasaporte,</p><p> 04-Documento origen,</p><p> 05-Certificado,</p><p> 06-Otro Documento,</p><p> 07-No Censado</p> | <p>SI-SII, </p><p>No Resto</p>                             |
| SellerPartyEntity                                | Vendedor                          |                                                                                                                                                                     | No                                                         |
| SellerPartyCorporateName                         | Razón Social                      |                                                                                                                                                                     | <p>Si-SII, </p><p>No Resto</p>                             |
| SellerTaxIdentification                          | VAT                               |                                                                                                                                                                     | Si                                                         |
| SellerAddress                                    | Dirección                         |                                                                                                                                                                     | No                                                         |
| SellerAddressPostCode                            | Codigo Postal                     |                                                                                                                                                                     | No                                                         |
| SellerAddressTown                                | Ciudad                            |                                                                                                                                                                     | No                                                         |
| SellerAddresProvince                             | Provincia                         |                                                                                                                                                                     | No                                                         |
| SellerAddresCountryCode                          | País                              |                                                                                                                                                                     | <p>Si-SII, debe ser el código ISO-3166 </p><p>No Resto</p> |
| **COMPRADOR**                                    |                                   |                                                                                                                                                                     |                                                            |
| BuyerPersonTypeCode                              | Tipo Persona                      | F-Fisica, J-Juridica                                                                                                                                                | No                                                         |
| BuyerPersonResidenceTypeCode                     | Tipo Residencia                   | <p>-NIF/DNI Nacional,</p><p> 02-NIF/IVA ,</p><p>03-Pasaporte,</p><p> 04-Documento origen,</p><p> 05-Certificado,</p><p> 06-Otro Documento,</p><p> 07-No Censado</p> | <p>SI-SII, </p><p>No Resto</p>                             |
| BuyerPartyEntity                                 | Vendedor                          |                                                                                                                                                                     | No                                                         |
| BuyerPartyCorporateName                          | Razón Social                      |                                                                                                                                                                     | Si-SII, No Resto                                           |
| BuyerTaxIdentification                           | VAT                               |                                                                                                                                                                     | Si                                                         |
| BuyerAddress                                     | Dirección                         |                                                                                                                                                                     | No                                                         |
| BuyerAddressPostCode                             | Codigo Postal                     |                                                                                                                                                                     | No                                                         |
| BuyerAddressTown                                 | Ciudad                            |                                                                                                                                                                     | No                                                         |
| BuyerAddresProvince                              | Provincia                         |                                                                                                                                                                     | No                                                         |
| BuyerAddresCountryCode                           | País                              |                                                                                                                                                                     | <p>Si-SII, debe ser el código ISO-3166 </p><p>No Resto</p> |
| **DETALLE**                                      |                                   |                                                                                                                                                                     | Sólo si se desea el desglose                               |
| item1                                            |                                   |                                                                                                                                                                     |                                                            |
| DetailAccount                                    | Subcuenta                         |                                                                                                                                                                     | SI                                                         |
| DetailAuxiliary                                  | Auxiliar, tipo centro coste       |                                                                                                                                                                     | Sólo si la cuenta tiene desgloses                          |
| DetailAuxiliaryAuxcod                            | Códido auxiliar ó centro de coste |                                                                                                                                                                     | Sólo si la cuenta tiene desgloses                          |
| DetailArticelCode                                | Codigo Articulo                   |                                                                                                                                                                     | No                                                         |
| DetailUnitOfMessure                              | Unidad de Medida                  |                                                                                                                                                                     | No                                                         |
| DetailUnitPrice                                  | Precio                            |                                                                                                                                                                     | No                                                         |
| DetailUnitQuantity                               | Cantidad                          |                                                                                                                                                                     | No                                                         |
| DetailTotalCost                                  | Importe total                     |                                                                                                                                                                     | Si                                                         |
| DetailDiscounts                                  | Importe descuento                 |                                                                                                                                                                     | No                                                         |
| DetailDiscounRate                                | % descuento                       |                                                                                                                                                                     | No                                                         |
| DetailGrossAmount                                | Importe bruto                     |                                                                                                                                                                     | No                                                         |
| Así hasta un máximo de 20 items.                 |                                   |                                                                                                                                                                     |                                                            |
| **IMPUESTOS**                                    |                                   |                                                                                                                                                                     |                                                            |
| Impuesto 1                                       |                                   |                                                                                                                                                                     |                                                            |
| Tax1Rate                                         | % Impuesto                        |                                                                                                                                                                     | Si                                                         |
| Tax1TaxableBase                                  | Base impuesto                     |                                                                                                                                                                     | No                                                         |
| Tax1TotalAmount                                  | Cuota                             |                                                                                                                                                                     | Si                                                         |
| Así hasta um máximo de 9 impuestos por documento |                                   |                                                                                                                                                                     |                                                            |

Una vez que se haya asignado los correspondientes campos a la plantilla ó al NLU, se tendrán que rellenar los valores necesarios en las diferentes entidades que conforman CaptoDocs.

Inicialmente para cada compañía se deben definir los siguientes conceptos, estos conceptos pueden variar en función del destino final del documento y de la solución a la que se quiera enlazar

{% hint style="info" %}
Ejemplo de Json generado para a3
{% endhint %}

{% code title="output.txt" %}

```markup
{
	"AccountingUser": "ADMIN",
	"Company": "1",
	"Department": "1",
	"Division": "1",
	"Holding": "HOLDING1",
	"Journal": "400",
	"LocalCurrency": "EUR",
	"Monbas": "2",
	"Posting": "1",
	"Token": "4R33vj9EdJHsdaAE74345fDsW",
	"Detail": "1",
	"Impost": "1",
	"Name": "Alquiler local",
	"Pagapu": "1",
	"PaymentAutomatic": "0",
	"PaymentClacre": "03",
	"PaymentOnAccount": "572000003",
	"PaymentOnAccountAuxcod": "",
	"PaymentOnAccountAuxtip": "",
	"SellerAccount": "410000003",
	"SellerAuxiliary": "",
	"SellerAuxiliaryAuxcod": "",
	"SellerConamp": "Alquiler y servicios mes",
	"SellerConcep": "02",
	"Tipfac": "PR",
	"SellerPartyCorporateName": "Alquileres, S.L.",
	"SellerAddress": "Av Diagonal, 1234",
	"SellerAddressPostCode": "08173",
	"SellerAddessTown": "Barcelona",
	"SellerTaxIdentification": "B00000000",
	"SellerEmail": "seller@email.com",
	"SelletTel": "0000000000000",
	"InvoiceNumber": "5158",
	"InvoiceIssueDate": "20190110",
	"BuyerPartyCorporateName": "Empresa, S.L.",
	"BuyerAddress": "Av Diagonal, 1234",
	"BuyesAddressPostCode": "08173",
	"BuyesAddressTown": "Barcelona",
	"BuyerAddressProvince": "Barcelona",
	"BuyerTaxIdentification": "B00000000",
	"Detail1ArticleCode": "Renta Octubre",
	"Detail1TotalCost": "819,30",
	"Detail2ArticleCode": "Gastos Comunes",
	"Detail2TotalCost": "219,59",
	"InvoiceTotalsGrossAmount": "1038,89",
	"Tax1Rate": "21,00",
	"Tax1TotalAmount": "218,17",
	"TotalInvoiceAmount": "1257,06",
	"Detail1": {
		"DetailAccount": "62100001",
		"DetailAuxiliary": "",
		"DetailAuxiliaryAuxcod": "",
		"DetailConamp": "Alquiler",
		"DetailConcep": "02",
		"DetailCurrency": "EUR"
	},
	"Detail2": {
		"DetailAccount": "62100001",
		"DetailAuxiliary": "",
		"DetailAuxiliaryAuxcod": "",
		"DetailConamp": "Suministros",
		"DetailConcep": "02",
		"DetailCurrency": "EUR"
	},
	"Tax1": {
		"TaxAccountTax": "47200000",
		"TaxAuxapu": "0",
		"TaxAuxcod": "",
		"TaxAuxtip": "",
		"TaxClaopr": "",
		"TaxColimp": "1",
		"TaxCurrency": "EUR",
		"TaxLibreg": "SOP",
		"TaxRelaci": "RG",
		"TaxType": "1"
	},
	"TotalInvoice": {
		"TotalInvoiceAccounting": "62100001",
		"TotalInvoiceAuxapu": "0",
		"TotalInvoiceAuxcod": "",
		"TotalInvoiceAuxtip": "",
		"TotalInvoiceCurrency": "EUR"
	}
}
```

{% endcode %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://library.captodocs.com/connect/wolters-kluwer/a3erp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.