Skip to main content

Buscar ventas

Con esta función, se tiene la capacidad de leer las ventas que han sido registrados en el sistema. Es importante destacar que se puede proporcionar el nombre de una en concreto a través de un parámetro de URL query así como una fecha de creación de esta. En caso de no especificar estos parámetro, se llevará a cabo la lectura de todos las ventas del sistema. Si la fecha se introduce en el formato no deseado, se mostrarán todas las fechas.

URL

/CTNEAT/SALEORDER/READ/{tkn}

Método HTTP

GET

Parámetros de la solicitud

Nombre del parámetro Tipo de dato Descripción del parámetro Obligatorio Posibles valores
CODIGOVENTA cadena Nombre de la venta No Cualquiera
FECHACREACION cadena Fecha de creación o lanzamiento del pedido No Fechas en formato DD/MM/YYYY

Encabezados de la solicitud

Nombre del encabezado Descripción del encabezado Obligatorio

Cuerpo de la solicitud

No se requiere un cuerpo de solicitud para este método HTTP.

Parámetros de la respuesta

Nombre del parámetro Tipo de dato Descripción del parámetro
Result JSON Json con la descripción del resultado de la operación
Elementos de Result
  • Result.NRecords: Valor numérico que indica el número de registros en la matriz Result.Data.
  • Result.Data: Matriz que contiene uno o más objetos (Cantidad de registrios leídos).
  • Result.Data[x].CODIGOVENTA: Nombre de la venta.
  • Result.Data[x].NOMBRECLIENTE: Nombre del cliente.
  • Result.Data[x].REFERENCIACLIENTE: Referencia de la venta para el cliente.
  • Result.Data[x].FECHACREACION: Fecha de creación de la venta.
  • Result.Data[x].LINES: Líneas asociadas a la venta
  • Result.Data[x].LINES[y].PRODUCTO: Código del producto de la venta.
  • Result.Data[x].LINES[y].VERSIONPRODUCTO: Versión del producto.
  • Result.Data[x].LINES[y].UNIDADES: Cantidad específica de la línea.
  • Result.Data[x].LINES[y].PRECIO: Precio total de la línea.
  • Result.Data[x].LINES[y].FECHAS: Listado de fechas de entrega asociadas a una línea de la venta.
  • Result.Data[x].LINES[y].FECHAS[t].UNIDADES: Precio total de la línea.
  • Result.Data[x].LINES[y].FECHAS[t].FECHAENTREGA: Precio total de la línea.

Códigos de estado de la respuesta

Código de estado Descripción del código de estado Posibles razones
200 OK La solicitud fue exitosa
400 Petición errónea Alguno de los parámetros pasados no es correcto
500 Error interno Error en el servidor
401 Unauthorized El usuario no está autenticado

Ejemplo de consulta

http://ctincoming/SALEORDER/READ/693DDFEC2F4BFDDEAF04DD2724984C9B3CA89D553DD8E5B9BB233AD6BB6075F1?CODIGOVENTA=PEDIDO&FECHACREACION=20250302112358

Ejemplo de respuesta

{ 
  "NRecords":1, 
  "Data":[ 
    {
        "CODIGOVENTA": "V-0001",
        "FECHACREACION": "24/02/2025",
        "REFERENCIACLIENTE": "SP-098-REF",
        "NOMBRECLIENTE": "CLIENTE",
        "LINEAS": [{
            "PRODUCTO": "PROD_0001",
            "UNIDADES": 100,
            "VERSIONPRODUCTO": "v0",
            "PRECIO": 230.65, 
            "FECHAS": [{
                "FECHAENTREGA": "24/04/2025",
                "UNIDADES": 50
            }]	
        }]
    } 
  ] 
}
No Comments
Back to top