Preguntas frecuentes
¿Qué es la API de Conciliador de Nubceo?
La API del conciliador de Nubceo es parte de Nubceo Connect. Nubceo Connect contiene distintos endpoints. Dentro de estos, se encuentran los endpoints relacionados a las ventas del POS.
¿Qué datos deben considerarse para dicha conexión a la API y la carga de ventas?
Los datos contienen una cabecera de ventas con datos generales de la venta como id y monto, y un detalle de pagos que contiene la forma en que se pagó esa venta, por ejemplo, datos de tarjeta, plataforma externa con la que se pagó y montos relacionados a dicho pago.
Ver la sección API Sales con detalles de los campos a realizar.
¿Con qué frecuencia el Punto de venta debe llamar a la API para cargar transacciones?
Depende del volumen de transacciones. Se sugiere que la carga sea diaria.
Cuando no ingresan datos al Conciliador Nubceo, ¿Cuáles pueden ser las cuasas?
Las causas pueden ser varias. Sin embargo, en general se debe a múltiples errores en los datos provistos al intentar cargar las ventas.
Podrían faltar datos requeridos u obligatorios, como también cargarse datos con valores erróneos o no aceptados, entre otras causas. En estos casos la API devuelve un error y su causa y el cliente debe realizar las correcciones correspondientes en los datos.
En caso de ventas repetidas, la API procesa la carga de ventas no repetidas y finalizado el proceso devuelve un campo que indica aquellas ventas que no se agregaron por ya encontrarse cargadas en Nubceo o por encontrarse repetidas en la petición.
La lógica de control de errores y acciones a tomar en base a estos errores debe agregarse a los llamados que se hagan a la API, es decir, manejarse del lado de la integración que consume los distintos endpoints que expone la API.
En la sección “Api Sales” se describe el detalle de los valores que espera la API y los errores devueltos.