Cartera avanzada: cobros, pagos y vencimientos en A3ERP

Los endpoints avanzados de cartera te permiten gestionar el ciclo de vida completo de los vencimientos: cobrarlos, pagarlos, recibirlos, enviarlos, bloquearlos, devolverlos, imputar gastos y anular cualquiera de estas operaciones. Además, puedes ligar o desligar conjuntos de efectos de cartera a facturas concretas, todo desde una misma interfaz REST.

El parámetro numcartera es el campo numcartera que devuelven las consultas de anticipos. El parámetro numvencimiento es el número secuencial del vencimiento dentro de ese conjunto de efectos.

Todos los endpoints siguen el patrón:

PUT https://api.appcloud.es/api/cartera/{accion}/{numcartera}/numvencimiento/{numvencimiento}

Parámetros de ruta comunes

string

required

Número identificador del conjunto de efectos de cartera.

string

required

Número del vencimiento dentro del conjunto de cartera indicado.

Cobrar vencimiento

Registra el cobro de un efecto de cartera de cliente. El importe cobrado no tiene que coincidir necesariamente con el importe del vencimiento.

PUT https://api.appcloud.es/api/cartera/cobrar/{numcartera}/numvencimiento/{numvencimiento}

Cuerpo de la petición (application/json)

string

Indica si el cobro debe generar repercusiones contables (T) o no (F).

string

Indica si es un cobro al descuento (T) o no (F).

string

Importe que se cobra. No tiene que coincidir con el del vencimiento.

string

Número de cuenta bancaria.

string

Número de cuenta de deudas por efectos al descuento del banco.

string

Fecha del cobro (formato DD/MM/YYYY).

string

Fecha valor del cobro (formato DD/MM/YYYY).

string

Código del banco.

string

Tipo de cambio entre la moneda del cobro y la moneda principal.

string

Cuenta contable de gastos del cobro.

string

Gastos imputados al cobro.

string

Centro de coste 1.

string

Centro de coste 2.

string

Centro de coste 3.

string

Número de documento del asiento contable.

Ejemplo de petición

PUT /api/cartera/cobrar/{numcartera}/numvencimiento/{numvencimiento} HTTP/1.1
Host: api.appcloud.es
Authorization: Bearer {token}
Content-Type: application/json

{
  "repcon": "T",
  "descue": "F",
  "importe": "500",
  "numcta": "57200008"
}

Respuesta 200

Vencimiento cobrado exitosamente

Pagar vencimiento

Registra el pago de un efecto de cartera de proveedor.

PUT https://api.appcloud.es/api/cartera/pagar/{numcartera}/numvencimiento/{numvencimiento}

Cuerpo de la petición (application/json)

string

Indica si el pago debe generar repercusiones contables (T) o no (F).

string

Importe que se paga. No tiene que coincidir con el del vencimiento.

string

Número de cuenta bancaria.

string

Fecha del pago (formato DD/MM/YYYY).

string

Fecha valor del pago.

string

Código del banco.

string

Tipo de cambio entre la moneda del pago y la moneda principal.

string

Cuenta de gastos del pago.

string

Gastos imputados al pago.

string

Centro de coste 1.

string

Centro de coste 2.

string

Centro de coste 3.

string

Número de documento del asiento contable.

Ejemplo de petición

PUT /api/cartera/pagar/{numcartera}/numvencimiento/{numvencimiento} HTTP/1.1
Host: api.appcloud.es
Authorization: Bearer {token}
Content-Type: application/json

{
  "repcon": "T",
  "importe": "500",
  "numcta": "57200008"
}

Respuesta 200

Vencimiento pagado exitosamente

Recibir vencimiento

Marca un vencimiento de cartera de cliente como recibido físicamente (p. ej., recepción de un pagaré o cheque).

PUT https://api.appcloud.es/api/cartera/recibir/{numcartera}/numvencimiento/{numvencimiento}

Cuerpo de la petición (application/json)

string

Indica si la recepción debe generar repercusiones contables (T/F).

string

Fecha de la recepción (formato DD/MM/YYYY).

string

Fecha valor de la recepción.

string

Número de documento del asiento contable.

Ejemplo de petición

PUT /api/cartera/recibir/{numcartera}/numvencimiento/{numvencimiento} HTTP/1.1
Host: api.appcloud.es
Authorization: Bearer {token}
Content-Type: application/json

{
  "repcon": "T",
  "fecha": "25/08/2023",
  "numdoc": "125784po62"
}

Respuesta 200

Vencimiento recibido exitosamente

Enviar vencimiento

Marca un vencimiento de cartera de proveedor como enviado (p. ej., envío de una remesa al banco).

PUT https://api.appcloud.es/api/cartera/enviar/{numcartera}/numvencimiento/{numvencimiento}

Cuerpo de la petición (application/json)

string

Indica si el envío debe generar repercusiones contables (T/F).

string

Fecha del envío (formato DD/MM/YYYY).

string

Fecha valor del envío.

string

Número de documento del asiento contable.

Ejemplo de petición

PUT /api/cartera/enviar/{numcartera}/numvencimiento/{numvencimiento} HTTP/1.1
Host: api.appcloud.es
Authorization: Bearer {token}
Content-Type: application/json

{
  "repcon": "T",
  "fecha": "25/08/2023",
  "numdoc": "125784po62"
}

Respuesta 200

Vencimiento enviado exitosamente

Bloquear vencimiento

Bloquea un vencimiento para impedir que sea procesado por otras operaciones. Es el único endpoint de esta sección que usa método GET.

GET https://api.appcloud.es/api/cartera/bloquear/{numcartera}/numvencimiento/{numvencimiento}

No requiere cuerpo en la petición. Ejemplo de petición

GET /api/cartera/bloquear/{numcartera}/numvencimiento/{numvencimiento} HTTP/1.1
Host: api.appcloud.es
Authorization: Bearer {token}

Respuesta 200

Vencimiento bloqueado exitosamente

Actualizar riesgo del vencimiento

Actualiza el estado de riesgo asociado a un vencimiento, por ejemplo cuando un efecto está en descuento y se necesita reflejar el riesgo en la contabilidad.

PUT https://api.appcloud.es/api/cartera/actualizar/{numcartera}/numvencimiento/{numvencimiento}

Cuerpo de la petición (application/json)

string

Indica si la actualización del riesgo debe generar repercusiones contables (T/F).

string

Fecha de la actualización del riesgo (formato DD/MM/YYYY).

string

Número de documento del asiento contable.

Ejemplo de petición

PUT /api/cartera/actualizar/{numcartera}/numvencimiento/{numvencimiento} HTTP/1.1
Host: api.appcloud.es
Authorization: Bearer {token}
Content-Type: application/json

{
  "repcon": "T",
  "fecha": "25/08/2023",
  "numdoc": "125784po62"
}

Respuesta 200

Riesgo del vencimiento actualizado exitosamente

Devolver vencimiento

Registra la devolución de un cobro ya realizado. Puede imputar gastos de devolución (p. ej., comisiones bancarias) a una cuenta contable específica.

PUT https://api.appcloud.es/api/cartera/devolver/{numcartera}/numvencimiento/{numvencimiento}

Cuerpo de la petición (application/json)

string

Indica si la devolución debe generar repercusiones contables (T/F).

string

Fecha de la devolución (formato DD/MM/YYYY).

string

Fecha valor de la devolución.

string

Importe que se devuelve.

string

Gastos imputados a la devolución.

string

Cuenta contable de gastos de la devolución.

string

Centro de coste 1.

string

Centro de coste 2.

string

Centro de coste 3.

string

Número de documento del asiento contable.

string

Importe de la comisión bancaria de la devolución.

string

Indica si se deben contabilizar los gastos de la devolución (T/F).

Ejemplo de petición

PUT /api/cartera/devolver/{numcartera}/numvencimiento/{numvencimiento} HTTP/1.1
Host: api.appcloud.es
Authorization: Bearer {token}
Content-Type: application/json

{
  "repcon": "T",
  "fecha": "25/08/2023",
  "numdoc": "125784po62",
  "ctagastos": "62600000",
  "comision": "30.25",
  "centro1": "MAD"
}

Respuesta 200

Devolución registrada exitosamente

Imputar gastos al vencimiento

Imputa gastos adicionales (como comisiones o gastos bancarios) a un vencimiento previamente devuelto.

PUT https://api.appcloud.es/api/cartera/imputargastos/{numcartera}/numvencimiento/{numvencimiento}

Cuerpo de la petición (application/json)

string

Indica si la imputación debe generar repercusiones contables (T/F).

string

Fecha de la imputación (formato DD/MM/YYYY).

string

Fecha valor de la devolución.

string

Gastos a imputar.

string

Cuenta contable de gastos.

string

Centro de coste 1.

string

Centro de coste 2.

string

Centro de coste 3.

string

Número de documento del asiento contable.

Ejemplo de petición

PUT /api/cartera/imputargastos/{numcartera}/numvencimiento/{numvencimiento} HTTP/1.1
Host: api.appcloud.es
Authorization: Bearer {token}
Content-Type: application/json

{
  "repcon": "T",
  "fecha": "25/08/2023",
  "numdoc": "125784po62",
  "ctagastos": "62600000",
  "centro1": "MAD"
}

Respuesta 200

Gastos imputados exitosamente

Anulación de operaciones de cartera

Anula cualquier operación previamente realizada sobre un vencimiento. El parámetro de ruta variable determina qué operación se anula.

PUT https://api.appcloud.es/api/cartera/{variable}/{numcartera}/numvencimiento/{numvencimiento}

string

required

Operación a anular. Valores posibles:

Valor	Operación anulada
`anularcobro`	Anula un cobro registrado
`anularpago`	Anula un pago registrado
`anularrecepcion`	Anula una recepción
`anularenvio`	Anula un envío
`anularbloqueo`	Desbloquea el vencimiento
`anulardevolucion`	Anula una devolución
`anularimputacion`	Anula una imputación de gastos
`anularactualizacionriesgo`	Anula una actualización de riesgo
`anularanticipo`	Anula un anticipo

Ejemplo de petición

PUT /api/cartera/anularcobro/{numcartera}/numvencimiento/{numvencimiento} HTTP/1.1
Host: api.appcloud.es
Authorization: Bearer {token}

Respuesta 200

Operación anulada exitosamente

Ligar cartera a factura

Liga el conjunto de efectos de cartera con el número de cartera indicado a la factura identificada por su ID. El parámetro Escobro determina si se ejecuta el cobro al ligar o solo se establece el vínculo.

PUT https://api.appcloud.es/api/cartera/ligar/{numcartera}/IdFactura/{idfactura}/Escobro/{T_o_F}

string

required

ID de la factura a la que se desea ligar la cartera.

string

required

Indica si se realiza el cobro al ligar (T) o únicamente se establece el vínculo sin cobrar (F).

Ejemplo de petición

PUT /api/cartera/ligar/46684/IdFactura/1023/Escobro/T HTTP/1.1
Host: api.appcloud.es
Authorization: Bearer {token}

Respuesta 200

Cartera ligada correctamente a la factura

Desligar cartera de factura

Esta operación desvincula todos los efectos del conjunto de cartera indicado de la factura a la que estaban ligados. Asegúrate de que el desligado no rompa la coherencia contable antes de ejecutarlo.

PUT https://api.appcloud.es/api/cartera/desligar/{numcartera}/IdFactura/{idfactura}/Escobro/{T_o_F}

string

required

ID de la factura de la que se desea desligar la cartera.

string

required

Indica si se realiza el escobro al desligar (T) o no (F).

Ejemplo de petición

PUT /api/cartera/desligar/46684/IdFactura/1023/Escobro/F HTTP/1.1
Host: api.appcloud.es
Authorization: Bearer {token}

Respuesta 200

Cartera desligada correctamente a la factura

Fundamentos

Maestros y Documentos

Stock e Inventario

Informes y Datos

Producción

Módulos Adicionales

Contabilidad

Cartera avanzada: cobros, pagos y vencimientos en A3ERP

Parámetros de ruta comunes

Cobrar vencimiento

Pagar vencimiento

Recibir vencimiento

Enviar vencimiento

Bloquear vencimiento

Actualizar riesgo del vencimiento

Devolver vencimiento

Imputar gastos al vencimiento

Anulación de operaciones de cartera

Ligar cartera a factura

Desligar cartera de factura