Ingresar

API Tarjetas Recibidas

Esta API permite consultar vouchers ingresados por la empresa, equivalentes a la funcionalidad disponible en Gestión > Comprobantes > Documentos > Tarjetas Recibidas dentro de ZetaSoftware.

La consulta permite filtrar vouchers por estado, período, financiera, cliente, comprobante, moneda, caja y local, facilitando el seguimiento operativo y financiero de tarjetas recibidas.

Casos de uso

  • Consultar vouchers registrados en un período determinado.
  • Filtrar vouchers por estado operativo.
  • Obtener vouchers por financiera, cliente, caja o moneda.
  • Integrar la información de tarjetas recibidas con sistemas externos de control o conciliación.

Endpoint del servicio

Método Query

Permite recuperar un listado paginado de vouchers según los filtros informados.

Requisitos previos

  • Contar con acceso habilitado a la API.
  • Disponer de códigos válidos de local, financiera, cliente, comprobante, moneda y caja, según corresponda.
  • Informar correctamente el período o la fecha a consultar.

Parámetros de entrada

ParámetroTipoObligatorioDescripción
LocalCodigoN(3)SíCódigo del local a consultar.
EstadoT(1)SíEstado del voucher. Valores admitidos: C = En cartera, E = Endosado, D = Depositado, O = Cobrado.
AnioT(4)SíAño del período a consultar, en formato AAAA.
MesT(2)SíMes del período a consultar, en formato MM.
FechaFechaNoFecha específica en formato AAAA-MM-DD. Si se envía vacía, la consulta considera todo el mes informado.
FinancieraCodigoT(3)NoCódigo de la financiera.
ClienteCodigoT(10)NoCódigo del cliente.
ComprobanteCodigoN(3)NoCódigo del comprobante asociado.
MonedaCodigoN(2)NoCódigo de la moneda.
CajaCodigoN(3)NoCódigo de la caja.
PageN(2)SíNúmero de página a consultar.

Estructura del request

LocalCodigo
Estado
Anio
Mes
Fecha
FinancieraCodigo
ClienteCodigo
ComprobanteCodigo
MonedaCodigo
CajaCodigo
Page

Estructura del response

RegistroId
ComprobanteCodigo
ComprobanteNombre
ComprobanteAbreviacion
Fecha
Serie
Numero
FinancieraCodigo
FinancieraNombre
FinancieraAbreviacion
ClienteCodigo
ClienteNombre
Descripcion
TarjetaNumero
TarjetaTitular
PlanPagos
NumeroAutorizacion
MonedaCodigo
MonedaNombre
MonedaSimbolo
MonedaAbreviacion
LocalCodigo
LocalNombre
CajaCodigo
CajaNombre
UsuarioCodigo
UsuarioNombre
RegistroHora
RegistroFecha
Total
Estado
EstadoNombre
EstadoFecha
Notas
IsLastPage

Campos devueltos

CampoDescripción
RegistroIdIdentificador del registro.
ComprobanteCodigoCódigo del comprobante asociado.
ComprobanteNombreNombre del comprobante.
ComprobanteAbreviacionAbreviación del comprobante.
FechaFecha del voucher.
SerieSerie del comprobante.
NumeroNúmero del comprobante o voucher.
FinancieraCodigoCódigo de la financiera.
FinancieraNombreNombre de la financiera.
FinancieraAbreviacionAbreviación de la financiera.
ClienteCodigoCódigo del cliente.
ClienteNombreNombre del cliente.
DescripcionDescripción asociada al registro.
TarjetaNumeroNúmero de la tarjeta asociado al voucher.
TarjetaTitularTitular de la tarjeta.
PlanPagosPlan de pagos asociado.
NumeroAutorizacionNúmero de autorización de la operación.
MonedaCodigoCódigo de moneda.
MonedaNombreNombre de la moneda.
MonedaSimboloSímbolo de la moneda.
MonedaAbreviacionAbreviación de la moneda.
LocalCodigoCódigo del local.
LocalNombreNombre del local.
CajaCodigoCódigo de la caja.
CajaNombreNombre de la caja.
UsuarioCodigoCódigo del usuario que registró la operación.
UsuarioNombreNombre del usuario que registró la operación.
RegistroHoraHora de registro.
RegistroFechaFecha de registro.
TotalImporte total del voucher.
EstadoCódigo de estado del voucher.
EstadoNombreDescripción del estado del voucher.
EstadoFechaFecha asociada al estado actual.
NotasObservaciones o notas del registro.
IsLastPageIndica si la página consultada es la última con datos disponibles.

Ejemplo de request

{
  "LocalCodigo": 1,
  "Estado": "C",
  "Anio": "2026",
  "Mes": "03",
  "Fecha": "",
  "FinancieraCodigo": "",
  "ClienteCodigo": "",
  "ComprobanteCodigo": "",
  "MonedaCodigo": "",
  "CajaCodigo": "",
  "Page": 1
}

Ejemplo de response

[
  {
    "RegistroId": 845,
    "ComprobanteCodigo": 201,
    "ComprobanteNombre": "Voucher tarjeta",
    "ComprobanteAbreviacion": "VOU",
    "Fecha": "2026-03-18",
    "Serie": "A",
    "Numero": 15284,
    "FinancieraCodigo": "001",
    "FinancieraNombre": "Financiera Demo",
    "FinancieraAbreviacion": "FD",
    "ClienteCodigo": "C00045",
    "ClienteNombre": "Cliente Demo S.A.",
    "Descripcion": "Cobro con tarjeta",
    "TarjetaNumero": "****1234",
    "TarjetaTitular": "Cliente Demo S.A.",
    "PlanPagos": "1 cuota",
    "NumeroAutorizacion": "587412",
    "MonedaCodigo": 1,
    "MonedaNombre": "Pesos Uruguayos",
    "MonedaSimbolo": "$",
    "MonedaAbreviacion": "UYU",
    "LocalCodigo": 1,
    "LocalNombre": "Casa Central",
    "CajaCodigo": 1,
    "CajaNombre": "Caja Principal",
    "UsuarioCodigo": "ADM",
    "UsuarioNombre": "Administrador",
    "RegistroHora": "16:10:22",
    "RegistroFecha": "2026-03-18",
    "Total": 3250.00,
    "Estado": "C",
    "EstadoNombre": "En cartera",
    "EstadoFecha": "2026-03-18",
    "Notas": "",
    "IsLastPage": "true"
  }
]

Observaciones

  • La consulta requiere informar local, estado, año, mes y página.
  • Si Fecha se envía vacía, el resultado considera todo el mes informado.
  • El campo IsLastPage permite determinar si existen más páginas disponibles para consultar.

Consideraciones de integración

  • Se recomienda recorrer páginas sucesivas hasta que IsLastPage indique fin de resultados.
  • Validar los códigos de estado antes de automatizar filtros.
  • Usar filtros por financiera, cliente, moneda o caja para reducir volumen de datos cuando sea necesario.
  • Verificar consistencia entre Estado, EstadoNombre y EstadoFecha en procesos de conciliación o seguimiento.
API Tarjetas Recibidas - PreviousAPI Stock ActualNext - API Tarjetas RecibidasAPI Eliminar Remitos
Compartir

API Tarjetas Recibidas

O copia el enlace

CONTENIDO