Skip to main content
Los endpoints de cartera te permiten gestionar los anticipos (entregas a cuenta) de clientes y proveedores en A3ERP. Puedes consultar todos los anticipos existentes junto con el importe pendiente de asignar, registrar nuevos anticipos de cobro o pago, y aplicar un anticipo existente a una factura concreta. Esta funcionalidad es especialmente útil cuando un cliente realiza pagos por adelantado antes de la emisión de la factura, o cuando tu empresa efectúa pagos a cuenta a un proveedor.

​
GET — Anticipos de un cliente

Consulta todos los anticipos de un cliente y la cantidad pendiente de asignar a facturas.
​
string
required
Código del cliente cuyos anticipos quieres consultar.
​
string
required
Token JWT con prefijo Bearer.
Ejemplo:
Respuesta 200 — Lista de anticipos del cliente:
Campos de la respuesta:
​
string
Código del cliente. Devuelto como cadena de 8 caracteres rellena con espacios a la izquierda.
​
string
Nombre o razón social del cliente.
​
integer
Número de cartera del anticipo. Este valor es el que se utiliza como numanti al asignar el anticipo a una factura.
​
string
Fecha del anticipo en formato ISO 8601.
​
number
Importe total del anticipo en la moneda del documento.
​
number
Importe pendiente de asignar a facturas. Un valor 0 indica que el anticipo ya está completamente aplicado.
​
string
Documento de pago asociado al anticipo.

​
GET — Anticipos de un proveedor

Consulta todos los anticipos de un proveedor y la cantidad pendiente de asignar a facturas de compra.
​
string
required
Código del proveedor cuyos anticipos quieres consultar.
​
string
required
Token JWT con prefijo Bearer.
Ejemplo:
Respuesta 200 — Lista de anticipos del proveedor:
La estructura de respuesta es idéntica a la de anticipos de cliente. El campo codcli contendrá en este caso el código del proveedor.

​
POST — Crear un anticipo

Registra un nuevo anticipo de cobro o pago en la cartera de A3ERP.
​
string
required
Token JWT con prefijo Bearer.
Campos del cuerpo:
​
string
required
Indica si el anticipo es un cobro o un pago:
  • T — Cobro (anticipo de cliente).
  • F — Pago (anticipo a proveedor).
​
string
required
Código del cliente (si esCobro es T) o del proveedor (si esCobro es F).
​
string
required
Código del banco o caja asociado al anticipo.
​
string
required
Código del documento de pago (p. ej. L para letra, T para transferencia).
​
string
required
Tipo contable del anticipo.
​
string
required
Código de moneda (p. ej. EURO).
​
string
required
Fecha de vencimiento del anticipo en formato DD/MM/AAAA.
​
string
required
Fecha contable del anticipo en formato DD/MM/AAAA.
​
string
required
Importe del anticipo.
​
string
Texto libre con observaciones sobre el anticipo.
Ejemplo — Crear un anticipo de pago a proveedor:
Respuesta 200: El anticipo se ha creado correctamente (sin cuerpo de respuesta).

​
POST — Asignar anticipo a una factura

Aplica un anticipo existente (ya registrado en cartera) a una factura, reduciendo el importe pendiente de la factura en la cantidad especificada.
​
string
required
Token JWT con prefijo Bearer.
Campos del cuerpo:
​
string
required
Indica si la factura es de compra o de venta:
  • T — Factura de compra.
  • F — Factura de venta.
​
string
required
Identificador interno de la factura a la que asignar el anticipo.
​
string
required
Número de cartera del anticipo. Corresponde al campo numcartera devuelto por las consultas de anticipos de cliente o proveedor.
​
string
required
Código de moneda del anticipo (p. ej. EURO).
​
string
required
Importe a aplicar del anticipo sobre la factura. Puede ser menor o igual al importe disponible del anticipo.
Ejemplo — Asignar un anticipo a una factura de compra:
Respuesta 200: El anticipo se ha asignado correctamente a la factura (sin cuerpo de respuesta).
El valor de numanti debe ser el campo numcartera obtenido en la consulta de anticipos del cliente o proveedor, no el código del cliente/proveedor.