Ir al contenido

Diferencia entre revisiones de «API Transacciones»

De LAZARVS
Created page with "= API Transacciones de Lazarvs = Esta documentación describe los endpoints disponibles en la API de Lazarvs para operaciones relacionadas con transacciones, como oportunidades y notas de venta. == Índice == * Información General * Autenticación * Endpoints de la API * Esquemas de Respuesta == Información General == * '''Título''': API_Transacciones * '''Descripció..."
 
Sin resumen de edición
 
(No se muestran 4 ediciones intermedias del mismo usuario)
Línea 1: Línea 1:
= API Transacciones de Lazarvs =
= API Transacciones de Lazarvs =


Esta documentación describe los endpoints disponibles en la API de Lazarvs para operaciones relacionadas con transacciones, como oportunidades y notas de venta.
La API permite consultar y crear oportunidades, notas de venta y órdenes de compra. Las operaciones GET y POST comparten la ruta de cada recurso.


== Índice ==
__TOC__
* [[#Información General|Información General]]
* [[#Autenticación|Autenticación]]
* [[#Endpoints de la API|Endpoints de la API]]
* [[#Esquemas de Respuesta|Esquemas de Respuesta]]


== Información General ==
== Información general ==


* '''Título''': API_Transacciones
* '''Objeto''': <code>API_Transacciones</code>.
* '''Descripción''': API para operaciones de transacciones.
* '''URL base''': <code><nowiki>{{URL de Lazarvs}}/transacciones</nowiki></code>.
* '''URL Base del Servidor''': <nowiki>{{URL de Lazarvs}}/transacciones</nowiki>
* '''Formato''': JSON.
* '''Contrato local de desarrollo''': <code><nowiki>{{URL de Lazarvs}}/API_Transacciones.yaml</nowiki></code>.


== Autenticación ==
La URL de Lazarvs incluye el protocolo, servidor y contexto de la aplicación. Debe utilizarse la URL correspondiente al ambiente de destino. Los códigos de maestros deben existir en la compañía y el ambiente utilizados.


Para acceder a los endpoints, se requiere un token JWT que debe incluirse en el encabezado '''Authorization''' con el prefijo "Bearer".
== Autenticación y encabezados ==


'''Ejemplo de Encabezado:'''
Todas las operaciones requieren el token JWT autorizado para la integración. La compañía y el usuario se obtienen del token; no se seleccionan enviando esos datos en el cuerpo de la orden.
<nowiki>
Authorization: Bearer <tu_token_jwt>
</nowiki>


== Endpoints de la API ==
<pre>
Authorization: Bearer <token_jwt>
Accept: application/json
Content-Type: application/json
</pre>


=== 1. /OportunidadExiste ===
<code>Accept</code> indica el formato esperado de respuesta. <code>Content-Type</code> debe enviarse en los POST con cuerpo JSON. Los GET no requieren cuerpo. Los datos adicionales del payload JWT que una operación no utiliza se ignoran; no deben confundirse con el cuerpo JSON del POST.


; Descripción
== Convenciones ==
: Verifica la existencia de una oportunidad en el sistema.


; Método
* Respetar exactamente las mayúsculas y minúsculas de los parámetros y miembros JSON documentados. En particular, el GET de órdenes de compra recibe <code>Ordennumero</code>, mientras que el POST devuelve <code>OrdenNumero</code>.
: GET
* Las fechas se envían como cadenas <code>YYYY-MM-DD</code>.
* Los booleanos se envían como <code>true</code> o <code>false</code>, sin comillas.
* Los números se envían sin separadores de miles y con punto decimal, sin comillas. Los códigos se envían como cadenas para conservar ceros iniciales.
* En respuestas observadas, el generador serializa algunos importes y números como cadenas, aunque el YAML los declara numéricos. Los clientes deben contemplar esa representación.
* Que el YAML no declare un campo obligatorio no elimina las validaciones funcionales de las transacciones. Los ejemplos deben adaptarse a los maestros y configuración de cada compañía.


; Parámetros de Consulta
=== Nombres externos de los objetos JSON ===
* '''Oportunidad''' (string, opcional): Identificador de la oportunidad.


; Respuesta
Los cuerpos de los POST y los datos devueltos por los GET utilizan los siguientes nombres externos:
La respuesta exitosa tendrá el código '''200''' y devuelve un JSON con la estructura de '''API_Transacciones_Respuesta'''.


=== 2. /OportunidadInsertar ===
{| class="wikitable"
! Recurso !! Raíz del POST !! Raíz del GET !! Tipo interno POST !! Tipo interno GET
|-
| Oportunidad || <code>Oportunidad</code> || <code>Oportunidad</code> || <code>SDTOportunidad</code> || <code>SDTOportunidad</code>
|-
| Nota de venta || <code>NotaVenta</code> || <code>NotaVenta</code> || <code>SDTNotaVenta</code> || <code>SDTNotaVenta</code>
|-
| Orden de compra || <code>OrdenDeCompra</code> || <code>OrdenDeCompra</code> || <code>SDTOrdenDeCompra</code> || <code>SDTOrdenDeCompraConsulta</code>
|}


; Descripción
El prefijo <code>SDT</code> identifica los tipos internos, no el nombre de la propiedad raíz que debe enviar o leer el consumidor. La respuesta del POST de orden de compra conserva <code>OrdenNumero</code> y <code>Mensajes</code>.
: Inserta una nueva oportunidad en el sistema.


; Método
Esta documentación refleja los nombres externos confirmados en la implementación. El YAML de versión <code>20261105223625</code> todavía declara algunos nombres raíz anteriores, por lo que no debe usarse para reconstruir esas envolturas JSON sin actualizarlo.
: POST


; Cuerpo de la Solicitud (JSON)
== Endpoints ==
* '''SDTOportunidad''' (object): Datos de la oportunidad a insertar.


; Cuerpo de Solicitud Vacío
{| class="wikitable"
<nowiki>
! Método !! Ruta relativa !! Operación
{
|-
  "SDTOportunidad": {
| GET || <code>/Oportunidad</code> || Consulta por número externo de oportunidad.
    "Nombre": "<string>",
|-
    "Tipo": "<string>",
| POST || <code>/Oportunidad</code> || Crea una oportunidad.
    "NumeroExterno": "<string>",
|-
    "Territorio": "<string>",
| GET || <code>/NotaVenta</code> || Consulta una nota de venta asociada a una oportunidad externa.
    "AsignadoA": "<string>",
|-
    "Cuenta": "<string>",
| POST || <code>/NotaVenta</code> || Crea una nota de venta.
    "CuentaIdTributaria": "<string>",
|-
    "Prospecto": "<long>",
| GET || <code>/OrdenDeCompra</code> || Consulta por número de orden y/o oportunidad externa.
    "Origen": "<string>",
|-
    "FechaApertura": "<date>",
| POST || <code>/OrdenDeCompra</code> || Crea cabecera y líneas de una orden de compra.
    "FechaInicio": "<date>",
|}
    "FechaEntregaOferta": "<date>",
 
    "FechaCierreEsperado": "<date>",
=== GET /Oportunidad ===
    "FechaCierreEfectivo": "<date>",
 
    "Etapa": "<string>",
Consulta una oportunidad por su número externo.
    "Probabilidad": "<double>",
 
    "Solucion": "<string>",
{| class="wikitable"
    "ProximoPaso": "<string>",
! Parámetro query !! Tipo !! Descripción
    "DeclaradoAlProveedor": "<boolean>",
|-
    "OportunidadProveedor": "<string>",
| <code>Oportunidad</code> || string || Número externo de oportunidad. El YAML lo declara opcional; debe informarse para identificar la oportunidad buscada.
    "Importante": "<boolean>",
|}
    "Competencia": "<string>",
 
    "Descripcion": "<string>",
<pre>
    "ActividadPlanificada": "<string>",
GET {{URL de Lazarvs}}/transacciones/Oportunidad?Oportunidad=2024-0101
    "Moneda": "<string>",
</pre>
    "IngresoEsperadoMoneda": "<double>"
 
  }
La respuesta contiene <code>Oportunidad</code> y los <code>Mensajes</code> que correspondan. Si no se encuentra el registro, se devuelve HTTP 404.
}
 
</nowiki>
=== POST /Oportunidad ===
 
Crea una oportunidad. El cuerpo contiene un objeto raíz <code>Oportunidad</code>. Su estructura completa figura en la sección de esquemas.


; Ejemplo de Cuerpo de Solicitud
<pre>
<nowiki>
{
{
   "SDTOportunidad": {
   "Oportunidad": {
     "Nombre": "Prod XX",
     "Nombre": "Oportunidad de prueba",
    "Tipo": "",
     "NumeroExterno": "API-PRUEBA-001",
     "NumeroExterno": "2024-0101",
     "CuentaIdTributaria": "ID_TRIBUTARIA_CLIENTE",
    "Territorio": "",
     "FechaApertura": "2026-11-04",
    "AsignadoA": "",
    "Cuenta": "",
     "CuentaIdTributaria": "NRORUT/CUIT",
    "Prospecto": "0",
    "Origen": "",
     "FechaApertura": "2024-01-01",
    "FechaInicio": "2024-03-01",
    "FechaEntregaOferta": "2024-06-30",
    "FechaCierreEsperado": "2024-09-30",
    "FechaCierreEfectivo": "2024-10-15",
    "Etapa": "50",
    "Probabilidad": "0",
    "Solucion": "Lazarvs",
    "ProximoPaso": "No hay",
    "DeclaradoAlProveedor": "false",
    "OportunidadProveedor": "N/A",
    "Importante": "true",
    "Competencia": "Otro ERP",
    "Descripcion": "Oportunidad de prueba",
    "ActividadPlanificada": "Sin plan",
     "Moneda": "USD",
     "Moneda": "USD",
     "IngresoEsperadoMoneda": "20000"
     "IngresoEsperadoMoneda": 20000,
    "Probabilidad": 0,
    "DeclaradoAlProveedor": false,
    "Importante": false
   }
   }
}
}
</nowiki>
</pre>


=== 3. /NotaVentaOportunidadExiste ===
Ejemplo orientativo: completar los códigos y demás datos exigidos por la configuración. La respuesta contiene la colección de mensajes de la operación.


; Descripción
=== GET /NotaVenta ===
: Verifica la existencia de una nota de venta para una oportunidad específica.


; Método
Consulta una nota de venta asociada a una oportunidad identificada por su número externo.
: GET


; Parámetros de Consulta
{| class="wikitable"
* '''Oportunidad''' (string, opcional): Identificador de la oportunidad.
! Parámetro query !! Tipo !! Descripción
|-
| <code>Oportunidad</code> || string || Número externo de oportunidad. El YAML lo declara opcional; debe informarse para realizar esta búsqueda.
|}


=== 4. /NotaVentaOportunidadInsertar ===
<pre>
GET {{URL de Lazarvs}}/transacciones/NotaVenta?Oportunidad=2024-0101
</pre>


; Descripción
La respuesta contiene <code>NotaVenta</code> y los <code>Mensajes</code> que correspondan. Si no se encuentra, se devuelve HTTP 404.
: Inserta una nueva nota de venta para una oportunidad existente.


; Método
=== POST /NotaVenta ===
: POST


; Cuerpo de la Solicitud (JSON)
Crea una nota de venta mediante el objeto raíz <code>NotaVenta</code>. Debe indicarse al menos una referencia: <code>OportunidadExterna</code>, <code>OportunidadNumero</code> u <code>OrdenDeCompraCliente</code>. La implementación controla duplicados con las referencias informadas.
* '''SDTNotaVenta''' (object): Datos de la nota de venta a insertar.


; Cuerpo de Solicitud vacío
<pre>
<nowiki>
{
{
   "SDTNotaVenta": {
   "NotaVenta": {
     "Fecha": "<date>",
     "Fecha": "2026-11-04",
    "Tipo": "<string>",
     "Descripcion": "Nota de venta de prueba",
     "Descripcion": "<string>",
     "Moneda": "USD",
    "Comentarios": "<string>",
     "Cliente": "CODIGO_CLIENTE",
    "Local": "<string>",
     "OrdenDeCompraCliente": "OC-CLI-PRUEBA-001",
    "Almacen": "<string>",
     "UsaIdentificacion": false,
     "Moneda": "<string>",
     "CongelaPrecios": false,
     "OportunidadExterna": "<string>",
     "OportunidadNumero": "<long>",
     "UsaIdentificacion": "<boolean>",
    "Cliente": "<string>",
    "DireccionEntregaNumero": "<long>",
    "Condicion": "<string>",
     "CongelaPrecios": "<boolean>",
    "FechaPrecios": "<date>",
    "OrdenDeCompraCliente": "<string>",
    "Territorio": "<string>",
    "Jurisdiccion": "<string>",
    "PorcentajeDescuentoGlobal": "<double>",
    "FechaInicialEntrega": "<date>",
    "FechaFinalEntrega": "<date>",
    "Identificacion": {
      "ClienteNombre": "<string>",
      "ClienteTipo": "<string>",
      "ClienteDireccion": "<string>",
      "ClienteCiudad": "<string>",
      "ClientePais": "<string>",
      "ClientePersonaFisicaTipoDocumento": "<string>",
      "ClientePersonaFisicaNumeroDocumento": "<string>",
      "ClientePersonaJuridicaTipoDocumento": "<string>",
      "ClientePersonaJuridicaNumeroDocumento": "<string>"
    },
    "Entrega": {
      "EntregaDireccion": "<string>",
      "EntregaCiudad": "<string>",
      "EntregaCodigoPostal": "<string>",
      "EntregaEstadoProvincia": "<string>",
      "EntregaPais": "<string>",
      "EntregaTelefono": "<string>",
      "EntregaContacto": "<string>"
    },
     "Articulos": [
     "Articulos": [
       {
       {
         "ArticuloCodigo": "<string>",
         "ArticuloCodigo": "CODIGO_ARTICULO",
        "ArticuloLote": "<string>",
         "ArticuloCantidad": 2,
         "ArticuloCantidad": "<double>",
         "ArticuloPrecio": 100,
        "ArticuloTipoDeVenta": "<string>",
         "ArticuloPrecioImpuestoIncluido": false
        "ArticuloSerie": "<string>",
        "ArticuloPorcentajeImpuesto": "<double>",
         "ArticuloPrecio": "<double>",
         "ArticuloPrecioImpuestoIncluido": "<boolean>",
        "ArticuloDescuento": "<double>",
        "ArticuloProveedor": "<string>",
        "ArticuloCostoUnitario": "<double>",
        "ArticuloGastosImportacion": "<double>"
      },
      {
        "ArticuloCodigo": "<string>",
        "ArticuloLote": "<string>",
        "ArticuloCantidad": "<double>",
        "ArticuloTipoDeVenta": "<string>",
        "ArticuloSerie": "<string>",
        "ArticuloPorcentajeImpuesto": "<double>",
        "ArticuloPrecio": "<double>",
        "ArticuloPrecioImpuestoIncluido": "<boolean>",
        "ArticuloDescuento": "<double>",
        "ArticuloProveedor": "<string>",
        "ArticuloCostoUnitario": "<double>",
        "ArticuloGastosImportacion": "<double>"
       }
       }
     ],
     ],
     "Enlaces": [
     "Enlaces": []
      {
        "EnlaceDescripcion": "<string>",
        "EnlaceURL": "<string>"
      },
      {
        "EnlaceDescripcion": "<string>",
        "EnlaceURL": "<string>"
      }
    ]
   }
   }
}
}
</nowiki>
</pre>
; Ejemplo de Cuerpo de Solicitud
 
<nowiki>
Ejemplo orientativo: sustituir los códigos y completar las condiciones, ubicación y demás campos requeridos. La respuesta contiene la colección de mensajes. Los campos de identificación, entrega, artículos y enlaces se detallan en los esquemas.
 
=== GET /OrdenDeCompra ===
 
Devuelve la cabecera y las líneas de una orden de compra dentro de la compañía del token.
 
{| class="wikitable"
! Parámetro query exacto !! Tipo !! Descripción
|-
| <code>Ordennumero</code> || integer (int64) || Número interno de orden de compra. Opcional individualmente.
|-
| <code>Oportunidad</code> || string || Número externo de oportunidad (<code>OpoNroExt</code>), no su número interno. Opcional individualmente.
|}
 
'''Debe informarse al menos uno de los dos parámetros.''' Si se informan ambos, la orden debe cumplir ambos filtros. Si no se informa ninguno, la validación devuelve HTTP 400. Si no hay coincidencias, devuelve HTTP 404.
 
La respuesta es un único objeto: cuando una oportunidad tiene varias órdenes, la consulta implementada selecciona la de menor número.
 
<pre>
GET {{URL de Lazarvs}}/transacciones/OrdenDeCompra?Ordennumero=845
GET {{URL de Lazarvs}}/transacciones/OrdenDeCompra?Oportunidad=OP-EXTERNA-001
GET {{URL de Lazarvs}}/transacciones/OrdenDeCompra?Ordennumero=845&Oportunidad=OP-EXTERNA-001
</pre>
 
La respuesta contiene la propiedad raíz <code>OrdenDeCompra</code>, de tipo <code>SDTOrdenDeCompraConsulta</code>, y los mensajes que correspondan. Incluye códigos y nombres de los elementos relacionados, así como la ruta, la estación actual y sus nombres. El GET utiliza un SDT de consulta distinto del SDT de entrada del POST.
 
Los nombres corresponden a los códigos relacionados. <code>Descripcion</code> conserva el texto propio de la cabecera o de la línea y puede diferir del nombre del artículo. Los campos sin datos pueden aparecer como cadenas vacías. El estado de la orden se informa mediante <code>Estacion</code> y <code>EstacionNombre</code>.
 
=== POST /OrdenDeCompra ===
 
Crea una orden de compra con cabecera y una o más líneas. El cuerpo debe estar contenido en <code>OrdenDeCompra</code>. No se utilizan los filtros query del GET.
 
<pre>
{
{
   "SDTNotaVenta": {
   "OrdenDeCompra": {
     "Fecha": "2024-10-20",
     "Fecha": "2026-11-04",
     "Tipo": "",
     "FechaEntrega": "2026-11-04",
     "Descripcion": "Nota venta Test",
     "Descripcion": "PRUEBA API - Alta de orden de compra",
     "Comentarios": "Sin comentarios",
     "Proveedor": "0291",
     "Local": "",
     "CentroCostos": "GV01",
     "Almacen": "",
     "Almacen": "02",
     "Moneda": "USD",
     "Moneda": "USD",
     "OportunidadExterna": "2024-01",
     "EsImportacion": false,
    "OportunidadNumero": "0",
     "FormaPago": "45 Días, Cheque",
    "UsaIdentificacion": "false",
     "Lineas": [
    "Cliente": "",
    "DireccionEntregaNumero": "0",
    "Condicion": "Credito",
    "CongelaPrecios": "false",
    "FechaPrecios": "",
    "OrdenDeCompraCliente": "OC-CLI-001",
     "Territorio": "",
    "Jurisdiccion": "",
    "PorcentajeDescuentoGlobal": "0",
    "FechaInicialEntrega": "",
    "FechaFinalEntrega": "",
    "Identificacion": {
      "ClienteNombre": "",
      "ClienteTipo": "",
      "ClienteDireccion": "",
      "ClienteCiudad": "",
      "ClientePais": "",
      "ClientePersonaFisicaTipoDocumento": "",
      "ClientePersonaFisicaNumeroDocumento": "",
      "ClientePersonaJuridicaTipoDocumento": "",
      "ClientePersonaJuridicaNumeroDocumento": ""
    },
    "Entrega": {
      "EntregaDireccion": "",
      "EntregaCiudad": "",
      "EntregaCodigoPostal": "",
      "EntregaEstadoProvincia": "",
      "EntregaPais": "",
      "EntregaTelefono": "",
      "EntregaContacto": ""
    },
    "Articulos": [
      {
        "ArticuloCodigo": "9780444505156",
        "ArticuloLote": "",
        "ArticuloCantidad": "2",
        "ArticuloTipoDeVenta": "",
        "ArticuloSerie": "",
        "ArticuloPorcentajeImpuesto": "0",
        "ArticuloPrecio": "2500",
        "ArticuloPrecioImpuestoIncluido": "false",
        "ArticuloDescuento": "0",
        "ArticuloProveedor": "",
        "ArticuloCostoUnitario": "1000",
        "ArticuloGastosImportacion": "10"
      },
      {
        "ArticuloCodigo": " 4605664000050",
        "ArticuloLote": "",
        "ArticuloCantidad": "1",
        "ArticuloTipoDeVenta": "",
        "ArticuloSerie": "",
        "ArticuloPorcentajeImpuesto": "0",
        "ArticuloPrecio": "1500",
        "ArticuloPrecioImpuestoIncluido": "false",
        "ArticuloDescuento": "0",
        "ArticuloProveedor": "",
        "ArticuloCostoUnitario": "500",
        "ArticuloGastosImportacion": "20"
      }
    ],
     "Enlaces": [
       {
       {
         "EnlaceDescripcion": "Test1",
         "Destino": "C",
         "EnlaceURL": "https://www.abcdefyy.com"
         "Descripcion": "Prueba API - Línea 1",
        "Articulo": "020-000182-002",
        "CentroCostos": "GV01",
        "Mercancia": "W01",
        "Cantidad": 2,
        "Precio": 100,
        "ImpuestoCodigo": "BD"
       },
       },
       {
       {
         "EnlaceDescripcion": "Test2",
         "Destino": "C",
         "EnlaceURL": "https://www.jklmnozz.com"
         "Descripcion": "Prueba API - Línea 2",
        "Articulo": "020-160001-001",
        "CentroCostos": "GV01",
        "Mercancia": "W01",
        "Cantidad": 1,
        "Precio": 50,
        "ImpuestoCodigo": "BD"
       }
       }
     ]
     ]
   }
   }
}
}
</nowiki>
</pre>
 
Este ejemplo fue probado en test con esos maestros. Los códigos no son universales: deben sustituirse por los existentes en el ambiente y la compañía de destino.
 
==== Reglas del alta ====
 
* Se requiere al menos una línea.
* El servidor asigna el número de orden, las secuencias, la ruta y estación inicial y los datos de auditoría.
* Si se omite la fecha de orden, se utiliza la fecha del servidor. Si se omite la fecha de entrega, se utiliza la fecha de orden.
* Para compras locales corresponde informar el almacén de entrega. Para importaciones corresponde la condición de importación; se aplican las validaciones de la transacción.
* Para destino Bienes de Cambio, la unidad se obtiene del artículo. La mercancía también se toma del artículo cuando tiene una definida.
* La tasa del impuesto se obtiene del modelo a partir del código de impuesto; no se asigna desde <code>ImpuestoTasa</code>.
* Los subtotales, impuestos y totales se calculan mediante las reglas de los Business Components.
* Cabecera, líneas y actualización de totales se confirman con un único Commit. Si falla alguna etapa, se ejecuta Rollback de toda la operación.
* Cada POST exitoso crea una nueva orden. No debe repetirse una solicitud de alta sin verificar antes el resultado de la anterior.
 
==== Campos calculados ====
 
Aunque el SDT de entrada los incluye, no deben enviarse como datos de alta: <code>Numero</code>, los importes de cabecera <code>SubTotal</code>, <code>Impuestos</code> y <code>Total</code>, y los miembros de línea <code>Secuencia</code>, <code>ImpuestoTasa</code>, <code>SubTotal</code>, <code>Impuestos</code> y <code>Total</code>. Sus valores se asignan o calculan en el servidor.
 
==== Respuesta exitosa ====
 
<pre>
{
  "Mensajes": [
    {
      "Description": "Se creó la orden de compra 845",
      "Id": "INFOOC01",
      "Type": 2
    }
  ],
  "OrdenNumero": "845"
}
</pre>
 
El número del ejemplo corresponde a una ejecución de test. El número generado permite consultar la orden por GET. Los mensajes automáticos de guardados intermedios se filtran para no confundirlos con la confirmación final.
 
==== Respuesta de error ====
 
<pre>
{
  "Mensajes": [
    {
      "Description": "Línea 2: No existe 'Artículo'.",
      "Id": "ForeignKeyNotFound",
      "Type": 1
    },
    {
      "Description": "Línea 2: No existe 'Unidad'.",
      "Id": "ForeignKeyNotFound",
      "Type": 1
    }
  ],
  "OrdenNumero": "0"
}
</pre>
 
Con la implementación actual, los errores funcionales del POST devuelven HTTP 409. <code>OrdenNumero = 0</code> indica que no se devuelve una orden creada. El error de unidad puede ser consecuencia de un artículo inexistente, porque la unidad se resuelve a partir de ese artículo. Se verificó en test que un error en la segunda línea revierte también la cabecera y la primera línea.
 
== Respuestas y códigos HTTP ==
 
{| class="wikitable"
! HTTP !! Significado en la implementación
|-
| 200 || Operación exitosa. El POST de orden de compra devuelve el número generado; no utiliza 201 en esta versión.
|-
| 400 || GET de orden de compra sin número de orden ni oportunidad externa.
|-
| 401 || Token inválido o permisos insuficientes, según los eventos actuales.
|-
| 404 || Consulta GET sin resultados.
|-
| 405 || Operación no habilitada o uso de entidad no permitido por las validaciones actuales.
|-
| 409 || POST con errores funcionales o de validación.
|}
 
El YAML generado enumera 200 y 404 por operación, pero no refleja todos los códigos asignados en los eventos del API. La tabla anterior incluye el comportamiento implementado. No se utiliza 422 en la implementación actual.
 
=== Estructura de mensajes ===
 
Cada mensaje incluye <code>Id</code>, <code>Type</code> y <code>Description</code>. En las respuestas observadas se presenta como un arreglo <code>Mensajes</code>. Los nombres de esquemas internos del YAML no deben confundirse con los nombres de propiedades JSON.
 
{| class="wikitable"
! Type !! Significado
|-
| 0 || Advertencia (Warning)
|-
| 1 || Error (Error)
|-
| 2 || Información (Info)
|-
| 3 || Depuración (Debug)
|}
 
El YAML tiene una inconsistencia en los esquemas de mensajes: algunos GET referencian un ítem individual para <code>Mensajes</code>, y el esquema genérico de los POST de oportunidad y nota de venta usa <code>Messages</code>. Para integrar esos POST, comprobar la envoltura JSON efectiva en el ambiente de destino. Para órdenes de compra se verificó el arreglo <code>Mensajes</code> mostrado en los ejemplos. El esquema anterior <code>API_Transacciones_Respuesta</code> con <code>Existe</code> y <code>Datos</code> no es la respuesta declarada por el contrato actual.
 
== Esquemas de datos ==
 
Los tipos corresponden a OpenAPI; las reglas de obligatoriedad funcional dependen de la operación y de la configuración. Los nombres de los esquemas son internos y conservan el prefijo <code>SDT</code>; las propiedades raíz JSON expuestas no llevan ese prefijo. Para órdenes de compra, <code>SDTOrdenDeCompra</code> es el tipo de entrada del POST y <code>SDTOrdenDeCompraConsulta</code> es el tipo de salida del GET; ambas operaciones exponen la propiedad raíz <code>OrdenDeCompra</code>. Este último incorpora los campos descriptivos implementados.
 
=== SDTOportunidad ===
 
{| class="wikitable"
! Campo !! Tipo !! Descripción
|-
| <code>Nombre</code> || string || Nombre
|-
| <code>Tipo</code> || string || Tipo de Oportunidad
|-
| <code>NumeroExterno</code> || string || Número Externo
|-
| <code>Territorio</code> || string || Territorio
|-
| <code>AsignadoA</code> || string || Asignado a
|-
| <code>Cuenta</code> || string || Cuenta
|-
| <code>CuentaIdTributaria</code> || string || Número de Documento
|-
| <code>Prospecto</code> || integer (int64) || Prospecto
|-
| <code>Origen</code> || string || Origen
|-
| <code>FechaApertura</code> || string (date) || Fecha Apertura
|-
| <code>FechaInicio</code> || string (date) || Fecha Inicio de Validez
|-
| <code>FechaEntregaOferta</code> || string (date) || Fecha Entrega Oferta
|-
| <code>FechaCierreEsperado</code> || string (date) || Fecha Cierre Esperado
|-
| <code>FechaCierreEfectivo</code> || string (date) || Fecha Cierre Efectivo
|-
| <code>Etapa</code> || string || Etapa
|-
| <code>Probabilidad</code> || number (double) || Probabilidad
|-
| <code>Solucion</code> || string || Solución Ofrecida
|-
| <code>ProximoPaso</code> || string || Próximo paso
|-
| <code>DeclaradoAlProveedor</code> || boolean || Declarado al Proveedor
|-
| <code>OportunidadProveedor</code> || string || Oportunidad en Proveedor
|-
| <code>Importante</code> || boolean || Importante
|-
| <code>Competencia</code> || string || Competencia
|-
| <code>Descripcion</code> || string || Descripción
|-
| <code>ActividadPlanificada</code> || string || Pasos Planificados
|-
| <code>Moneda</code> || string || Moneda
|-
| <code>IngresoEsperadoMoneda</code> || number (double) || Ingreso Esperado
|}
 
=== SDTNotaVenta ===
 
{| class="wikitable"
! Campo !! Tipo !! Descripción
|-
| <code>Fecha</code> || string (date) || Fecha
|-
| <code>Tipo</code> || string || Código
|-
| <code>Descripcion</code> || string || Descripción
|-
| <code>Comentarios</code> || string || Comentarios
|-
| <code>Local</code> || string || Local
|-
| <code>Almacen</code> || string || Almacén
|-
| <code>Moneda</code> || string || Moneda
|-
| <code>OportunidadExterna</code> || string || Número Externo
|-
| <code>OportunidadNumero</code> || integer (int64) || Oportunidad
|-
| <code>UsaIdentificacion</code> || boolean || Ingresa Identificación
|-
| <code>Cliente</code> || string || Cliente
|-
| <code>ClienteIdTributaria</code> || string || Id Tributaria de Cliente (cuando no se envía cliente)
|-
| <code>DireccionEntregaNumero</code> || integer (int64) || Dirección Entrega
|-
| <code>Condicion</code> || string || Condición
|-
| <code>CongelaPrecios</code> || boolean || Congela Precios
|-
| <code>FechaPrecios</code> || string (date) || Fecha para Precios
|-
| <code>OrdenDeCompraCliente</code> || string || Orden de Compra de Cliente
|-
| <code>Territorio</code> || string || Territorio
|-
| <code>Jurisdiccion</code> || string || Jurisdicción
|-
| <code>PorcentajeDescuentoGlobal</code> || number (double) || Porcentaje de Descuento
|-
| <code>FechaInicialEntrega</code> || string (date) || Fecha Inicial de Entrega
|-
| <code>FechaFinalEntrega</code> || string (date) || Fecha Final de Entrega
|-
| <code>Identificacion</code> || object || Véase <code>SDTNotaVenta.Identificacion</code>.
|-
| <code>Entrega</code> || object || Véase <code>SDTNotaVenta.Entrega</code>.
|-
| <code>Articulos</code> || array || Colección de <code>SDTNotaVenta.Articulos_Articulo</code>.
|-
| <code>Enlaces</code> || array || Colección de <code>SDTNotaVenta.Enlaces_Enlace</code>.
|}
 
=== SDTNotaVenta.Identificacion ===
 
{| class="wikitable"
! Campo !! Tipo !! Descripción
|-
| <code>ClienteNombre</code> || string || Nombre de Cliente
|-
| <code>ClienteTipo</code> || string || Tipo Valores: <code>F</code> = Fisico, <code>J</code> = Juridico.
|-
| <code>ClienteDireccion</code> || string || Dirección de Cliente
|-
| <code>ClienteCiudad</code> || string || Ciudad
|-
| <code>ClientePais</code> || string || País
|-
| <code>ClientePersonaFisicaTipoDocumento</code> || string || Documento Valores: <code>C</code> = CI, <code>D</code> = DNI, <code>P</code> = Pasaporte, <code>N</code> = NIE, <code>O</code> = Otros.
|-
| <code>ClientePersonaFisicaNumeroDocumento</code> || string || Número
|-
| <code>ClientePersonaJuridicaTipoDocumento</code> || string || Localización Valores: <code>N</code> = Nacional, <code>E</code> = Exterior.
|-
| <code>ClientePersonaJuridicaNumeroDocumento</code> || string || Id Tributaria
|}
 
=== SDTNotaVenta.Entrega ===
 
{| class="wikitable"
! Campo !! Tipo !! Descripción
|-
| <code>EntregaDireccion</code> || string || Dirección de Entrega
|-
| <code>EntregaCiudad</code> || string || Ciudad
|-
| <code>EntregaCodigoPostal</code> || string || Código Postal
|-
| <code>EntregaEstadoProvincia</code> || string || Estado / Provincia
|-
| <code>EntregaPais</code> || string || País
|-
| <code>EntregaTelefono</code> || string || Teléfono
|-
| <code>EntregaContacto</code> || string || Contacto
|}
 
=== SDTNotaVenta.Articulos_Articulo ===
 
{| class="wikitable"
! Campo !! Tipo !! Descripción
|-
| <code>ArticuloCodigo</code> || string || Artículo
|-
| <code>ArticuloLote</code> || string || Lote
|-
| <code>ArticuloCantidad</code> || number (double) || Cantidad
|-
| <code>ArticuloTipoDeVenta</code> || string || Tipo de Venta
|-
| <code>ArticuloSerie</code> || string || Serie
|-
| <code>ArticuloPorcentajeImpuesto</code> || number (double) || Porcentaje de Impuesto
|-
| <code>ArticuloPrecio</code> || number (double) || Precio
|-
| <code>ArticuloPrecioImpuestoIncluido</code> || boolean || Impuesto de Venta incluido en el precio
|-
| <code>ArticuloDescuento</code> || number (double) || Descuento
|-
| <code>ArticuloProveedor</code> || string || Proveedor
|-
| <code>ArticuloCostoUnitario</code> || number (double) || Costo Unitario
|-
| <code>ArticuloGastosImportacion</code> || number (double) || Gastos Importación
|}
 
=== SDTNotaVenta.Enlaces_Enlace ===
 
{| class="wikitable"
! Campo !! Tipo !! Descripción
|-
| <code>EnlaceDescripcion</code> || string || Descripción
|-
| <code>EnlaceURL</code> || string || URL
|}
 
=== SDTOrdenDeCompra ===


== Esquemas de Respuesta ==
Objeto de entrada del POST. Los campos calculados incluidos en su estructura no deben utilizarse para establecer los valores de la orden.


=== Esquema API_Transacciones_Respuesta ===
{| class="wikitable"
! Campo !! Tipo !! Descripción
|-
| <code>Numero</code> || integer (int64) || Número de Orden de Compra Calculado/asignado por el servidor; no enviar en el POST.
|-
| <code>Fecha</code> || string (date) || Fecha de Orden de Compra
|-
| <code>Descripcion</code> || string || Descripción
|-
| <code>Proveedor</code> || string || Proveedor
|-
| <code>Comprador</code> || string || Comprador
|-
| <code>CentroCostos</code> || string || Centro de Costos
|-
| <code>Comentarios</code> || string || Comentarios al Proveedor
|-
| <code>EsImportacion</code> || boolean || Importación
|-
| <code>FechaEntrega</code> || string (date) || Fecha de Entrega Esperada
|-
| <code>CondicionImportacion</code> || string || Condición Valores: <code>EXW</code> = EXW, <code>FCA</code> = FCA, <code>FOB</code> = FOB, <code>FAS</code> = FAS, <code>CFR</code> = CFR, <code>CIF</code> = CIF, <code>CPT</code> = CPT, <code>CIP</code> = CIP, <code>DAF</code> = DAF, <code>DES</code> = DES, <code>DEQ</code> = DEQ, <code>DDU</code> = DDU, <code>DAT</code> = DAT, <code>DAP</code> = DAP, <code>DDP</code> = DDP, <code>N/A</code> = NoAplica.
|-
| <code>CondicionImportacionAsociada</code> || string || Asociado a Condición
|-
| <code>NotaVentaNumero</code> || integer (int64) || Nota de Venta
|-
| <code>OportunidadNumero</code> || integer (int64) || Oportunidad
|-
| <code>Almacen</code> || string || Almacén Entrega
|-
| <code>Segmento</code> || string || Segmento
|-
| <code>Moneda</code> || string || Moneda
|-
| <code>FormaPago</code> || string || Forma de Pago
|-
| <code>SubTotal</code> || number (double) || SubTotal Calculado/asignado por el servidor; no enviar en el POST.
|-
| <code>Impuestos</code> || number (double) || Impuesto Calculado/asignado por el servidor; no enviar en el POST.
|-
| <code>Total</code> || number (double) || Total Calculado/asignado por el servidor; no enviar en el POST.
|-
| <code>Lineas</code> || array || Colección de <code>SDTOrdenDeCompra.Lineas_LineasItem</code>.
|}


* '''Existe''' (boolean): Indica si el elemento existe.
=== SDTOrdenDeCompra.Lineas_LineasItem ===
* '''Datos''' (string): Información adicional sobre el resultado.
* '''Mensajes''' (array): Mensajes relacionados con la operación.
  * '''Id''' (string): ID del mensaje.
  * '''Type''' (integer): Tipo de mensaje (informativo, advertencia, error, etc.).
  * '''Description''' (string): Descripción del mensaje.


=== Esquema OportunidadInsertarInput ===
{| class="wikitable"
! Campo !! Tipo !! Descripción
|-
| <code>Secuencia</code> || integer (int64) || Secuencia OC Calculado/asignado por el servidor; no enviar en el POST.
|-
| <code>Destino</code> || string || Destino Valores: <code>U</code> = BienesDeUso, <code>C</code> = BienesDeCambio, <code>G</code> = Gastos, <code>P</code> = Especifico.
|-
| <code>Descripcion</code> || string || Descripción
|-
| <code>Articulo</code> || string || Artículo
|-
| <code>CentroCostos</code> || string || Centro de Costos
|-
| <code>Mercancia</code> || string || Mercancía
|-
| <code>Cuenta</code> || string || Cuenta
|-
| <code>Proyecto</code> || string || Proyecto
|-
| <code>TipoTransaccion</code> || string || Tipo de Transacción
|-
| <code>Unidad</code> || string || Unidad
|-
| <code>Cantidad</code> || number (double) || Cantidad
|-
| <code>Precio</code> || number (double) || Precio Unitario
|-
| <code>ImpuestoCodigo</code> || string || Impuesto
|-
| <code>ImpuestoTasa</code> || number (double) || Tasa de Impuesto Vigente Calculado/asignado por el servidor; no enviar en el POST.
|-
| <code>SubTotal</code> || number (double) || SubTotal Calculado/asignado por el servidor; no enviar en el POST.
|-
| <code>Impuestos</code> || number (double) || Impuesto Calculado/asignado por el servidor; no enviar en el POST.
|-
| <code>Total</code> || number (double) || Total Calculado/asignado por el servidor; no enviar en el POST.
|}


* '''SDTOportunidad''' (object): Información detallada de la oportunidad.
=== SDTOrdenDeCompraConsulta ===
  * '''Nombre''' (string): Nombre.
  * '''Tipo''' (string): Tipo de Oportunidad.
  * '''NumeroExterno''' (string): Número Externo.
  * '''Territorio''' (string): Territorio.
  * '''AsignadoA''' (string): Asignado a.
  * '''Cuenta''' (string): Cuenta.
  * '''CuentaIdTributaria''' (string): Número de Documento.
  * '''Prospecto''' (integer, format: int64): Prospecto.
  * '''Origen''' (string): Origen.
  * '''FechaApertura''' (string, format: date): Fecha Apertura.
  * '''FechaInicio''' (string, format: date): Fecha Inicio de Validez.
  * '''FechaEntregaOferta''' (string, format: date): Fecha Entrega Oferta.
  * '''FechaCierreEsperado''' (string, format: date): Fecha Cierre Esperado.
  * '''FechaCierreEfectivo''' (string, format: date): Fecha Cierre Efectivo.
  * '''Etapa''' (string): Etapa.
  * '''Probabilidad''' (number, format: double): Probabilidad.
  * '''Solucion''' (string): Solución Ofrecida.
  * '''ProximoPaso''' (string): Próximo paso.
  * '''DeclaradoAlProveedor''' (boolean): Declarado al Proveedor.
  * '''OportunidadProveedor''' (string): Oportunidad en Proveedor.
  * '''Importante''' (boolean): Importante.
  * '''Competencia''' (string): Competencia.
  * '''Descripcion''' (string): Descripción.
  * '''ActividadPlanificada''' (string): Pasos Planificados.
  * '''Moneda''' (string): Moneda.
  * '''IngresoEsperadoMoneda''' (number, format: double): Ingreso Esperado.


=== Esquema NotaVentaOportunidadInsertarInput ===
{| class="wikitable"
! Campo !! Tipo !! Descripción
|-
| <code>Numero</code> || integer (int64) || Número de Orden de Compra
|-
| <code>Fecha</code> || string (date) || Fecha de Orden de Compra
|-
| <code>Descripcion</code> || string || Descripción
|-
| <code>Proveedor</code> || string || Proveedor
|-
| <code>ProveedorNombre</code> || string || Nombre asociado a <code>Proveedor</code>.
|-
| <code>Comprador</code> || string || Comprador
|-
| <code>CompradorNombre</code> || string || Nombre asociado a <code>Comprador</code>.
|-
| <code>CentroCostos</code> || string || Centro de Costos
|-
| <code>CentroCostosNombre</code> || string || Nombre asociado a <code>CentroCostos</code>.
|-
| <code>Comentarios</code> || string || Comentarios al Proveedor
|-
| <code>EsImportacion</code> || boolean || Importación
|-
| <code>FechaEntrega</code> || string (date) || Fecha de Entrega Esperada
|-
| <code>CondicionImportacion</code> || string || Condición Valores: <code>EXW</code> = EXW, <code>FCA</code> = FCA, <code>FOB</code> = FOB, <code>FAS</code> = FAS, <code>CFR</code> = CFR, <code>CIF</code> = CIF, <code>CPT</code> = CPT, <code>CIP</code> = CIP, <code>DAF</code> = DAF, <code>DES</code> = DES, <code>DEQ</code> = DEQ, <code>DDU</code> = DDU, <code>DAT</code> = DAT, <code>DAP</code> = DAP, <code>DDP</code> = DDP, <code>N/A</code> = NoAplica.
|-
| <code>CondicionImportacionAsociada</code> || string || Asociado a Condición
|-
| <code>NotaVentaNumero</code> || integer (int64) || Nota de Venta
|-
| <code>OportunidadNumero</code> || integer (int64) || Oportunidad
|-
| <code>Almacen</code> || string || Almacén Entrega
|-
| <code>AlmacenNombre</code> || string || Nombre asociado a <code>Almacen</code>.
|-
| <code>Segmento</code> || string || Segmento
|-
| <code>SegmentoNombre</code> || string || Nombre asociado a <code>Segmento</code>.
|-
| <code>Moneda</code> || string || Moneda
|-
| <code>MonedaNombre</code> || string || Nombre asociado a <code>Moneda</code>.
|-
| <code>FormaPago</code> || string || Forma de Pago
|-
| <code>SubTotal</code> || number (double) || SubTotal
|-
| <code>Impuestos</code> || number (double) || Impuesto
|-
| <code>Total</code> || number (double) || Total
|-
| <code>Lineas</code> || array || Colección de <code>SDTOrdenDeCompraConsulta.Lineas_LineasItem</code>.
|-
| <code>Ruta</code> || string || Código de la ruta de la orden.
|-
| <code>RutaNombre</code> || string || Nombre de la ruta.
|-
| <code>Estacion</code> || string || Código de la estación actual.
|-
| <code>EstacionNombre</code> || string || Nombre de la estación actual.
|}


* '''SDTNotaVenta''' (object): Información detallada de la nota de venta.
=== SDTOrdenDeCompraConsulta.Lineas_LineasItem ===
  * '''Fecha''' (string, format: date): Fecha.
  * '''Tipo''' (string): Código.
  * '''Descripcion''' (string): Descripción.
  * '''Comentarios''' (string): Comentarios.
  * '''Local''' (string): Local.
  * '''Almacen''' (string): Almacén.
  * '''Moneda''' (string): Moneda.
  * '''OportunidadExterna''' (string): Número Externo.
  * '''OportunidadNumero''' (integer, format: int64): Oportunidad.
  * '''UsaIdentificacion''' (boolean): Ingresa Identificación.
  * '''Cliente''' (string): Cliente.
  * '''ClienteIdTributaria''' (string): Id Tributaria de Cliente (cuando no se envía cliente).
  * '''DireccionEntregaNumero''' (integer, format: int64): Dirección Entrega.
  * '''Condicion''' (string): Condición.
  * '''CongelaPrecios''' (boolean): Congela Precios.
  * '''FechaPrecios''' (string, format: date): Fecha para Precios.
  * '''OrdenDeCompraCliente''' (string): Orden de Compra de Cliente.
  * '''Territorio''' (string): Territorio.
  * '''Jurisdiccion''' (string): Jurisdicción.
  * '''PorcentajeDescuentoGlobal''' (number, format: double): Porcentaje de Descuento.
  * '''FechaInicialEntrega''' (string, format: date): Fecha Inicial de Entrega.
  * '''FechaFinalEntrega''' (string, format: date): Fecha Final de Entrega.
  * '''Identificacion''': Información de Identificación (ver sección SDTNotaVenta.Identificacion).
  * '''Entrega''': Información de Entrega (ver sección SDTNotaVenta.Entrega).
  * '''Articulos''': Lista de artículos (ver sección SDTNotaVenta.Articulos_Articulo).
  * '''Enlaces''': Lista de enlaces (ver sección SDTNotaVenta.Enlaces_Enlace).


* '''SDTNotaVenta.Identificacion''' (object): Información de Identificación del cliente.
{| class="wikitable"
  * '''ClienteNombre''' (string): Nombre de Cliente.
! Campo !! Tipo !! Descripción
  * '''ClienteTipo''' (string): Tipo.
|-
  * '''ClienteDireccion''' (string): Dirección de Cliente.
| <code>Secuencia</code> || integer (int64) || Secuencia OC
  * '''ClienteCiudad''' (string): Ciudad.
|-
  * '''ClientePais''' (string): País.
| <code>Destino</code> || string || Destino Valores: <code>U</code> = BienesDeUso, <code>C</code> = BienesDeCambio, <code>G</code> = Gastos, <code>P</code> = Especifico.
  * '''ClientePersonaFisicaTipoDocumento''' (string): Documento.
|-
  * '''ClientePersonaFisicaNumeroDocumento''' (string): Número.
| <code>Descripcion</code> || string || Descripción
  * '''ClientePersonaJuridicaTipoDocumento''' (string): Localización.
|-
  * '''ClientePersonaJuridicaNumeroDocumento''' (string): Id Tributaria.
| <code>Articulo</code> || string || Artículo
|-
| <code>ArticuloNombre</code> || string || Nombre asociado a <code>Articulo</code>.
|-
| <code>ArticuloNombreLargo</code> || string || Nombre largo del artículo.
|-
| <code>CentroCostos</code> || string || Centro de Costos
|-
| <code>CentroCostosNombre</code> || string || Nombre asociado a <code>CentroCostos</code>.
|-
| <code>Mercancia</code> || string || Mercancía
|-
| <code>MercanciaNombre</code> || string || Nombre asociado a <code>Mercancia</code>.
|-
| <code>Cuenta</code> || string || Cuenta
|-
| <code>CuentaNombre</code> || string || Nombre asociado a <code>Cuenta</code>.
|-
| <code>Proyecto</code> || string || Proyecto
|-
| <code>ProyectoNombre</code> || string || Nombre asociado a <code>Proyecto</code>.
|-
| <code>TipoTransaccion</code> || string || Tipo de Transacción
|-
| <code>TipoTransaccionNombre</code> || string || Nombre asociado a <code>TipoTransaccion</code>.
|-
| <code>Unidad</code> || string || Unidad
|-
| <code>UnidadNombre</code> || string || Nombre asociado a <code>Unidad</code>.
|-
| <code>UnidadAbreviatura</code> || string || Abreviatura de la unidad.
|-
| <code>Cantidad</code> || number (double) || Cantidad
|-
| <code>Precio</code> || number (double) || Precio Unitario
|-
| <code>ImpuestoCodigo</code> || string || Impuesto
|-
| <code>ImpuestoNombre</code> || string || Nombre del impuesto.
|-
| <code>ImpuestoTasa</code> || number (double) || Tasa de Impuesto Vigente
|-
| <code>SubTotal</code> || number (double) || SubTotal
|-
| <code>Impuestos</code> || number (double) || Impuesto
|-
| <code>Total</code> || number (double) || Total
|}


* '''SDTNotaVenta.Entrega''' (object): Información de Entrega.
== Verificación de una integración ==
  * '''EntregaDireccion''' (string): Dirección de Entrega.
  * '''EntregaCiudad''' (string): Ciudad.
  * '''EntregaCodigoPostal''' (string): Código Postal.
  * '''EntregaEstadoProvincia''' (string): Estado / Provincia.
  * '''EntregaPais''' (string): País.
  * '''EntregaTelefono''' (string): Teléfono.
  * '''EntregaContacto''' (string): Contacto.


* '''SDTNotaVenta.Articulos_Articulo''' (object): Detalles de Artículos.
# Consultar por GET una orden conocida y comprobar que corresponde a la compañía del token.
  * '''ArticuloCodigo''' (string): Artículo.
# Crear en test una orden con dos líneas válidas.
  * '''ArticuloLote''' (string): Lote.
# Consultar el número devuelto y comparar cabecera, líneas e importes con Lazarvs.
  * '''ArticuloCantidad''' (number, format: double): Cantidad.
# Repetir con una primera línea válida y una segunda inválida, usando una descripción distinta.
  * '''ArticuloTipoDeVenta''' (string): Tipo de Venta.
# Comprobar HTTP 409, mensajes de error y número de salida 0; verificar en Lazarvs que no quedó una orden con la descripción de la prueba fallida.
  * '''ArticuloSerie''' (string): Serie.
# Probar el GET con cada filtro, con ambos filtros y sin filtros.
  * '''ArticuloPorcentajeImpuesto''' (number, format: double): Porcentaje de Impuesto.
  * '''ArticuloPrecio''' (number, format: double): Precio.
  * '''ArticuloPrecioImpuestoIncluido''' (boolean): Impuesto de Venta incluido en el precio.
  * '''ArticuloDescuento''' (number, format: double): Descuento.
  * '''ArticuloProveedor''' (string): Proveedor.
  * '''ArticuloCostoUnitario''' (number, format: double): Costo Unitario.
  * '''ArticuloGastosImportacion''' (number, format: double): Gastos de Importación.


* '''SDTNotaVenta.Enlaces_Enlace''' (object): Detalles de Enlaces.
Las pruebas de alta deben ejecutarse en test antes de habilitar una integración en producción.
  * '''EnlaceDescripcion''' (string): Descripción.
  * '''EnlaceURL''' (string): URL.

Revisión actual - 22:48 5 nov 2026

API Transacciones de Lazarvs

La API permite consultar y crear oportunidades, notas de venta y órdenes de compra. Las operaciones GET y POST comparten la ruta de cada recurso.

Información general

  • Objeto: API_Transacciones.
  • URL base: {{URL de Lazarvs}}/transacciones.
  • Formato: JSON.
  • Contrato local de desarrollo: {{URL de Lazarvs}}/API_Transacciones.yaml.

La URL de Lazarvs incluye el protocolo, servidor y contexto de la aplicación. Debe utilizarse la URL correspondiente al ambiente de destino. Los códigos de maestros deben existir en la compañía y el ambiente utilizados.

Autenticación y encabezados

Todas las operaciones requieren el token JWT autorizado para la integración. La compañía y el usuario se obtienen del token; no se seleccionan enviando esos datos en el cuerpo de la orden.

Authorization: Bearer <token_jwt>
Accept: application/json
Content-Type: application/json

Accept indica el formato esperado de respuesta. Content-Type debe enviarse en los POST con cuerpo JSON. Los GET no requieren cuerpo. Los datos adicionales del payload JWT que una operación no utiliza se ignoran; no deben confundirse con el cuerpo JSON del POST.

Convenciones

  • Respetar exactamente las mayúsculas y minúsculas de los parámetros y miembros JSON documentados. En particular, el GET de órdenes de compra recibe Ordennumero, mientras que el POST devuelve OrdenNumero.
  • Las fechas se envían como cadenas YYYY-MM-DD.
  • Los booleanos se envían como true o false, sin comillas.
  • Los números se envían sin separadores de miles y con punto decimal, sin comillas. Los códigos se envían como cadenas para conservar ceros iniciales.
  • En respuestas observadas, el generador serializa algunos importes y números como cadenas, aunque el YAML los declara numéricos. Los clientes deben contemplar esa representación.
  • Que el YAML no declare un campo obligatorio no elimina las validaciones funcionales de las transacciones. Los ejemplos deben adaptarse a los maestros y configuración de cada compañía.

Nombres externos de los objetos JSON

Los cuerpos de los POST y los datos devueltos por los GET utilizan los siguientes nombres externos:

Recurso Raíz del POST Raíz del GET Tipo interno POST Tipo interno GET
Oportunidad Oportunidad Oportunidad SDTOportunidad SDTOportunidad
Nota de venta NotaVenta NotaVenta SDTNotaVenta SDTNotaVenta
Orden de compra OrdenDeCompra OrdenDeCompra SDTOrdenDeCompra SDTOrdenDeCompraConsulta

El prefijo SDT identifica los tipos internos, no el nombre de la propiedad raíz que debe enviar o leer el consumidor. La respuesta del POST de orden de compra conserva OrdenNumero y Mensajes.

Esta documentación refleja los nombres externos confirmados en la implementación. El YAML de versión 20261105223625 todavía declara algunos nombres raíz anteriores, por lo que no debe usarse para reconstruir esas envolturas JSON sin actualizarlo.

Endpoints

Método Ruta relativa Operación
GET /Oportunidad Consulta por número externo de oportunidad.
POST /Oportunidad Crea una oportunidad.
GET /NotaVenta Consulta una nota de venta asociada a una oportunidad externa.
POST /NotaVenta Crea una nota de venta.
GET /OrdenDeCompra Consulta por número de orden y/o oportunidad externa.
POST /OrdenDeCompra Crea cabecera y líneas de una orden de compra.

GET /Oportunidad

Consulta una oportunidad por su número externo.

Parámetro query Tipo Descripción
Oportunidad string Número externo de oportunidad. El YAML lo declara opcional; debe informarse para identificar la oportunidad buscada.
GET {{URL de Lazarvs}}/transacciones/Oportunidad?Oportunidad=2024-0101

La respuesta contiene Oportunidad y los Mensajes que correspondan. Si no se encuentra el registro, se devuelve HTTP 404.

POST /Oportunidad

Crea una oportunidad. El cuerpo contiene un objeto raíz Oportunidad. Su estructura completa figura en la sección de esquemas.

{
  "Oportunidad": {
    "Nombre": "Oportunidad de prueba",
    "NumeroExterno": "API-PRUEBA-001",
    "CuentaIdTributaria": "ID_TRIBUTARIA_CLIENTE",
    "FechaApertura": "2026-11-04",
    "Moneda": "USD",
    "IngresoEsperadoMoneda": 20000,
    "Probabilidad": 0,
    "DeclaradoAlProveedor": false,
    "Importante": false
  }
}

Ejemplo orientativo: completar los códigos y demás datos exigidos por la configuración. La respuesta contiene la colección de mensajes de la operación.

GET /NotaVenta

Consulta una nota de venta asociada a una oportunidad identificada por su número externo.

Parámetro query Tipo Descripción
Oportunidad string Número externo de oportunidad. El YAML lo declara opcional; debe informarse para realizar esta búsqueda.
GET {{URL de Lazarvs}}/transacciones/NotaVenta?Oportunidad=2024-0101

La respuesta contiene NotaVenta y los Mensajes que correspondan. Si no se encuentra, se devuelve HTTP 404.

POST /NotaVenta

Crea una nota de venta mediante el objeto raíz NotaVenta. Debe indicarse al menos una referencia: OportunidadExterna, OportunidadNumero u OrdenDeCompraCliente. La implementación controla duplicados con las referencias informadas.

{
  "NotaVenta": {
    "Fecha": "2026-11-04",
    "Descripcion": "Nota de venta de prueba",
    "Moneda": "USD",
    "Cliente": "CODIGO_CLIENTE",
    "OrdenDeCompraCliente": "OC-CLI-PRUEBA-001",
    "UsaIdentificacion": false,
    "CongelaPrecios": false,
    "Articulos": [
      {
        "ArticuloCodigo": "CODIGO_ARTICULO",
        "ArticuloCantidad": 2,
        "ArticuloPrecio": 100,
        "ArticuloPrecioImpuestoIncluido": false
      }
    ],
    "Enlaces": []
  }
}

Ejemplo orientativo: sustituir los códigos y completar las condiciones, ubicación y demás campos requeridos. La respuesta contiene la colección de mensajes. Los campos de identificación, entrega, artículos y enlaces se detallan en los esquemas.

GET /OrdenDeCompra

Devuelve la cabecera y las líneas de una orden de compra dentro de la compañía del token.

Parámetro query exacto Tipo Descripción
Ordennumero integer (int64) Número interno de orden de compra. Opcional individualmente.
Oportunidad string Número externo de oportunidad (OpoNroExt), no su número interno. Opcional individualmente.

Debe informarse al menos uno de los dos parámetros. Si se informan ambos, la orden debe cumplir ambos filtros. Si no se informa ninguno, la validación devuelve HTTP 400. Si no hay coincidencias, devuelve HTTP 404.

La respuesta es un único objeto: cuando una oportunidad tiene varias órdenes, la consulta implementada selecciona la de menor número.

GET {{URL de Lazarvs}}/transacciones/OrdenDeCompra?Ordennumero=845
GET {{URL de Lazarvs}}/transacciones/OrdenDeCompra?Oportunidad=OP-EXTERNA-001
GET {{URL de Lazarvs}}/transacciones/OrdenDeCompra?Ordennumero=845&Oportunidad=OP-EXTERNA-001

La respuesta contiene la propiedad raíz OrdenDeCompra, de tipo SDTOrdenDeCompraConsulta, y los mensajes que correspondan. Incluye códigos y nombres de los elementos relacionados, así como la ruta, la estación actual y sus nombres. El GET utiliza un SDT de consulta distinto del SDT de entrada del POST.

Los nombres corresponden a los códigos relacionados. Descripcion conserva el texto propio de la cabecera o de la línea y puede diferir del nombre del artículo. Los campos sin datos pueden aparecer como cadenas vacías. El estado de la orden se informa mediante Estacion y EstacionNombre.

POST /OrdenDeCompra

Crea una orden de compra con cabecera y una o más líneas. El cuerpo debe estar contenido en OrdenDeCompra. No se utilizan los filtros query del GET.

{
  "OrdenDeCompra": {
    "Fecha": "2026-11-04",
    "FechaEntrega": "2026-11-04",
    "Descripcion": "PRUEBA API - Alta de orden de compra",
    "Proveedor": "0291",
    "CentroCostos": "GV01",
    "Almacen": "02",
    "Moneda": "USD",
    "EsImportacion": false,
    "FormaPago": "45 Días, Cheque",
    "Lineas": [
      {
        "Destino": "C",
        "Descripcion": "Prueba API - Línea 1",
        "Articulo": "020-000182-002",
        "CentroCostos": "GV01",
        "Mercancia": "W01",
        "Cantidad": 2,
        "Precio": 100,
        "ImpuestoCodigo": "BD"
      },
      {
        "Destino": "C",
        "Descripcion": "Prueba API - Línea 2",
        "Articulo": "020-160001-001",
        "CentroCostos": "GV01",
        "Mercancia": "W01",
        "Cantidad": 1,
        "Precio": 50,
        "ImpuestoCodigo": "BD"
      }
    ]
  }
}

Este ejemplo fue probado en test con esos maestros. Los códigos no son universales: deben sustituirse por los existentes en el ambiente y la compañía de destino.

Reglas del alta

  • Se requiere al menos una línea.
  • El servidor asigna el número de orden, las secuencias, la ruta y estación inicial y los datos de auditoría.
  • Si se omite la fecha de orden, se utiliza la fecha del servidor. Si se omite la fecha de entrega, se utiliza la fecha de orden.
  • Para compras locales corresponde informar el almacén de entrega. Para importaciones corresponde la condición de importación; se aplican las validaciones de la transacción.
  • Para destino Bienes de Cambio, la unidad se obtiene del artículo. La mercancía también se toma del artículo cuando tiene una definida.
  • La tasa del impuesto se obtiene del modelo a partir del código de impuesto; no se asigna desde ImpuestoTasa.
  • Los subtotales, impuestos y totales se calculan mediante las reglas de los Business Components.
  • Cabecera, líneas y actualización de totales se confirman con un único Commit. Si falla alguna etapa, se ejecuta Rollback de toda la operación.
  • Cada POST exitoso crea una nueva orden. No debe repetirse una solicitud de alta sin verificar antes el resultado de la anterior.

Campos calculados

Aunque el SDT de entrada los incluye, no deben enviarse como datos de alta: Numero, los importes de cabecera SubTotal, Impuestos y Total, y los miembros de línea Secuencia, ImpuestoTasa, SubTotal, Impuestos y Total. Sus valores se asignan o calculan en el servidor.

Respuesta exitosa

{
  "Mensajes": [
    {
      "Description": "Se creó la orden de compra 845",
      "Id": "INFOOC01",
      "Type": 2
    }
  ],
  "OrdenNumero": "845"
}

El número del ejemplo corresponde a una ejecución de test. El número generado permite consultar la orden por GET. Los mensajes automáticos de guardados intermedios se filtran para no confundirlos con la confirmación final.

Respuesta de error

{
  "Mensajes": [
    {
      "Description": "Línea 2: No existe 'Artículo'.",
      "Id": "ForeignKeyNotFound",
      "Type": 1
    },
    {
      "Description": "Línea 2: No existe 'Unidad'.",
      "Id": "ForeignKeyNotFound",
      "Type": 1
    }
  ],
  "OrdenNumero": "0"
}

Con la implementación actual, los errores funcionales del POST devuelven HTTP 409. OrdenNumero = 0 indica que no se devuelve una orden creada. El error de unidad puede ser consecuencia de un artículo inexistente, porque la unidad se resuelve a partir de ese artículo. Se verificó en test que un error en la segunda línea revierte también la cabecera y la primera línea.

Respuestas y códigos HTTP

HTTP Significado en la implementación
200 Operación exitosa. El POST de orden de compra devuelve el número generado; no utiliza 201 en esta versión.
400 GET de orden de compra sin número de orden ni oportunidad externa.
401 Token inválido o permisos insuficientes, según los eventos actuales.
404 Consulta GET sin resultados.
405 Operación no habilitada o uso de entidad no permitido por las validaciones actuales.
409 POST con errores funcionales o de validación.

El YAML generado enumera 200 y 404 por operación, pero no refleja todos los códigos asignados en los eventos del API. La tabla anterior incluye el comportamiento implementado. No se utiliza 422 en la implementación actual.

Estructura de mensajes

Cada mensaje incluye Id, Type y Description. En las respuestas observadas se presenta como un arreglo Mensajes. Los nombres de esquemas internos del YAML no deben confundirse con los nombres de propiedades JSON.

Type Significado
0 Advertencia (Warning)
1 Error (Error)
2 Información (Info)
3 Depuración (Debug)

El YAML tiene una inconsistencia en los esquemas de mensajes: algunos GET referencian un ítem individual para Mensajes, y el esquema genérico de los POST de oportunidad y nota de venta usa Messages. Para integrar esos POST, comprobar la envoltura JSON efectiva en el ambiente de destino. Para órdenes de compra se verificó el arreglo Mensajes mostrado en los ejemplos. El esquema anterior API_Transacciones_Respuesta con Existe y Datos no es la respuesta declarada por el contrato actual.

Esquemas de datos

Los tipos corresponden a OpenAPI; las reglas de obligatoriedad funcional dependen de la operación y de la configuración. Los nombres de los esquemas son internos y conservan el prefijo SDT; las propiedades raíz JSON expuestas no llevan ese prefijo. Para órdenes de compra, SDTOrdenDeCompra es el tipo de entrada del POST y SDTOrdenDeCompraConsulta es el tipo de salida del GET; ambas operaciones exponen la propiedad raíz OrdenDeCompra. Este último incorpora los campos descriptivos implementados.

SDTOportunidad

Campo Tipo Descripción
Nombre string Nombre
Tipo string Tipo de Oportunidad
NumeroExterno string Número Externo
Territorio string Territorio
AsignadoA string Asignado a
Cuenta string Cuenta
CuentaIdTributaria string Número de Documento
Prospecto integer (int64) Prospecto
Origen string Origen
FechaApertura string (date) Fecha Apertura
FechaInicio string (date) Fecha Inicio de Validez
FechaEntregaOferta string (date) Fecha Entrega Oferta
FechaCierreEsperado string (date) Fecha Cierre Esperado
FechaCierreEfectivo string (date) Fecha Cierre Efectivo
Etapa string Etapa
Probabilidad number (double) Probabilidad
Solucion string Solución Ofrecida
ProximoPaso string Próximo paso
DeclaradoAlProveedor boolean Declarado al Proveedor
OportunidadProveedor string Oportunidad en Proveedor
Importante boolean Importante
Competencia string Competencia
Descripcion string Descripción
ActividadPlanificada string Pasos Planificados
Moneda string Moneda
IngresoEsperadoMoneda number (double) Ingreso Esperado

SDTNotaVenta

Campo Tipo Descripción
Fecha string (date) Fecha
Tipo string Código
Descripcion string Descripción
Comentarios string Comentarios
Local string Local
Almacen string Almacén
Moneda string Moneda
OportunidadExterna string Número Externo
OportunidadNumero integer (int64) Oportunidad
UsaIdentificacion boolean Ingresa Identificación
Cliente string Cliente
ClienteIdTributaria string Id Tributaria de Cliente (cuando no se envía cliente)
DireccionEntregaNumero integer (int64) Dirección Entrega
Condicion string Condición
CongelaPrecios boolean Congela Precios
FechaPrecios string (date) Fecha para Precios
OrdenDeCompraCliente string Orden de Compra de Cliente
Territorio string Territorio
Jurisdiccion string Jurisdicción
PorcentajeDescuentoGlobal number (double) Porcentaje de Descuento
FechaInicialEntrega string (date) Fecha Inicial de Entrega
FechaFinalEntrega string (date) Fecha Final de Entrega
Identificacion object Véase SDTNotaVenta.Identificacion.
Entrega object Véase SDTNotaVenta.Entrega.
Articulos array Colección de SDTNotaVenta.Articulos_Articulo.
Enlaces array Colección de SDTNotaVenta.Enlaces_Enlace.

SDTNotaVenta.Identificacion

Campo Tipo Descripción
ClienteNombre string Nombre de Cliente
ClienteTipo string Tipo Valores: F = Fisico, J = Juridico.
ClienteDireccion string Dirección de Cliente
ClienteCiudad string Ciudad
ClientePais string País
ClientePersonaFisicaTipoDocumento string Documento Valores: C = CI, D = DNI, P = Pasaporte, N = NIE, O = Otros.
ClientePersonaFisicaNumeroDocumento string Número
ClientePersonaJuridicaTipoDocumento string Localización Valores: N = Nacional, E = Exterior.
ClientePersonaJuridicaNumeroDocumento string Id Tributaria

SDTNotaVenta.Entrega

Campo Tipo Descripción
EntregaDireccion string Dirección de Entrega
EntregaCiudad string Ciudad
EntregaCodigoPostal string Código Postal
EntregaEstadoProvincia string Estado / Provincia
EntregaPais string País
EntregaTelefono string Teléfono
EntregaContacto string Contacto

SDTNotaVenta.Articulos_Articulo

Campo Tipo Descripción
ArticuloCodigo string Artículo
ArticuloLote string Lote
ArticuloCantidad number (double) Cantidad
ArticuloTipoDeVenta string Tipo de Venta
ArticuloSerie string Serie
ArticuloPorcentajeImpuesto number (double) Porcentaje de Impuesto
ArticuloPrecio number (double) Precio
ArticuloPrecioImpuestoIncluido boolean Impuesto de Venta incluido en el precio
ArticuloDescuento number (double) Descuento
ArticuloProveedor string Proveedor
ArticuloCostoUnitario number (double) Costo Unitario
ArticuloGastosImportacion number (double) Gastos Importación

SDTNotaVenta.Enlaces_Enlace

Campo Tipo Descripción
EnlaceDescripcion string Descripción
EnlaceURL string URL

SDTOrdenDeCompra

Objeto de entrada del POST. Los campos calculados incluidos en su estructura no deben utilizarse para establecer los valores de la orden.

Campo Tipo Descripción
Numero integer (int64) Número de Orden de Compra Calculado/asignado por el servidor; no enviar en el POST.
Fecha string (date) Fecha de Orden de Compra
Descripcion string Descripción
Proveedor string Proveedor
Comprador string Comprador
CentroCostos string Centro de Costos
Comentarios string Comentarios al Proveedor
EsImportacion boolean Importación
FechaEntrega string (date) Fecha de Entrega Esperada
CondicionImportacion string Condición Valores: EXW = EXW, FCA = FCA, FOB = FOB, FAS = FAS, CFR = CFR, CIF = CIF, CPT = CPT, CIP = CIP, DAF = DAF, DES = DES, DEQ = DEQ, DDU = DDU, DAT = DAT, DAP = DAP, DDP = DDP, N/A = NoAplica.
CondicionImportacionAsociada string Asociado a Condición
NotaVentaNumero integer (int64) Nota de Venta
OportunidadNumero integer (int64) Oportunidad
Almacen string Almacén Entrega
Segmento string Segmento
Moneda string Moneda
FormaPago string Forma de Pago
SubTotal number (double) SubTotal Calculado/asignado por el servidor; no enviar en el POST.
Impuestos number (double) Impuesto Calculado/asignado por el servidor; no enviar en el POST.
Total number (double) Total Calculado/asignado por el servidor; no enviar en el POST.
Lineas array Colección de SDTOrdenDeCompra.Lineas_LineasItem.

SDTOrdenDeCompra.Lineas_LineasItem

Campo Tipo Descripción
Secuencia integer (int64) Secuencia OC Calculado/asignado por el servidor; no enviar en el POST.
Destino string Destino Valores: U = BienesDeUso, C = BienesDeCambio, G = Gastos, P = Especifico.
Descripcion string Descripción
Articulo string Artículo
CentroCostos string Centro de Costos
Mercancia string Mercancía
Cuenta string Cuenta
Proyecto string Proyecto
TipoTransaccion string Tipo de Transacción
Unidad string Unidad
Cantidad number (double) Cantidad
Precio number (double) Precio Unitario
ImpuestoCodigo string Impuesto
ImpuestoTasa number (double) Tasa de Impuesto Vigente Calculado/asignado por el servidor; no enviar en el POST.
SubTotal number (double) SubTotal Calculado/asignado por el servidor; no enviar en el POST.
Impuestos number (double) Impuesto Calculado/asignado por el servidor; no enviar en el POST.
Total number (double) Total Calculado/asignado por el servidor; no enviar en el POST.

SDTOrdenDeCompraConsulta

Campo Tipo Descripción
Numero integer (int64) Número de Orden de Compra
Fecha string (date) Fecha de Orden de Compra
Descripcion string Descripción
Proveedor string Proveedor
ProveedorNombre string Nombre asociado a Proveedor.
Comprador string Comprador
CompradorNombre string Nombre asociado a Comprador.
CentroCostos string Centro de Costos
CentroCostosNombre string Nombre asociado a CentroCostos.
Comentarios string Comentarios al Proveedor
EsImportacion boolean Importación
FechaEntrega string (date) Fecha de Entrega Esperada
CondicionImportacion string Condición Valores: EXW = EXW, FCA = FCA, FOB = FOB, FAS = FAS, CFR = CFR, CIF = CIF, CPT = CPT, CIP = CIP, DAF = DAF, DES = DES, DEQ = DEQ, DDU = DDU, DAT = DAT, DAP = DAP, DDP = DDP, N/A = NoAplica.
CondicionImportacionAsociada string Asociado a Condición
NotaVentaNumero integer (int64) Nota de Venta
OportunidadNumero integer (int64) Oportunidad
Almacen string Almacén Entrega
AlmacenNombre string Nombre asociado a Almacen.
Segmento string Segmento
SegmentoNombre string Nombre asociado a Segmento.
Moneda string Moneda
MonedaNombre string Nombre asociado a Moneda.
FormaPago string Forma de Pago
SubTotal number (double) SubTotal
Impuestos number (double) Impuesto
Total number (double) Total
Lineas array Colección de SDTOrdenDeCompraConsulta.Lineas_LineasItem.
Ruta string Código de la ruta de la orden.
RutaNombre string Nombre de la ruta.
Estacion string Código de la estación actual.
EstacionNombre string Nombre de la estación actual.

SDTOrdenDeCompraConsulta.Lineas_LineasItem

Campo Tipo Descripción
Secuencia integer (int64) Secuencia OC
Destino string Destino Valores: U = BienesDeUso, C = BienesDeCambio, G = Gastos, P = Especifico.
Descripcion string Descripción
Articulo string Artículo
ArticuloNombre string Nombre asociado a Articulo.
ArticuloNombreLargo string Nombre largo del artículo.
CentroCostos string Centro de Costos
CentroCostosNombre string Nombre asociado a CentroCostos.
Mercancia string Mercancía
MercanciaNombre string Nombre asociado a Mercancia.
Cuenta string Cuenta
CuentaNombre string Nombre asociado a Cuenta.
Proyecto string Proyecto
ProyectoNombre string Nombre asociado a Proyecto.
TipoTransaccion string Tipo de Transacción
TipoTransaccionNombre string Nombre asociado a TipoTransaccion.
Unidad string Unidad
UnidadNombre string Nombre asociado a Unidad.
UnidadAbreviatura string Abreviatura de la unidad.
Cantidad number (double) Cantidad
Precio number (double) Precio Unitario
ImpuestoCodigo string Impuesto
ImpuestoNombre string Nombre del impuesto.
ImpuestoTasa number (double) Tasa de Impuesto Vigente
SubTotal number (double) SubTotal
Impuestos number (double) Impuesto
Total number (double) Total

Verificación de una integración

  1. Consultar por GET una orden conocida y comprobar que corresponde a la compañía del token.
  2. Crear en test una orden con dos líneas válidas.
  3. Consultar el número devuelto y comparar cabecera, líneas e importes con Lazarvs.
  4. Repetir con una primera línea válida y una segunda inválida, usando una descripción distinta.
  5. Comprobar HTTP 409, mensajes de error y número de salida 0; verificar en Lazarvs que no quedó una orden con la descripción de la prueba fallida.
  6. Probar el GET con cada filtro, con ambos filtros y sin filtros.

Las pruebas de alta deben ejecutarse en test antes de habilitar una integración en producción.