Consultar cartera de efectos

GET /api/common/contabilidad/carteraefectos V4

Descripción

Obtiene los efectos de cartera de cobro o de pago, filtrando opcionalmente por ejercicio, serie de factura y número de efecto. Si se especifica campos (separados por comas), se devuelven únicamente esos campos. Si no se especifica, se devuelven todos los campos.

Parámetros de consulta

Parámetro	Tipo	Requerido	Descripción
tipo	enum	❌	Tipo de cartera: cobros o pagos. Si se omite, se devuelven ambos
ejercicio	int	❌	Filtrar por ejercicio
serieFactura	string	❌	Filtrar por serie de factura
numeroEfecto	int	❌	Filtrar por número de efecto
campos	string	❌	Campos a devolver, separados por comas. Si se omite, se devuelven todos
codigoEmpresa	int	✅ (si es multiempresa)	Código de la empresa

Note

tipo puede ser:

* Cobro
* Pago

Campos disponibles

Si se indica un campo que no existe, la API devuelve un error 400 con la lista de campos disponibles:

codigoEmpresa, movCartera, movPosicion, prevision, numeroEfecto, numeroOrdenEfecto, ejercicio, serieFactura, factura, suFacturaNo, documentoConta, comentario, codigoClienteProveedor, codigoCuenta, contrapartida, codigoCuentaFactura, claseEfecto, codigoTipoEfecto, tipoEfecto, tipoDocumento, codigoComisionista, codigoCanal, codigoProyecto, codigoBanco, codigoAgencia, dc, ccc, iban, referenciaMandato, bancoRemesa, numeroRemesa, fechaEmision, fechaFactura, fechaVencimiento, fechaRemesa, fechaCobroEfecto_, fechaImpagado, codigoDivisa, factorCambio, importeEfecto, importeDivisa, importeCobrado, importePendiente, importeGastos, aceptado, domiciliado, remesable, statusBorrado, statusContabilizado, statusRemesado, statusImpagado, statusRecibido

Ejemplo con filtros

curl -X GET "https://api.tandem.com/api/common/contabilidad/carteraefectos?tipo=Cobro&ejercicio=2026&serieFactura=A&campos=numeroEfecto,factura,codigoClienteProveedor,fechaVencimiento,importeEfecto,importePendiente" \
  -H "Authorization: Bearer tu_access_token"

Respuesta exitosa (200)

{
  "success": true,
  "message": "Efectos de cartera obtenidos correctamente",
  "data": [
    {
      "numeroEfecto": 1520,
      "factura": 345,
      "codigoClienteProveedor": "0000002",
      "fechaVencimiento": "2026-11-30T00:00:00",
      "importeEfecto": 1210.00,
      "importePendiente": 1210.00
    }
  ]
}