Esta función es la encargada de retornar la configuración para cada campo del catálogo de terceros, dicha configuración es asignada en el sistema ContaPyme / AgroWin en la opción “Configuración” del catálogo de terceros.
Por cada campo retorna: Si es visible, requerido o de solo lectura, valor por defecto, etiqueta, tipo de lista y configuración para las listas.
Nombre parámetro | Tipo | Descripción | Ejemplo |
dataJSON | JSON |
En esta función este parámetro no se utiliza pero se define debido que puede ser requerido para usos futuros en el Agente CP. |
{} |
controlkey | Varchar | Corresponde al keyagente obtenido en el logueo (requerido). | "564654" |
iapp | Varchar | Código que identifica a la aplicación que interactúa con el Agente (requerido) | "1068" |
random | Varchar | Cadena aleatoria que se crea en el lado del cliente, esto con el fin de que las peticiones no sean cacheadas por el navegador Internet Explorer (para aplicaciones web). (Opcional). | "54654" |
Nombre parámetro | Tipo | Descripción |
encabezado | JSON |
Json que contiene en su interior los siguientes datos: resultado (varchar): Retorna true siempre que la petición se ejecute satisfactoriamente. |
respuesta | JSON |
Json que contiene en su interior el objeto “datos”, éste a su vez contiene objetos con las secciones de información del catálogo de terceros, cada una de estas secciones contiene los campos con su respectiva configuración. infobasica (objeto): Corresponde al nombre de cada una de las secciones de información del catálogo de terceros, las secciones son: infobasica, listadirecciones, listacontactos, datosvendedor, lineasproductos, listaeleminvproveedor, listaproductoscomprados. Cada sección contiene objetos con los campos del catálogo de terceros, la llave del objeto es el nombre del campo y su valor contiene la configuración, así: bvisible: Contiene T cuando el campo es visible en el formulario y F cuando no lo es. blectura: Contiene T cuando el campo es de solo lectura (es decir, no se puede modificar) y F cuando no lo es. brequerido: Contiene T cuando el campo es obligatorio en el formulario y F cuando es opcional. etiqueta: contiene el nombre del campo definido por el usuario. Hay algunos campos que permiten configurar su nombre según las necesidades del usuario, en ese caso, este parámetro contendrá el nombre que definió el usuario para el campo. valorpordefecto: valor por defecto configurado por el usuario para el campo.
itdlista: Código identificador del tipo de lista, influye en el tipo de campo que se debe presentar en el formulario. Los tipos son: 0: Edit – Corresponde a una caja de texto normal. 1: Autolista – Cuando la configuración retorne este tipo de lista, se debe llamar la función GetAutoLista de la clase TCatTerceros y enviar el nombre del campo para poder obtener los valores que se deben presentar en el listado, adicionalmente si ncampofiltro (que se describe más adelante) retorna algún valor, al llamar la función GetAutoLista se debe enviar dicho campo de filtro. ncampofiltro: Nombre del campo de filtro que se debe aplicar al obtener la autolista, esto cuando el itdlista es 1. ncatalogo: nombre de la clase de la cual se debe llamar la función GetListaSelección cuando el itdlista es 2. beditable: aplica para cuando el itdlista es 1, cuando contenga F indica que el campo debe ser un combobox (pues el campo corresponde a una tabla de usuario) y cuando contenga T indica que el campo debe ser un combobox editable.
bcaracteresespecialesennit: Contiene T cuando es posible definir caracteres especiales como guión medio “-”, guión bajo “_” y punto “.” en el código del tercero. Contiene F cuando el código del tercero no puede contener ningún carácter especial. separadordigverificacion: Contiene el caracter que se usará para separar el código del tercero y el dígito de verificación en informes y reportes. bapellidotercero: contiene T cuando se debe manejar el nombre y el apellido del tercero en campos independientes, es decir, en el formulario de edición del tercero se debe presentar un campo para ingresar el nombre y otro para ingresar el apellido. Cuando este parámetro contenga F se debe manejar en un solo campo el nombre y el apellido del tercero. ordennombreapellido: Contiene T cuando se debe mostrar primero el campo nombre tercero y luego el campo apellido tercero; y contiene F cuando se debe mostrar primero el apellido y luego el nombre. bverifycupocredito: Contiene T cuando al procesar operaciones que permitan crear cuentas por cobrar, se verifica que el saldo total por cobrar al tercero no exceda el cupo de crédito definido para él. Y contiene F cuando no se realiza dicha verificación bverifyvencimientomaximo: Contiene T cuando al procesar operaciones que permitan crear cuentas por cobrar, se verifica que el vencimiento máximo de las cuentas por cobrar al tercero no exceda el número de días máximo que se puede tardar un tercero para saldar una deuda. qdiasplazocxcparacontado: Cantidad de días de plazo máximo de CxC para considerar el pago como de contado. bactivarcomisiones: contiene T cuando está activado el manejo de comisiones a vendedores, en ese caso, se debe: itdbasecomisionventasdef: Identificador del tipo de base para el cálculo de la comisión en ventas que se da a los vendedores. Los tipos de base son: itdbasecomisionrecaudodef: Identificador del tipo de base para el cálculo de la comisión por recaudo que se da a los vendedores. Los tipos de base son: |
seguridaddedatos | Boolean | Retorna true siempre y cuando se aplique seguridad de datos al obtener la lista de terceros. Si no se aplica seguridad de datos en el catálogo de terceros, este campo no se retornará. |
{ "result":[{ "encabezado":{"resultado":"false","imensaje":"40","mensaje":"Usuario no logueado."}, "respuesta":{"datos":""} }] }