Tabla de Precio
Registro de Tabla de Precio
El endpoint PostAddPriceTable es responsable del registro de una nueva tabla de precio en el sistema MIMS y puede ser visualizado en la pantalla CAD084.
Cómo registrar una tabla de precio
Request HTTP Post
| Tipo de Solicitud | URL Ejemplo |
|---|---|
| POST | {{url_base}}/PostAddPriceTable |
| Ejemplo | http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostAddPriceTable" |
Parámetros de Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| PriceTableNo | String(15) | Sí | Código externo de la tabla de precio |
| DescriptionTable | String(40) | Sí | Descripción de la tabla de precio |
| IsInactiveValidity | Boolean | No | Flag que indica que la vigencia de la tabla de precio está inactiva |
| ValidityStartDate | DataHora | No | Fecha inicial de la vigencia |
| ValidityEndDate | DataHora | No | Fecha final de la vigencia |
| ConversionCurrencyNo | String(25) | No | Código de la moneda de conversión |
| ItemList | AddPriceTableItemList | No | Lista de items de la tabla de precio |
| OverwriteIfExists | Boolean | No | Flag que indica que los datos deben ser sobrescritos si el registro ya existe |
📝 Objeto AddPriceTableItemList
El objeto AddPriceTableItemList representa una lista con los items de la tabla de precio.
Parámetros de Entrada
Parámetro Tipo Obligatorio Descripción ProductNo String(25) Sí Código del producto IsInactiveItem Boolean No Flag que indica que el item de la tabla de precio está inactivo IsFixedCommission Boolean No Flag que indica si la comisión es fija LimitCommission Boolean No Flag que indica si limita comisión PayCommission Boolean No Flag que indica si paga comisión ResetCommission Boolean No Flag que indica si reinicia comisión SalePrice Float Sí Precio de Venta del item
Retorno
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| WebServiceReturn | WebServiceReturn | Sí | Informaciones estándar de respuesta del WebService en la ejecución del método |
| PriceTableCode | Integer | Sí | Código interno de la tabla de precio generado en el sistema MIMS |
Ejemplo de Request
curl --location 'http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostAddPriceTable"' \
--header 'Content-Type: application/json' \
--data '{
"PriceTableNo": "TAB001",
"DescriptionTable": "Tabla de precio Base 2025",
"IsInactiveValidity": false,
"ValidityStartDate": "2025-02-01T00:00:00Z",
"ValidityEndDate": "2025-12-31T23:59:59Z",
"ConversionCurrencyNo": "BRL",
"OverwriteIfExists": true,
"ItemList":[
{
"ProductNo": "PROD001",
"IsInactiveItem": false,
"IsFixedCommission": true,
"LimitCommission": true,
"PayCommission": true,
"ResetCommission": true,
"SalePrice": 15
}
]
}'
Ejemplo de Response
{
"WebServiceReturn": {
"Status": "wrsSuccess",
"ErrorCode": "",
"Message": "",
"Actor": "",
"ReturnQuestion": null
},
"PriceTableCode": 789
}
🐞 Posibles Errores
| Código | Mensaje |
|---|---|
| APT‑001 | ¡El parámetro Código Externo de la Tabla de Precio (PriceTableNo) informado ya existe! |
| APT‑002 | ¡El parámetro Fecha Final Vigencia (ValidityEndDate) informado es menor que el parámetro Fecha Inicio Vigencia (ValidityStartDate) informado! |
| APT‑003 | ¡El parámetro Código Externo de la Moneda de Conversión (ConversionCurrencyNo) informado no fue encontrado! |
Eliminación de Tabla de Precio
El endpoint PostDeletePriceTable es responsable de ejecutar la eliminación de una tabla de precio y sus items en MIMS.
Cómo eliminar una tabla de precio
Request HTTP Post
| Tipo de Solicitud | URL Ejemplo |
|---|---|
| POST | {{url_base}}/PostDeletePriceTable |
| Ejemplo | http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostDeletePriceTable" |
Parámetros de Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| PriceTableNo | String(15) | Sí | Código externo de la tabla de precio |
| ErrorIfNotFound | Boolean | No | Retorna error si la tabla de precio informada no existe en la base de datos |
Retorno
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| WebServiceReturn | WebServiceReturn | Sí | Informaciones estándar de respuesta del WebService en la ejecución del método |
Ejemplo de Request
curl --location --request POST '{{url_base}}/PostDeletePriceTable' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{
"PriceTableNo": "TP001",
"ErrorIfNotFound": true
}'
Ejemplo de Response
{
"WebServiceReturn": {
"Status": "wrsSuccess",
"ErrorCode": "",
"Message": "",
"Actor": "",
"ReturnQuestion": null
}
}
🐞 Posibles Errores
| Código | Mensaje |
|---|---|
| DPT‑001 | ¡El parámetro Código Externo de la Tabla de Precio (PriceTableNo) informado no fue encontrado! |
| DPT‑002 | ¡La tabla de precio informada pertenece a un cliente, por lo tanto no puede ser eliminada! |