Referencia de herramientas

Estas son las herramientas que tu asistente puede usar con Dux. Todas son de solo lectura.

`facturas`

Consultá las facturas emitidas: cliente, fecha, total y estado. Podés filtrar por cliente (nombre o CUIT), fechas y estado. Si no indicás fechas, se consulta solo el mes en curso. Las notas de crédito y débito no figuran en este listado.

Parámetros

Nombre	Tipo	Requerido	Descripción
`fecha_desde`	string	No	Emitidas desde (yyyy-MM-dd). Sin fechas se consulta solo el mes en curso; si indicás una, indicá también la otra
`fecha_hasta`	string	No	Emitidas hasta (yyyy-MM-dd). Sin fechas se consulta solo el mes en curso; si indicás una, indicá también la otra
`id_cliente`	integer	No	Filtrar por id de cliente
`id_sucursal`	integer	No	Filtrar por id de sucursal
`tipo_comprobante`	string	No	Tipo de comprobante
`letra`	string	No	Letra del comprobante (A, B, C...)
`punto_venta`	string	No	Punto de venta
`nro_comprobante`	integer	No	Número de comprobante
`estado`	string	No	EMITIDA, ANULADA o VENCIDA
`trae_detalles`	boolean	No	true para incluir los ítems de cada factura. La respuesta es más extensa.
`empresa`	string o integer	No	Nombre (parcial) o id de la empresa. Opcional si la cuenta tiene una sola.
`offset`	integer	No	Registros a saltear para pedir la página siguiente.
`limit`	integer	No	Registros por página (máximo 50, default 50).
`cliente`	string	No	Nombre, apellido o razón social (parcial), o CUIT/documento (con o sin guiones). Si coincide con varios clientes se devuelven candidatos para elegir; o pasá id_cliente.

Ejemplo de pregunta

¿Qué facturas le hice a Pérez en enero?

Características

Solo lectura: sí
Modifica datos: no
Repetible sin efectos: sí
Consulta sistemas externos: no

`pedidos`

Consultá los pedidos de venta de un período, con cliente, estado y total. Indicá siempre el rango de fechas. Podés filtrar por cliente, sucursal, estado y fecha de entrega.

Parámetros

Nombre	Tipo	Requerido	Descripción
`fecha_desde`	string	Sí	Pedidos desde (yyyy-MM-dd)
`fecha_hasta`	string	Sí	Pedidos hasta (yyyy-MM-dd)
`id_cliente`	integer	No	Filtrar por id de cliente
`id_sucursal`	integer	No	Filtrar por id de sucursal
`nro_pedido`	integer	No	Número de pedido
`estado`	string	No	Estado del pedido
`estado_remito`	string	No	Estado del remito
`anulado`	boolean	No	true solo anulados, false solo vigentes
`fecha_entrega_desde`	string	No	Entrega desde (yyyy-MM-dd)
`fecha_entrega_hasta`	string	No	Entrega hasta (yyyy-MM-dd)
`empresa`	string o integer	No	Nombre (parcial) o id de la empresa. Opcional si la cuenta tiene una sola.
`incluir_detalles`	boolean	No	true para incluir los ítems de cada registro. La respuesta es más extensa.
`offset`	integer	No	Registros a saltear para pedir la página siguiente.
`limit`	integer	No	Registros por página (máximo 50, default 50).

Ejemplo de pregunta

¿Qué pedidos de venta tengo para entregar esta semana?

Características

Solo lectura: sí
Modifica datos: no
Repetible sin efectos: sí
Consulta sistemas externos: no

`compras`

Consultá los comprobantes de compra: proveedor, fecha, montos y estado de recepción. Podés filtrar por proveedor, fechas, estado y pagos pendientes. Si no indicás fechas, se consulta solo el mes en curso.

Parámetros

Nombre	Tipo	Requerido	Descripción
`fecha_desde`	string	No	Compras desde (yyyy-MM-dd). Sin fechas se consulta solo el mes en curso; si indicás una, indicá también la otra
`fecha_hasta`	string	No	Compras hasta (yyyy-MM-dd). Sin fechas se consulta solo el mes en curso; si indicás una, indicá también la otra
`id_sucursal`	integer	No	Filtrar por id de sucursal
`id_proveedor`	integer	No	Filtrar por id de proveedor
`cuit`	string	No	CUIT del proveedor
`nro_comprobante`	string	No	Número de comprobante
`estado`	string	No	EMITIDA o ANULADA
`tipo_comprobante`	string	No	Tipo de comprobante
`estado_recepcion`	string	No	Estado de recepción
`pago_pendiente`	boolean	No	true solo con pago pendiente
`incluir_detalle`	boolean	No	true para incluir ítems y percepciones. La respuesta es más extensa.
`empresa`	string o integer	No	Nombre (parcial) o id de la empresa. Opcional si la cuenta tiene una sola.
`offset`	integer	No	Registros a saltear para pedir la página siguiente.
`limit`	integer	No	Registros por página (máximo 50, default 50).

Ejemplo de pregunta

¿Qué compras de este mes tienen el pago pendiente?

Características

Solo lectura: sí
Modifica datos: no
Repetible sin efectos: sí
Consulta sistemas externos: no

`items`

Consultá tus artículos: código, rubro, marca, costo, precios por lista y stock por depósito. Podés filtrar por código, rubro, marca o proveedor. El costo se muestra solo si tu perfil tiene permiso.

Parámetros

Nombre	Tipo	Requerido	Descripción
`cod_item`	string	No	Código del artículo
`id_rubro`	integer	No	Filtrar por rubro
`id_sub_rubro`	integer	No	Filtrar por sub-rubro
`id_proveedor`	integer	No	Filtrar por proveedor
`id_lista_precio`	integer	No	Devolver solo el precio de esta lista
`id_deposito`	integer	No	Devolver solo el stock de este depósito
`codigo_marca`	string	No	Código de marca
`tipo_item`	string	No	Tipo de artículo
`habilitado`	boolean	No	true solo habilitados
`offset`	integer	No	Registros a saltear para pedir la página siguiente.
`limit`	integer	No	Registros por página (máximo 50, default 50).

Ejemplo de pregunta

¿Qué precio tiene el artículo con código ABC123 en cada lista?

Características

Solo lectura: sí
Modifica datos: no
Repetible sin efectos: sí
Consulta sistemas externos: no

`stock`

Consultá el stock de un artículo por depósito, o el de todo un depósito. Indicá el depósito o el código del artículo; si buscás por nombre, indicá también el depósito.

Parámetros

Nombre	Tipo	Requerido	Descripción
`id_deposito`	integer	No	Id del depósito (ver operación depositos)
`cod_item`	string	No	Código del artículo
`item`	string	No	Nombre (parcial) del artículo; requiere id_deposito
`offset`	integer	No	Registros a saltear para pedir la página siguiente.
`limit`	integer	No	Registros por página (máximo 50, default 50).

Ejemplo de pregunta

¿Cuánto stock tengo del artículo ABC123 en cada depósito?

Características

Solo lectura: sí
Modifica datos: no
Repetible sin efectos: sí
Consulta sistemas externos: no

`cobros`

Consultá los cobros (recibos) de un período, con cliente y monto. Indicá siempre el rango de fechas. Podés filtrar por cliente, sucursal y tipo.

Parámetros

Nombre	Tipo	Requerido	Descripción
`fecha_desde`	string	Sí	Cobros desde (yyyy-MM-dd)
`fecha_hasta`	string	Sí	Cobros hasta (yyyy-MM-dd)
`id_cliente`	integer	No	Filtrar por id de cliente
`id_sucursal`	integer	No	Filtrar por id de sucursal
`tipo_comprobante`	string	No	RECIBO o DEVOLUCION
`cuit`	string	No	CUIT del cliente
`anuladas`	string	No	S para incluir cobros anulados, N para excluirlos
`empresa`	string o integer	No	Nombre (parcial) o id de la empresa. Opcional si la cuenta tiene una sola.
`offset`	integer	No	Registros a saltear para pedir la página siguiente.
`limit`	integer	No	Registros por página (máximo 50, default 50).

Ejemplo de pregunta

¿Qué cobros registramos ayer?

Características

Solo lectura: sí
Modifica datos: no
Repetible sin efectos: sí
Consulta sistemas externos: no

`empresas`

Listá las empresas de tu cuenta: razón social, categoría fiscal y CUIT.

Parámetros

Nombre	Tipo	Requerido	Descripción
Sin parámetros

Ejemplo de pregunta

¿Qué empresas tengo disponibles en mi cuenta?

Características

Solo lectura: sí
Modifica datos: no
Repetible sin efectos: sí
Consulta sistemas externos: no

`clientes`

Buscá clientes por nombre, razón social o CUIT: contacto, localidad y condiciones por defecto.

Parámetros

Nombre	Tipo	Requerido	Descripción
`id_cliente`	integer	No	Id del cliente
`habilitado`	boolean	No	true solo habilitados
`id_provincia`	integer	No	Filtrar por provincia (ver operación provincias)
`id_localidad`	integer	No	Filtrar por localidad (ver operación localidades)
`empresa`	string o integer	No	Nombre (parcial) o id de la empresa. Opcional si la cuenta tiene una sola.
`offset`	integer	No	Registros a saltear para pedir la página siguiente.
`limit`	integer	No	Registros por página (máximo 50, default 50).
`cliente`	string	No	Nombre, apellido o razón social (parcial), o CUIT/documento (con o sin guiones)

Ejemplo de pregunta

Buscame los datos de contacto de un cliente por su nombre.

Características

Solo lectura: sí
Modifica datos: no
Repetible sin efectos: sí
Consulta sistemas externos: no

`listar_operaciones`

Mostrá las demás consultas disponibles, con sus filtros. Podés filtrar por área o buscar por palabra.

Parámetros

Nombre	Tipo	Requerido	Descripción
`area`	string	No	Filtra por área funcional (opcional).
`buscar`	string	No	Texto a buscar en el id o la descripción (sin distinguir mayúsculas ni acentos); se puede combinar con area.

Ejemplo de pregunta

¿Qué consultas de stock puedo hacer?

Características

Solo lectura: sí
Modifica datos: no
Repetible sin efectos: sí
Consulta sistemas externos: no

`consultar`

Ejecutá una de las demás consultas del catálogo, como presupuestos, remitos, órdenes de compra, pagos a proveedores o gastos.

Parámetros

Nombre	Tipo	Requerido	Descripción
`parametros`	object	No	Parámetros según el schema de la operación.
`operacion`	string	Sí	Id de la operación (ver listar_operaciones).

Ejemplo de pregunta

Mostrame las condiciones de pago habilitadas.

Características

Solo lectura: sí
Modifica datos: no
Repetible sin efectos: sí
Consulta sistemas externos: no

Consultas sin herramienta propia

Se consultan con consultar y se descubren con listar_operaciones. Agrupadas por área:

Ventas

estado_validacion_factura: Estado de validación ante AFIP (CAE) de una factura. Parámetros: id_comp_venta.
presupuestos: Presupuestos de venta de un período. Parámetros: fecha_desde, fecha_hasta, id_cliente, id_sucursal, nro_presupuesto, incluir_anulada, fecha_vencimiento_desde, fecha_vencimiento_hasta.
remitos_venta: Remitos de venta, con estado de facturación. Sin fechas consulta solo el mes en curso. Parámetros: fecha_desde, fecha_hasta, id_cliente, id_sucursal, estado_facturacion, anulado, id_deposito, trae_detalles.
listas_precio_venta: Listas de precio de venta. Parámetros: id_lista_precio_venta.
etiquetas_pedido: Etiquetas disponibles para clasificar pedidos. Parámetros: incluir_eliminadas.
etiquetas_venta: Etiquetas disponibles para clasificar ventas. Parámetros: incluir_eliminadas.

Compras

ordenes_compra: Órdenes de compra, con estado de recepción y facturación. Parámetros: fecha_desde, fecha_hasta, id_sucursal, id_proveedor, estado, estado_recepcion, estado_facturacion, incluir_detalle.
pagos_proveedores: Pagos a proveedores de un período. Parámetros: fecha_desde, fecha_hasta, id_sucursal, id_proveedor, forma_pago, estado.
gastos: Gastos (comprobantes de proveedor sin stock). Sin fechas consulta solo el mes en curso. Parámetros: fecha_desde, fecha_hasta, id_sucursal, id_proveedor, cuit, gasto, estado, tipo_comprobante, pago_pendiente, incluir_detalle.
gastos_servicios: Catálogo de gastos y servicios. Parámetros: item, cod_item, id_rubro, id_sub_rubro, id_proveedor, habilitado.

Stock

depositos: Depósitos de la cuenta. Parámetros: id_deposito.
rubros: Rubros de artículos. Parámetros: id_rubro.
sub_rubros: Sub-rubros de artículos. Parámetros: id_rubro, id_sub_rubro.

Tesoreria

cuentas: Cuentas bancarias y de caja. Parámetros: id_cuenta, nombre, habilitado.
bancos: Bancos. Parámetros: nombre.
monedas: Monedas.

Base

sucursales: Sucursales de la empresa.
proveedores: Proveedores. Parámetros: apellido_razon_social, nro_doc, habilitado.
personales: Personal de la empresa (vendedores, cobradores). Parámetros: id_personal, es_vendedor.
provincias: Lista las provincias, opcionalmente una por id. Parámetros: id_provincia.
localidades: Localidades. Parámetros: localidad, cod_postal, id_provincia, id_localidad.
zonas: Zonas de clientes. Parámetros: nombre.

Configuracion

condiciones_pago: Lista las condiciones de pago configuradas. Parámetros: id_condicion_pago, nombre, habilitado, forma_pago.
percepciones_impuestos: Percepciones e impuestos configurados. Parámetros: id_percepcion_impuesto.
puntos_venta: Puntos de venta de la empresa. Parámetros: nro_pto_vta, tipo_pto_vta.