Ingresar

API Bandeja de Entrada de Asientos

Esta API permite gestionar asientos contables importados en la bandeja de entrada de ZetaSoftware. Los asientos disponibles en esta bandeja están pendientes de validación e importación definitiva dentro del sistema contable.

La bandeja de entrada se encuentra en el sistema en la ruta: Contabilidad > Herramientas > Bandeja de Entrada.

Casos de uso

  • Consultar asientos contables importados antes de su validación.
  • Insertar nuevos asientos desde sistemas externos.
  • Actualizar asientos existentes en la bandeja.
  • Eliminar registros incorrectos o no requeridos.
  • Integrar procesos de importación contable automatizada.

Endpoint del servicio

Requisitos previos

  • Acceso habilitado a la API.
  • Configuración previa de tipos de asiento, cuentas contables y centros de costos en el sistema.
  • Conocimiento de los códigos internos utilizados por la empresa (cuentas, monedas, contactos, etc.).

Método Query

Permite consultar los asientos disponibles en la bandeja de entrada mediante filtros.

Parámetros de entrada

ParámetroTipoObligatorioDescripción
IdDesdeNNoIdentificador inicial del rango de asientos.
IdHastaNNoIdentificador final del rango de asientos.
FechaDesdeFechaNoFecha inicial del rango de consulta.
FechaHastaFechaNoFecha final del rango de consulta.
TipoAsientoT(3)NoCódigo del tipo de asiento contable.
OrigenTNoOrigen del asiento (por ejemplo: API, Excel, AsCMP).
ValidadoT(1)NoIndica si el asiento fue validado (‘S’ / ‘N’).
PageNSíNúmero de página a consultar. Cada página devuelve hasta 500 registros.

Estructura del request

IdDesde
IdHasta
FechaDesde
FechaHasta
TipoAsiento
Origen
Validado
Page

Estructura del response

Id
Fecha
TipoAsiento
Concepto
Moneda
TipoCambio
RUT
Contacto
Cuenta
Importe
DebeHaber
CentroCostos
Referencia
Local
LiteralTributario
Origen
Validado
Error

Campos devueltos

CampoDescripción
IdIdentificador del asiento en bandeja.
FechaFecha del asiento.
TipoAsientoTipo de asiento contable.
ConceptoDescripción del asiento.
MonedaCódigo de moneda.
TipoCambioTipo de cambio aplicado.
RUTIdentificación fiscal asociada.
ContactoCódigo de cliente o proveedor.
CuentaCódigo de cuenta contable.
ImporteImporte del movimiento.
DebeHaberIndica Debe (‘D’) o Haber (‘H’).
CentroCostosCódigo de centro de costos.
ReferenciaReferencia asociada.
LocalCódigo de local.
LiteralTributarioCódigo de literal tributario.
OrigenOrigen del asiento.
ValidadoEstado de validación.
ErrorDetalle de error si el registro presenta inconsistencias.

Método Save

Permite insertar o actualizar asientos contables en la bandeja de entrada.

Parámetros de entrada

CampoTipoObligatorioDescripción
RegistroIdNSíDebe enviarse en 0 para nuevos registros.
AsientoIdNSíIdentificador del asiento para agrupar líneas Debe/Haber.
FechaFechaSíFormato AAAA-MM-DD.
TipoAsientoT(3)SíCódigo de tipo de asiento.
ConceptoTNoDescripción del asiento.
MonedaNSíCódigo de moneda.
TipoCambioNNoTipo de cambio aplicado.
RUTTNoIdentificación fiscal.
ContactoTNoCódigo de cliente o proveedor.
CuentaNSíCuenta contable.
ImporteNSíImporte del movimiento.
DebeHaberT(1)Sí‘D’ o ‘H’.
CentroCostosTNoCódigo de centro de costos.
ReferenciaTNoReferencia adicional.
LocalNNoCódigo de local.
LiteralTributarioNNoCódigo tributario.

Resultado

Succeed
Error
Mensaje

Método Load

Permite recuperar el detalle de un asiento específico.

Parámetro de entrada

  • RegistroId: Identificador del registro.

Resultado

Devuelve los mismos campos definidos en el método Save.

Método Delete

Permite eliminar un asiento de la bandeja de entrada.

Parámetro de entrada

  • RegistroId: Identificador del registro a eliminar.

Resultado

Succeed
Error
Mensaje

Observaciones

  • La API opera sobre asientos en estado previo a la importación definitiva.
  • Los asientos deben ser validados dentro del sistema antes de impactar en contabilidad.
  • La paginación en Query es obligatoria y retorna hasta 500 registros por página.

Consideraciones de integración

  • Se recomienda validar previamente los datos antes de utilizar el método Save.
  • El campo AsientoId debe mantenerse consistente entre líneas Debe y Haber.
  • Controlar el campo Error en Query para detectar inconsistencias.
  • Evitar duplicación de registros gestionando correctamente los identificadores.
API Bandeja de Entrada de Asientos - PreviousAPI Balance ContableNext - API Bandeja de Entrada de AsientosAPI CFEs Recibidos
Compartir

API Bandeja de Entrada de Asientos

O copia el enlace

CONTENIDO