Incidencias
Observaciones de datos y diferencias de recepción.
Recurso JSON
issuesModelo y significado
automatic=receiving identifica casos derivados: el estado se resuelve corrigiendo factura/remito/vínculo. No modificar manualmente esos campos para ocultar una diferencia. receiving contiene cantidades, relaciones y motivos concretos.
Consulta del recurso
HTTP
GET https://finanzas.neavision.com.ar/api/v1/agent/issues
Authorization: Bearer <token-de-integracion>Requiere issues:read. Respuesta de lista: { data: [...], page: { total, nextCursor } }. El detalle se consulta con /issues/{id}. Ver paginación y filtros.
Diccionario de campos
Obligatorio / Opcional: campos del registro de negocio; dentro de una lista u objeto, se aplica cuando ese contenedor está presente. Servidor: identidad y auditoría. Respuesta: campos agregados o administrados por el servidor; no enviarlos como una edición ordinaria. La presencia de los calculados depende del endpoint.
| Campo | Tipo / valores | Condición | Significado y restricciones |
|---|---|---|---|
externalId | string | Opcional | Identidad opcional del sistema de origen. Única por recurso entre registros activos. Máx. 500 caracteres. |
notes | string | Opcional | Observaciones registradas. Máx. 10000 caracteres. |
title | string | Obligatorio | Título de la incidencia. Máx. 1000 caracteres. |
description | string | Obligatorio | Descripción registrada. Máx. 10000 caracteres. |
status | "open" | "resolved" | Obligatorio | Estado registrado o calculado, según el recurso y endpoint. |
severity | "info" | "warning" | "error" | Obligatorio | info, warning o error. |
resource | "customers" | "sales-invoices" | "receipts" | "sales-credits" | "payment-orders" | "products" | "delivery-notes" | "stock-movements" | "suppliers" | "invoices" | "expenses" | "payments" | "credits" | "commitments" | "recurrences" | "documents" | "issues" | "notification-rules" | "notifications" | Opcional | Nombre del recurso relacionado. |
recordId | uuid | Opcional | UUID del registro relacionado. |
resolvedAt | date-time | Opcional | Momento de resolución. |
automatic | string | Respuesta | receiving indica incidencia derivada de recepción. |
receiving | object | Respuesta | Detalle estructurado de recepción que originó la incidencia. |
receiving.key | string | Respuesta | Clave estable de la fila de recepción. |
receiving.resource | "invoices" | "delivery-notes" | Respuesta | Nombre del recurso relacionado. |
receiving.recordId | uuid | Respuesta | UUID del registro relacionado. |
receiving.lineId | string | Respuesta | ID textual de la línea destino, local a la factura. |
receiving.supplierId | uuid | Respuesta | UUID de suppliers; distingue la cuenta del proveedor. |
receiving.supplierName | string | Respuesta | Nombre del proveedor en la proyección. |
receiving.invoiceId | uuid | null | Respuesta | UUID de la factura asociada; el recurso destino depende del circuito. |
receiving.invoiceLineId | string | null | Respuesta | ID local de la línea de factura; null si no existe destino conocido. |
receiving.invoiceNumber | string | null | Respuesta | Número de factura relacionado; null si no se conoce. |
receiving.productId | uuid | null | Respuesta | UUID de products. |
receiving.supplierCode | string | null | Respuesta | Código de proveedor opcional. Coincidencia exacta cuando ambas líneas lo informan. |
receiving.description | string | Respuesta | Descripción registrada. |
receiving.unit | string | Respuesta | Unidad textual exacta. No hay conversiones automáticas. |
receiving.invoicedQuantity | string | null | Respuesta | Cantidad facturada; null cuando falta el detalle. |
receiving.receivedQuantity | string | Respuesta | Cantidad vinculada recibida, incluso vínculos incompatibles señalados en reasons. |
receiving.missingQuantity | string | null | Respuesta | Cantidad faltante; null cuando no puede calcularse. |
receiving.excessQuantity | string | Respuesta | Cantidad recibida por encima de lo facturado. |
receiving.unlinkedQuantity | string | Respuesta | Parte física recibida sin asignación a factura. |
receiving.receivingStatus | "unlinked" | "pending" | "partial" | "complete" | "excess" | "mismatch" | Respuesta | Estado de conciliación de cantidades. |
receiving.detailPending | boolean | Respuesta | Falta el detalle físico necesario para conciliar. |
receiving.deliveryNoteIds | array | Respuesta | UUID de remitos relacionados. |
receiving.deliveryNoteNumbers | array | Respuesta | Números de remitos relacionados. |
receiving.orderReferences | array | Respuesta | Referencias documentadas de pedidos; no son claves foráneas. |
receiving.reasons | array | Respuesta | Motivos concretos de incompatibilidad. |
receiving.documentIds | array | Respuesta | UUID de los respaldos. No contiene imágenes ni archivos. |
receiving.deliveries | array | Respuesta | Recepciones que componen esta fila. |
receiving.deliveries[].noteId | uuid | Respuesta | UUID del remito que originó esta recepción. |
receiving.deliveries[].lineId | string | Respuesta | ID textual de la línea destino, local a la factura. |
receiving.deliveries[].number | string | Respuesta | Número de comprobante conservado como texto, con sus ceros y formato. |
receiving.deliveries[].date | string | Respuesta | Fecha civil del movimiento, YYYY-MM-DD. |
receiving.deliveries[].quantity | string | Respuesta | Cantidad decimal exacta. En entradas de líneas/movimientos es positiva, hasta 4 decimales. |
receiving.deliveries[].reasons | array | Respuesta | Motivos concretos de incompatibilidad. |
id | uuid | Servidor | Identificador UUID estable del registro. No usar el número de comprobante como ID. |
version | integer | Servidor | Versión entera para detectar cambios sobre este registro. Mín. 1. |
createdAt | date-time | Servidor | Momento de creación, ISO 8601 con zona. |
updatedAt | date-time | Servidor | Última modificación del registro; no implica que un saldo derivado se haya mantenido igual. |
voidedAt | date-time | Servidor | Momento de anulación; null o ausente indica registro activo. |