Comprobantes por Cliente

El API de Comprobantes del Cliente ofrece la capacidad de obtener un amplio listado de comprobantes que incluye Venta Crédito, Venta Contado, Nota de Crédito, Devolución Contado, Movimiento de Stock (ejemplo: Remitos, Pedidos), y Recibos de Cobranza emitidos.

URL

• Descripción: https://api.zetasoftware.com/z.apis.asoapcomprobantesclientev1?wsdl
• Servicio: https://api.zetasoftware.com/z.apis.asoapcomprobantesclientev1

Método Query

Este método permite realizar consultas sobre los comprobantes asociados a un cliente específico o a todos los clientes en un período determinado.

Filtros

• ClienteCodigo (T(10)): Código del cliente. Si se deja vacío, la consulta devuelve comprobantes de todos los clientes.
• Mes (MM): Mes del período a consultar. Obligatorio.
• Anio (AAAA): Año del período a consultar. Obligatorio.
• FechaDesde (AAAA-MM-DD): Fecha de inicio para filtrar los comprobantes. Opcional.
• FechaHasta (AAAA-MM-DD): Fecha de fin para filtrar los comprobantes. Opcional.

Resultado

El resultado del método Query se estructura en varias capas que incluyen tanto el encabezado de los comprobantes como las líneas de detalle y las formas de pago asociadas. A continuación, se detallan los componentes clave:

Encabezado

• ComprobanteCodigo (short): Código único del comprobante.
• Serie (string): Serie del comprobante.
• Numero (long): Número del comprobante.
• Fecha (string): Fecha de emisión del comprobante.
• MonedaCodigo (byte): Código de la moneda utilizada en la transacción.
• Cotizacion (double): Cotización de la moneda en la fecha del comprobante.
• ClienteCodigo (string): Código del cliente.
• VendedorCodigo (string): Código del vendedor que generó el comprobante.
• PrecioCodigo (short): Código de la lista de precios aplicada.
• CondicionPagoCodigo (string): Código de la condición de pago.
• DepositoOrigenCodigo (short): Código del depósito de origen.
• DepositoDestinoCodigo (short): Código del depósito de destino.
• CentroCostoCodigo (string): Código del centro de costo asociado.
• ReferenciaCodigo (string): Código de referencia adicional.
• TotalRecibo (double): Monto total del recibo emitido.
• LocalCodigo (short): Código del local donde se emitió el comprobante.
• CajaCodigo (short): Código de la caja registradora utilizada.
• UsuarioCodigo (short): Código del usuario que generó el comprobante.
• ClienteNombre (string): Nombre del cliente.
• ClienteTipoDocumento (string): Tipo de documento del cliente (ej.: CI, RUT).
• ClientePais (string): País del cliente.
• ClienteDocumento (string): Número de documento del cliente.
• ClienteDireccion (string): Dirección del cliente.
• ClienteDepartamento (string): Departamento del cliente.
• ClienteCiudad (string): Ciudad del cliente.
• ClienteCP (string): Código postal del cliente.
• ClienteTelefono (string): Teléfono del cliente.
• ClienteSucursal (short): Código de la sucursal del cliente.
• ClienteEmail (string): Email del cliente.
• ClienteEntrega (string): Lugar de entrega especificado por el cliente.
• CFETipo (short): Tipo de comprobante fiscal electrónico (CFE).
• CFEEstado (byte): Estado del CFE.
• CFEAcuse (byte): Acuse del CFE.
• CFEMensaje (string): Mensaje relacionado con el CFE.
• Notas (string): Notas adicionales sobre el comprobante.

Líneas del Comprobante

Cada comprobante puede contener múltiples líneas que detallan los artículos o servicios facturados. Las propiedades de cada línea incluyen:

• ArticuloCodigo (string): Código del artículo o servicio.
• Concepto (string): Descripción o concepto del ítem facturado.
• Lote (string): Lote del artículo, si aplica.
• Vencimiento (string): Fecha de vencimiento del lote, si aplica..
• Cantidad (double): Cantidad facturada.
• PrecioUnitario (double): Precio unitario del artículo o servicio.
• Descuento1 (double): Primer nivel de descuento aplicado.
• Descuento2 (double): Segundo nivel de descuento aplicado.
• Descuento3 (double): Tercer nivel de descuento aplicado.
• Neto (double): Monto neto después de aplicar descuentos.
• IVA (double): Monto del IVA aplicado.
• Total (double): Monto total de la línea.
• Notas (string): Notas adicionales para la línea específica.

Formas de Pago

Cada comprobante puede estar asociado con varias formas de pago. Las propiedades de cada forma de pago incluyen:

• FormaPagoCodigo (byte): Código de la forma de pago (ej.: efectivo, tarjeta de crédito).
• MonedaPagoCodigo (byte): Código de la moneda en la que se realizó el pago.
• MonedaPagoMonto (double): Monto pagado en la moneda de pago.
• MonedaComprobanteMonto (double): Monto equivalente en la moneda del comprobante pagado.

Consideraciones Adicionales

Se insta a los desarrolladores a hacer un uso prudente de este API para evitar el bloqueo del mismo. Para obtener el conjunto completo de registros para un período específico, se debe utilizar el método Query y dejar vacío el parámetro ClienteCodigo. De esta forma, una única consulta proporcionará todos los resultados pertinentes.

Es crucial que esta consulta esté optimizada para evitar su uso mediante un “cron” o que se ejecute más de una vez al día. Asimismo, se desalienta la ejecución programada del método Query durante horarios comerciales, con el fin de garantizar un rendimiento óptimo.