Tesorería

Registrar un pago entrante o saliente

Registra un pago en una cuenta de tesorería.

Herramienta

filmo_treasury_payments_create

Destructivatreasury:write

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_treasury_payments_create",
    "arguments": {
      "direction": "in",
      "amount": "1234.50",
      "date": "2026-09-01T08:00:00Z",
      "paymentMethodId": "paym_8f2a1c",
      "treasuryAccountId": "trea_8f2a1c",
      "idempotencyKey": "<a UUID you generate>"
    }
  }
}

{
  "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

Envía tu propia idempotencyKey

Un reintento sin la misma clave duplica el efecto. Envía tu propia idempotencyKey (un UUID) y reenvía la misma si reintentas.

Requiere confirmación humana

Pon esta herramienta en la lista de «preguntar antes de ejecutar» de tu cliente. Las anotaciones son pistas que declara el servidor, no garantías: no decidas la aprobación solo por destructiveHint. El servidor marca esta herramienta con _meta["anthropic/requiresUserInteraction"], que los clientes que lo respetan usan para preguntar a una persona antes de cada llamada.

El documento al que está vinculado va como el PAR linkedDocumentType + linkedDocumentId, nunca como un campo por tipo: enviar dos identificadores a la vez dejaría sin saber a cuál se vinculó. type: "deposit" marca una fianza cobrada a un cliente: exige direction: in (400 en direction en caso contrario) y no se descuenta del total del pedido. La fecha puede ser cualquier momento de hoy, pero no un día posterior, en la zona horaria de la cuenta (400 en date). Envía Idempotency-Key: un reintento sin ella registra el pago dos veces. Devuelve el pago completo, la misma proyección que su GET.

Argumentos

directionstringObligatorio

in para un cobro de un cliente, out para un pago a un proveedor.

Opciones disponibles: in, out

amountstringObligatorio

Importe como cadena decimal, mayor que cero.

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

currencystring

Moneda en ISO 4217. Por defecto, EUR.

Límites: longitud mín. 3, longitud máx. 3

datestring<date-time>Obligatorio

Fecha del pago, 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.

paymentMethodIdstringObligatorio

Método de pago configurado en la cuenta.

Límites: longitud mín. 1

treasuryAccountIdstringObligatorio

Cuenta de tesorería por la que entra o sale el dinero.

Límites: longitud mín. 1

typestring

"deposit" marca una fianza cobrada a un cliente: exige direction=in (400 en caso contrario) y no se descuenta del total del pedido.

Opciones disponibles: normal, deposit

contactIdstring

Cliente o proveedor del pago.

linkedDocumentTypestring

Tipo del documento al que está vinculado el pago. Va junto con linkedDocumentId.

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

linkedDocumentIdstring

Documento al que está vinculado el pago. Va junto con linkedDocumentType.

referencestring

Referencia externa del pago.

Límites: longitud máx. 200

notesstring

Notas. Se guardan en Filmo y NO se devuelven.

Límites: longitud máx. 2000

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 POST /api/v1/treasury/payments.

Tesorería
Registrar un pago entrante o saliente
Registra un pago en una cuenta de tesorería.
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

Registrar un pago entrante o saliente

Escrituras seguras

Errores