Skip to main content

Página nueva

Con esta función, es posible llevar a cabo la creación de ventas así como sus productos asociados y sus fechas de entrega.

URL

/CTNEAT/SALEORDER/ADD/{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 Cualquiera
FECHACREACION cadena Fecha de la venta Ha de tener el formato 24/01/2026
REFERENCIACLIENTE cadena Código de la venta para el cliente No Cualquiera
NOMBRECLIENTE cadena Nombre del cliente Cualquiera que esté entre los que hay almacenados en el sistema. De lo contrario mostrará un error de asociación del cliente con la venta
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 dedel producto asociado a la venta Cualquiera
UNIDADES numérico FechaUnidades denecesarias ladel ventaproducto HaNúmeros depositivos tener el formato 24/01/2026enteros
VERSIONPRODUCTO cadena CódigoVersión dedel laproducto venta para el clienteseleccionado No CualquieraVersió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 NombrePrecio delde clientela línea Cualquiera que esténo entresea losnegativo que hay almacenados encon el sistema.siguiente Deformato lo256.36 contrario mostrará un error de asociación del cliente con la venta(9999999999.9999)
LINEASFECHAS Lista de objetos LíneasFechas 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ámetroTipo de datoDescripción del parámetroObligatorioPosibles valores
FECHAENTREGAcadenaCódigo del producto asociado a la ventaCualquiera
UNIDADESnuméricoUnidades de la ventaNúmeros positivos enteros

Encabezados de la solicitud

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

Cuerpo de la solicitud

Formato del cuerpo de la solicitud: application/json

Descripción del cuerpo de la solicitud:

{
	"ITEMCODE"CODIGOVENTA": "CODIGO_PN"V-0001",
	"DESCRIPTION"FECHACREACION": "DESCRIPCION_CODIGO_PN"24/02/2025",
	"CODETYPE"REFERENCIACLIENTE": "CODETYPE"CÓDIGO_CLIENTE",
	"NOMBRECLIENTE": "CLIENTE",
	"LINEAS": [
		"PRODUCTO": "PROD_0001",
		"UNIDADES": 100,
		"VERSIONPRODUCTO": "v0",
		"PRECIO": 230.65, 
		"FECHAS": [
			"FECHAENTREGA": ,
			"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

http://ctincoming/CTNEAT/ITEM/ADD/6A201F1F5147079FF9CA80DCDBB032AB386905091BC973B53F50E6493EC53868

{ 
  "ITEMCODE":"CODIGO_PN",
  "DESCRIPTION":"DESCRIPCION_CODIGO_PN",
  "CODETYPE":2
}

Ejemplo de respuesta

{ "Success":true, "fault":{ "faultcode":"none", "faultstring":"Item code added", "detail":"Item code: CODIGO_PN successfully added" } }