Bandeja Entrada de Asientos

La API «Bandeja de Entrada de Asientos» facilita una interacción segura y eficiente con asientos contables importados que se hallan en la bandeja de entrada. Estos asientos están sujetos a procesos de validación e importación final dentro del sistema de contabilidad de una empresa. La interfaz se puede acceder siguiendo la ruta Herramientas > Bandeja de Entrada en el módulo de Contabilidad.

URL

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

Método Query

• Filtros:
  1. IdDesde y IdHasta: Estos campos numéricos definen el rango secuencial de los asientos a considerar.
  2. FechaDesde y FechaHasta: Establecen el rango temporal en el que se desean consultar los asientos.
  3. TipoAsiento: Se refiere a un tipo específico de asiento contable ya existente en el sistema de la empresa.
  4. Origen: Este campo identifica el origen del asiento. Se admite una serie de valores como API, AsCMP, Excel, etc., que determinan si el asiento ha sido generado automáticamente desde diferentes módulos o importado desde ciertos formatos.
  5. Validado: Indica si el asiento ha pasado por un proceso de validación; los valores posibles son ‘S’ para sí y ‘N’ para no.
  6. Page: Es un parámetro obligatorio que controla la paginación de los resultados, mostrando 500 registros por página.
• Resultado:
  • Los campos que se pueden obtener como resultado incluyen Id, Fecha, TipoAsiento, Concepto, Moneda, TipoCambio, RUT, Contacto, Cuenta, Importe, DebeHaber, CentroCostos, Referencia, Local, LiteralTributario, Origen, Validado y Error.

Método Save

El método Save es una operación crucial en la API «Bandeja de Entrada de Asientos», permitiendo la inserción o actualización de asientos contables.

Datos

• RegistroId: Este campo numérico debe enviarse con un valor cero. Actúa como un marcador de posición para nuevos asientos.
• AsientoId: Este número secuencial identifica de manera única un asiento. Es el valor que se debe usar para enviar los datos de los componentes Debe y Haber de un asiento específico.
• Fecha: Formato en que debe ingresarse la fecha del asiento (AAAA-MM-DD).
• TipoAsiento: Código de texto de tres caracteres que identifica el tipo de asiento contable.
• Concepto: Este campo se usa para describir el concepto del asiento.
• Moneda: Representa el código numérico de la moneda en la que se ha efectuado el asiento.
• TipoCambio: Valor numérico que representa la tasa de cambio especial aplicable.
• RUT: Campo de texto con un máximo de 12 caracteres para registrar el RUT.
• Contacto: Corresponde al código del cliente o proveedor.
• Cuenta: Número que identifica la cuenta contable en el sistema.
• Importe: Valor numérico del importe del asiento, con precisión hasta 12.2 decimales.
• DebeHaber: Indica si el asiento corresponde al Debe o al Haber, con los valores permitidos ‘D’ y ‘H’.
• CentroCostos: Este campo se corresponde con el código del centro de costos establecido en la configuración de la empresa.
• Referencia: Código de referencia que se puede configurar en el sistema de la empresa.
• Local: Código numérico del local dentro de la estructura empresarial.
• LiteralTributario: Este número de tres dígitos corresponde al literal tributario de la cuenta y debe ser consultado con la empresa.

Resultado

• Succeed / Error / Mensaje: El método devuelve uno de estos tres valores, indicando el estado de la operación realizada. ‘Succeed’ indica éxito, ‘Error’ indica fallo y ‘Mensaje’ proporciona información adicional sobre la operación.

Método Load

El método Load es una herramienta esencial para recuperar información de asientos contables ya registrados en la bandeja de entrada. Se utiliza principalmente para realizar consultas precisas y obtener detalles sobre transacciones contables específicas.

Filtros

• RegistroId: Es un número que se corresponde con el valor asignado por ZetaSoftware. Este campo es especialmente útil cuando se necesita acceder a información detallada de un asiento contable particular.

Resultado

Los campos que se pueden recuperar son idénticos a los usados en el método Save, incluyendo RegistroId, AsientoId, Fecha, TipoAsiento, Concepto, Moneda, TipoCambio, RUT, Contacto, Cuenta, Importe, DebeHaber, CentroCostos, Referencia, Local y LiteralTributario.

Método Delete

La inclusión de un método Delete representa un elemento clave para la gestión de la integridad de los datos contables. Este método permite eliminar asientos que ya no son necesarios o que fueron creados por error.

Filtros

• RegistroId: Al igual que en el método Load, el uso de este filtro es vital cuando se necesita suprimir una entrada específica de la bandeja de entrada.

Resultado

• Succeed / Error / Mensaje: Al igual que con el método Save, el método Delete devuelve uno de estos tres valores para indicar el resultado de la operación. Esto provee un mecanismo claro y simple para entender el éxito o el fracaso de la acción de eliminación.