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": "[e-mail]",
	"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"
	}
}