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 | Sí | Cualquiera |
| FECHACREACION | cadena | Fecha de la venta | Sí | 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 | Sí | 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 |
Sí | Cualquiera |
| UNIDADES | numérico | Sí | ||
| VERSIONPRODUCTO | cadena | No | ||
| PRECIO | numérico | Sí | Cualquiera que |
|
| Lista de objetos | 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 | Código del producto asociado a la venta | Sí | Cualquiera |
| 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:
{
"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" } }