Introducción

Este documento es una guía API, anexa al Manual de configuración y uso técnico del Portal de Proveedores Nos Conecta, de Corporate ERP. También se encuentra en formato Word en este link. 

En su uso, tener en cuenta:

• Fue desarrollado a partir de la estructura original de Nos Conecta, a la cual se le agregó una sección correspondiente a su aplicación en Corporate. Por este motivo, se sugiere siempre verificar su vigencia.
• Si bien el mismo detalla los pasos a seguir, no reemplaza el manual de la API disponible en: https://{URL DEL AMBIENTE}/reference/ al que podrá acceder con los siguientes datos de usuario y contraseña:

Datos necesarios para el uso de la API de NosConecta

Nota: El manual online es interactivo y permite la realización de pruebas, devolviendo por cada petición un CURL para uso con cualquier lenguaje. Para avanzar con el desarrollo de la interfaz, VISMA disponibiliza un ambiente de homologación para que se puedan realizar las pruebas pertinentes.

_____________________________________________________________________________________________________________________

Visión general

La API está construida respetando la arquitectura RESTFul, lo cual significa que toda la comunicación se basa en el protocolo HTTP. En la misma, se realizan distintas peticiones que se encargarán de responder el servidor, proporcionando una respuesta con un formato específico. 

El formato de respuesta respeta las cabeceras propias del protocolo, que varían según sea un resultado positivo o negativo, y el mensaje en el cuerpo del mismo tendrá formato JSON, con la codificación UTF-8.

Configuración inicial

1. Login en la API:

• Enpoint: GET/auth
• Parámetros:

• user: usuario asignado
• password: *la clave del usuario

• El endpoint devolverá un JWT con vigencia de 12hs, que deberá ser utilizado para realizar todas las peticiones requeridas.

2. Nuevo registro maestro de Proveedores: 

Pasos requeridos para dar de alta un usuario nuevo:

• Endpoint: POST/autocomplete
• Parámetros:

• valueToSearch: CUIT del proveedor
• assocValue: JSON con datos del proveedor*
• field: ID campo
• idapp: Id de la aplicación

* JSON de ejemplo: 

{"razon_social":"ZETECH SA","numero_proveedor":"778899"}

** El JSON con los valores de los proveedores, depende de la estructura del maestro definida en el alcance de la implementación. Una vez definido el alcance, se estará compartiendo el JSON definitivo.

JSON resultante:

El resultado de este GET será un JSON con la estructura de los campos de las aplicaciones a las que tiene acceso el usuario.

3. Editar registro maestro Proveedores:

Pasos requeridos para modificar un registro del maestro Proveedores:

• Endpoint: PUT/autocomplete/{idapp}
• Parámetros:

• idapp: Id de la aplicación
• valueToSearch: CUIT del proveedor
• assocValue: JSON con datos del proveedor*
• field: ID campo

_____________________________________________________________________________________________________________________

Configuración en Calipso

Alta de Proveedores

Función

fProveedorNosConecta

Uso de la función

Permite sincronizar y dar de alta los proveedores en Nos Conecta.

Argumentos 

1. PROVEEDOR: es el proveedor que se requiere sincronizar. 

2. CUENTAECOMERCE: es la cuenta ECommerce que contiene los datos de conexión. 

3. ACCION: string para indicar la acción que se requiere ejecutar “alta” y “editar”.

4. CODIGOCONFIGURACION: es el código de la configuración auxiliar con los datos de conexión del endpoint:

• Código Externo: es el id de aplicación en Nos Conecta. 
• URL Externa: es la url del endPoint.

Ejemplo del llamado a la función

call fProveedorNosConecta(oProveedor, oCuenta, "alta", "04")

____________________________________

#CorporateERP #NosConecta