Ventas Mensuales

El endpoint PostAddMonthlyIncome es responsable de registrar el valor de ventas mensuales realizadas en ERP en el sistema MIMS.

---

Cómo registrar valor de ventas mensuales

HTTP POST Request

Tipo de Solicitud	URL Ejemplo
POST	{{url_base}}/PostAddMonthlyIncome
Ejemplo	http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostAddMonthlyIncome"

Parámetros de Entrada

Parámetro	Tipo	Obligatorio	Descripción
BranchNo	String(25)	Sí	Código Externo de Filial
Period	String(40)	Sí	Período (Mes/Año)
OverwriteIfExists	Boolean	No	Flag que indica que los datos deben ser sobrescritos si el registro ya existe
ItemList	AddMonthlyIncomeItemList	Sí	Lista de todos los costos por producto en el período

📝 Objeto AddMonthlyIncomeItemList

El objeto AddMonthlyIncomeItemList representa un item de ventas mensuales realizado en ERP.

Parámetros de Entrada

Parámetro	Tipo	Obligatorio	Descripción
ProductNo	String(25)	Sí	Código Externo del Producto
TotalProductWeight	Float	Sí	Peso total del producto
TotalProductCost	Float	Sí	Costo total del producto

---

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}}/PostAddMonthlyIncome' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{
  "BranchNo": "FIL123",
  "Period": "01-2025",
  "OverwriteIfExists": true,
  "ItemList": [
    {
      "ProductNo": "PROD001",
      "TotalProductWeight": 1000.50,
      "TotalProductCost": 50000.75
    },
    {
      "ProductNo": "PROD002",
      "TotalProductWeight": 750.30,
      "TotalProductCost": 32000.40
    }
  ]
}'

---

Ejemplo de Response

{
  "WebServiceReturn": {
      "Status": "wrsSuccess",
      "ErrorCode": "",
      "Message": "",
      "Actor": "",
      "ReturnQuestion": null
  }
}

---

🐞 Posibles Errores

Código	Mensaje
AMI‑001	El Costo Mensual ya fue procesado para Período (PeriodNo) [valor enviado en la solicitud] y Filial (BranchNo) [valor enviado en la solicitud] informado. Operación no permitida!
AMI‑002	La Receita Mensual ya existe para Período (PeriodNo) [valor enviado en la solicitud] y Filial (BranchNo) [valor enviado en la solicitud] informado. Operación no permitida!

---