Diferencia entre revisiones de «API Elementos»
Created page with "= API Elementos de Lazarvs = Esta documentación describe los endpoints disponibles en la API de Lazarvs para acceder a datos de elementos, verificar la existencia de clientes y objetos de contrato, así como insertarlos. == Índice == * Información General * Autenticación * Endpoints de la API * Esquemas de Respuesta == Información General == * '''Título''': API_Ele..." |
Sin resumen de edición |
||
| (No se muestra una edición intermedia del mismo usuario) | |||
| Línea 13: | Línea 13: | ||
* '''Título''': API_Elementos | * '''Título''': API_Elementos | ||
* '''Descripción''': API para operaciones de elementos en Lazarvs. | * '''Descripción''': API para operaciones de elementos en Lazarvs. | ||
* '''URL Base del Servidor''': < | * '''URL Base del Servidor''':<pre>{{URL de Lazarvs}}/elementos</pre> | ||
== Autenticación == | == Autenticación == | ||
| Línea 20: | Línea 20: | ||
'''Ejemplo de Encabezado:''' | '''Ejemplo de Encabezado:''' | ||
<pre> | |||
Authorization: Bearer <tu_token_jwt> | |||
Accept: application/json | |||
Content-Type: application/json | |||
</pre> | |||
== Convenciones y nombres externos == | |||
Los nombres externos utilizados por la integración no incluyen el prefijo <code>SDT</code>. Los nombres de los tipos internos pueden conservarlo. | |||
{| class="wikitable" | |||
! Recurso !! Raíz JSON GET !! Raíz JSON POST | |||
|- | |||
| Cliente || <code>Cliente</code> || <code>Cliente</code> | |||
|- | |||
| Objeto de contrato || <code>ObjetoContrato</code> || <code>ObjetoContrato</code> | |||
|- | |||
| Proyecto || <code>ProyectoLista</code> || No disponible | |||
|} | |||
El nombre <code>ProyectoLista</code> corresponde a la variable anterior <code>SDTProyectoLista</code> sin el prefijo. El parámetro query continúa llamándose <code>Proyecto</code> y los miembros de cada proyecto continúan siendo <code>PryCod</code>, <code>PryNom</code> y <code>Compania</code>. | |||
* Respetar exactamente las mayúsculas y minúsculas de los nombres externos y parámetros query. | |||
* Los códigos y documentos se envían como cadenas para conservar ceros iniciales. | |||
* Las fechas se expresan como <code>YYYY-MM-DD</code>. Omitir las fechas opcionales que no se utilicen; su aceptación depende de las validaciones del servicio. | |||
* Los booleanos se envían sin comillas: <code>true</code> y <code>false</code>. | |||
* Los números se envían sin comillas, con punto decimal y sin separadores de miles. | |||
* Los ejemplos son orientativos: sustituir los códigos y datos por valores válidos en la compañía y ambiente de destino. | |||
* Los campos que el YAML declara opcionales pueden estar sujetos a validaciones funcionales. No se puede deducir del YAML qué combinaciones de filtros permiten una búsqueda válida. | |||
El YAML adjunto, versión <code>20261106132434</code>, todavía declara las variables con prefijo <code>SDT</code>. Esta página utiliza los nombres externos indicados para la implementación actual. La estructura de mensajes y los códigos HTTP adicionales deben contrastarse con el servicio: el YAML solo enumera 200 y 404 y no declara la seguridad JWT, aunque la integración requiere el token. | |||
Los GET no requieren cuerpo. En los POST se debe enviar <code>Content-Type: application/json</code>; <code>Accept: application/json</code> solicita una respuesta JSON. | |||
== Endpoints de la API == | == Endpoints de la API == | ||
=== 1. /Cliente (Verificar Existencia) === | === 1. /Cliente (Verificar Existencia) === | ||
<pre> | |||
GET {{URL de Lazarvs}}/elementos/Cliente?Documentopersonajuridica=219999990099 | |||
</pre> | |||
; Descripción | ; Descripción | ||
| Línea 39: | Línea 73: | ||
; Parámetros de Consulta | ; Parámetros de Consulta | ||
* '''Documentopersonafisica''' (string, opcional): Documento de persona física. | * '''Documentopersonafisica''' (string, opcional): Documento de persona física. | ||
* '''Documentopersonajuridica''' (string, opcional): | * '''Documentopersonajuridica''' (string, opcional): Identificación fiscal de persona jurídica. | ||
| Línea 46: | Línea 80: | ||
*'''404 Not Found''': Cliente no encontrado. | *'''404 Not Found''': Cliente no encontrado. | ||
*'''401 Unauthorized''': Token JWT inválido o ausente. | *'''401 Unauthorized''': Token JWT inválido o ausente. | ||
; Ejemplo de Respuesta Exitosa | ; Ejemplo de Respuesta Exitosa | ||
<pre> | |||
{ " | { | ||
"Cliente": { | |||
"Nombre": "Corporate YYY", | |||
"TipoPersona": "J", | |||
"Localizacion": "N", | |||
"IdentificacionFiscal": "219999990099" | |||
}, | |||
"Mensajes": [ | |||
{ | { | ||
"Id": "MSG001", | |||
"Type": 2, | |||
"Description": "Cliente encontrado" | |||
} | |||
] | |||
} | } | ||
</ | </pre> | ||
=== 2. /Cliente (Insertar) === | === 2. /Cliente (Insertar) === | ||
| Línea 81: | Línea 114: | ||
; Cuerpo de la Solicitud (JSON) | ; Cuerpo de la Solicitud (JSON) | ||
* ''' | * '''Cliente''' (object): Datos del cliente a insertar. | ||
; | ; Plantilla de cuerpo de solicitud | ||
<pre> | |||
{ | { | ||
" | "Cliente": { | ||
"Codigo": "<string>", | "Codigo": "<string>", | ||
"Nombre": "<string>", | "Nombre": "<string>", | ||
| Línea 106: | Línea 139: | ||
"DocumentoTipo": "<string>", | "DocumentoTipo": "<string>", | ||
"DocumentoNumero": "<string>", | "DocumentoNumero": "<string>", | ||
"Nacimiento": " | "Nacimiento": "2026-11-06", | ||
"TrabajoNombre": "<string>", | "TrabajoNombre": "<string>", | ||
"TrabajoDireccion": "<string>", | "TrabajoDireccion": "<string>", | ||
| Línea 113: | Línea 146: | ||
"IdentificacionFiscal": "<string>", | "IdentificacionFiscal": "<string>", | ||
"Contacto": "<string>", | "Contacto": "<string>", | ||
"LimiteCredito": | "LimiteCredito": 0, | ||
"Moneda": "<string>", | "Moneda": "<string>", | ||
"Condicion": "<string>", | "Condicion": "<string>", | ||
| Línea 122: | Línea 155: | ||
"PagoEmail": "<string>", | "PagoEmail": "<string>", | ||
"PagoEmailSeEnvia": "<boolean>", | "PagoEmailSeEnvia": "<boolean>", | ||
"PagoEmailEnvioDia": | "PagoEmailEnvioDia": 0, | ||
"Situacion": "<string>", | "Situacion": "<string>", | ||
"Estado": "<string>" | "Estado": "<string>" | ||
} | } | ||
} | } | ||
</ | </pre> | ||
; Ejemplo de Cuerpo de Solicitud | ; Ejemplo de Cuerpo de Solicitud | ||
<pre> | |||
{ | { | ||
" | "Cliente": { | ||
"Nombre": "Corporate YYY", | "Nombre": "Corporate YYY", | ||
"NombreFantasia": "YYY", | "NombreFantasia": "YYY", | ||
| Línea 149: | Línea 182: | ||
"TipoPersona": "J", | "TipoPersona": "J", | ||
"Territorio": "01", | "Territorio": "01", | ||
"TrabajoNombre": "", | "TrabajoNombre": "", | ||
"TrabajoDireccion": "", | "TrabajoDireccion": "", | ||
"TrabajoTelefono": "", | "TrabajoTelefono": "", | ||
"Localizacion": "", | "Localizacion": "N", | ||
"IdentificacionFiscal": "", | "IdentificacionFiscal": "219999990099", | ||
"Contacto": "Persona X", | "Contacto": "Persona X", | ||
"LimiteCredito": | "LimiteCredito": 10000.0, | ||
"Moneda": "USD", | "Moneda": "USD", | ||
"Condicion": "", | "Condicion": "", | ||
| Línea 166: | Línea 196: | ||
"PagoTelefono": "", | "PagoTelefono": "", | ||
"PagoEmail": "", | "PagoEmail": "", | ||
"PagoEmailSeEnvia": | "PagoEmailSeEnvia": true, | ||
"PagoEmailEnvioDia": | "PagoEmailEnvioDia": 0, | ||
"Situacion": "A", | "Situacion": "A", | ||
"Estado": "A" | "Estado": "A" | ||
} | } | ||
} | } | ||
</ | </pre> | ||
; Códigos de Respuesta | ; Códigos de Respuesta | ||
*'''200 OK''': Cliente insertado exitosamente, devuelve | *'''200 OK''': Cliente insertado exitosamente, devuelve los mensajes de la operación, con la estructura de [[#Esquema Mensajes|Mensajes]]. | ||
*'''404 Not Found''': | * '''404 Not Found''': Respuesta declarada por el YAML; no identifica de forma general todos los errores de inserción. | ||
*'''401 Unauthorized''': Token JWT inválido o ausente. | *'''401 Unauthorized''': Token JWT inválido o ausente. | ||
; Ejemplo de Respuesta Exitosa | ; Ejemplo de Respuesta Exitosa | ||
La envoltura de mensajes debe comprobarse en la respuesta efectiva del servicio. El YAML declara el esquema <code>GeneXus.Common.Messages</code>, con la propiedad <code>Messages</code>; no debe suponerse que la respuesta sea un arreglo sin objeto contenedor. | |||
</ | |||
=== 3. /ObjetoContrato (Verificar Existencia) === | === 3. /ObjetoContrato (Verificar Existencia) === | ||
<pre> | |||
GET {{URL de Lazarvs}}/elementos/ObjetoContrato?Documpersonajuridica=219999990099&Modelo=MODELO&Serie=SERIE | |||
</pre> | |||
; Descripción | ; Descripción | ||
| Línea 206: | Línea 230: | ||
; Parámetros de Consulta | ; Parámetros de Consulta | ||
* '''Documpersonafisica''' (string, opcional): Documento de persona física. | * '''Documpersonafisica''' (string, opcional): Documento de persona física. | ||
* '''Documpersonajuridica''' (string, opcional): | * '''Documpersonajuridica''' (string, opcional): Identificación fiscal de persona jurídica. | ||
* '''Modelo''' (string, opcional): Modelo del objeto. | * '''Modelo''' (string, opcional): Modelo del objeto. | ||
* '''Serie''' (string, opcional): Serie del objeto. | * '''Serie''' (string, opcional): Serie del objeto. | ||
| Línea 215: | Línea 239: | ||
* '''404 Not Found''': Objeto de contrato no encontrado. | * '''404 Not Found''': Objeto de contrato no encontrado. | ||
* '''401 Unauthorized''': Token JWT inválido o ausente. | * '''401 Unauthorized''': Token JWT inválido o ausente. | ||
; Ejemplo de Respuesta Exitosa | ; Ejemplo de Respuesta Exitosa | ||
<pre> | |||
{ | { | ||
" | "ObjetoContrato": { | ||
"Cliente": "00001", | "Cliente": "00001", | ||
"Codigo": "123456", | "Codigo": "123456", | ||
| Línea 229: | Línea 252: | ||
{ | { | ||
"Id": "MSG003", | "Id": "MSG003", | ||
"Type": | "Type": 2, | ||
"Description": "Objeto de contrato encontrado" | "Description": "Objeto de contrato encontrado" | ||
} | } | ||
] | ] | ||
} | } | ||
</ | </pre> | ||
=== 4. /ObjetoContrato (Insertar) === | === 4. /ObjetoContrato (Insertar) === | ||
| Línea 248: | Línea 271: | ||
; Cuerpo de la Solicitud (JSON) | ; Cuerpo de la Solicitud (JSON) | ||
* ''' | * '''ObjetoContrato''' (object, opcional): Datos del objeto de contrato a insertar. Ver [[#Esquema ObjetoContratoInsertarInput|Esquema ObjetoContratoInsertarInput]]. | ||
; | ; Plantilla de cuerpo de solicitud | ||
<pre> | |||
{ | { | ||
" | "ObjetoContrato": { | ||
"Cliente": "<string>", | "Cliente": "<string>", | ||
"Codigo": "<string>", | "Codigo": "<string>", | ||
"Nombre": "<string>", | "Nombre": "<string>", | ||
"FechaInicio": " | "FechaInicio": "2026-11-06", | ||
"FechaFin": " | "FechaFin": "2026-11-06", | ||
"Tipo": "<string>", | "Tipo": "<string>", | ||
"DocumentoTipo": "<string>", | "DocumentoTipo": "<string>", | ||
"DocumentoNumero": "<string>", | "DocumentoNumero": "<string>", | ||
"FechaNacimiento": " | "FechaNacimiento": "2026-11-06", | ||
"Telefono": "<string>", | "Telefono": "<string>", | ||
"Email": "<string>", | "Email": "<string>", | ||
| Línea 280: | Línea 303: | ||
} | } | ||
} | } | ||
</ | </pre> | ||
; Ejemplo de Cuerpo de Solicitud | ; Ejemplo de Cuerpo de Solicitud | ||
<pre> | |||
{ | { | ||
" | "ObjetoContrato": { | ||
"Cliente": "00001", | "Cliente": "00001", | ||
"Codigo": "123456", | "Codigo": "123456", | ||
"Nombre": "Nombre Apellido", | "Nombre": "Nombre Apellido", | ||
"FechaInicio": "2024-01-01", | "FechaInicio": "2024-01-01", | ||
"Tipo": "F", | "Tipo": "F", | ||
"DocumentoTipo": "C", | "DocumentoTipo": "C", | ||
"DocumentoNumero": "1234567890", | "DocumentoNumero": "1234567890", | ||
"FechaNacimiento": " | "FechaNacimiento": "1980-06-30", | ||
"Telefono": "12345678", | "Telefono": "12345678", | ||
"Email": "aa@bb.com", | "Email": "aa@bb.com", | ||
| Línea 311: | Línea 333: | ||
} | } | ||
} | } | ||
</pre> | |||
; Códigos de Respuesta | ; Códigos de Respuesta | ||
* '''200 OK''': Objeto de contrato insertado exitosamente, devuelve | * '''200 OK''': Objeto de contrato insertado exitosamente, devuelve los mensajes de la operación, con la estructura de [[#Esquema Mensajes|Mensajes]]. | ||
* '''404 Not Found''': | * '''404 Not Found''': Respuesta declarada por el YAML; no identifica de forma general todos los errores de inserción. | ||
* '''401 Unauthorized''': Token JWT inválido o ausente. | * '''401 Unauthorized''': Token JWT inválido o ausente. | ||
; Ejemplo de Respuesta Exitosa | ; Ejemplo de Respuesta Exitosa | ||
La envoltura de mensajes debe comprobarse en la respuesta efectiva del servicio. El YAML declara el esquema <code>GeneXus.Common.Messages</code>, con la propiedad <code>Messages</code>; no debe suponerse que la respuesta sea un arreglo sin objeto contenedor. | |||
</ | |||
=== 5. /Proyecto (Verificar Existencia) === | === 5. /Proyecto (Verificar Existencia) === | ||
<pre> | |||
GET {{URL de Lazarvs}}/elementos/Proyecto?Proyecto=PRJ001 | |||
</pre> | |||
; Descripción : Verifica la existencia de un proyecto mediante su código. | ; Descripción : Verifica la existencia de un proyecto mediante su código. | ||
| Línea 349: | Línea 365: | ||
* '''404 Not Found''': Proyecto no encontrado. | * '''404 Not Found''': Proyecto no encontrado. | ||
* '''401 Unauthorized''': Token JWT inválido o ausente. | * '''401 Unauthorized''': Token JWT inválido o ausente. | ||
; Ejemplo de Respuesta Exitosa | ; Ejemplo de Respuesta Exitosa | ||
<pre> | |||
{ | { | ||
" | "ProyectoLista": [ | ||
{ | { | ||
"PryCod": "PRJ001", | "PryCod": "PRJ001", | ||
| Línea 365: | Línea 380: | ||
{ | { | ||
"Id": "MSG005", | "Id": "MSG005", | ||
"Type": | "Type": 2, | ||
"Description": "Proyecto encontrado" | "Description": "Proyecto encontrado" | ||
} | } | ||
] | ] | ||
} | } | ||
</ | </pre> | ||
== Esquemas de Respuesta == | == Esquemas de Respuesta == | ||
| Línea 376: | Línea 391: | ||
=== Esquema Cliente_getOutput === | === Esquema Cliente_getOutput === | ||
* ''' | * '''Cliente''' (object, opcional): Información detallada del cliente. Ver [[#Esquema ClienteInsertarInput|Esquema ClienteInsertarInput]]. | ||
* '''Mensajes''' (array, opcional): Mensajes relacionados con la operación. Ver [[#Esquema Mensajes|Mensajes]]. | * '''Mensajes''' (array, opcional): Mensajes relacionados con la operación. Ver [[#Esquema Mensajes|Mensajes]]. | ||
=== Esquema ObjetoContrato_getOutput === | === Esquema ObjetoContrato_getOutput === | ||
* ''' | * '''ObjetoContrato''' (object, opcional): Información detallada del objeto de contrato. Ver [[#Esquema ObjetoContratoInsertarInput|Esquema ObjetoContratoInsertarInput]]. | ||
* '''Mensajes''' (array, opcional): Mensajes relacionados con la operación. Ver [[#Esquema Mensajes|Mensajes]]. | * '''Mensajes''' (array, opcional): Mensajes relacionados con la operación. Ver [[#Esquema Mensajes|Mensajes]]. | ||
=== Esquema ProyectoOutput === | === Esquema ProyectoOutput === | ||
* ''' | * '''ProyectoLista''' (array, opcional): Lista de proyectos. | ||
** '''PryCod''' (string): Código del proyecto. | |||
** '''PryNom''' (string): Nombre del proyecto. | |||
** '''Compania''' (string): Compañía asociada. | |||
* '''Mensajes''' (array, opcional): Mensajes relacionados con la operación. Ver [[#Esquema Mensajes|Mensajes]]. | * '''Mensajes''' (array, opcional): Mensajes relacionados con la operación. Ver [[#Esquema Mensajes|Mensajes]]. | ||
| Línea 395: | Línea 410: | ||
* '''Id''' (string): ID del mensaje. | * '''Id''' (string): ID del mensaje. | ||
* '''Type''' (integer, format: int32): Tipo de mensaje (1 | * '''Type''' (integer, format: int32): Tipo de mensaje: 0 = Advertencia (Warning), 1 = Error (Error), 2 = Información (Info), 3 = Depuración (Debug). | ||
* '''Description''' (string): Descripción del mensaje. | * '''Description''' (string): Descripción del mensaje. | ||
=== Esquema ClienteInsertarInput === | === Esquema ClienteInsertarInput === | ||
* ''' | * '''Cliente''' (object, opcional): Información detallada del cliente a insertar. | ||
** '''Codigo''' (string, opcional): Código de Cliente. | |||
** '''Nombre''' (string, opcional): Nombre de Cliente. | |||
** '''NombreFantasia''' (string, opcional): Nombre Fantasía. | |||
** '''NumeroFidelizacion''' (string, opcional): Número de Fidelización. | |||
** '''Direccion''' (string, opcional): Dirección de Cliente. | |||
** '''Ciudad''' (string, opcional): Ciudad del Cliente. | |||
** '''CodigoPostal''' (string, opcional): Código Postal. | |||
** '''EstadoProvincia''' (string, opcional): Estado/Provincia. | |||
** '''Pais''' (string, opcional): País (ejemplo: "UY"). | |||
** '''Telefono''' (string, opcional): Teléfono del Cliente. | |||
** '''Celular''' (string, opcional): Celular. | |||
** '''Email''' (string, opcional): E-mail del Cliente. | |||
** '''EmailFacturacion''' (string, opcional): E-mail facturación. | |||
** '''DatosFacturacion''' (string, opcional): Datos Facturación. | |||
** '''TipoCliente''' (string, opcional): Tipo de Cliente (ejemplo: "CN"). | |||
** '''TipoPersona''' (string, opcional): Tipo de Persona (ejemplo: "J" para jurídica, "F" para física). | |||
** '''Territorio''' (string, opcional): Código de Territorio. | |||
** '''DocumentoTipo''' (string, opcional): Tipo de Documento (ejemplo: "N"). | |||
** '''DocumentoNumero''' (string, opcional): Número de Documento. | |||
** '''Nacimiento''' (string, format: date, opcional): Fecha de Nacimiento (formato: YYYY-MM-DD). | |||
** '''TrabajoNombre''' (string, opcional): Trabajo del Cliente. | |||
** '''TrabajoDireccion''' (string, opcional): Dirección del Trabajo del Cliente. | |||
** '''TrabajoTelefono''' (string, opcional): Teléfono del Trabajo del Cliente. | |||
** '''Localizacion''' (string, opcional): Localización. | |||
** '''IdentificacionFiscal''' (string, opcional): Id Tributaria. | |||
** '''Contacto''' (string, opcional): Contacto en el Cliente. | |||
** '''LimiteCredito''' (number, format: double, opcional): Límite de Crédito. | |||
** '''Moneda''' (string, opcional): Moneda (ejemplo: "USD"). | |||
** '''Condicion''' (string, opcional): Condición. | |||
** '''PresentacionDia''' (string, opcional): Días de presentación de facturas. | |||
** '''PagoDia''' (string, opcional): Días de pago a proveedores. | |||
** '''PagoContacto''' (string, opcional): Contacto pago a proveedores. | |||
** '''PagoTelefono''' (string, opcional): Teléfono pago a proveedores. | |||
** '''PagoEmail''' (string, opcional): E-mail pago a proveedores. | |||
** '''PagoEmailSeEnvia''' (boolean, opcional): ¿Se envían mails recordatorios? | |||
** '''PagoEmailEnvioDia''' (integer, format: int32, opcional): Día de envío. | |||
** '''Situacion''' (string, opcional): Situación (ejemplo: "A"). | |||
** '''Estado''' (string, opcional): Estado del Cliente (ejemplo: "A"). | |||
=== Esquema ObjetoContratoInsertarInput === | === Esquema ObjetoContratoInsertarInput === | ||
* ''' | * '''ObjetoContrato''' (object, opcional): Información detallada del contrato a insertar. | ||
** '''Cliente''' (string, opcional): Código de Cliente. | |||
** '''Codigo''' (string, opcional): Código. | |||
** '''Nombre''' (string, opcional): Nombre. | |||
** '''FechaInicio''' (string, format: date, opcional): Fecha de inicio (formato: YYYY-MM-DD). | |||
** '''FechaFin''' (string, format: date, opcional): Fecha de fin (formato: YYYY-MM-DD). | |||
** '''Tipo''' (string, opcional): Tipo (ejemplo: "F"). | |||
** '''DocumentoTipo''' (string, opcional): Tipo de Documento (ejemplo: "C"). | |||
** '''DocumentoNumero''' (string, opcional): Número de Documento. | |||
** '''FechaNacimiento''' (string, format: date, opcional): Fecha de Nacimiento (formato: YYYY-MM-DD). | |||
** '''Telefono''' (string, opcional): Teléfono. | |||
** '''Email''' (string, opcional): E-mail. | |||
** '''EmailFacturacion''' (string, opcional): E-mail facturación. | |||
** '''Localizacion''' (string, opcional): Localización. | |||
** '''IdentificacionFiscal''' (string, opcional): Identificación Fiscal. | |||
** '''Contacto''' (string, opcional): Contacto. | |||
** '''Modelo''' (string, opcional): Modelo. | |||
** '''Serie''' (string, opcional): Serie. | |||
** '''Ubicacion''' (string, opcional): Ubicación. | |||
** '''Responsable''' (string, opcional): Responsable. | |||
** '''Plan''' (string, opcional): Plan. | |||
** '''Poliza''' (string, opcional): Póliza. | |||
** '''DatoAdicional''' (string, opcional): Dato Adicional. | |||
** '''Estado''' (string, opcional): Estado (ejemplo: "A"). | |||
== Valores enumerados == | |||
{| class="wikitable" | |||
! Campo !! Valores | |||
|- | |||
| <code>Cliente.TipoPersona</code> || <code>F</code> = Fisico, <code>J</code> = Juridico | |||
|- | |||
| <code>Cliente.DocumentoTipo</code> || <code>C</code> = CI, <code>D</code> = DNI, <code>P</code> = Pasaporte, <code>N</code> = NIE, <code>O</code> = Otros | |||
|- | |||
| <code>Cliente.Localizacion</code> || <code>N</code> = Nacional, <code>E</code> = Exterior | |||
|- | |||
| <code>Cliente.Situacion</code> || <code>A</code> = Activo, <code>H</code> = Suspendido, <code>C</code> = Clearing | |||
|- | |||
| <code>Cliente.Estado</code> || <code>A</code> = Abierto, <code>C</code> = Cerrado | |||
|- | |||
| <code>ObjetoContrato.Tipo</code> || <code>F</code> = PersonaFisica, <code>J</code> = PersonaJuridica, <code>B</code> = BienFisico, <code>I</code> = BienIntangible | |||
|- | |||
| <code>ObjetoContrato.DocumentoTipo</code> || <code>C</code> = CI, <code>D</code> = DNI, <code>P</code> = Pasaporte, <code>N</code> = NIE, <code>O</code> = Otros | |||
|- | |||
| <code>ObjetoContrato.Localizacion</code> || <code>N</code> = Nacional, <code>E</code> = Exterior | |||
|- | |||
| <code>ObjetoContrato.Estado</code> || <code>A</code> = Abierto, <code>C</code> = Cerrado | |||
|} | |||
En clientes, <code>DocumentoTipo</code> y <code>DocumentoNumero</code> identifican a la persona física; <code>Localizacion</code> e <code>IdentificacionFiscal</code> corresponden a la identificación fiscal de la persona jurídica. Los valores de los ejemplos deben cumplir las reglas del país y de la compañía. | |||
Revisión actual - 11:05 6 nov 2026
API Elementos de Lazarvs
Esta documentación describe los endpoints disponibles en la API de Lazarvs para acceder a datos de elementos, verificar la existencia de clientes y objetos de contrato, así como insertarlos.
Índice
Información General
- Título: API_Elementos
- Descripción: API para operaciones de elementos en Lazarvs.
- URL Base del Servidor:
{{URL de Lazarvs}}/elementos
Autenticación
Para acceder a los endpoints, se requiere un token JWT que debe incluirse en el encabezado Authorization con el prefijo "Bearer".
Ejemplo de Encabezado:
Authorization: Bearer <tu_token_jwt> Accept: application/json Content-Type: application/json
Convenciones y nombres externos
Los nombres externos utilizados por la integración no incluyen el prefijo SDT. Los nombres de los tipos internos pueden conservarlo.
| Recurso | Raíz JSON GET | Raíz JSON POST |
|---|---|---|
| Cliente | Cliente |
Cliente
|
| Objeto de contrato | ObjetoContrato |
ObjetoContrato
|
| Proyecto | ProyectoLista |
No disponible |
El nombre ProyectoLista corresponde a la variable anterior SDTProyectoLista sin el prefijo. El parámetro query continúa llamándose Proyecto y los miembros de cada proyecto continúan siendo PryCod, PryNom y Compania.
- Respetar exactamente las mayúsculas y minúsculas de los nombres externos y parámetros query.
- Los códigos y documentos se envían como cadenas para conservar ceros iniciales.
- Las fechas se expresan como
YYYY-MM-DD. Omitir las fechas opcionales que no se utilicen; su aceptación depende de las validaciones del servicio. - Los booleanos se envían sin comillas:
trueyfalse. - Los números se envían sin comillas, con punto decimal y sin separadores de miles.
- Los ejemplos son orientativos: sustituir los códigos y datos por valores válidos en la compañía y ambiente de destino.
- Los campos que el YAML declara opcionales pueden estar sujetos a validaciones funcionales. No se puede deducir del YAML qué combinaciones de filtros permiten una búsqueda válida.
El YAML adjunto, versión 20261106132434, todavía declara las variables con prefijo SDT. Esta página utiliza los nombres externos indicados para la implementación actual. La estructura de mensajes y los códigos HTTP adicionales deben contrastarse con el servicio: el YAML solo enumera 200 y 404 y no declara la seguridad JWT, aunque la integración requiere el token.
Los GET no requieren cuerpo. En los POST se debe enviar Content-Type: application/json; Accept: application/json solicita una respuesta JSON.
Endpoints de la API
1. /Cliente (Verificar Existencia)
GET {{URL de Lazarvs}}/elementos/Cliente?Documentopersonajuridica=219999990099
- Descripción
- Verifica la existencia de un cliente mediante su documento.
- Método
- GET
- URL
- /Cliente
- Parámetros de Consulta
- Documentopersonafisica (string, opcional): Documento de persona física.
- Documentopersonajuridica (string, opcional): Identificación fiscal de persona jurídica.
- Códigos de Respuesta
- 200 OK: La solicitud fue exitosa, devuelve un JSON con la estructura de Cliente_getOutput.
- 404 Not Found: Cliente no encontrado.
- 401 Unauthorized: Token JWT inválido o ausente.
- Ejemplo de Respuesta Exitosa
{
"Cliente": {
"Nombre": "Corporate YYY",
"TipoPersona": "J",
"Localizacion": "N",
"IdentificacionFiscal": "219999990099"
},
"Mensajes": [
{
"Id": "MSG001",
"Type": 2,
"Description": "Cliente encontrado"
}
]
}
2. /Cliente (Insertar)
- Descripción
- Inserta un nuevo cliente en el sistema.
- Método
- POST
- URL
- /Cliente
- Cuerpo de la Solicitud (JSON)
- Cliente (object): Datos del cliente a insertar.
- Plantilla de cuerpo de solicitud
{
"Cliente": {
"Codigo": "<string>",
"Nombre": "<string>",
"NombreFantasia": "<string>",
"NumeroFidelizacion": "<string>",
"Direccion": "<string>",
"Ciudad": "<string>",
"CodigoPostal": "<string>",
"EstadoProvincia": "<string>",
"Pais": "<string>",
"Telefono": "<string>",
"Celular": "<string>",
"Email": "<string>",
"EmailFacturacion": "<string>",
"DatosFacturacion": "<string>",
"TipoCliente": "<string>",
"TipoPersona": "<string>",
"Territorio": "<string>",
"DocumentoTipo": "<string>",
"DocumentoNumero": "<string>",
"Nacimiento": "2026-11-06",
"TrabajoNombre": "<string>",
"TrabajoDireccion": "<string>",
"TrabajoTelefono": "<string>",
"Localizacion": "<string>",
"IdentificacionFiscal": "<string>",
"Contacto": "<string>",
"LimiteCredito": 0,
"Moneda": "<string>",
"Condicion": "<string>",
"PresentacionDia": "<string>",
"PagoDia": "<string>",
"PagoContacto": "<string>",
"PagoTelefono": "<string>",
"PagoEmail": "<string>",
"PagoEmailSeEnvia": "<boolean>",
"PagoEmailEnvioDia": 0,
"Situacion": "<string>",
"Estado": "<string>"
}
}
- Ejemplo de Cuerpo de Solicitud
{
"Cliente": {
"Nombre": "Corporate YYY",
"NombreFantasia": "YYY",
"NumeroFidelizacion": "",
"Direccion": "Calle y Número",
"Ciudad": "Ciudad X",
"CodigoPostal": "12345",
"EstadoProvincia": "Montevideo",
"Pais": "UY",
"Telefono": "12345678",
"Celular": "012345678",
"Email": "aa@bb.com",
"EmailFacturacion": "cc@bb.com",
"DatosFacturacion": "N/A",
"TipoCliente": "CN",
"TipoPersona": "J",
"Territorio": "01",
"TrabajoNombre": "",
"TrabajoDireccion": "",
"TrabajoTelefono": "",
"Localizacion": "N",
"IdentificacionFiscal": "219999990099",
"Contacto": "Persona X",
"LimiteCredito": 10000.0,
"Moneda": "USD",
"Condicion": "",
"PresentacionDia": "",
"PagoDia": "",
"PagoContacto": "",
"PagoTelefono": "",
"PagoEmail": "",
"PagoEmailSeEnvia": true,
"PagoEmailEnvioDia": 0,
"Situacion": "A",
"Estado": "A"
}
}
- Códigos de Respuesta
- 200 OK: Cliente insertado exitosamente, devuelve los mensajes de la operación, con la estructura de Mensajes.
- 404 Not Found: Respuesta declarada por el YAML; no identifica de forma general todos los errores de inserción.
- 401 Unauthorized: Token JWT inválido o ausente.
- Ejemplo de Respuesta Exitosa
La envoltura de mensajes debe comprobarse en la respuesta efectiva del servicio. El YAML declara el esquema GeneXus.Common.Messages, con la propiedad Messages; no debe suponerse que la respuesta sea un arreglo sin objeto contenedor.
3. /ObjetoContrato (Verificar Existencia)
GET {{URL de Lazarvs}}/elementos/ObjetoContrato?Documpersonajuridica=219999990099&Modelo=MODELO&Serie=SERIE
- Descripción
- Verifica la existencia de un objeto de contrato mediante datos de cliente y objeto.
- Método
- GET
- URL
- /ObjetoContrato
- Parámetros de Consulta
- Documpersonafisica (string, opcional): Documento de persona física.
- Documpersonajuridica (string, opcional): Identificación fiscal de persona jurídica.
- Modelo (string, opcional): Modelo del objeto.
- Serie (string, opcional): Serie del objeto.
- Códigos de Respuesta
- 200 OK: La solicitud fue exitosa, devuelve un JSON con la estructura de ObjetoContrato_getOutput.
- 404 Not Found: Objeto de contrato no encontrado.
- 401 Unauthorized: Token JWT inválido o ausente.
- Ejemplo de Respuesta Exitosa
{
"ObjetoContrato": {
"Cliente": "00001",
"Codigo": "123456",
"Nombre": "Nombre Apellido"
},
"Mensajes": [
{
"Id": "MSG003",
"Type": 2,
"Description": "Objeto de contrato encontrado"
}
]
}
4. /ObjetoContrato (Insertar)
- Descripción
- Inserta un nuevo objeto de contrato en el sistema.
- Método
- POST
- URL
- /ObjetoContrato
- Cuerpo de la Solicitud (JSON)
- ObjetoContrato (object, opcional): Datos del objeto de contrato a insertar. Ver Esquema ObjetoContratoInsertarInput.
- Plantilla de cuerpo de solicitud
{
"ObjetoContrato": {
"Cliente": "<string>",
"Codigo": "<string>",
"Nombre": "<string>",
"FechaInicio": "2026-11-06",
"FechaFin": "2026-11-06",
"Tipo": "<string>",
"DocumentoTipo": "<string>",
"DocumentoNumero": "<string>",
"FechaNacimiento": "2026-11-06",
"Telefono": "<string>",
"Email": "<string>",
"EmailFacturacion": "<string>",
"Localizacion": "<string>",
"IdentificacionFiscal": "<string>",
"Contacto": "<string>",
"Modelo": "<string>",
"Serie": "<string>",
"Ubicacion": "<string>",
"Responsable": "<string>",
"Plan": "<string>",
"Poliza": "<string>",
"DatoAdicional": "<string>",
"Estado": "<string>"
}
}
- Ejemplo de Cuerpo de Solicitud
{
"ObjetoContrato": {
"Cliente": "00001",
"Codigo": "123456",
"Nombre": "Nombre Apellido",
"FechaInicio": "2024-01-01",
"Tipo": "F",
"DocumentoTipo": "C",
"DocumentoNumero": "1234567890",
"FechaNacimiento": "1980-06-30",
"Telefono": "12345678",
"Email": "aa@bb.com",
"EmailFacturacion": "cc@bb.com",
"Localizacion": "",
"IdentificacionFiscal": "",
"Contacto": "Nombre y apellido",
"Modelo": "",
"Serie": "",
"Ubicacion": "",
"Responsable": "",
"Plan": "Plan X",
"Poliza": "Póliza Y",
"DatoAdicional": "Otra información",
"Estado": "A"
}
}
- Códigos de Respuesta
- 200 OK: Objeto de contrato insertado exitosamente, devuelve los mensajes de la operación, con la estructura de Mensajes.
- 404 Not Found: Respuesta declarada por el YAML; no identifica de forma general todos los errores de inserción.
- 401 Unauthorized: Token JWT inválido o ausente.
- Ejemplo de Respuesta Exitosa
La envoltura de mensajes debe comprobarse en la respuesta efectiva del servicio. El YAML declara el esquema GeneXus.Common.Messages, con la propiedad Messages; no debe suponerse que la respuesta sea un arreglo sin objeto contenedor.
5. /Proyecto (Verificar Existencia)
GET {{URL de Lazarvs}}/elementos/Proyecto?Proyecto=PRJ001
- Descripción
- Verifica la existencia de un proyecto mediante su código.
- Método
- GET
- URL
- /Proyecto
- Parámetros de Consulta
Proyecto (string, opcional): Código del proyecto.
- Códigos de Respuesta
- 200 OK: La solicitud fue exitosa, devuelve un JSON con la estructura de ProyectoOutput.
- 404 Not Found: Proyecto no encontrado.
- 401 Unauthorized: Token JWT inválido o ausente.
- Ejemplo de Respuesta Exitosa
{
"ProyectoLista": [
{
"PryCod": "PRJ001",
"PryNom": "Proyecto Alpha",
"Compania": "Empresa X"
}
],
"Mensajes": [
{
"Id": "MSG005",
"Type": 2,
"Description": "Proyecto encontrado"
}
]
}
Esquemas de Respuesta
Esquema Cliente_getOutput
- Cliente (object, opcional): Información detallada del cliente. Ver Esquema ClienteInsertarInput.
- Mensajes (array, opcional): Mensajes relacionados con la operación. Ver Mensajes.
Esquema ObjetoContrato_getOutput
- ObjetoContrato (object, opcional): Información detallada del objeto de contrato. Ver Esquema ObjetoContratoInsertarInput.
- Mensajes (array, opcional): Mensajes relacionados con la operación. Ver Mensajes.
Esquema ProyectoOutput
- ProyectoLista (array, opcional): Lista de proyectos.
- PryCod (string): Código del proyecto.
- PryNom (string): Nombre del proyecto.
- Compania (string): Compañía asociada.
- Mensajes (array, opcional): Mensajes relacionados con la operación. Ver Mensajes.
Esquema Mensajes
- Id (string): ID del mensaje.
- Type (integer, format: int32): Tipo de mensaje: 0 = Advertencia (Warning), 1 = Error (Error), 2 = Información (Info), 3 = Depuración (Debug).
- Description (string): Descripción del mensaje.
Esquema ClienteInsertarInput
- Cliente (object, opcional): Información detallada del cliente a insertar.
- Codigo (string, opcional): Código de Cliente.
- Nombre (string, opcional): Nombre de Cliente.
- NombreFantasia (string, opcional): Nombre Fantasía.
- NumeroFidelizacion (string, opcional): Número de Fidelización.
- Direccion (string, opcional): Dirección de Cliente.
- Ciudad (string, opcional): Ciudad del Cliente.
- CodigoPostal (string, opcional): Código Postal.
- EstadoProvincia (string, opcional): Estado/Provincia.
- Pais (string, opcional): País (ejemplo: "UY").
- Telefono (string, opcional): Teléfono del Cliente.
- Celular (string, opcional): Celular.
- Email (string, opcional): E-mail del Cliente.
- EmailFacturacion (string, opcional): E-mail facturación.
- DatosFacturacion (string, opcional): Datos Facturación.
- TipoCliente (string, opcional): Tipo de Cliente (ejemplo: "CN").
- TipoPersona (string, opcional): Tipo de Persona (ejemplo: "J" para jurídica, "F" para física).
- Territorio (string, opcional): Código de Territorio.
- DocumentoTipo (string, opcional): Tipo de Documento (ejemplo: "N").
- DocumentoNumero (string, opcional): Número de Documento.
- Nacimiento (string, format: date, opcional): Fecha de Nacimiento (formato: YYYY-MM-DD).
- TrabajoNombre (string, opcional): Trabajo del Cliente.
- TrabajoDireccion (string, opcional): Dirección del Trabajo del Cliente.
- TrabajoTelefono (string, opcional): Teléfono del Trabajo del Cliente.
- Localizacion (string, opcional): Localización.
- IdentificacionFiscal (string, opcional): Id Tributaria.
- Contacto (string, opcional): Contacto en el Cliente.
- LimiteCredito (number, format: double, opcional): Límite de Crédito.
- Moneda (string, opcional): Moneda (ejemplo: "USD").
- Condicion (string, opcional): Condición.
- PresentacionDia (string, opcional): Días de presentación de facturas.
- PagoDia (string, opcional): Días de pago a proveedores.
- PagoContacto (string, opcional): Contacto pago a proveedores.
- PagoTelefono (string, opcional): Teléfono pago a proveedores.
- PagoEmail (string, opcional): E-mail pago a proveedores.
- PagoEmailSeEnvia (boolean, opcional): ¿Se envían mails recordatorios?
- PagoEmailEnvioDia (integer, format: int32, opcional): Día de envío.
- Situacion (string, opcional): Situación (ejemplo: "A").
- Estado (string, opcional): Estado del Cliente (ejemplo: "A").
Esquema ObjetoContratoInsertarInput
- ObjetoContrato (object, opcional): Información detallada del contrato a insertar.
- Cliente (string, opcional): Código de Cliente.
- Codigo (string, opcional): Código.
- Nombre (string, opcional): Nombre.
- FechaInicio (string, format: date, opcional): Fecha de inicio (formato: YYYY-MM-DD).
- FechaFin (string, format: date, opcional): Fecha de fin (formato: YYYY-MM-DD).
- Tipo (string, opcional): Tipo (ejemplo: "F").
- DocumentoTipo (string, opcional): Tipo de Documento (ejemplo: "C").
- DocumentoNumero (string, opcional): Número de Documento.
- FechaNacimiento (string, format: date, opcional): Fecha de Nacimiento (formato: YYYY-MM-DD).
- Telefono (string, opcional): Teléfono.
- Email (string, opcional): E-mail.
- EmailFacturacion (string, opcional): E-mail facturación.
- Localizacion (string, opcional): Localización.
- IdentificacionFiscal (string, opcional): Identificación Fiscal.
- Contacto (string, opcional): Contacto.
- Modelo (string, opcional): Modelo.
- Serie (string, opcional): Serie.
- Ubicacion (string, opcional): Ubicación.
- Responsable (string, opcional): Responsable.
- Plan (string, opcional): Plan.
- Poliza (string, opcional): Póliza.
- DatoAdicional (string, opcional): Dato Adicional.
- Estado (string, opcional): Estado (ejemplo: "A").
Valores enumerados
| Campo | Valores |
|---|---|
Cliente.TipoPersona |
F = Fisico, J = Juridico
|
Cliente.DocumentoTipo |
C = CI, D = DNI, P = Pasaporte, N = NIE, O = Otros
|
Cliente.Localizacion |
N = Nacional, E = Exterior
|
Cliente.Situacion |
A = Activo, H = Suspendido, C = Clearing
|
Cliente.Estado |
A = Abierto, C = Cerrado
|
ObjetoContrato.Tipo |
F = PersonaFisica, J = PersonaJuridica, B = BienFisico, I = BienIntangible
|
ObjetoContrato.DocumentoTipo |
C = CI, D = DNI, P = Pasaporte, N = NIE, O = Otros
|
ObjetoContrato.Localizacion |
N = Nacional, E = Exterior
|
ObjetoContrato.Estado |
A = Abierto, C = Cerrado
|
En clientes, DocumentoTipo y DocumentoNumero identifican a la persona física; Localizacion e IdentificacionFiscal corresponden a la identificación fiscal de la persona jurídica. Los valores de los ejemplos deben cumplir las reglas del país y de la compañía.