En este Instructivo se explica cómo efectuar la conexión y realizar el envío de información a través de los distintos web service que provee Finnegans.
Configuraciones previas
Usuario
- Ir al maestro de usuarios, ingresando en Menú → Configuración → General Seguridad → Usuarios.
- Ingresar en Nuevo para cargar los datos de un usuario que se utilizará únicamente para el envío de información a través del web service. El objetivo de esto es, por un lado, que el web service tenga independencia de un usuario físico y, por el otro, que la auditoría de los registros que se reciben por web service quede registrada de forma separada para mayor control.
- Se debe completar:
a) Correo electrónico. Debe existir y ser distinto al de un usuario físico, ya que no se activará en el sistema hasta que se ingrese desde el link que llega al correo registrado.
b) Nombre.
c) Activo. Debe estar la casilla de validación tildada para que el usuario pueda efectuar transacciones a través del web service.
WS Factura de venta
Para el envío de facturas de venta a través del web service de Finnegans se debe tener en cuenta lo siguiente:
- La url es: https://j11.teamplace.finneg.com/BSA/Operacion
- El método a ejecutar para el envío de facturas de venta a Finnegans es POST.
- El body tiene formato xml y la estructura es la siguiente:
<x:Envelope xmlns:x="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:tra="http://TransaccionWS.webServices.bsuite.app/">
<x:Header/>
<x:Body>
<tra:importarTransaccion>
<userName>userName</userName> <!--Correo del usuario -->
<password>password</password> <!--Contraseña del usuario -->
<nombreApp>BSA</nombreApp> <!-- Valor fijo -
<nombreEmpresa>nombreEmpresa</nombreEmpresa> <!--Dominio -->
<codigoEmpresa>codigoEmpresa</codigoEmpresa> <!--Código de la empresa --> <xmlTransaccion><![CDATA[<?xml version = "1.0" encoding = "UTF-8"?>
<Root>
<OperacionXml
ComprobanteExterno="FACVTA-1" <!-- Código único que identifique la
transacción - CondicionPago="10" <!-- Obligatorio. Código de la
condición de pago -->
Descripcion="" <!-- Descripción general del comprobante -->
Fecha="2022-06-08" <!-- Obligatorio. Fecha formato AAAA-MM-DD -->
FechaBaseVencimiento="2022-06-08" <!-- Obligatorio. Fecha a partir de
la que se calcula el vencimiento del documento formato AAAA-MM-DD -->
ListaPrecio="" <!-- Código de la lista de precios de venta -->
Moneda="PES" <!-- Obligatorio. Código de la moneda -->
NumeroDocumento="A-0001-10000000" <!-- Número de documento según máscara de talonario -->
Organizacion="CLIENTE1" <!-- Código del cliente -->
ProvinciaDestino="" <!--Código de la provincia -->
ProvinciaOrigen="" <!--Código de la provincia →
Vendedor="" <!--Código del vendedor -->
TipoDocumento="FACTVENELEC" <!-- Código del tipo de documento -->
Workflow="VENTAS" !-- Código del workflow al que pertenece el documento a crear ComprobanteImpositivo="001"> <!-- Código del tipo de comprobante impositivo --> <Items>
<ItemProducto
Cantidad="10" <!-- Cantidad del producto -->
DepositoDestino="" <!-- Código del depósito de destino -->
DepositoOrigen="" <!-- Código del depósito de origen -->
Descripcion="CAR. MENTA CRISTAL x 925 GRS." <!-- Descripción del ítem de producto -->
Descuento1="0.00"
Descuento2="0.00"
Importe="100.00" <!-- Importe total del ítem de producto (precio por cantidad) --> ImporteExento="0.00" <!-- Importe exento del ítem de producto -->
Precio="10.00" <!-- Precio del producto -->
Producto="624"> <!-- Código del producto -->
</ItemProducto>
<ItemConcepto
Concepto="VENTA_IVA 21" <!-- Código del concepto calculado -->
Importe="21.00" <!-- Importe del concepto calculado -->
ImporteGravado="100.00" <!-- Importe imponible de de la transacción -->
PorcentajeImpuesto="21.00" <!-- Porcentaje aplicable del concepto calculado --> />
<ItemPercepcion
TipoRetencion = "" <!-- Código del tipo de retención -->
ConceptoRetencion ="PERP_IIBBBS" <!-- Código de la retención -->
ComprobanteRetencion = "" <!-- Número de comprobante de la retención --> Importe = "5.12" <!-- Importe de la retención -->
Fecha = "2022-06-08" <!-- Fecha de la retención -->
IdentificacionTributaria =
ISAR = "100.00" <!-- Importe imponible de la transacción -->
Descripcion = "Percepcion IIBB Pcia de Bs As"> <!-- Descripción de la retención --> </ItemPercepcion>
</Items>
<Cotizaciones
Cotizacion="100.00" <!-- Tipo de cambio de la moneda -->
Moneda="DOL" <!-- Código de la moneda -->
/>
</OperacionXml>
</Root>
]]>
</xmlTransaccion>
</tra:importarTransaccion>
</x:Body>
</x:Envelope>
- La respuesta recibida será la siguiente en caso de éxito
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:importarTransaccionResponse xmlns:ns2="http://TransaccionWS.webServices.bsuite.app/"> <return><?xml version="1.0" encoding="UTF-8"?><Operaciones Observaciones="Se leyeron 1 registros"><PuntoVenta NombreTransaccion="FACTVENELEC - 4"
NumeroComprobante="A-0001-10000003" NumeroInterno="4" Resultado="true" comprobanteExterno="12547"/></Operaciones></return>
</ns2:importarTransaccionResponse>
</soap:Body>
</soap:Envelope>
Si no se pudo crear la factura, se recibirá un mensaje de error indicando el problema
WS Punto de venta
Para el envío de punto de venta a través de web service, se debe considerar lo siguiente:
- La url es: https://j11.teamplace.finneg.com/BSA/PuntoVentaW
- El método a ejecutar para el envío de puntos de venta a Finnegans es POST.
- El body tiene formato xml y la estructura es la siguiente
xmlns:tra="http://TransaccionWS.webServices.bsuite.app/">
<x:Header/>
<x:Body>
<tra:importarTransaccion>
<userName>userName</userName> <!-- Correo del usuario -->
<password>password</password> <!-- Contraseña del usuario -->
<nombreApp>BSA</nombreApp> <!-- Valor fijo -
<nombreEmpresa>nombreEmpresa</nombreEmpresa> <!-- Dominio -->
<codigoEmpresa>codigoEmpresa</codigoEmpresa> <!-- Código de la empresa --> <xmlTransaccion><![CDATA[<?xml version = "1.0" encoding = "UTF-8"?>
<Root>
<PuntoVentaXml
ComprobanteExterno="PVF-1" <!-- Código único que identifique la transacción - CondicionPago="10" <!-- Obligatorio. Código de la condición de pago -->
Descripcion="" <!-- Descripción general del comprobante -->
Fecha="2022-06-08" <!-- Obligatorio. Fecha formato AAAA-MM-DD -->
FechaBaseVencimiento="2022-06-08" <!-- Obligatorio. Fecha a partir de la que se calcula el vencimiento del documento formato AAAA-MM-DD -->
ListaPrecio="" <!-- Código de la lista de precios de venta -->
Moneda="PES" <!-- Obligatorio. Código de la moneda -->
NumeroDocumento="A-0010-00005132" <!-- Número de documento según máscara de talonario -->
Organizacion="CLIENTE1" <!-- Código del cliente -->
TipoDocumento="PTOVTA-FV" <!-- Código del tipo de documento -->
Workflow="VENTAS" <!-- Código del workflow al que pertenece el documento a crear ComprobanteImpositivo="001"> <!-- Código del tipo de comprobante impositivo --> <Items>
<ItemProducto
Cantidad="1" <!-- Cantidad del producto -->
DepositoDestino="" <!-- Código del depósito de destino -->
DepositoOrigen="Prueba" <!-- Código del depósito de origen -->
Descripcion="CAR. MENTA x 925 GRS." <!-- Descripción del ítem de producto -->
Descuento1="0.00"
Descuento2="0.00"
Importe="314.16" <!-- Importe total del ítem de producto (precio por cantidad) -->
ImporteExento="0.00" <!-- Importe exento del ítem de producto -->
Precio="314.16" <!-- Precio del producto -->
Producto="624"> <!-- Código del producto -->
</ItemProducto>
<ItemConcepto
Concepto="VENTA_IVA 21" <!-- Código del concepto calculado -->
Importe="21.00" <!-- Importe del concepto calculado -->
ImporteGravado="100.00" <!-- Importe imponible de de la transacción -->
PorcentajeImpuesto="21.00" <!-- Porcentaje aplicable del concepto calculado -->
/>
<ItemPercepcion
TipoRetencion = "" <!-- Código del tipo de retención -->
ConceptoRetencion ="PERP_IIBBBS" <!-- Código de la retención -->
ComprobanteRetencion = "" <!-- Número de comprobante de la retención -->
Importe = "5.12" <!-- Importe de la retención -->
Fecha = "2022-06-08" <!-- Fecha de la retención -->
IdentificacionTributaria =
ISAR = "100.00" <!-- Importe imponible de la transacción -->
Descripcion = "Percepcion IIBB Pcia de Bs As"> <!-- Descripción de la
retención --> </ItemPercepcion>
<ItemBanco
OperacionBancaria="RECEPCHTER" <!-- Código del tipo de operación bancaria -->
Cuenta="BCDPES" <!-- Código de la cuenta contable del banco -->
Importe="314.16" <!-- Importe total de la cobranza en el banco -->
Moneda="PES" <!-- Código de la moneda -->
Chequera = "" <!-- Código de la chequera -->
ChequeNumero = "12345681" <!-- Número de cheque -->
Banco = "00072" <!-- Código de banco -->
CUITLibrador = "20222525641" <!-- CUIT del librador sin guiones -->
FechaCheque = "2022-06-08" <!-- Fecha del cheque -->
FechaVtoCheque = "2017-02-10" <!-- Fecha de vencimiento del cheque -->
BeneficiarioCheque = "" <!-- Beneficiario del cheque
Descripcion="Parte cobrada con cheques" <!-- Descripción del ítem de cobro --> />
<ItemTarjeta
OperacionBancaria = "" <!-- Código del tipo de operación bancaria --> Cuenta = "" <!-- Código de la cuenta contable de la tarjeta -->
Importe = "" <!-- Importe total de la cobranza en la tarjeta -->
Moneda = "" <!-- Código de la moneda -->
Descripcion = "" <!-- Descripción del ítem de cobro -->
Cupon = "" <!-- Número de cupón -->
NroAutorizacion = "" <!-- Número de autorización de la operación en la tarjeta --> Titular = "" <!-- Titular de la tarjeta -->
DocumentoTitular = "" <!--
Número de documento del titular de la tarjeta -->
TarjetaFechaVto = ""> <!-- Fecha de vencimiento de la tarjeta -->
</ItemTarjeta>
<ItemEfectivo
Cuenta = "" <!-- Código de la cuenta contable de efectivo -->
Importe = "" <!-- Importe total de la cobranza en efectivo -->
Moneda = "" <!-- Código de la moneda -->
Descripcion = ""> <!-- Descripción del ítem de cobro -->
</ItemEfectivo>
<ItemOtros
Cuenta = "" <!-- Código de la cuenta contable del cobro o ajuste -->
ImporteDebe = "" <!-- Importe que impacta en el debe -->
ImporteHaber = "" <!-- Importe que impacta en el haber -->
Moneda = "" <!-- Código de la moneda -->
Descripcion = ""> <!-- Descripción del ítem de cobro -->
</ItemOtros>
<ItemRetencion
TipoRetencion = "" <!-- Código del tipo de retención -->
ConceptoRetencion = "" <!-- Código de la retención -->
ComprobanteRetencion = "" <!-- Número de comprobante de la retención --> Importe = "" <!-- Importe de la retención -->
Fecha = "" <!-- Fecha de la retención -->
IdentificacionTributaria =
ISAR = "" <!-- Importe imponible de la transacción -->
Descripcion = ""> <!-- Descripción de la retención -->
</ItemRetencion>
</Items>
<Cotizaciones
Cotizacion="100.00" <!-- Tipo de cambio de la moneda -->
Moneda="DOL" <!-- Código de la moneda -->
/>
</PuntoVentaXml>
</Root>
]]>
</xmlTransaccion>
</tra:importarTransaccion>
</x:Body>
</x:Envelope>