Tesorería

Actualizar un pago

Corrige un pago ya registrado o lo marca como conciliado con el extracto bancario.

Herramienta

filmo_treasury_payments_update

Escrituratreasury:write

treasury:write
120/min
Anotación del servidor: Idempotente

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_treasury_payments_update",
    "arguments": {
      "paymentId": "paym_8f2a1c"
    }
  }
}

{
  "structuredContent": {
    "data": {
      "id": "id_8f2a1c",
      "direction": "<direction>",
      "amount": "1234.50",
      "currency": "EUR",
      "date": "2026-09-01T08:00:00Z",
      "type": "<type>",
      "treasuryAccountId": "trea_8f2a1c",
      "contactId": "cont_8f2a1c",
      "reference": "<reference>",
      "linkedDocuments": [
        {
          "type": "invoice",
          "id": "id_8f2a1c",
          "amount": "1234.50"
        }
      ],
      "createdAt": "2026-09-01T08:00:00Z",
      "updatedAt": "2026-09-01T08:00:00Z"
    },
    "meta": {
      "idempotencyKey": "<the key you sent, or the one the server generated>",
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}

generado desde el esquema

reconciled y notes se aceptan y no se devuelven: son estado del proceso contable interno. La fecha sigue la regla de la creación: cualquier hora de hoy, no un día posterior en la zona horaria de la cuenta (400 en date). Un nuevo importe mueve la asignación solo cuando todo el pago estaba asignado a un único documento o pedido; en cualquier otro pago solo cambia la parte sin asignar, así que los documentos conservan lo que habían cobrado, y un importe inferior a lo que ya está asignado responde 409 conflict sin escribir. Una fianza reembolsada, y el propio reembolso, conservan su importe y su sentido: cambiar cualquiera de los dos responde 409 conflict y no se escribe nada. Si los documentos vinculados al pago siguen cambiando mientras se guarda, también responde 409 conflict, no se escribe nada y se puede reintentar la llamada. Devuelve el pago completo, la misma proyección que su GET.

Argumentos

paymentIdstringObligatorio

Identificador del pago de tesorería.

Límites: longitud mín. 1

directionstring

Nueva dirección del pago.

Opciones disponibles: in, out

amountstring

Nuevo importe como cadena decimal, mayor que cero. Si todo el pago está asignado a un único documento o pedido, la asignación sigue al nuevo importe. En caso contrario, lo asignado se mantiene y solo cambia la parte sin asignar; un importe inferior a lo ya asignado responde 409 conflict.

Límites: patrón ^\d{1,13}(\.\d{1,2})?$

datestring<date-time>

Nueva fecha, en ISO 8601 con desplazamiento. Se acepta cualquier hora de hoy; un día posterior, en la zona horaria de la cuenta, se rechaza con 400.

paymentMethodIdstring | null

Nuevo método de pago; null lo quita.

contactIdstring | null

Nuevo contacto; null lo desvincula.

referencestring | null

Nueva referencia externa; null la borra.

Límites: longitud máx. 200

notesstring

Nuevas notas. NO se devuelven.

Límites: longitud máx. 2000

reconciledboolean

Marca el pago como conciliado con el extracto bancario.

idempotencyKeystring

Clave de idempotencia elegida por el cliente (se recomienda un UUID). Repetir la misma clave con los mismos argumentos en 24 h devuelve la respuesta almacenada sin volver a ejecutar; con argumentos distintos responde 422. Es la forma segura de reintentar tras un fallo de red.

Límites: longitud mín. 1, longitud máx. 255

ifMatchstring

Bloqueo optimista: el meta.etag que obtuviste de la lectura de detalle de este recurso (o "*"). Si el recurso ha cambiado desde entonces, la llamada falla con 412 precondition_failed antes de escribir nada; léelo de nuevo y reintenta. Omítelo para escribir sin condiciones.

Límites: longitud mín. 1

Resultado

En un éxito el resultado lleva structuredContent con data y meta. Estos son los atributos de data.

Ver los atributos de data

idstring

Identificador del pago.

directionstring

in cuando entra dinero (un cobro) y out cuando sale (un pago).

amountstring

Importe del pago como cadena decimal, en la moneda indicada.

Límites: patrón ^-?\d+\.\d{2}$

currencystring

Moneda del pago, como código ISO 4217.

datestring<date-time>

Fecha del pago en ISO 8601 UTC.

typestring

normal, o deposit cuando es un pago anticipado.

treasuryAccountIdstring

Cuenta de tesorería por la que pasa el pago.

contactIdstring | null

Cliente o proveedor del pago; null si no se ha declarado.

referencestring | null

Referencia externa del pago; null si no tiene.

linkedDocumentsobject[]

Documentos a los que está asignado el pago; vacío si no está vinculado a ninguno.

Mostrar atributos hijos

linkedDocuments.typestring

Tipo del documento vinculado.

Opciones disponibles: invoice, creditNote, supplierInvoice, quote, proforma, salesReceipt, simpleCreditNote, purchaseOrder

linkedDocuments.idstring

Identificador del documento vinculado.

linkedDocuments.amountstring

Importe de este pago asignado al documento, como cadena decimal.

Límites: patrón ^-?\d+\.\d{2}$

createdAtstring<date-time>

Fecha de creación en ISO 8601 UTC.

updatedAtstring<date-time>

Fecha de la última modificación en ISO 8601 UTC.

Un error es un resultado con isError: true y el problema en content[0].text; no hay structuredContent. Consulta Errores.

La misma operación por REST

Esta herramienta ejecuta PATCH /api/v1/treasury/payments/{paymentId}.

Tesorería
Actualizar un pago
Corrige un pago ya registrado o lo marca como conciliado con el extracto bancario.
Guías
Escrituras seguras
Un asistente que puede escribir también puede escribir lo equivocado. Decide qué herramientas necesitan a una persona, reintenta sin duplicar y sabe qué pone en marcha una escritura.
Guías
Errores
Un error de herramienta es un resultado con isError: true y el problema en el primer bloque de texto. Ramifica por su code.

¿Te ha resultado útil esta página?

Resultado

Argumentos

Resultado

La misma operación por REST

Páginas relacionadas

Actualizar un pago

Escrituras seguras

Errores