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 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

-NIF/DNI Nacional,

02-NIF/IVA ,

03-Pasaporte,

04-Documento origen,

05-Certificado,

06-Otro Documento,

07-No Censado

SI-SII,

No Resto

SellerPartyEntity

Vendedor

No

SellerPartyCorporateName

Razón Social

Si-SII,

No Resto

SellerTaxIdentification

VAT

Si

SellerAddress

Dirección

No

SellerAddressPostCode

Codigo Postal

No

SellerAddressTown

Ciudad

No

SellerAddresProvince

Provincia

No

SellerAddresCountryCode

País

Si-SII, debe ser el código ISO-3166

No Resto

COMPRADOR

BuyerPersonTypeCode

Tipo Persona

F-Fisica, J-Juridica

No

BuyerPersonResidenceTypeCode

Tipo Residencia

-NIF/DNI Nacional,

02-NIF/IVA ,

03-Pasaporte,

04-Documento origen,

05-Certificado,

06-Otro Documento,

07-No Censado

SI-SII,

No Resto

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

Si-SII, debe ser el código ISO-3166

No Resto

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

Ejemplo de Json generado para a3

output.txt
{
	"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"
	}
}

Última actualización