API REST para datos contables

Como todo documento de REDA Financials es un objeto personalizado de Salesforce, la API REST estándar es la puerta de entrada de tu integración: crea facturas desde tu CRM o sistema de facturación, consulta saldos hacia un data warehouse, contabiliza documentos desde middleware, todo con los endpoints que tu equipo ya conoce.

El patrón canónico: crear el borrador y luego contabilizar

Los endpoints, de un vistazo

Nada de esto es específico de REDA: son los endpoints REST estándar de Salesforce, mostrados sobre los objetos refin__ (el paquete está construido en la API v65.0; funciona cualquier versión actual):

Contabilizar un borrador, en el cable

La llamada de contabilización es deliberadamente anticlimática — un solo campo:

PATCH /services/data/v65.0/sobjects/refin__Sales_Invoice__c/a0X8d000001AbCdEAV

{
  "refin__Status__c": "Posted"
}

El éxito es un HTTP 204 No Content — y detrás, un documento completamente contabilizado. Un rechazo vuelve como el arreglo de errores estándar con el mensaje legible del paquete; por ejemplo, un usuario de integración sin puesto de licencia REDA ve:

[
  {
    "message": "Debe ser un usuario con licencia de REDA Financials para crear, editar o eliminar Transacciones contables. Contacte a su administrador.",
    "errorCode": "FIELD_CUSTOM_VALIDATION_EXCEPTION",
    "fields": []
  }
]

Leer lo que acabas de crear es SOQL simple:

GET /services/data/v65.0/query
    ?q=SELECT Id, Name, refin__Status__c
       FROM refin__Sales_Invoice__c
       WHERE refin__Status__c = 'Draft'

Para el cuerpo de las inserciones en sí, obtén la lista de campos desde el endpoint describe o el Object Manager en lugar de este artículo — los conjuntos de campos y los campos obligatorios de tu org son la fuente de verdad, y los campos de dimensión adicionales que agregó tu administrador forman parte de ella.

Lo que la plataforma completa por ti

Lectura de datos

• SOQL a través del endpoint de consulta — facturas abiertas, recibos sin aplicar, campos de antigüedad (son campos de fórmula en los registros), lo que tu panel necesite.
• El libro mayor en sí — refin__Accounting_Transaction__c es la fuente de verdad de la contabilización; suma débitos y créditos por cuenta contable y habrás reconstruido cualquier saldo externamente.
• Los acumulados son campos — el saldo pendiente de una factura, el importe sin aplicar de un recibo, la cifra comprometida de una línea de presupuesto: todo se puede consultar directamente, sin cálculos de tu parte.

Reglas del camino

• No existe atajo: los documentos contabilizados quedan bloqueados a ediciones por API exactamente igual que para los usuarios; las correcciones pasan por los flujos de descontabilización/anulación, programáticamente las mismas transiciones de estado.
• Las aplicaciones también son registros — crear un refin__Cash_Receipt_Application__c aplica un recibo (se ejecutan todos los controles de coincidencia); eliminarlo lo desaplica.
• Respeta las fechas de cierre — las escrituras en libros cerrados son rechazadas; tu integración debe fechar los documentos en períodos abiertos, como cualquier contador.
• La idempotencia depende de ti — la clave natural es la referencia de tu sistema de origen (colócala en el campo Referencia y valida antes de insertar; la validación de referencia de proveedor duplicada ayuda del lado de cuentas por pagar).

Errores comunes que hay que evitar

Qué sigue

1. Bulk API (importación y exportación de datos) — el mismo patrón a escala de migración.
2. Descripción general de la API — el panorama completo.
3. Saldos de apertura y migración de datos — el proyecto clásico de REST/Bulk.

Preguntas frecuentes