Leer artículos en stock
Con esta función, se tiene la capacidad de leer el stock actual de los artículos que han sido registrados en el sistema. Es importante destacar que se puede proporcionar el código del artículo que se desea leer a través de un argumento de URL query.
URL
/CTNEAT/STOCKITEM/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 |
|---|---|---|---|---|
| ITEMCODE | cadena | Código interno del artículo | No (Si el código de artículo no se especifica, la API devolverá todos los artículos del sistema) | Cualquiera |
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].ITEMCODE: Representa el código del artículo.
- Result.Data[x].CURRENTUNITS: Representan las unidades actuales del artículo.
- Result.Data[x].RESERVEDUNITS: Representan las unidades reservadas de artículo en el sistema.
- Result.Data[x].PLANNEDUNITS: Representa la cantidad de unidades que hay en planificación.
- Result.Data[x].SPN: Representa el Part number de proveedor que tiene este artículo.
- Result.Data[x].MPN: Representa el Part number de fabricante que tiene este artículo.
- Result.Data[x].CUSTOMERNAME: Representa el nombre del cliente al que este artículo está asociado.
Códigos de estado de la respuesta
| Código de estado | Descripción del código de estado | Posibles razones |
|---|---|---|
| 200 | OK | La solicitud tuvo éxito |
| 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/STOCKITEM/READ/693DDFEC2F4BFDDEAF04DD2724984C9B3CA89D553DD8E5B9BB233AD6BB6075F1?ITEMCODE=test_item
Ejemplo de respuesta
{
"NRecords":1,
"Data":[
{
"ITEMCODE": "test_item",
"CURRENTUNITS": 100,
"RESERVEDUNITS": 0,
"PLANNEDUNITS": 10,
"SPN": "",
"MPN": "",
"CUSTOMERNAME": "",
}
]
}
No Comments