Remesas bancarias: gestiona lotes de cobros y pagos

Las remesas son lotes de efectos de cobro o pago agrupados para su tramitación bancaria masiva, como los adeudos directos SEPA o las transferencias de proveedores. Con estos endpoints puedes crear remesas nuevas, consultar las existentes, añadir efectos a una remesa o eliminarlos, y también operar sobre remesas de clientes y proveedores para cobrarlas o pagarlas de forma completa o parcial.

Recuerda incluir siempre la cabecera Authorization: Bearer {token} en todas las peticiones a estos endpoints.

Consultar remesas

Consultar todas las remesas

Obtiene el listado completo de todas las remesas existentes en la empresa.

GET https://api.appcloud.es/api/cartera/remesas

Ejemplo de petición

GET /api/cartera/remesas HTTP/1.1
Host: api.appcloud.es
Authorization: Bearer {token}
Accept: */*

Respuesta 200 — Array de objetos remesa.

Consultar remesa por ID

Obtiene los detalles de una remesa concreta mediante su identificador.

GET https://api.appcloud.es/api/cartera/remesas/{id}

string

required

Identificador único de la remesa.

Ejemplo de petición

GET /api/cartera/remesas/42 HTTP/1.1
Host: api.appcloud.es
Authorization: Bearer {token}

Respuestas

Código	Descripción
`200`	Detalles de la remesa
`404`	Remesa no encontrada

Filtrar remesas

Obtiene el listado de remesas que cumplen con el filtro especificado.

GET https://api.appcloud.es/api/cartera/remesas/filtro/{filtro}

string

required

Expresión de filtro a aplicar en la búsqueda de remesas.

Ejemplo de petición

GET /api/cartera/remesas/filtro/escobro%3D'T' HTTP/1.1
Host: api.appcloud.es
Authorization: Bearer {token}

Ordenar remesas

Obtiene el listado de remesas ordenadas según el criterio especificado.

GET https://api.appcloud.es/api/cartera/remesas/order/{order}

string

required

Criterio de ordenamiento para las remesas (p. ej., nombre de campo ascendente o descendente).

Ejemplo de petición

GET /api/cartera/remesas/order/fecha HTTP/1.1
Host: api.appcloud.es
Authorization: Bearer {token}

Filtrar y ordenar remesas

Combina filtrado y ordenación en una sola llamada.

GET https://api.appcloud.es/api/cartera/remesas/filtro/{filtro}/order/{order}

string

required

Expresión de filtro a aplicar.

string

required

Criterio de ordenamiento de los resultados.

Ejemplo de petición

GET /api/cartera/remesas/filtro/escobro%3D'T'/order/fecha HTTP/1.1
Host: api.appcloud.es
Authorization: Bearer {token}

Crear remesa

Crea una nueva remesa indicando los efectos de cartera que la formarán.

POST https://api.appcloud.es/api/cartera/remesas/crear

Cuerpo de la petición (application/json)

string

Tipo de remesa: T para cobro (clientes), F para pago (proveedores).

string

Indica si la remesa es al descuento (T) o no (F).

string

Fecha de la remesa en formato DD/MM/YYYY.

string

Código del banco asociado a la remesa.

string

Código de moneda (p. ej., EURO).

string

Tipo de contrato bancario.

string

Tipo de mandato SEPA. Valores posibles: B2B, CORE, COR1.

array

Lista de efectos de cartera que forman parte de la remesa. Cada elemento debe incluir:

NumCartera (string) — Número de cartera del efecto.
NumVencimiento (string) — Número de vencimiento del efecto.

Ejemplo de petición

POST /api/cartera/remesas/crear HTTP/1.1
Host: api.appcloud.es
Authorization: Bearer {token}
Content-Type: application/json

{
  "escobro": "T",
  "descue": "T",
  "fecha": "05/09/2023",
  "codban": "1",
  "codmon": "EURO",
  "tipocont": "1",
  "tipomandato": "B2B",
  "Efectos": [
    {
      "NumCartera": "text",
      "NumVencimiento": "text"
    }
  ]
}

Respuesta 201 — Remesa creada (sin contenido).

La respuesta 201 no devuelve cuerpo. Una respuesta 400 indica datos de entrada incorrectos.

Cobrar una remesa entera

Cobra todos los efectos de una remesa de clientes en una sola operación.

PUT https://api.appcloud.es/api/cartera/cobrarremesa/{numremesa}

string

required

Número de la remesa a cobrar.

Cuerpo de la petición (application/json)

string

Repercusiones contables (T/F).

string

Cobro al descuento (T/F).

string

Cuenta bancaria (p. ej., 57200001).

string

Cuenta de riesgo (p. ej., 52080003).

string

Fecha del cobro (DD/MM/YYYY).

string

Fecha valor del cobro.

string

Código del banco.

string

Tipo de cambio.

string

Cuenta de gastos.

string

Cuenta de comisiones (p. ej., 66900000).

string

Importe de las comisiones (p. ej., 2,5).

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.

Ejemplo de petición

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

{
  "repcon": "T",
  "descue": "F",
  "ctabanco": "57200001",
  "ctariesgo": "52080003",
  "fecha": "25/08/2023",
  "fechavalor": "31/08/2023",
  "codban": "1",
  "cambio": "1",
  "ctagastos": "62600000",
  "ctacomisiones": "66900000",
  "comisiones": "2,5",
  "gastos": "30.25",
  "centro1": "MAD",
  "numdoc": "125784po62"
}

Respuesta 200

{ "message": "Efectos eliminados correctamente." }

Cobrar una remesa de forma parcial

Cobra únicamente los efectos indicados dentro de una remesa de clientes.

PUT https://api.appcloud.es/api/cartera/cobrarremesaparcial/{numremesa}

string

required

Número de la remesa a cobrar parcialmente.

Acepta los mismos campos del cuerpo que el cobro total, más los siguientes adicionales:

string

Si se desea generar un único asiento para todos los efectos cobrados (T/F).

array

Lista de efectos concretos a cobrar dentro de la remesa. Cada elemento debe incluir NumCartera y NumVencimiento.

Ejemplo de petición

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

{
  "repcon": "T",
  "ctabanco": "57200001",
  "fecha": "25/08/2023",
  "unasiento": "T",
  "Efectos": [
    { "NumCartera": "46684", "NumVencimiento": "1" }
  ]
}

Pagar una remesa de proveedores

Paga todos los efectos de una remesa de proveedores en una sola operación.

PUT https://api.appcloud.es/api/cartera/pagarremesa/{numremesa}

string

required

Número de la remesa a pagar.

Acepta los mismos campos de cuerpo que el cobro de remesa entera. Para pagar solo efectos concretos (pago parcial), añade unasiento y el array Efectos al cuerpo. Ejemplo de pago parcial

{
  "repcon": "T",
  "ctabanco": "57200001",
  "fecha": "25/08/2023",
  "fechavalor": "31/08/2023",
  "codban": "1",
  "cambio": "1",
  "unasiento": "T",
  "Efectos": [
    { "NumCartera": "46684", "NumVencimiento": "1" },
    { "NumCartera": "46683", "NumVencimiento": "1" }
  ]
}

Anular cobro de una remesa

Anula el cobro previamente registrado de una remesa de clientes.

DELETE https://api.appcloud.es/api/cartera/anularcobraremesa/{numremesa}

string

required

Número de la remesa cuyo cobro se desea anular.

Ejemplo de petición

DELETE /api/cartera/anularcobraremesa/{numremesa} HTTP/1.1
Host: api.appcloud.es
Authorization: Bearer {token}

Respuesta 200

{ "message": "cobro anulado correctamente" }

Anular pago de una remesa

Anula el pago previamente registrado de una remesa de proveedores.

DELETE https://api.appcloud.es/api/cartera/anularpagoremesa/{numremesa}

string

required

Número de la remesa cuyo pago se desea anular.

Ejemplo de petición

DELETE /api/cartera/anularpagoremesa/{numremesa} HTTP/1.1
Host: api.appcloud.es
Authorization: Bearer {token}

Respuesta 200

{ "message": "pago anulado correctamente" }

Añadir efectos a una remesa existente

Agrega nuevos efectos de cartera a una remesa ya creada.

POST https://api.appcloud.es/api/cartera/remesas/anadeefectos/{numremesa}

string

required

Número de la remesa a la que se añadirán los efectos.

Cuerpo de la petición (application/json)

array

required

Lista de efectos a añadir. Cada elemento debe incluir:

NumCartera (string) — Número de cartera del efecto.
NumVencimiento (string) — Número de vencimiento del efecto.

Ejemplo de petición

POST /api/cartera/remesas/anadeefectos/{numremesa} HTTP/1.1
Host: api.appcloud.es
Authorization: Bearer {token}
Content-Type: application/json

{
  "Efectos": [
    {
      "NumCartera": "text",
      "NumVencimiento": "text"
    }
  ]
}

Respuesta 200

{ "message": "Efectos añadidos correctamente." }

Eliminar efectos de una remesa existente

Elimina efectos específicos de una remesa. La remesa debe conservar al menos un efecto tras la operación.

POST https://api.appcloud.es/api/cartera/remesas/eliminaefectos/{numremesa}

string

required

Número de la remesa de la que se eliminarán los efectos.

Cuerpo de la petición (application/json)

array

required

Lista de efectos a eliminar. Cada elemento debe incluir NumCartera y NumVencimiento.

Ejemplo de petición

POST /api/cartera/remesas/eliminaefectos/{numremesa} HTTP/1.1
Host: api.appcloud.es
Authorization: Bearer {token}
Content-Type: application/json

{
  "Efectos": [
    {
      "NumCartera": "text",
      "NumVencimiento": "text"
    }
  ]
}

No es posible dejar una remesa sin efectos. Si intentas eliminar todos los efectos de una remesa, la API devolverá un error 400.

Respuesta 200

{ "message": "Efectos eliminados correctamente." }

Respuestas de error

Código	Descripción
`400`	Solicitud incorrecta (p. ej., remesa quedaría sin efectos)
`401`	No autorizado
`404`	Remesa no encontrada

Fundamentos

Maestros y Documentos

Stock e Inventario

Informes y Datos

Producción

Módulos Adicionales

Contabilidad

Remesas bancarias: gestiona lotes de cobros y pagos

Consultar remesas

Consultar todas las remesas

Consultar remesa por ID

Filtrar remesas

Ordenar remesas

Filtrar y ordenar remesas

Crear remesa

Cobrar una remesa entera

Cobrar una remesa de forma parcial

Pagar una remesa de proveedores

Anular cobro de una remesa

Anular pago de una remesa

Añadir efectos a una remesa existente

Eliminar efectos de una remesa existente