Proveedores
Identidad comercial y fiscal de proveedores y servicios.
Recurso JSON
suppliersModelo y significado
Referenciar por UUID. Nombre, alias o CUIT no sustituyen supplierId. kind distingue supplier y service. Las categorías y alias son texto, sin catálogos relacionales propios.
Consulta del recurso
HTTP
GET https://finanzas.neavision.com.ar/api/v1/agent/suppliers
Authorization: Bearer <token-de-integracion>Requiere suppliers:read. Respuesta de lista: { data: [...], page: { total, nextCursor } }. El detalle se consulta con /suppliers/{id}. Ver paginación y filtros.
Ejemplo estructurado
JSON
{
"id": "10000000-0000-4000-8000-000000000001",
"version": 1,
"createdAt": "2026-10-01T12:00:00Z",
"updatedAt": "2026-10-01T12:00:00Z",
"voidedAt": null,
"name": "Proveedor de ejemplo",
"kind": "supplier"
}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. |
name | string | Obligatorio | Nombre visible. Máx. 1000 caracteres. |
legalName | string | Opcional | Razón social opcional. Máx. 1000 caracteres. |
taxId | string | Opcional | CUIT, 11 dígitos como texto. Patrón: ^\d{11}$ |
kind | "supplier" | "service" | Obligatorio | Clasificación del registro; los valores permitidos dependen del recurso. |
category | string | Opcional | Rubro como texto libre, sin tabla de categorías. Máx. 1000 caracteres. |
aliases | array | Opcional | Otros nombres usados para reconocer la misma entidad. Máx. 100 elementos. |
email | email | Opcional | Correo electrónico. |
phone | string | Opcional | Teléfono como texto. Máx. 100 caracteres. |
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. |