Modificar venta

Con esta función, es posible llevar a cabo la modificación de algunos de los parámetros de una venta así como sus productos asociados y sus fechas de entrega.

Hay que tener en cuenta que se podrán añadir nuevas líneas de producto y nuevas fechas de entrega para estas, siemrpe y cuando no se superen las unidades totales del producto a entregar. En cuyo caso, devolverá un error.

En la adición de nuevos productos, no se pueden añadir productos que ya forma parte de la venta, pues el hacer esta acción devolverá un error.

No obstante, es posible modificar los siguientes parámetros:

• Referencia del cliente en la venta.
• Precio del producto en una línea ya existente.
• Añadir o eliminar una línea existente.
• Añadir o eliminar fechas de entrega de una línea existente.
• Añadir nuevas fechas de entrega a una línea existente.

URL

/CTNEAT/SALEORDER/UPDATE/{tkn}

Método HTTP

POST

Parámetros de la solicitud

Parámetros de la venta

Nombre del parámetro	Tipo de dato	Descripción del parámetro	Obligatorio	Posibles valores
CODIGOVENTA	cadena	Código de la venta	Sí	Cualquiera previamente generado en el sistema. Este campo no es posible modificarlo.
REFERENCIACLIENTE	cadena	Código de la venta para el cliente	No	Cualquiera
LINEAS	Lista de objetos	Líneas asociadas a la venta	No	Cualquiera que tenga el formato de la tabla de parámetros de la línea de la venta

Parámetros de la Línea de la venta

Nombre del parámetro	Tipo de dato	Descripción del parámetro	Obligatorio	Posibles valores
PRODUCTO	cadena	Código del producto asociado a la venta	Sí	Cualquiera
UNIDADES	numérico	Unidades necesarias del producto	Sí	Números positivos enteros
VERSIONPRODUCTO	cadena	Versión del producto seleccionado	No	Versión del producto que aparece en el sistema. Si no se informa el campo, se añadirá la versión por defecto (v0)
PRECIO	numérico	Precio de la línea	Sí	Cualquiera que no sea negativo con el siguiente formato 256.36 (9999999999.9999)
FECHAS	Lista de objetos	Fechas de entrega asociadas a la venta	No	Cualquiera que cumpla los requisitos del objeto de la tabla de Parámetros de la fecha de entrega

Parámetros de la fecha de entrega

Nombre del parámetro	Tipo de dato	Descripción del parámetro	Obligatorio	Posibles valores
FECHAENTREGA	cadena	Fecha de la	Sí	Ha de tener el formato DD/MM/YYYY (ej.: 24/01/2026)
UNIDADES	numérico	Unidades de la venta	Sí	Números positivos enteros

Encabezados de la solicitud

Nombre del encabezado	Descripción del encabezado	Obligatorio
Content-Type	Tipo de contenido de la solicitud	Sí

Cuerpo de la solicitud

Formato del cuerpo de la solicitud: application/json

Descripción del cuerpo de la solicitud:

{
	"CODIGOVENTA": "NÚMERO VENTA",
	"REFERENCIACLIENTE": "CÓDIGO_CLIENTE",
	"LINEAS": [{
    	"PRODUCTO": "CÓDIGO PRODUCTO",
		"UNIDADES": 1000,
		"VERSIONPRODUCTO": "VERSIÓN DEL PRODUCTO",
		"PRECIO": 125.25, 
		"FECHAS": [
          {
        	"FECHAENTREGA": "DD/MM/YYYY",
          	"UNIDADES": 50
          },
          {
        	"FECHAENTREGA": "DD/MM/YYYY",
          	"UNIDADES": 50
          }
        ]	
    }]
}

Parámetros de la respuesta

Nombre del parámetro	Tipo de dato	Descripción del parámetro	Formato
ErrorContent	JSON	Json con la descripción del resultado de la operación	Formato ErrorContent

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

URL

http://ctincoming/CTNEAT/SALEORDER/UPDATE/6A201F1F5147079FF9CA80DCDBB032AB386905091BC973B53F50E6493EC53868

Objeto de entrada

{
	"CODIGOVENTA": "V-0001",
	"REFERENCIACLIENTE": "SP-098-REF",
	"LINEAS": [{
		"PRODUCTO": "PROD_0001",
		"UNIDADES": 100,
		"VERSIONPRODUCTO": "v0",
		"PRECIO": 230.65, 
		"FECHAS": [
          {
        	"FECHAENTREGA": "02/11/2025",
          	"UNIDADES": 50
          },
          {
        	"FECHAENTREGA": "06/11/2025",
          	"UNIDADES": 50
          }
        ]	
	}]
}

Ejemplo de respuesta

{ "Success":true, "fault":{ "faultcode":"none", "faultstring":"Sale order has been modified", "detail":"Sale order: V-0001 successfully updated" } }