Release Notes

Changelog

Evolución de las APIs de Auditoría


Objetivo

Optimizar y flexibilizar la integración y el consumo de datos de auditoría en el sistema RUB, incluyendo fecha y hora por ítem auditado, mayor precisión y consistencia en los datos sumarizados de auditoría y soporte transparente a identificadores internos de RUB o códigos externos provenientes del ERP.

Estas modificaciones responden a las necesidades de extracción continua de datos e integraciones con sistemas externos, garantizando trazabilidad temporal y una correspondencia total entre los totales sumarizados y el detalle de ítems.


Detalle de las Modificaciones

1. Inclusión de timestamp en la API de Ítems de Auditoría

Endpoint: GET /{tenant}/api/rest/audit/itens/{store}/{auditId}

Cada ítem retornado por la API incluye la propiedad timestamp con la fecha y hora del registro de auditoría de dicho producto.

Ejemplo de Respuesta:

JSON
[
  {
    "store": 30001,
    "auditId": 1,
    "product": "7699",
    "categoryL1Code": "2",
    "categoryL1Description": "2 - Bebidas",
    "status": 1,
    "statusDescription": "Sem Presença e Com Estoque",
    "auditStock": 7699,
    "timestamp": "2026-09-16 10:01:07"
  },
  {
    "store": 30001,
    "auditId": 1,
    "product": "12454",
    "categoryL1Code": "2",
    "categoryL1Description": "2 - Bebidas",
    "status": 1,
    "statusDescription": "Sem Presença e Com Estoque",
    "auditStock": 12454,
    "timestamp": "2026-09-16 10:01:07"
  }
]

2. Soporte a Código Interno y Externo en el Parámetro store

Endpoint: GET /{tenant}/api/rest/audit/itens/{store}/{auditId}

El integrador puede utilizar en la ruta de la solicitud el identificador que resulte más adequado para su arquitectura:

El sistema traduce automáticamente el identificador informado a la tienda correspondiente en RUB, retornando los ítems de auditoría con total transparencia. En caso de que el identificador informado no exista, la API mantiene la respuesta estándar de tienda no encontrada.


3. Corrección y Consistencia en la Sumarización de Auditoría

Endpoint: GET /{tenant}/api/rest/audit

El endpoint consolidado de auditorías asegura que los valores sumarizados correspondan fielmente a los datos detallados:

Ejemplo de Respuesta:

JSON
[
  {
    "store": 30001,
    "auditId": 1,
    "auditedIn": "Loja inteira",
    "date": "2026-09-16 10:01:07",
    "lastReading": "2026-09-16 10:01:07",
    "closingDate": null,
    "disruptionCost": 1037118.7619,
    "itensWithStock": 25,
    "auditItens": 25,
    "readedItens": 25,
    "situation": "Aberta",
    "startedBy": "root (Super Usuário)",
    "closedBy": "",
    "type": 1,
    "typeDescription": "Presença",
    "statuses": [
      {
        "status": 5,
        "statusDescription": "Com Presença e com Estoque",
        "amount": 0
      },
      {
        "status": 3,
        "statusDescription": "Lido não pertence",
        "amount": 0
      },
      {
        "status": 4,
        "statusDescription": "Com Presença e sem Estoque",
        "amount": 0
      },
      {
        "status": 2,
        "statusDescription": "Sem Presença e Sem Estoque",
        "amount": 0
      },
      {
        "status": 1,
        "statusDescription": "Sem Presença e Com Estoque",
        "amount": 25
      }
    ]
  }
]

Beneficios