Integración Clientes: Napse - Brigde

Laura_Monroy · 1 Diciembre, 2025 19:46

Esta integración tiene como objetivo igualar la información de Clientes entre los dos sistemas, utilizando la aplicación Deals para recibir la información de Napse-Bridge.

Esto le permitirá a los usuarios tener un monitor en Finnegans para controlar y gestionar los envíos de información y en caso de presentarse un posible error, identificar su causa.

¿Para qué sirve?

Deals recibirá el alta y actualización de Clientes para enviar al Maestro Clientes en el ERP, con el fin de poder operar en ambos sistemas con la información de Clientes correctamente sincronizada.

Antes de empezar

Antes de utilizar esta funcionalidad, es necesario llevar a cabo las siguientes configuraciones:

Configurar Deals

Activar Deals

Como primer paso se debe activar la Empresa en Deals. Si la empresa no está activada, no se dispondrá del CFU (Clave Única Finnegans), la cual es esencial para enviar información y realizar operaciones dentro de Deals.

Menú > Deals > Configurar Empresa:

En “Configurar Empresa” para habilitar la Empresa, generar el CFU y Secret Key, presionar en el botón “Activar”:

Campos:

Razón Social: nombre bajo el cual una empresa está registrada, viene dada por default.
Identificación Fiscal: número único asignado a la Empresa para fines fiscales y de identificación, viene dado por default.
Clave Finnegans Única (CFU): utilizada para recibir información y para operar dentro de Deals.
Secret Key: se genera un Bearer Token para Deals junto con el CFU, por ejemplo, se usan para hacer publicaciones o descargas desde Postman, de forma manual.
Dirección de email: viene dada por default.

En caso de que la Empresa ya esté activada o dada de alta, el botón “Activar” estará bloqueado en color gris, por lo que no podrá interactuar con el:

image602×525 19.3 KB

Para información detalla de Deals puede ingresar a Manual de usuario de Deals

Documento"Clientes"

Este documento público disponible en Deals, permite la creación y actualziación de clientes.

Menú > Deals > Catálogo de documentos:

Buscar el documento “Clientes”:

El Schema JSON será el siguiente:

{
  "Nombre": "",
  "Codigo": "",
  "Activo": false,
  "RazonSocial": "",
  "Email": "",
  "CategoriaFiscal": "",
  "IdentificacionTributaria": "",
  "IdentificacionTributariaNumero": "",
  "EsProveedor": false,
  "Vendedor": "",
  "Direcciones": [
    {
      "Pais": "",
      "Provincia": "",
      "Localidad": "",
      "CodigoPostal": "",
      "Calle": "",
      "NumeroCalle": "",
      "Depto": "",
      "Piso": "",
      "DireccionTipo": ""
    }
  ],
  "Telefonos": [
    {
      "NumeroTipo": "",
      "Numero": ""
    }
  ]
}

Campos Requeridos del Schema “Clientes”:

Nombre
Código
Activo
CategoriaFiscal
IdentificacionTributaria

Detalle de los campos del Schema “Clientes”:

Los datos son tomados de Maestros del ERP. Generalmente, ya están configurados, pero si se desea configurar valores específicos para estos campos, se puede acceder al Maestro y realizar la modificación. Estas son las rutas de acceso:

CategoriaFiscal: Menú > Gestión Empresarial > Impuestos > Maestros > Categorías Fiscales.
IdentificacionTributaria: Menú > Gestión Empresarial > Impuestos > Maestros > Identificación Tributaria.
IdentificacionTributariaNumero: este dato debe respetar la máscara configurada para la Identificación Tributaria, en el Maestro mencionado en el punto anterior. Ejemplo:
- DNI: ##.###.###
- CUIL: ##-########-#
- CUIT: ##-########-#, es decir, 11 digitos separados por dos guiones:
  
  image497×424 19.4 KB
País: Menú > Gestión Empresarial > Contabilidad > Maestros > Países.
Provincia: Menú > Gestión Empresarial > Contabilidad > Maestros > Provincias.
Localidad: Menú > Gestión Empresarial > Contabilidad > Maestros > Localidades.
DireccionTipo: se completa de la siguiente forma de acuerdo al Tipo de Dirección:
- Otro > Código ERP = 0
- Fiscal > Código ERP = 1
- Comercial > Código ERP = 2
- Legal > Código ERP = 3
- Particular > Código ERP = 4
- Entrega > Código ERP = 5

Al completar los campos País, Provincia, Localidad y DirecciónTipo, estos se visualizan de la siguiente manera en el detalle del Cliente dentro del Maestro en Finnegans:

image514×470 21 KB

Método público de Publicación

URL de publicación: https://go-prod.finneg.com/api/1/deals-back/publicarClientes
Código de método de publicación: postCliente
Recibe la información enviada de Clientes a Deals:

Método público de Descarga

Envía al Maestro Clientes del ERP la información recibida de Clientes en Deals:

Configurar Publicaciones

Menú > Deals > Publicaciones > Publicaciones Propias

Presionando el botón “Nuevo”, completando el campo “Documento = Clientes” y “Metodo de Publicacion = postCliente” se crea el registro de integración.

Publicacion Clientes

Configurar Descargas

Menú > Deals > Descargas > Mis Descargas

Presionando el botón “Nuevo”, completando el campo “Documento = Clientes” y “Metodo de Publicacion = getCliente” se crea el registro de integración.

Descarga Clientes

En la descarga se deberá configurar el origen permitido para el método de publicación anteriormente configurado y los parámetros “Concepto_Cliente” y “Cuenta_Ciente” que harán posible transaccionar en el ERP con los Clientes creados mediante la integración.
- Solapa “Parámetros Públicos”: los parámetros “Concepto_Cliente” y “Cuenta_Ciente” vienen datos por defecto, el campo “Valor” es configurable. Estos datos se deben tomar de los Maestros “Conceptos de Organizaciones” y “Cuentas”, respectivamente:
  
  image1892×787 22 KB
- Solapa “Orígenes Permitidos”: se selcciona el código del método de publicación anteriormente configurado:
  
  image1870×785 21.4 KB

Para acceder a los maestros de “Conceptos de Organizaciones” y “Cuentas”, seguir las siguientes rutas:

Menú > Gestion Empresarial > Contabilidad > Maestro > Cuentas
Menú > Gestion Empresarial > Contabilidad > Maestro > Conceptos de Organización

Configurar Sinónimos

Los sinónimos en Deals permiten transformar automáticamente valores específicos de los campos de las transacciones recibidas. Esto se realiza asignando “Sinónimos” a estos valores codificados, facilitando la estandarización y procesamiento de la información en el sistema.

Menú > Deals > Sinónimos

Presionando el botón “Nuevo Sinónimo” y completando los campos de la siguiente forma:
A modo de ejemplo se configura el campo “CategoriaFiscal”, donde Deals recibe el valor “IVA Responsable Inscripto” y lo transforma en el valor del Maestro del ERP para este tipo de categoría fiscal, el cual es igual a “RI”:
- Origen: Código del método
- Campo: CategoriaFiscal
- Valor: IVA Responsable Inscripto
- Función: Igual
- Sinónimo: RI

Se puede hacer más de una configuración de sinónimo por campo. Esto permite que cuando Deasl reciba información distinta a la disponible en los maestros del ERP, se transforme el dato y se realice el envío de forma correcta.

Campos disponibles del JSON “Clientes” para ser configurados como Sinónimos:

Estos son los campos a los cuales se les podría asignar un sinónimo:

CategoriaFiscal
IdentificacionTributaria
Vendedor
Direcciones.Pais
Direcciones.Provincia
Direcciones.Localidad
DireccionTipo

Modo de uso

Obtener Token de Autenticación de Deals

Con la CFU y Secret Key se puede obtener el Token de Autenticación para realizar los envos a la URL de Publicación.

URL Token: https://go-prod.finneg.com/api/1/deals-back/authenticate

En Postman lo obtenemos de la siguiente forma:

Utilizando un método POST en Postman, se deberá enviar el siguiente Body:

{
"cfu": "CFU",
"secretKey":"SecretKey"
}

Con lo anterior se obtiene un Token:

{
    "jwttoken": "token"
}

Este es el token que se debe utilizar en los envíos que se realicen a la URL de Publicación en Deals.

Enviar la creación y actualización de Clientes a la URL de Publicación de Deals

Después de configurar todo lo explicado anteriormente, para utilizar la integración solamente se debe crear o actualizar cualquier Cliente haciendo el envío a la URL de Publicación y verificar en el Monitor de “Mis Descargas” en Deals que el registro se haya enviado correctamente o no al Maestro de Clientes en Deals.

Si los registros ingresan bien a Finnegans, se debe visualizar en la columna “Estado” el valor SUCCESS.
Si el registro quedó con error y no pudo ingresar a Finnegans, se debe visualizar en la columna “Estado” el valor ERROR.

Creación de Cliente:

En Postman posicionarse en la solapa “Authorization”, en “Auth Type” seleccionar “Bearer Token” y completar el Token obtenido anteriormente:

image1438×278 20.1 KB

Importante: ademas del schema JSON que contiene los campos para la creacion o actualizacion del Cliente, siempre se debe completar para cada cliente el siguiente head, que contiene el CFU de la Empresa y el origen, correspondiente al codigo de Publicacion de Deals:

{
        "head": {
            "CFUtoList": [
                "CFU"
            ],
            "externalIdentification": "Prueba",
            "origin": "postCliente"
        },

En Postman se ejecuta un POST y se envía la creación de un cliente, ejemplo JSON:

[
    {
        "head": {
            "CFUtoList": [
                "3891154827644175555"
            ],
            "externalIdentification": "PruebaClienteDeals5",
            "origin": "postCliente"
        },
        "document": {
            "Nombre": "CLT Deals 5",
            "Codigo": "CD5",
            "Activo": true,
            "RazonSocial": "CLT Deals 5",
            "Email": "cd5@gmail.com",
            "CategoriaFiscal": "CF",
            "IdentificacionTributaria": "SINIDENTIFICACION",
            "IdentificacionTributariaNumero": "",
            "EsProveedor": false,
            "Vendedor": "",
            "Direcciones": [
                {
                    "Pais": "Arg",
                    "Provincia": "BSAS",
                    "Localidad": "BSAS_143",
                    "CodigoPostal": "",
                    "Calle": "Dorrego",
                    "NumeroCalle": "1234",
                    "Depto": "",
                    "Piso": "",
                    "DireccionTipo": "2"
                }
            ],
            "Telefonos": [
                {
                    "NumeroTipo": "Celular",
                    "Numero": "12345678"
                }
            ]
        }
    },
    {
        "head": {...

Monitor de Publicaciones:

Ir a los 3 puntos y seleccionar “Ver en el Monitor”:

Los envios fueron correctamente publicados en Deals:

Monitor de Descargas:

Ir a los 3 puntos y seleccionar “Ver en el Monitor”. Las descargas fueron correctas en Deals y la informacion fue enviada al Maestro de Clientes en el ERP:

Maestro de Clientes:

Los clientes se crearon en el Maestro:

Actualización de Cliente

Para actualizar un cliente existente, se realiza nuevamente una solicitud POST desde Postman. En Deals se verifica si el cliente ya existe y, de ser así, se envía al Maestro de Clientes la nueva información recibida. Esta actualización sobrescribe los datos previamente registrados en el maestro.

Información del cliente antes de la actualización:

Envío del JSON con datos modificados:
- También se observa que para el campo “CategoriaFiscal”, se envía el dato "“IVA Responsable Inscripto” y como se valida en el siguiente punto, en el monitor de “Mis Descargas”, el envío de información al ERP fue correcto, por lo que se aplicó el sinonimo “RI”.

Monitor de Publicaciones:

Monitor de Descargas:

Cliente actualizado en el ERP:

Gestión de errores en el Monitor de Deals

Se ejecuta en Postman una solicitud POST, enviando una estructura para el campo “IdentificacionTributariaNumero”, que no corresponde a la mascara configurada en el Maestro del ERP para la Identificación Tributaria CUIT:

Envío del JSON

Monitor de Publicaciones:

Monitor de Descargas:

No es posible hacer el envio a Finnegans, ya que el formato de la mascara para el CUIT, no es correcto, debe ser de la siguiente manera: ##-########-#