Alta de efectos en cartera

POST /api/common/contabilidad/carteraefectos V4

Descripción

Crea efectos manuales en la cartera de cobros o de pagos. Los datos bancarios, la delegación, el comisionista, la remesa habitual y el tipo de efecto se toman de la ficha del cliente o proveedor si no se indican. Por defecto el efecto se crea sin bloqueo y remesable.

El cuerpo es una lista de efectos, de modo que se pueden dar de alta varios en una sola llamada.

Parámetros de consulta

Parámetro	Tipo	Requerido	Descripción
codigoEmpresa	int	✅ (si es multiempresa)	Código de la empresa

Campos obligatorios *

Campo	Tipo	Requerido	Descripción
tipo	enum	✅	Tipo de cartera: cobro (cliente) o pago (proveedor)
ejercicio	int	✅	Ejercicio del efecto
comentario	string	✅	Comentario del efecto (máximo 40 caracteres)
codigoClienteProveedor	string	✅	Código del cliente o proveedor (debe existir en contabilidad)
fechaEmision	string	✅	Fecha de emisión (YYYY-MM-DD)
fechaVencimiento	string	✅	Fecha de vencimiento. No puede ser anterior a la de emisión
importeEfecto	decimal	✅	Importe del efecto. Debe ser mayor que 0
...		❌	Resto de campos opcionales

Note

tipo puede ser:

* Cobro
* Pago

Valores por defecto

• Si no se indican, codigoCuenta, contrapartida, remesaHabitual, codigoTipoEfecto, criterioIva, idDelegacion, codigoComisionista, codigoCanal y los datos bancarios (codigoBanco, codigoAgencia, dc, ccc, iban, referenciaMandato) se toman de la ficha del cliente o proveedor.
• claseEfecto, tipoEfecto, aceptado, domiciliado, timbres, bloqueo y remesable se toman del tipo de efecto. Si el tipo de efecto no existe, se usa bloqueo = 0 y remesable = -1.
• Si el efecto va asociado a una factura (factura > 0) y no se indica numeroOrdenEfecto, el orden se numera de forma consecutiva a partir del último efecto de esa factura.

Ejemplo con filtros

curl -X POST "https://api.tandem.com/api/common/contabilidad/carteraefectos?codigoEmpresa=9999" \
  -H "Authorization: Bearer tu_access_token" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "tipo": "Cobro",
      "ejercicio": 2026,
      "comentario": "Efecto manual",
      "codigoClienteProveedor": "0000002",
      "fechaEmision": "2026-10-07",
      "fechaVencimiento": "2026-11-30",
      "importeEfecto": 1210.00
    }
  ]'

Cuerpo de la petición

[
  {
    "tipo": "Cobro",
    "ejercicio": 0,
    "comentario": "string",
    "codigoClienteProveedor": "string",
    "fechaEmision": "2026-10-07T00:00:00",
    "fechaVencimiento": "2026-10-07T00:00:00",
    "importeEfecto": 0,
    "serieFactura": "string",
    "factura": 0,
    "numeroOrdenEfecto": 0,
    "codigoDivisa": "string",
    "importeCambio": 0,
    "importeDivisa": 0,
    "tipoRemesa": "string",
    "idDelegacion": "string",
    "codigoComisionista": 0,
    "remesaHabitual": "string",
    "codigoBanco": "string",
    "codigoAgencia": "string",
    "dc": "string",
    "ccc": "string",
    "iban": "string",
    "referenciaMandato": "string",
    "criterioIva": 0,
    "codigoTipoEfecto": 0,
    "codigoCuenta": "string",
    "contrapartida": "string",
    "codigoCanal": "string",
    "codigoDomicilioRecibo": 0,
    "claseEfecto": 0,
    "tipoEfecto": "string",
    "aceptado": 0,
    "domiciliado": 0,
    "timbres": 0,
    "bloqueo": 0,
    "remesable": 0
  }
]

Respuesta

Se devuelve un resultado por cada efecto enviado, en el mismo orden del cuerpo (indice es la posición del efecto en la lista, empezando en 0).

{
  "success": true,
  "message": "Proceso de alta de efectos finalizado",
  "data": [
    {
      "success": true,
      "indice": 0,
      "message": "Efecto de cartera creado correctamente.",
      "numeroEfecto": 1521
    },
    {
      "success": false,
      "indice": 1,
      "message": "El campo 'importeEfecto' es obligatorio y debe ser mayor que 0."
    }
  ]
}