Skip to main content

Leer albaranes de entrega

Con esta función, se pueden consultar los albaranes de entrega que hayan sido previamente registrados en el sistema.

Es importante destacar que se puede proporcionar el nombre de un albarán en concreto a través de un parámetro de URL query así como una fecha de creación de este. Además, también se añade un nuevo parámetro para poder ver los que han sido finalizados como los que aún están pendientes.

En caso de no especificar estos parámetro, se llevará a cabo la lectura de todos los registros del sistema. Si la fecha se introduce en el formato no deseado, se mostrarán todas las fechas.

URL

/CTNEAT/SALEDELIVERY/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
DELIVERYNOTENAME cadena Nombre del albarán de entrega No Cualquiera
CREATIONDATE cadena Fecha de creación o lanzamiento del pedido No Fechas en formato YYYYMMDDHHmmSS
FINISHED numérico Mostrará los albaranes de entrega finalizados No Solo puede ser 1 o 0. En caso de no añadir el parámetro a al query, se devolverán tanto los que han sido finalizados como los que no.

Encabezados de la solicitud

Encabezados:

Nombre del encabezadoDescripción del encabezadoObligatorio
application/json

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].DELIVERYNOTENAME: Nombre del pedido.
  • Result.Data[x].CUSTOMER: Nombre del cliente asociado al albarán.
  • Result.Data[x].FINISHED: Muestra si el pedido está o no finalizado.
  • Result.Data[x].CREATIONDATE: Fecha de creación del pedido.
  • Result.Data[x].FINISHDATE: Fecha de creación del pedido.
  • Result.Data[x].SALENAME: Nombre de la venta asociada al albarán de entrega.
  • Result.Data[x].LINES: Líneas del albarán de entrega
  • Result.Data[x].LINES[y].PRODUCT: Código del producto de la línea.
  • Result.Data[x].LINES[y].PRODUCTVERSION: Inidica la versión del preoducto asiciado.
  • Result.Data[x].LINES[y].DEILVEREDUNITS: Indica las unidades entregadas.
  • Result.Data[x].LINES[y].UNITS: Cantidad asignada en la línea.
  • Result.Data[x].LINES[y].PRICE: 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/SALEDELIVERY/READ/693DDFEC2F4BFDDEAF04DD2724984C9B3CA89D553DD8E5B9BB233AD6BB6075F1?DELIVERYNOTENAME=ALB_0001&CREATIONDATE=20250302112358&FINISHED=0

Ejemplo de respuesta

{ 
  "NRecords":1, 
  "Data":[ 
    {
        "DELIVERYNOTENAME": "ALB_0001",
        "CUSTOMER": "CUST001",
        "FINISHED": 0,
        "CREATIONDATE": "20250302",
        "FINISHDATE": "",
        "SALENAME": "SALE_0001",
        "LINES": [{
            "PRODUCT": "PROD_0001",
            "PRODUCTVERSION": "v0",
            "DEILVEREDUNITS": 100,
            "UNITS": 100,
            "PRICE": 20.56
        }]
    } 
  ] 
}
Back to top