Ir al contenido

Revisar el historial de contabilizaciones de ERP

Cuando un flujo de trabajo contabiliza en un ERP (mediante el paso Contabilizar documentos, consulte Contabilizar documentos en sistemas ERP, o mediante el paso de contabilización propio de un sistema, como un asiento de diario o un cheque manual de Sage 100, un asiento de diario de Sage Intacct o NetSuite, un documento de Acumatica, Business Central o Xero, un asiento de diario de Dynamics 365 Finance & Operations, Oracle Fusion, Workday Financials o SAP S/4HANA Cloud, o un documento de SAP), PlaidCloud registra cada intento de contabilización en un libro duradero por inquilino, de modo que el mismo documento nunca se contabilice dos veces. El historial de contabilizaciones de ERP es la vista de solo lectura sobre ese libro: cada intento y su estado actual, con el número de documento propio del ERP y las marcas de tiempo, filtrable por proyecto.

Complementa la tabla de resultados por ejecución que escribe un paso de contabilización: la tabla de resultados recoge los resultados de una sola ejecución, mientras que el historial de contabilizaciones es el registro permanente de todas las ejecuciones y flujos de trabajo, y sigue cada contabilización durante todo su ciclo de vida en lugar de congelarla en el momento en que terminó la ejecución.

Cada fila es un documento contabilizado (o con intento de contabilización) en un entorno de ERP de una conexión:

Campo Significado
ledger_id El id de la fila en el libro.
project_id El proyecto desde el que se hizo la contabilización.
connection_id La conexión de ERP utilizada.
environment_id El entorno de la conexión en el que se contabilizó (por ejemplo, uno de pruebas frente a producción).
natural_key La clave de negocio del documento, tal como la derivó el paso de contabilización.
mode live para una contabilización real, simulate para lo que habría contabilizado una ejecución simulada.
state El estado actual del ciclo de vida de la contabilización (vea más abajo).
confirmation_id El número de documento propio del ERP, una vez que el ERP lo asigna. Nunca se establece en una contabilización simulada.
run_id La ejecución del flujo de trabajo que hizo la contabilización.
submitted_at, created_at, updated_at Cuándo se envió la contabilización, cuándo se registró por primera vez y cuándo cambió por última vez.

Una contabilización hecha en modo de simulación lleva mode simulate, lo que la distingue de una real a simple vista; consulte Contabilizaciones simuladas más abajo.

Una contabilización pasa por estos estados a medida que el ERP la procesa:

Estado Significado
preflighted Validada y reservada, aún no enviada al ERP.
submitted Enviada al ERP; el resultado aún no se conoce.
pending Aceptada para procesamiento asíncrono; a la espera de un resultado final.
posted Contabilización confirmada; confirmation_id contiene el número de documento del ERP.
rejected El ERP rechazó la contabilización.
in_doubt No se pudo confirmar el resultado: una persona debe comprobarlo directamente en el ERP antes de cualquier reintento.
reversed Un documento contabilizado previamente fue revertido.

El Registro de asientos muestra las mismas contabilizaciones con su propio conjunto de estados, más sencillo.

Una ejecución iniciada en modo de simulación valida lo que enviaría un paso de contabilización, pero nunca contacta con el ERP. Lo que habría contabilizado un paso de contabilización se registra igualmente aquí, con mode simulate, para que pueda revisarlo del mismo modo que una contabilización real (incluido su natural_key), sin un confirmation_id, ya que ningún ERP llegó a verlo.

Los documentos simulados de un paso Contabilizar documentos también se registran aquí, con mode simulate, salvo los de un sistema contabilizado a través del agente de PlaidCloud (como SAP local y Sage 100), que aparecen solo en el Registro de asientos como Se contabilizaría.

Una entrada simulada nunca ocupa ni bloquea el espacio que protege la escritura idempotente de una contabilización real. Si más tarde ejecuta el mismo documento en producción, la contabilización real continúa y sustituye el registro simulado. Un espacio de trabajo sin un libro de contabilizaciones configurado valida igualmente con normalidad una ejecución simulada; simplemente no registra nada aquí.

Borre las entradas simuladas de un proyecto de forma independiente de las reales con DELETE /rest/v1/analyze/erp/write/history/simulated?project_id=<project> (opcionalmente acotado con connection_id) o con la herramienta MCP erp_clear_simulated_postings con los mismos argumentos. En ambos casos solo se eliminan las filas simuladas (una contabilización real nunca se toca). El mismo borrado elimina también los documentos de las ejecuciones Contabilizar documentos del proyecto que se ejecutaron en simulación, y las copias propias del Registro de asientos de las contabilizaciones simuladas. La respuesta informa de cleared (filas del historial y documentos de ejecuciones simuladas) y de sims_cleared (las copias del Registro).

Limite cada lectura a un proyecto al que pueda acceder. Necesita acceso de lectura a ese proyecto, el mismo acceso que requiere el resto de su trabajo en el proyecto.

GET /rest/v1/analyze/erp/write/history?project_id=<project>

Los parámetros de consulta opcionales acotan el resultado:

Parámetro Efecto
connection_id Solo las contabilizaciones hechas en esta conexión.
state Solo las contabilizaciones en este estado (por ejemplo, state=in_doubt).
mode live o simulate. Sin él, las contabilizaciones reales y simuladas se muestran juntas.
limit Tamaño de página (100 de forma predeterminada).
cursor El next_cursor de la página anterior.

Los resultados llegan de más reciente a más antiguo. Cuando una página se llena hasta limit, la respuesta incluye un next_cursor; páselo de vuelta como cursor para leer la página siguiente, y deténgase cuando next_cursor sea nulo.

Llame a la herramienta erp_post_history con los mismos argumentos: project_id (obligatorio) y, opcionalmente, connection_id, state, mode, limit y cursor. Devuelve las mismas filas, paginadas del mismo modo.

  • Todo lo que sigue en duda en un proyecto: state=in_doubt: las contabilizaciones que debe confirmar a mano en el ERP.
  • Qué contabilizó una ejecución concreta: lea el historial del proyecto y haga coincidir por run_id.
  • Si un documento realmente se contabilizó: busque su fila y lea state y confirmation_id.