Ir al contenido

Diferencia entre revisiones de «API Elementos»

De LAZARVS
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
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''': <nowiki>{{URL de Lazarvs}}/elementos</nowiki>
* '''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:'''
<nowiki>
<pre>
  Authorization: Bearer <tu_token_jwt>
  Authorization: Bearer <tu_token_jwt>
</nowiki>
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): Documento de persona jurídica.
* '''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.
*'''500 Internal Server Error''': Error interno del servidor.




; Ejemplo de Respuesta Exitosa
; Ejemplo de Respuesta Exitosa


<nowiki>
<pre>
{ "SDTCliente":
{
  "Cliente": {
    "Nombre": "Corporate YYY",
    "TipoPersona": "J",
    "Localizacion": "N",
    "IdentificacionFiscal": "219999990099"
  },
  "Mensajes": [
     {
     {
       "Nombre": "Corporate YYY",
       "Id": "MSG001",
      "DocumentoNumero": "219999990099",
      "Type": 2,
      "TipoPersona": "J"
      "Description": "Cliente encontrado"
    },
    }
  "Mensajes":
  ]
    [
        {
          "Id": "MSG001",
          "Type": 1,
          "Description": "Cliente encontrado"
        }
    ]
}
}
</nowiki>
</pre>


=== 2. /Cliente (Insertar) ===
=== 2. /Cliente (Insertar) ===
Línea 81: Línea 114:


; Cuerpo de la Solicitud (JSON)
; Cuerpo de la Solicitud (JSON)
* '''SDTCliente''' (object): Datos del cliente a insertar.
* '''Cliente''' (object): Datos del cliente a insertar.


; Cuerpo de solicitud vacío
; Plantilla de cuerpo de solicitud
<nowiki>
<pre>
{
{
   "SDTCliente": {
   "Cliente": {
     "Codigo": "<string>",
     "Codigo": "<string>",
     "Nombre": "<string>",
     "Nombre": "<string>",
Línea 106: Línea 139:
     "DocumentoTipo": "<string>",
     "DocumentoTipo": "<string>",
     "DocumentoNumero": "<string>",
     "DocumentoNumero": "<string>",
     "Nacimiento": "<date>",
     "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": "<double>",
     "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": "<integer>",
     "PagoEmailEnvioDia": 0,
     "Situacion": "<string>",
     "Situacion": "<string>",
     "Estado": "<string>"
     "Estado": "<string>"
   }
   }
}
}
</nowiki>
</pre>


; Ejemplo de Cuerpo de Solicitud
; Ejemplo de Cuerpo de Solicitud
<nowiki>
<pre>
{
{
   "SDTCliente": {
   "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",
    "DocumentoTipo": "N",
    "DocumentoNumero": "219999990099",
    "Nacimiento": "1950-07-28",
     "TrabajoNombre": "",
     "TrabajoNombre": "",
     "TrabajoDireccion": "",
     "TrabajoDireccion": "",
     "TrabajoTelefono": "",
     "TrabajoTelefono": "",
     "Localizacion": "",
     "Localizacion": "N",
     "IdentificacionFiscal": "",
     "IdentificacionFiscal": "219999990099",
     "Contacto": "Persona X",
     "Contacto": "Persona X",
     "LimiteCredito": "10000",
     "LimiteCredito": 10000.0,
     "Moneda": "USD",
     "Moneda": "USD",
     "Condicion": "",
     "Condicion": "",
Línea 166: Línea 196:
     "PagoTelefono": "",
     "PagoTelefono": "",
     "PagoEmail": "",
     "PagoEmail": "",
     "PagoEmailSeEnvia": "true",
     "PagoEmailSeEnvia": true,
     "PagoEmailEnvioDia": "0",
     "PagoEmailEnvioDia": 0,
     "Situacion": "A",
     "Situacion": "A",
     "Estado": "A"
     "Estado": "A"
   }
   }
}
}
</nowiki>
</pre>


; Códigos de Respuesta
; Códigos de Respuesta
*'''200 OK''': Cliente insertado exitosamente, devuelve un array de mensajes con la estructura de [[#Esquema Mensajes|Mensajes]].
*'''200 OK''': Cliente insertado exitosamente, devuelve los mensajes de la operación, con la estructura de [[#Esquema Mensajes|Mensajes]].
*'''404 Not Found''': Error en la inserción.
* '''404 Not Found''': Respuesta declarada por el YAML; no identifica de forma general todos los errores de inserción.
*'''400 Bad Request''': Datos del cliente inválidos o faltantes.
*'''401 Unauthorized''': Token JWT inválido o ausente.
*'''401 Unauthorized''': Token JWT inválido o ausente.
*'''500 Internal Server Error''': Error interno del servidor.




; Ejemplo de Respuesta Exitosa
; Ejemplo de Respuesta Exitosa
<nowiki>
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.
[
  {
    "Id": "MSG002",
    "Type": 1,
    "Description": "Cliente insertado exitosamente"
  }
]
</nowiki>


=== 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): Documento de persona jurídica.
* '''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.
* '''500 Internal Server Error''': Error interno del servidor.




; Ejemplo de Respuesta Exitosa
; Ejemplo de Respuesta Exitosa
<nowiki>
<pre>
{
{
   "SDTObjetoContrato": {
   "ObjetoContrato": {
     "Cliente": "00001",
     "Cliente": "00001",
     "Codigo": "123456",
     "Codigo": "123456",
Línea 229: Línea 252:
     {
     {
       "Id": "MSG003",
       "Id": "MSG003",
       "Type": 1,
       "Type": 2,
       "Description": "Objeto de contrato encontrado"
       "Description": "Objeto de contrato encontrado"
     }
     }
   ]
   ]
}
}
</nowiki>
</pre>


=== 4. /ObjetoContrato (Insertar) ===
=== 4. /ObjetoContrato (Insertar) ===
Línea 248: Línea 271:


; Cuerpo de la Solicitud (JSON)
; Cuerpo de la Solicitud (JSON)
* '''SDTObjetoContrato''' (object, opcional): Datos del objeto de contrato a insertar. Ver [[#Esquema ObjetoContratoInsertarInput|Esquema ObjetoContratoInsertarInput]].
* '''ObjetoContrato''' (object, opcional): Datos del objeto de contrato a insertar. Ver [[#Esquema ObjetoContratoInsertarInput|Esquema ObjetoContratoInsertarInput]].




; Cuerpo de Solicitud vacío
; Plantilla de cuerpo de solicitud
<nowiki>
<pre>
{
{
   "SDTObjetoContrato": {
   "ObjetoContrato": {
     "Cliente": "<string>",
     "Cliente": "<string>",
     "Codigo": "<string>",
     "Codigo": "<string>",
     "Nombre": "<string>",
     "Nombre": "<string>",
     "FechaInicio": "<date>",
     "FechaInicio": "2026-11-06",
     "FechaFin": "<date>",
     "FechaFin": "2026-11-06",
     "Tipo": "<string>",
     "Tipo": "<string>",
     "DocumentoTipo": "<string>",
     "DocumentoTipo": "<string>",
     "DocumentoNumero": "<string>",
     "DocumentoNumero": "<string>",
     "FechaNacimiento": "<date>",
     "FechaNacimiento": "2026-11-06",
     "Telefono": "<string>",
     "Telefono": "<string>",
     "Email": "<string>",
     "Email": "<string>",
Línea 280: Línea 303:
   }
   }
}
}
</nowiki>
</pre>


; Ejemplo de Cuerpo de Solicitud
; Ejemplo de Cuerpo de Solicitud
<nowiki>
<pre>
{
{
   "SDTObjetoContrato": {
   "ObjetoContrato": {
     "Cliente": "00001",
     "Cliente": "00001",
     "Codigo": "123456",
     "Codigo": "123456",
     "Nombre": "Nombre Apellido",
     "Nombre": "Nombre Apellido",
     "FechaInicio": "2024-01-01",
     "FechaInicio": "2024-01-01",
    "FechaFin": "",
     "Tipo": "F",
     "Tipo": "F",
     "DocumentoTipo": "C",
     "DocumentoTipo": "C",
     "DocumentoNumero": "1234567890",
     "DocumentoNumero": "1234567890",
     "FechaNacimiento": "2050-06-30",
     "FechaNacimiento": "1980-06-30",
     "Telefono": "12345678",
     "Telefono": "12345678",
     "Email": "aa@bb.com",
     "Email": "aa@bb.com",
Línea 311: Línea 333:
   }
   }
}
}
</nowiki>
</pre>


; Códigos de Respuesta
; Códigos de Respuesta
* '''200 OK''': Objeto de contrato insertado exitosamente, devuelve un array de mensajes con la estructura de [[#Esquema Mensajes|Mensajes]].
* '''200 OK''': Objeto de contrato insertado exitosamente, devuelve los mensajes de la operación, con la estructura de [[#Esquema Mensajes|Mensajes]].
* '''404 Not Found''': Error en la inserción.
* '''404 Not Found''': Respuesta declarada por el YAML; no identifica de forma general todos los errores de inserción.
* '''400 Bad Request''': Datos del objeto de contrato inválidos o faltantes.
* '''401 Unauthorized''': Token JWT inválido o ausente.
* '''401 Unauthorized''': Token JWT inválido o ausente.
* '''500 Internal Server Error''': Error interno del servidor.




; Ejemplo de Respuesta Exitosa
; Ejemplo de Respuesta Exitosa
<nowiki>
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.
[
  {
    "Id": "MSG004",
    "Type": 1,
    "Description": "Objeto de contrato insertado exitosamente"
  }
]
</nowiki>


=== 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.
* '''500 Internal Server Error''': Error interno del servidor.




; Ejemplo de Respuesta Exitosa
; Ejemplo de Respuesta Exitosa
<nowiki>
<pre>
{
{
   "SDTProyectoLista": [
   "ProyectoLista": [
     {
     {
       "PryCod": "PRJ001",
       "PryCod": "PRJ001",
Línea 365: Línea 380:
     {
     {
       "Id": "MSG005",
       "Id": "MSG005",
       "Type": 1,
       "Type": 2,
       "Description": "Proyecto encontrado"
       "Description": "Proyecto encontrado"
     }
     }
   ]
   ]
}
}
</nowiki>
</pre>


== Esquemas de Respuesta ==
== Esquemas de Respuesta ==
Línea 376: Línea 391:
=== Esquema Cliente_getOutput ===
=== Esquema Cliente_getOutput ===


* '''SDTCliente''' (object, opcional): Información detallada del cliente. Ver [[#Esquema ClienteInsertarInput|Esquema ClienteInsertarInput]].
* '''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 ===


* '''SDTObjetoContrato''' (object, opcional): Información detallada del objeto de contrato. Ver [[#Esquema ObjetoContratoInsertarInput|Esquema ObjetoContratoInsertarInput]].
* '''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 ===


* '''SDTProyectoLista''' (array, opcional): Lista de proyectos.
* '''ProyectoLista''' (array, opcional): Lista de proyectos.
  * '''PryCod''' (string): Código del proyecto.
** '''PryCod''' (string): Código del proyecto.
  * '''PryNom''' (string): Nombre del proyecto.
** '''PryNom''' (string): Nombre del proyecto.
  * '''Compania''' (string): Compañía asociada.
** '''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: Informativo, 2: Advertencia, 3: Error).
* '''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 ===


* '''SDTCliente''' (object, opcional): Información detallada del cliente a insertar.
* '''Cliente''' (object, opcional): Información detallada del cliente a insertar.
  * '''Codigo''' (string, opcional): Código de Cliente.
** '''Codigo''' (string, opcional): Código de Cliente.
  * '''Nombre''' (string, opcional): Nombre de Cliente.
** '''Nombre''' (string, opcional): Nombre de Cliente.
  * '''NombreFantasia''' (string, opcional): Nombre Fantasía.
** '''NombreFantasia''' (string, opcional): Nombre Fantasía.
  * '''NumeroFidelizacion''' (string, opcional): Número de Fidelización.
** '''NumeroFidelizacion''' (string, opcional): Número de Fidelización.
  * '''Direccion''' (string, opcional): Dirección de Cliente.
** '''Direccion''' (string, opcional): Dirección de Cliente.
  * '''Ciudad''' (string, opcional): Ciudad del Cliente.
** '''Ciudad''' (string, opcional): Ciudad del Cliente.
  * '''CodigoPostal''' (string, opcional): Código Postal.
** '''CodigoPostal''' (string, opcional): Código Postal.
  * '''EstadoProvincia''' (string, opcional): Estado/Provincia.
** '''EstadoProvincia''' (string, opcional): Estado/Provincia.
  * '''Pais''' (string, opcional): País (ejemplo: "UY").
** '''Pais''' (string, opcional): País (ejemplo: "UY").
  * '''Telefono''' (string, opcional): Teléfono del Cliente.
** '''Telefono''' (string, opcional): Teléfono del Cliente.
  * '''Celular''' (string, opcional): Celular.
** '''Celular''' (string, opcional): Celular.
  * '''Email''' (string, opcional): E-mail del Cliente.
** '''Email''' (string, opcional): E-mail del Cliente.
  * '''EmailFacturacion''' (string, opcional): E-mail facturación.
** '''EmailFacturacion''' (string, opcional): E-mail facturación.
  * '''DatosFacturacion''' (string, opcional): Datos Facturación.
** '''DatosFacturacion''' (string, opcional): Datos Facturación.
  * '''TipoCliente''' (string, opcional): Tipo de Cliente (ejemplo: "CN").
** '''TipoCliente''' (string, opcional): Tipo de Cliente (ejemplo: "CN").
  * '''TipoPersona''' (string, opcional): Tipo de Persona (ejemplo: "J" para jurídica, "F" para física).
** '''TipoPersona''' (string, opcional): Tipo de Persona (ejemplo: "J" para jurídica, "F" para física).
  * '''Territorio''' (string, opcional): Código de Territorio.
** '''Territorio''' (string, opcional): Código de Territorio.
  * '''DocumentoTipo''' (string, opcional): Tipo de Documento (ejemplo: "N").
** '''DocumentoTipo''' (string, opcional): Tipo de Documento (ejemplo: "N").
  * '''DocumentoNumero''' (string, opcional): Número de Documento.
** '''DocumentoNumero''' (string, opcional): Número de Documento.
  * '''Nacimiento''' (string, format: date, opcional): Fecha de Nacimiento (formato: YYYY-MM-DD).
** '''Nacimiento''' (string, format: date, opcional): Fecha de Nacimiento (formato: YYYY-MM-DD).
  * '''TrabajoNombre''' (string, opcional): Trabajo del Cliente.
** '''TrabajoNombre''' (string, opcional): Trabajo del Cliente.
  * '''TrabajoDireccion''' (string, opcional): Dirección del Trabajo del Cliente.
** '''TrabajoDireccion''' (string, opcional): Dirección del Trabajo del Cliente.
  * '''TrabajoTelefono''' (string, opcional): Teléfono del Trabajo del Cliente.
** '''TrabajoTelefono''' (string, opcional): Teléfono del Trabajo del Cliente.
  * '''Localizacion''' (string, opcional): Localización.
** '''Localizacion''' (string, opcional): Localización.
  * '''IdentificacionFiscal''' (string, opcional): Id Tributaria.
** '''IdentificacionFiscal''' (string, opcional): Id Tributaria.
  * '''Contacto''' (string, opcional): Contacto en el Cliente.
** '''Contacto''' (string, opcional): Contacto en el Cliente.
  * '''LimiteCredito''' (number, format: double, opcional): Límite de Crédito.
** '''LimiteCredito''' (number, format: double, opcional): Límite de Crédito.
  * '''Moneda''' (string, opcional): Moneda (ejemplo: "USD").
** '''Moneda''' (string, opcional): Moneda (ejemplo: "USD").
  * '''Condicion''' (string, opcional): Condición.
** '''Condicion''' (string, opcional): Condición.
  * '''PresentacionDia''' (string, opcional): Días de presentación de facturas.
** '''PresentacionDia''' (string, opcional): Días de presentación de facturas.
  * '''PagoDia''' (string, opcional): Días de pago a proveedores.
** '''PagoDia''' (string, opcional): Días de pago a proveedores.
  * '''PagoContacto''' (string, opcional): Contacto pago a proveedores.
** '''PagoContacto''' (string, opcional): Contacto pago a proveedores.
  * '''PagoTelefono''' (string, opcional): Teléfono pago a proveedores.
** '''PagoTelefono''' (string, opcional): Teléfono pago a proveedores.
  * '''PagoEmail''' (string, opcional): E-mail pago a proveedores.
** '''PagoEmail''' (string, opcional): E-mail pago a proveedores.
  * '''PagoEmailSeEnvia''' (boolean, opcional): ¿Se envían mails recordatorios?
** '''PagoEmailSeEnvia''' (boolean, opcional): ¿Se envían mails recordatorios?
  * '''PagoEmailEnvioDia''' (integer, format: int32, opcional): Día de envío.
** '''PagoEmailEnvioDia''' (integer, format: int32, opcional): Día de envío.
  * '''Situacion''' (string, opcional): Situación (ejemplo: "A").
** '''Situacion''' (string, opcional): Situación (ejemplo: "A").
  * '''Estado''' (string, opcional): Estado del Cliente (ejemplo: "A").
** '''Estado''' (string, opcional): Estado del Cliente (ejemplo: "A").


=== Esquema ObjetoContratoInsertarInput ===
=== Esquema ObjetoContratoInsertarInput ===


* '''SDTObjetoContrato''' (object, opcional): Información detallada del contrato a insertar.
* '''ObjetoContrato''' (object, opcional): Información detallada del contrato a insertar.
  * '''Cliente''' (string, opcional): Código de Cliente.
** '''Cliente''' (string, opcional): Código de Cliente.
  * '''Codigo''' (string, opcional): Código.
** '''Codigo''' (string, opcional): Código.
  * '''Nombre''' (string, opcional): Nombre.
** '''Nombre''' (string, opcional): Nombre.
  * '''FechaInicio''' (string, format: date, opcional): Fecha de inicio (formato: YYYY-MM-DD).
** '''FechaInicio''' (string, format: date, opcional): Fecha de inicio (formato: YYYY-MM-DD).
  * '''FechaFin''' (string, format: date, opcional): Fecha de fin (formato: YYYY-MM-DD).
** '''FechaFin''' (string, format: date, opcional): Fecha de fin (formato: YYYY-MM-DD).
  * '''Tipo''' (string, opcional): Tipo (ejemplo: "F").
** '''Tipo''' (string, opcional): Tipo (ejemplo: "F").
  * '''DocumentoTipo''' (string, opcional): Tipo de Documento (ejemplo: "C").
** '''DocumentoTipo''' (string, opcional): Tipo de Documento (ejemplo: "C").
  * '''DocumentoNumero''' (string, opcional): Número de Documento.
** '''DocumentoNumero''' (string, opcional): Número de Documento.
  * '''FechaNacimiento''' (string, format: date, opcional): Fecha de Nacimiento (formato: YYYY-MM-DD).
** '''FechaNacimiento''' (string, format: date, opcional): Fecha de Nacimiento (formato: YYYY-MM-DD).
  * '''Telefono''' (string, opcional): Teléfono.
** '''Telefono''' (string, opcional): Teléfono.
  * '''Email''' (string, opcional): E-mail.
** '''Email''' (string, opcional): E-mail.
  * '''EmailFacturacion''' (string, opcional): E-mail facturación.
** '''EmailFacturacion''' (string, opcional): E-mail facturación.
  * '''Localizacion''' (string, opcional): Localización.
** '''Localizacion''' (string, opcional): Localización.
  * '''IdentificacionFiscal''' (string, opcional): Identificación Fiscal.
** '''IdentificacionFiscal''' (string, opcional): Identificación Fiscal.
  * '''Contacto''' (string, opcional): Contacto.
** '''Contacto''' (string, opcional): Contacto.
  * '''Modelo''' (string, opcional): Modelo.
** '''Modelo''' (string, opcional): Modelo.
  * '''Serie''' (string, opcional): Serie.
** '''Serie''' (string, opcional): Serie.
  * '''Ubicacion''' (string, opcional): Ubicación.
** '''Ubicacion''' (string, opcional): Ubicación.
  * '''Responsable''' (string, opcional): Responsable.
** '''Responsable''' (string, opcional): Responsable.
  * '''Plan''' (string, opcional): Plan.
** '''Plan''' (string, opcional): Plan.
  * '''Poliza''' (string, opcional): Póliza.
** '''Poliza''' (string, opcional): Póliza.
  * '''DatoAdicional''' (string, opcional): Dato Adicional.
** '''DatoAdicional''' (string, opcional): Dato Adicional.
  * '''Estado''' (string, opcional): Estado (ejemplo: "A").
** '''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 del 11:03 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: true y false.
  • 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)


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

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.