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. Loguearse para obtener el token para utilizar la API:

• Enpoint: GET/auth
• Parámetros:
  • user: api_calipso_demo
  • password: *la clave del usuario según el ambiente.
• El endpoint devolverá un JWT con vigencia de 12hs, que deberá ser utilizado para realizar todas las peticiones requeridas.

2. Consultar la estructura de campos de metadata de las aplicaciones:

• Endpoint: GET/metadata/{idact}/structure

• Parámetros:

• idact: 3

• 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. Cargar registros en la aplicación Cuenta Corriente:

• Endpoint: POST/file
• Parámetros:

• idaplicacion: 2873
• archivo: no aplica*
• datos: JSON con los nombres de los campos y los valores a cargar

• JSON de ejemplo de carga de una Cuenta corriente

{"cuit": "01234567890","numero_de_documento": "1234A12341236","tipo_de_documento": "Factura","fecha_documento": "01/12/2020","importe": "111,22","moneda": "ARG","estado": "Aprobado para pago","numero_de_pago": "888"}

4. Cargar registros en la aplicación Orden de pago:

• Endpoint: POST/file
• Parámetros:

• idaplicacion: 2874
• archivo: Archivo a cargar
• datos: JSON con los nombres de los campos y los valores a cargar

{"cuit": "01234567890","fecha_de_pago": "12/12/2020","importe": "111,22","moneda": "ARG","forma_de_pago": "Transferencia Bancaria","numero_de_pago": "889"}

5. Cargar registros en la aplicación Retenciones:

• Endpoint: POST/file
• Parámetros:

• idaplicacion: 2875
• archivo: Archivo a cargar
• datos: JSON con los nombres de los campos y los valores a cargar}

{"cuit": "30691323958","numero_de_retencion": "0031-00002368","importe": "3287,56","moneda": "ARS","tipo": "Ingresos Brutos C.A.B.A.","numero_de_pago": "887"}

6. Cargar registros en la aplicación Orden de compra / Recepción:

• Endpoint: POST/file
• Parámetros:

• idaplicacion: 2877
• archivo: no aplica*

Datos: JSON con los nombres de los campos y los valores a cargar

{

"cuit": "01234567890",

"comprador": "Juan Pedro",

"numero_de_pedido": "123456",

"numero_de_linea": "1",

"fecha_de_envio": "2021-07-05",

"codigo_de_material": "12",

"descripcion_material": "Tornillos",

"cantidad_disponible_para_facturar": "20",

"cantidad_pedida": "30",

"tipo_operacion": "Mercaderia",

"condicion_de_pago": "1",

"cantidad_entregada": "30",

"monto_disponible_para_facturar": "500",

"cantidad_facturada": "10",

"moneda": "ARG",

"numero_recepcion": "789",

"fecha_de_recepcion": "2021-07-08",

"estado": "Disponible",

"identificador": "123456-1-789"

}

_____________________________________________________________________________________________________________________

Configuración en Calipso

Función de repositorio: 

fCargarDocumentoNosConecta 

Uso de la función:

Permite subir Nos Conecta los diferentes comprobantes.

Argumentos:

1. CUENTAECOMERCE: objeto: es la cuenta ecommerce que contiene todos los datos de conexión.

2. TRANSACCION: es la transacción de la cual se tomarán los datos para sincronizar. 

3. ACCION: indica qué acción se llevará a cabo: 

1. CC: se conformará json de Cuenta Corriente 

2. OP: se generará json de Orden de Pago

3. RET: se genera json de Retenciones 

4. OC: se genera json de orden de compra 

4. CODIGOCONFIGURACION: es el código de la configuración auxiliar que se utilizará con los datos adicionales del endpoint que se requiere ejecutar. 

5. PATHFILE: es el path del archivo que se va a subir a Nos Conecta. 

Ejemplo de uso: 

call fCargarDocumentoNosConecta( oCuenta, oTr, "cc", "07", "" )

Ejemplo con reporte: 

xPath = fGuardarReporteJasper(oTr, "631fd88e-6c29-48e5-a4d0-1b533b5c795e", "") 

call fCargarDocumentoNosConecta( oCuenta, xItemI, "ret", "09", xPath )

Ejemplo de configuración:

____________________________________

#CorporateERP #NosConecta